データベースとコレクション

Overview

このガイドでは、MongoDB Java ドライバーで MongoDB の データベース と コレクション を使用する方法を学習できます。

MongoDB では、データは次のレベルの階層に整理されています。

• Databases

• コレクション

• ドキュメント

データベースは、MongoDB インスタンスの最上位のデータ組織です。 データベースは、ドキュメントを含むコレクションに整理されています。 ドキュメントには、文字列、数値、日付などのリテラル データと、その他の（埋め込み）ドキュメントが含まれます。 ドキュメント フィールドの型と構造の詳細については、 ドキュメントのサーバードキュメントを参照してください。

データベースへのアクセス

MongoDBインスタンス内の MongoDatabase にアクセスするには、MongoClientインスタンスの getDatabase() メソッドを使用します。

次の例えではtestDatabaseという名前のデータベースにアクセスします。

MongoDatabase database = mongoClient.getDatabase("testDatabase");

コレクションにアクセスする

MongoDatabaseインスタンスの getCollection() メソッドを使用して、接続済みのMongoDBインスタンスのデータベース内の MongoCollection にアクセスします。

次の例では、MongoDatabase から testCollection という名前のコレクションにアクセスします。

MongoDatabase database = mongoClient.getDatabase("testDatabase");
MongoCollection<Document> collection = database.getCollection("testCollection");

コレクションを作成する

MongoDatabaseインスタンスの createCollection() メソッドを使用して、接続されたMongoDBインスタンスのデータベースにコレクションを作成します。

次の例では、 exampleCollectionという名前のコレクションを作成します。

database.createCollection("exampleCollection");

CreateCollectionOptionsクラスを使用して、最大サイズやドキュメント検証ルールなどのコレクションオプションを指定できます。createCollection() メソッドは、CreateCollectionOptions のインスタンスを任意の 2 つ目のパラメータとして受け入れます。

ValidationOptions collOptions = new ValidationOptions().validator(
    Filters.or(Filters.exists("commander"), Filters.exists("first officer")));
database.createCollection("ships",
    new CreateCollectionOptions().validationOptions(collOptions));

コレクションの一覧を取得する

MongoDatabase.listCollectionNames() メソッドを使用して、データベース内のコレクションのリストをクエリできます。

for (String name : database.listCollectionNames()) {
    System.out.println(name);
}

コレクションの削除

MongoCollection.drop() メソッドを使用して、データベースからコレクションを削除できます。

MongoCollection<Document> collection = database.getCollection("bass");
collection.drop();

データベースの削除

次の例に示すように、 MongoDatabase.drop() メソッドを使用して、 MongoDBインスタンスからデータベースを削除できます。

MongoDatabase database = mongoClient.getDatabase("testDatabase");
database.drop();

読み込み設定（read preference）、読み取り保証（read concern）、書込み保証（write concern）の指定

読み込み設定（read preference ） 、 読み取り保証（ read concern ） 、 書込み保証（ write concern ） は、MongoDB レプリカセットに接続するときに、ドライバーが読み取り操作をルーティングして読み取りおよび書込み操作の確認を待つ方法を制御します。 読み込み設定（read preference）と読み取り保証（read concern）はすべての読み取り操作に適用されます。書込み保証 (write concern) はすべての書込み (write) 操作に適用されます。

MongoDatabase インスタンスは、書込み保証（write concern）、読み取り保証（read concern）、書込み設定（write preference）の設定を、作成に使用されるMongoClientから継承します。 MongoCollectionインスタンスは、書込み保証（write concern）、読み取り保証（read concern）、書込み設定（write preference）の設定を、作成に使用されるMongoDatabaseから継承します。 ただし、次のメソッドを使用して、通常継承する設定とは異なる読み込み設定（read preference）、読み取り保証（read concern）、または書込み保証（write concern）を持つMongoDatabaseまたはMongoCollectionのインスタンスを取得できます。

• MongoDatabase.withReadConcern()

• MongoDatabase.withReadPreference()

• MongoDatabase.withWriteConcern()

• MongoCollection.withReadConcern()

• MongoCollection.withReadPreference()

• MongoCollection.withWriteConcern()

詳細については、 読み込み設定（ read preference ） 、 読み取り保証（ read concern ） 、 書込み保証（ write concern） に関するサーバーのドキュメントを参照してください。