rabbit-slide-kenhys-groonga-meetup-20140429 2014.04.29.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1bf670b520b76d7c75e0b9f56aca873304e71db0
+  data.tar.gz: d86a7474ced5e06fa080fef72ce4467ac48626dc
+SHA512:
+  metadata.gz: 12e6c310f34c87801b1cc60810280f03c72b3318c8a1baa140608a793cecc49f7e4326df72184c9027cd0fd335db92684c4ab2b1617495bfb0d9c58b00544062
+  data.tar.gz: 284d94a44abde0b027b2ea24647664ae5f8d2cfad2641c3dd9d418486d6d34c45b54739e96db52a6f0045d7599b9f3663592e0ef20a63a4d24e5ac15afcb8a3a

data/.rabbit

@@ -0,0 +1,2 @@
+--allotted-time 90m
+groonga-meetup-20140429.rab

data/README.rd

@@ -0,0 +1,26 @@
+= Groonga Meetup 2014/04/29
+
+2014年4月29日に行われたGroonga meetupで使用したスライドです。
+GroongaやMroongaを初めて触れる人向けに演習を通じて基本をおさえてもらうための資料です。
+今回は主にGroonga中心のサンプルを用意しました。
+
+== For author
+
+=== Show
+
+  rake
+
+=== Publish
+
+  rake publish
+
+== For viewers
+
+=== Install
+
+  gem install rabbit-slide-kenhys-groonga-meetup-20140429
+
+=== Show
+
+  rabbit rabbit-slide-kenhys-groonga-meetup-20140429.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # task.spec.files += Dir.glob("doc/**/*.*")
+  # task.spec.files -= Dir.glob("private/**/*.*")
+  # task.spec.add_runtime_dependency("YOUR THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,18 @@
+---
+id: groonga-meetup-20140429
+base_name: groonga-meetup-20140429
+tags: []
+presentation_date: 2014/04/29
+version: 2014.04.29.1
+licenses: []
+slideshare_id: groonga-meetup-20140429
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+author:
+  markup_language: 
+  name: HAYASHI Kentaro
+  email: hayashi@clear-code.com
+  rubygems_user: kenhys
+  slideshare_user: kenhys
+  speaker_deck_user: 

data/groonga-meetup-20140429.rab

