指定されたディレクトリ、もしくは単一のzipファイルに、JSONドキュメントのグループをロードするために、このツールを使用することができます。これは、Couchbase Serverをインストールする時に使用する基本的なツールで、任意でCouchbaseから提供される2つのサンプルデータベースをインストールするか選択します。使用しているプラットフォームに応じて、次の場所にこのツールがあります:
Linux |
/opt/couchbase/bin/tools/
|
Windows |
C:\Program Files\Couchbase\Server\bin\tools\
|
Mac OS X |
/Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/tools/
|
ドキュメントとビューに関連付けられたデザインドキュメントをロードする時、次のようなディレクトリ構造を使用する必要があります:
/design_docs // which contains all the design docs for views. /docs // which contains all the raw json data files. This can contain other sub directories too.
アップロードしたいすべてのJSONファイルは整形式JSONを含みます。ファイル名はスペースを除外する必要があります。CouchbaseサーバにJSONドキュメントとデザインドキュメントをアップロードする場合は、デザインドキュメントは全JSONドキュメントの後にアップロードされることに注意してください。cbdocloaderのコマンドオプションは次のとおりです。
-n HOST[:PORT], --node=HOST[:PORT] Default port is 8091 -u USERNAME, --user=USERNAME REST username of the cluster. It can be specified in environment variable REST_USERNAME. -p PASSWORD, --password=PASSWORD REST password of the cluster. It can be specified in environment variable REST_PASSWORD. -b BUCKETNAME, --bucket=BUCKETNAME Specific bucket name. Default is default bucket. Bucket will be created if it does not exist. -s QUOTA, RAM quota for the bucket. Unit is MB. Default is 100MB. -h --help Show this help message and exit
ZIPファイルからJSONをアップロードする例は次のとおりです:
./cbdocloader -n localhost:8091 -u Administrator -p password -b mybucket ../samples/gamesim.zip
発生する可能性のある典型的なエラーが3種類あることに注意してください: 1)ファイルが適切にフォーマットされていない、2)証明情報が正しくない、3)JSONを格納する新しいバケットのRAM割当が現在与えられている割当より非常に大きい。Couchbase Serverのノード用RAM割当を変更する方法の詳細については、「Couchbaseのクォータの変更」を参照してください。