MongoLink入門

MongoLinkはMongoDBを使うためのツールである.このチュートリアルでは,MongoDBに対してよく行われる操作をMongoLinkを使ってどのように行うのかについて説明する.

このチュートリアルでは,MongoDBサーバがお使いのローカルマシン上で,デフォルトのホストとポートで動作中であることを想定している.MongoDBサーバをローカルで実行するためのプラットフォームごとの説明はこちらを参照されたい.

ローカル接続の確立

MongoLinkをロードする:

デフォルトのホスト"localhost"とポート27017(これらはローカルマシンでMongoDBサーバを起動するときのデフォルトのホスト名とポートである)を使ってクライアント接続を確立する:

ポートとホストは明示的に指定することもできる:

またはMongoDB接続文字列URI形式も使える:

データベースへの接続

MongoDBサーバは複数の独立したデータベースをホストすることができる.サーバで利用できるデータベースをリストする:

データベースに接続する:

これは以下と等しい:

コレクションへの接続

コレクションはドキュメントの集合である.コレクションを取得することは,データベースを取得することと同じである:

このシンタックスは以下に等しい:

注意:データベースとコレクションは遅延で作成されるので,コレクションとデータベースの取得はMongoDBサーバに対して何の操作も行わない.コレクションとデータベースは最初のドキュメントがそれらに挿入されたら初めて作られる.

ドキュメント

MongoDBにおけるドキュメントは,(場合によっては)ネストしたAssociationとして見ることができる.ここで,キーは文字列でなければならず,値は少数のタイプ(文字列,リスト,整数,日付等)に限られる.ドキュメントの簡単な例を以下に挙げる:

値として使用できるタイプのリストは,"BSON"形式のドキュメントを参照されたい.

1つのドキュメントをコレクションに挿入する

前出のドキュメントを"WolframTest"コレクションに挿入する:

挿入されたドキュメントのIDのリストを取得する:

注意Note: :MongoDBのどのドキュメントも"_id"キーを持たなければならない.挿入するドキュメントがこのキーを持たない場合,キーは自動的にドキュメントに加えられ,値はタイプBSONObjectIDとなる.

BSONObjectIDオブジェクトはその作成に関するさまざまなメタ情報を含む:

複数のドキュメントをコレクションに挿入する

多くのドキュメントを一度にコレクションに挿入するとより効率的である.ドキュメントのリストを作成する:

これらの2つのドキュメントをコレクションに挿入する:

ドキュメントを1つ取得する

MongoCollectionFindOneを使って簡単なクエリを実行すると,コレクションの中からドキュメントが1つ返される:

5歳の猫のドキュメントを探していることを指定する:

プロジェクションを使うと,さまざまな不要キーを除くことができる."date"と"sex"のフィールドを除く:

ドキュメントの不要部分を転送する必要がなくなるため,これはサーバからのドキュメントの転送速度を高めるために使用できる.

注意:クエリの作成方法については,MongoDBのドキュメントのチュートリアル「Query Documents」が参考になる.

複数のドキュメントを取得する

MongoCollectionFindのシンタックスはMongoCollectionFindOneのものと同じであるが,ドキュメントの代りに,大規模データ集合の操作に適したMongoCursorが返される:

MongoCursorに対してRead(またはMongoCursorNextでも同じ)を呼び出すと,次のドキュメントが得られる:

カーソルからすべてのドキュメントが読み込まれた後に再びReadを呼び出すと,Nullが返される:

再びドキュメントを読み込むためには,新しいカーソルを作成する必要がある:

ReadList (またはMongoCursorToArrayでも同じ)を呼び出すと,残りのすべてのドキュメントのリストが得られる:

カーソル内の全てのドキュメントはDatasetに読み込むこともできる:

カーソルの本当の有用性は,コレクション内の全てのドキュメントをメモリ内にロードしておかなくても処理することができることにある:

そのため,大規模データ集合が取り扱えるのである.

コレクションからのサンプリング

コレクションからサンプリングを行うことができる:

カーソルをDatasetに読み込む:

ドキュメントの変更

"age"が4より大きいすべてのドキュメントを,"age"が10となるように変更する:

ドキュメントの削除

注意:ドキュメントの削除は危険で,簡単には取消し操作ができない.コレクション内で"age"が3であるドキュメントをすべて削除する:

コレクション内の全てのドキュメントを削除する: