Azure Cosmos DB のデータベースは、1 つ以上のコンテナーの管理単位です。 コンテナーを作成または管理するには、まずデータベースを作成する必要があります。
データベースに名前を付けます
Azure Cosmos DB では、データベースは名前空間に似ています。 データベースを作成すると、データベース名は、データベース リソースと子リソースへのアクセスに使用される URI のセグメントを形成します。
作成されると、データベースの URI は次の形式になります。
https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>
データベースを作成する
CosmosClient を作成したら、クライアントを使用して、次の 2 つの異なる呼び出しからデータベースを作成します。
- createIfNotExists - データベースが存在しない場合は作成します。 存在する場合は、データベースを返します。
- create - データベースを作成します。 存在する場合は、エラー statusCode を返します。
const databaseName = 'myDb';
// Possible results:
// Create then return database
// Return existing database
// Return error statusCode
const {statusCode, database } = await client.databases.createIfNotExists({ id: databaseName });
// Possible results:
// Create then return database
// Return error statusCode, reason includes database already exists
const {statusCode, database } = await client.databases.create({ id: databaseName });
statusCode は HTTP 応答コードです。 正常な応答は 200 から 299 の範囲です。
データベースにアクセスする
データベースは、 Database オブジェクトから直接、または CosmosClient からのクエリ結果を介してアクセスされます。
const databaseName = 'myDb';
// Direct - assumes database already exists
const { database, statusCode } = await client.database(databaseName);
// Query - assumes database already exists
const { resources } = await client.databases
.query({
query: `SELECT * FROM root r where r.id =@dbId`,
parameters: [
{
name: '@dbId',
value: databaseName
}
]
})
.fetchAll();
オブジェクトによるアクセス:
- データベース (複数形): 新しいデータベースの作成、またはすべてのデータベースのクエリ/読み取りに使用されます。
- データベース (単数形): ID によって既存のデータベースを読み取り、更新、または削除したり、そのデータベースに属するコンテナーにアクセスしたりするために使用されます。
データベースを削除する
Database オブジェクトを取得したら、 Database オブジェクトを使用してデータベースを 削除 できます。
const {statusCode } = await database.delete();
statusCode は HTTP 応答コードです。 正常な応答は 200 から 299 の範囲です。
次のステップ
データベースを作成したので、次のガイドを使用してコンテナーを作成します。