Oracle NoSQL Database - 5分でクイック・スタート

Oracle NoSQL Databaseのインストール

http://www.oracle.com/technetwork/database/nosqldb/downloads/index.htmlから、tar.gzファイルをダウンロードします。

.tar.gzパッケージをgunzipおよびuntarします(.zipパッケージをダウンロードした場合はunzipします)。この例では、Oracle NoSQL Databaseバージョン2.0.14 Community Editionを使用します。実際のパッケージ名およびディレクトリ名は、ご使用のリリース・バージョンや、Community Edition (CE)またはEnterprise Edition (EE)のどちらを使用しているかによって異なります。
```
$ gunzip kv-ce-2.0.14.tar.gz
$ tar xvf kv-ce-2.0.14.tar
kv-2.0.14/
...
kv-2.0.14/README.txt
$
```

KVLiteの起動

KVLiteは、単一プロセス版のOracle NoSQL Databaseです。KVLiteはパフォーマンスに優れているわけではありませんが、単純なキーバリュー・ストアに簡単にアクセスしてAPIをテストすることができます。

kv-2.0.14ディレクトリに移動し、NoSQL Databaseサーバーを起動します。

$ cd kv-2.0.14
$ java -jar lib/kvstore.jar kvlite
Created new kvlite store with args:
-root ./kvroot -store kvstore -host myhost -port 5000 -admin 5001

2つ目のシェルでkv-2.0.14ディレクトリに移動し、KVLiteインスタンスにpingして稼働状況をテストします。出力内容は様々ですが、稼働中のストアが表示されます。

$ cd kv-2.0.14
$ java -jar lib/kvstore.jar ping -host myhost -port 5000
Pinging components of store kvstore based upon topology sequence #14
kvstore comprises 10 partitions and 1 Storage Nodes
Storage Node [sn1] on myhost:5000    Datacenter: KVLite [dc1]  Status: RUNNING  ...
        Rep Node [rg1-rn1]      Status: RUNNING,MASTER at sequence number: 38 haPort: 5011

サンプルのHello Worldをコンパイルして実行します。これによって、Oracle NoSQL Databaseが開かれ、1つのレコードが書き込まれます。
```
$ javac -cp examples:lib/kvclient.jar examples/hello/HelloBigDataWorld.java
$ java -cp examples:lib/kvclient.jar hello.HelloBigDataWorld
Hello Big Data World!
$
```
Hello Worldサンプル・コードの内容を確認し、これを拡張して様々なOracle NoSQL Database APIを試用します。スキーマとAvroの使用方法の詳細は、examples/avroディレクトリ内の例を参照してください。スタート・ガイドおよびJavadocでAvroについて詳しく説明しています。

Oracle NoSQL Databaseの詳細

ドキュメントの開始ページ(ローカルのkv-2.0.14/doc/index.htmlまたはOTN)を開きます。そこから、スタート・ガイド(HTMLまたはPDF)およびJavadocを参照してNoSQL Database APIについて確認します。『Oracle NoSQL Database管理者ガイド』(HTMLまたはPDF)は、大規模なインストールの計画方法とデプロイ方法の理解に役立ちます。

KVLiteは、NoSQL Database APIについて理解するためにのみ使用することに注意してください。システムの本格的な評価は、複数プロセスおよび複数ノードの構成で行う必要があります。ここでは、1つのシャードが3つのホストにレプリケートされた簡単なマルチノード・システムをインストールする基本的な手順を説明します。ホスト名およびポート番号は、あくまでも一例です。適切な値に置き換えてください。

このソフトウェアがまだ利用可能になっていないノードで、パッケージの解凍方法に関する前述の手順を繰り返す必要があります。その後、管理者ガイドの「インストール」に記載されている追加手順に従います。次の手順では、この例で使用する3つのノード上でストレージ・ノード・エージェントが稼働していることを前提としています。
必ずすべてのノードでntpを実行してください。ノード間に時間同期の問題があると、予期しないエラーが発生する場合があります。

コマンドライン・インタフェース(CLI)を使用して、ストアを構成およびデプロイします。この例では、ホスト名をそれぞれhost01、host02およびhost03としています。ホストhost01は、管理サービスに使用します。

$ java -jar lib/kvstore.jar runadmin -host host01 -port 5000
kv-> configure -name "mystore"
kv-> plan deploy-datacenter -name MyDC -rf 3 -wait
kv-> plan deploy-sn -dcname MyDC -host host01 -port 5000 -wait
kv-> plan deploy-admin -sn sn1 -port 5001
kv-> pool create -name MyPool
kv-> pool join -name MyPool -sn sn1
kv-> plan deploy-sn -dcname MyDC -host host02 -port 5000 -wait
kv-> pool join -name MyPool -sn sn2
kv-> plan deploy-sn -dcname MyDC -host host03 -port 5000 -wait
kv-> pool join -name MyPool -sn sn3
kv-> topology create -name MyStoreLayout -pool MyPool -partitions 100
kv-> topology preview -name MyStoreLayout
kv-> plan deploy-topology -name MyStoreLayout -wait
kv-> show plans
kv-> show topology
kv-> verify
kv-> quit

CLIの詳細は、NoSQL Database CLIリファレンスに関する項を参照してください。

パフォーマンスを評価するには、ターゲット・ホスト・マシンに必ず十分なメモリーを構成します。これを行うには、ストレージ・ノードの初期インストールまたはデプロイ時に使用可能なメモリーをストレージ・ノードごとに指定するか、デプロイ後にストレージ・ノードの構成パラメータを設定します。詳細は、インストールの計画に関する項を参照してください。

Oracle NoSQL Database OTNフォーラムで質問したり、コメントすることができます。