@@ -0,0 +1,614 @@
+= Groonga meetup #2
+
+: author
+  林健太郎
+: institution
+  クリアコード
+: content-source
+  Groonga meetup
+: date
+  2014/04/29
+: allotted-time
+  90m
+: theme
+  .
+
+= はじめに
+
+* 開催の目的
+* 今回の内容
+* Any Questions？
+
+= 開催の目的(1)
+
+「全文検索をしたい人の最初の一歩を踏みだしやすくしよう」
+
+= 今回の内容(1)
+
+  * 全文検索事始め
+  * GroongaやMroongaの特長の紹介
+  * 最新版の導入について
+  * GroongaやMroongaの環境構築
+
+= 今回の内容(2)
+
+  * 題材の説明と実際の演習(随時)
+  * Any Questions？
+
+= 全文検索事始め
+
+* 既存のシステムに全文検索導入したい
+* 手持ちのメタ情報を効率良く検索したい
+
+= Groongaの特長(1)
+
+* 全文検索と即時更新
+  * 参照ロックフリー
+    * 更新しつつ検索OK
+* カラムストアを採用
+  * 集計クエリを高速に処理可能
+
+= Groongaの特長(2)
+
+* 豊富なトークナイザー
+  * 検索漏れないことを重視しますか？
+  * 検索精度を重視しますか？
+* 位置情報検索のサポート
+
+= Groongaの特長(3)
+
+* アプリケーションへの組込み
+  * ライブラリとして活用可能
+  * 実はバックエンドでGroongaが動いていることも
+
+= Groongaとパッケージ
+
+* Debian
+* Ubuntu
+* CentOS
+* Fedora
+* Windows
+
+= Groonga on Debian
+
+* Debian 7.4 (wheezy)
+* Debian 8 (jessie)
+* Debian unstable (sid)
+
+= Groonga on Ubuntu(1)
+
+* Ubuntu 12.04 (Precise)
+* Ubuntu 12.10 (Quantal)
+  * 明日でサポート終了 4.0.1まで
+* Ubuntu 13.04 (Raring)
+  * すでにサポート終了 3.1.2まで
+
+= Groonga on Ubuntu(2)
+
+* Ubuntu 13.10 (Saucy)
+  * 7月にサポート終了
+* Ubuntu 14.04 (Trusty)
+  * 今月からサポート開始
+
+= Groonga on CentOS
+
+* CentOS 5/6
+  * 中国語のトークナイザーは未サポート
+* CentOS 7?
+  * まだrcベースらしいのでしばらく先
+
+= Groonga on Fedora(1)
+
+* Fedora 20
+  * 中国語のトークナイザーは未サポート
+  * Groonga公式とFedora公式に違いはない
+  * Fedoraでリリースするのはちょっと遅れる(2-3週)
+
+= Groonga on Fedora(2)
+
+  * リリース短縮にはKarmaが必要
+
+  # image
+  # src = images/bohdi-what-is-karma.png
+  # relative_height = 100
+
+= FedoraでKarmaを稼ぐ
+
+  * (('tag:x-small'))Bohdiにログイン
+  * (('tag:x-small'))メニューのTestingを選択
+  * (('tag:x-small'))Groongaパッケージを選択
+  * (('tag:x-small'))works for meコメントを追加
+
+  https://admin.fedoraproject.org/updates/
+
+= FedoraでKarmaを稼ぐ(1)
+
+  * (('tag:x-small'))((*Bohdiにログイン*))
+  * (('tag:x-small'))メニューのTestingを選択
+  * (('tag:x-small'))Groongaパッケージを選択
+  * (('tag:x-small'))works for meコメントを追加
+
+  https://admin.fedoraproject.org/updates/
+
+= FedoraでKarmaを稼ぐ(2)
+
+  * (('tag:x-small'))Bohdiにログイン
+  * (('tag:x-small'))((*メニューのTestingを選択*))
+  * (('tag:x-small'))Groongaパッケージを選択
+  * (('tag:x-small'))works for meコメントを追加
+
+= FedoraでKarmaを稼ぐ(2)
+
+  * Testingって？
+
+  # image
+  # src = images/bohdi-select-menu.png
+  # relative_height = 100
+
+= FedoraでKarmaを稼ぐ(3)
+
+  * (('tag:x-small'))Bohdiにログイン
+  * (('tag:x-small'))メニューのTestingを選択
+  * (('tag:x-small'))((*Groongaパッケージを選択*))
+  * (('tag:x-small'))works for meコメントを追加
+
+= FedoraでKarmaを稼ぐ(4)
+
+  * (('tag:x-small'))Bohdiにログイン
+  * (('tag:x-small'))メニューのTestingを選択
+  * (('tag:x-small'))Groongaパッケージを選択
+  * (('tag:x-small'))((*works for meコメントを追加*))
+
+= FedoraでKarmaを稼ぐ(4)
+
+  * works for meコメントって?
+    * これを送信するとKarma +1
+
+  # image
+  # src = images/bohdi-works-for-me.png
+  # relative_height = 100
+
+= Mroongaの特長(1)
+
+* 導入しやすいプラグイン形式
+* 他のストレージエンジンとの連携
+  * ラッパーモード
+
+= Mroongaの特長(2)
+
+* データ更新が多くても検索性能が良い
+* LIKEからの置き換えも比較的容易
+
+= Mroongaとパッケージ
+
+* Debian
+* Ubuntu
+* CentOS
+* Fedora
+* Windows
+
+= Mroonga on Debian
+
+* MySQL 5.5系
+  * Debian 7.4 (wheezy)
+  * Debian 8 (jessie)
+  * Debian unstable (sid)
+
+= Mroonga on Ubuntu(1)
+
+* MySQL 5.5系
+  * Ubuntu 12.04 (Precise)
+  * Ubuntu 12.10 (Quantal)
+    * 明日でサポート終了 4.01まで
+  * Ubuntu 13.04 (Raring)
+    * すでにサポート終了 3.12まで
+
+= Mroonga on Ubuntu(2)
+
+* MySQL 5.5系
+  * Ubuntu 13.10 (Saucy)
+    * 7月にサポート終了
+  * Ubuntu 14.04 (Trusty)
+    * 今月からサポート開始
+
+= Mroonga on CentOS 5
+
+* CentOS 5
+  * 以前はMySQLが古すぎたので、MySQL 5.6対応パッケージを提供
+  * MySQL 5.5(SCL)対応パッケージに移行
+
+= Mroonga on CentOS 6
+
+* CentOS 6
+  * MySQL 5.1しか使えないというのは古い情報です！
+  * MySQL 5.5対応(SCL)パッケージに移行
+
+= Mroonga on CentOS
+
+  * CentOS 5やCentOS 6でMySQL 5.6
+    * wingリポジトリをお勧めしています
+
+  http://wing-repo.net/
+
+= Mroonga on Fedora
+
+* Fedora 20
+  * MySQL 5.5 & MariaDB 5.5対応
+  * Fedora公式リポジトリでは未リリース
+    * Mroonga含めてインストールしたいならGroongaリポジトリを登録する
+
+= 環境構築してみよう
+
+* Groongaのインストール
+* Mroongaのインストール
+
+= (('tag:x-small'))どれをインストールしたらいい？(1)
+
+* groonga
+  * ちょっとお試しで使うならコレ
+  * コマンドラインで使うだけ
+  * いろいろ指定すればサーバーとしても利用可
+
+= (('tag:x-small'))どれをインストールしたらいい？(2)
+
+* groonga-server-http
+  * サーバー立てるならコレ
+* groonga-server-gqtp
+  * 特に理由がなければスルー
+
+= (('tag:x-small'))どれをインストールしたらいい？(3)
+
+* groonga-httpd
+  * 不満がでてきたらコレ
+  * POSTしたいならコレ一択
+
+= (('tag:x-small'))どれをインストールしたらいい？(3)
+
+* ((*groonga-httpd*))
+  * 不満がでてきたらコレ
+  * POSTしたいならコレ一択
+
+= Install Groonga(1)
+
+(('⏳'))(('tag:x-small'))Groongaをインストールしてみましょう
+
+  * groonga-httpd
+
+  http://groonga.org/ja/docs/install.html
+
+= Install Groonga(2)
+
+(('⏳'))(('tag:x-small'))トークナイザーやノーマライザーをインストールしてみましょう
+
+  * groonga-tokenizer-mecab
+  * groonga-normalizer-mysql
+
+  http://groonga.org/ja/docs/install.html
+
+= Install Groonga(3)
+
+(('⏳'))(('tag:x-small'))Groongaが起動しているか確認しましょう
+
+  % curl http://localhost:10041/d/status
+
+= Install Groonga(4)
+
+(('⏳'))(('tag:x-small'))Groongaが起動していない場合は起動しましょう
+
+  % sudo service groonga-httpd start
+
+= Install Mroonga(1)
+
+(('⏳'))(('tag:x-small'))Mroongaをインストールしてみましょう
+
+  http://mroonga.org/ja/docs/install.html
+
+= Install Mroonga(2)
+
+(('⏳'))(('tag:x-small'))Mroongaが使えるか確認しましょう
+
+  mysql> show engines;
+
+= Install Mroonga(3)
+
+(('⏳'))(('tag:x-small'))インストールされているとどうなる？
+
+  mysql> SELECT * FROM mysql.plugin;
+  +---------+---------------+
+  | name    | dl            |
+  +---------+---------------+
+  | mroonga | ha_mroonga.so |
+  +---------+---------------+
+  1 row in set (0.00 sec)
+
+= Install Mroonga(4)
+
+(('⏳'))(('tag:x-small'))インストールされているとどうなる？
+
+  mysql> SELECT * FROM mysql.func;
+  +--------------------+-----+---------------+----------+
+  | name               | ret | dl            | type     |
+  +--------------------+-----+---------------+----------+
+  | last_insert_grn_id |   2 | ha_mroonga.so | function |
+  | mroonga_snippet    |   0 | ha_mroonga.so | function |
+  | mroonga_command    |   0 | ha_mroonga.so | function |
+  | mroonga_escape     |   0 | ha_mroonga.so | function |
+  +--------------------+-----+---------------+----------+
+  4 rows in set (0.00 sec)
+
+= 今回の演習の題材
+
+* 駅データ.jp
+  * http://www.ekidata.jp/
+#* Wikipediaの記事の一部
+#  * (('tag:x-small'))http://ja.wikipedia.org/wiki/Wikipedia:データベースダウンロード
+
+= 題材のダウンロード
+
+(('⏳'))(('tag:x-small'))以下から今回使うサンプルをダウンロードしてください
+
+  http://packages.groonga.org/tmp/groonga-meetup-20140429.tar.gz
+
+= Groonga編
+
+* よく使うgroongaコマンド
+  * table_create/table_remove
+  * column_create/column_remove
+  * select/load/delete/dump
+
+= テーブルのキーの話
+
+  * いろいろあるけど((*TABLE_PAT_KEY*))
+  * 長過ぎるキーは禁物(ShortText)
+
+  table_create Company TABLE_PAT_KEY UInt32
+
+= データを追加/更新しよう
+
+* 多才なloadコマンド
+  * 追加も更新もこれ一つで
+
+= 失敗時にわかりやすいロードの仕方(1)
+
+  * こうやってロードできるけど
+
+  load --table Company
+  [
+  ["_key", "column1", "column2", ...
+  ["key1",  "data1", "data2", ...
+
+= 失敗時にわかりやすいロードの仕方(2)
+
+  * key:valueのペアがわかりやすい
+
+  load --table Company
+  [
+  {"_key": "key1", "column1":"data1", "column2":", ...
+
+= 失敗時にわかりやすいロードの仕方(3)
+
+(('⏳'))実際に試してみましょう
+
+  % 0001-load/load-fail.sh
+  % 0001-load/load-succeed.sh
+
+  [[0,1398668413.7959,0.00316190719604492],3]
+
+= データをより安全にロードする(3)
+
+(('⏳'))実際に試してみましょう\n
+(('⚠'))((*_key:3のstatusが抜けている*))
+
+  % ./0001-load/load-fail.sh
+  % ./0001-load/load-succeed.sh
+
+  [[0,1398668413.7959,0.00316190719604492],3]
+
+= データを更新してみよう
+
+(('⏳'))実際に試してみましょう\n
+((*_key:3のstatusを更新します*))
+
+  % ./0002-update/update-status.sh
+
+= データを検索してみよう
+
+(('⏳'))実際に試してみましょう\n
+(('⚠'))((*1件もヒットしない*))
+  % ./0003-search/search-name.sh
+
+= 検索するにはインデックスが必要(1)
+
+(('⏳'))インデックスを追加してみましょう\n
+
+  % ./0003-search/add-index.sh
+
+= 検索するにはインデックスが必要(2)
+
+(('⏳'))COLUMN_INDEXを指定するのがポイントです
+
+  table_remove Lexicon
+  table_create Lexicon TABLE_PAT_KEY ShortText --default_tokenizer \
+    TokenBigram --normalizer NormalizerAuto
+  column_create Lexicon name_index COLUMN_INDEX|WITH_SECTION|WITH_POSITION Users name
+  column_create Lexicon sect_index COLUMN_INDEX|WITH_SECTION|WITH_POSITION Users sect
+
+= 検索するにはインデックスが必要(3)
+
+(('⏳'))再度検索してみましょう\n
+
+  % ./0003-search/search-name.sh
+
+= 検索するにはインデックスが必要(4)
+
+(('⏳'))インデックスを覗いてみる
+
+  % ./0003-search/dump-lexicon.sh
+
+= データを削除してみよう(1)
+
+(('⏳'))キーをもとに削除する
+
+  delete Company 2
+
+  % 0004-delete/delete-by-key.sh
+
+= データを削除してみよう(2)
+
+(('⏳'))nameカラムの値をもとに削除する
+
+  delete Company --filter "name == 'JR北海道'"
+
+  % 0004-delete/delete-by-name.sh
+
+= データを削除してみよう(3)
+
+(('⏳'))statusの値をもとに削除する
+
+  delete Company --filter 'status > 0'
+
+  % 0004-delete/delete-by-status.sh
+
+= HTTP経由でのリクエストの基本
+
+  * コマンド名 + キー=値のペア
+
+  http://localhost:10041/d/コマンド名?キー1=値1&キー2=値2....
+
+= HTTP経由でテーブルを作成する(1)
+
+(('⏳'))table_createコマンドを使ってアクセス
+
+  % ./0005-create-table/create-table.sh
+
+  curl 'http://localhost:10041/d/table_create?name=Company&type=TABLE_PAT_KEY&key_type=UInt32'
+
+= HTTP経由でカラムを作成する(1)
+
+(('⏳'))column_createコマンドを使ってアクセス
+
+  % ./0006-create-column/create-column.sh
+
+  curl 'http://localhost:10041/d/column_create?table=Company&name=full_name&flags=COLUMN_SCALAR&type=ShortText'
+
+= POSTでデータを更新する(1)
+
+(('⏳'))POSTでデータをロードしてみましょう
+
+  % ./0007-post-data/post-data.sh
+
+= HTTPでデータを検索する(1)
+
+(('⏳'))HTTP経由で検索してみましょう
+
+  % ./0008-search-http/search-http.sh
+
+= 管理画面を触ってみよう
+
+(('⏳'))ブラウザで次のURLにアクセスしてください
+
+  http://localhost:10041/
+
+#= 位置情報を検索してみよう
+#
+#= 文字列をトークナイズしてみよう
+#
+#= 文字列を正規化してみよう
+#
+#= クエリ展開してみよう
+#
+#= 他のプロダクトを活用してみよう
+#
+#* Rroonga
+#* Sewell
+#* grnmini
+#
+#= Rroongaを使ってみる(1)
+#
+#  Debian系% sudo apt-get install libgroonga-dev
+#  Red Hat系% sudo apt-get install groonga-devel
+#
+#  % gem install rroonga
+#
+#= Sewellを使ってみる(1)
+#
+#  % gem install sewell
+#
+#= Sewellを使ってみる(2)
+#
+#  % gem install sewell
+#
+#= GrnMiniを使ってみる(1)
+#
+#* ongaeshiさん作
+#
+#= GrnMiniを使ってみる(2)
+#
+#  % gem install grnmini
+#
+
+= Mroonga編
+
+= モードの違いをおさえる(1)
+
+* ラッパーモード
+  * データは他のストレージエンジン
+  * 全文検索をMroongaでがんばる
+    * トランザクションでロールバックすると不整合発生
+  * チューニングはMySQLの範囲で
+
+= モードの違いをおさえる(2)
+
+* ストレージモード
+  * 全部Mroongaでがんばる
+  * トランザクション何それ？
+
+= ストレージモード
+
+  * ENGINE=mroongaと覚えましょう
+
+= ラッパーモード
+
+  * コメントでエンジンを指定
+ 
+  ENGINE=mroonga COMMENT='engine "innodb"'
+  
+= パーサーの指定
+
+  * コメントでパーサーを指定
+  * Groongaの用語だとトークナイザー
+
+  FULLTEXT INDEX (content) COMMENT 'parser "TokenMecab"'
+
+= ノーマライザーの指定
+
+  * コメントでノーマライザーを指定
+
+  FULLTEXT INDEX (content) COMMENT 'normalizer "NormalizerAuto"'
+
+= パーサー&ノーマライザーの指定
+
+  * 両方指定したいときは,で区切る
+
+  FULLTEXT INDEX (content) COMMENT 'parser "TokenMecab", normalizer "NormalizerAuto"'
+
+= MATCH AGAINSTとBOOLEAN MODE
+
+  * QUERY EXPANSION MODE
+    * MySQLにおまかせの類似文書検索
+  * BOOLEAN MODE
+    * 明示的に検索を制御
+
+= 位置情報検索
+
+(('⏳'))(('tag:x-small'))Qiitaの位置情報検索の記事を試してみよう
+
+  http://qiita.com/groonga/items/7abca5004d2ae386d388
+
+= 感謝
+
+* WEICさん\n会場提供ありがとうございます！
+
+= おわり
+
+* Any Questions?

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kenhys-groonga-meetup-20140429
+version: !ruby/object:Gem::Version
+  version: 2014.04.29.1
+platform: ruby
+authors:
+- HAYASHI Kentaro
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: |-
+  2014年4月29日に行われたGroonga meetupで使用したスライドです。
+  GroongaやMroongaを初めて触れる人向けに演習を通じて基本をおさえてもらうための資料です。
+  今回は主にGroonga中心のサンプルを用意しました。
+email:
+- hayashi@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .rabbit
+- README.rd
+- Rakefile
+- config.yaml
+- groonga-meetup-20140429.rab
+- images/bohdi-select-menu.png
+- images/bohdi-what-is-karma.png
+- images/bohdi-works-for-me.png
+- pdf/groonga-meetup-20140429-groonga-meetup-20140429.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kenhys/groonga-meetup-20140429/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Groonga Meetup 2014/04/29
+test_files: []