CosmosClient class
Azure Cosmos DB データベース アカウントのクライアント側の論理表現を提供します。 このクライアントは、Azure Cosmos DB データベース サービスで要求を構成して実行するために使用されます。
例
クライアントをインスタンス化し、新しいデータベースを作成する
const client = new CosmosClient({endpoint: "<URL HERE>", key: "<KEY HERE>"});
await client.databases.create({id: "<database name here>"});
例
カスタム接続ポリシーを使用してクライアントをインスタンス化する
const client = new CosmosClient({
endpoint: "<URL HERE>",
key: "<KEY HERE>",
connectionPolicy: {
requestTimeout: 10000,
},
});
コンストラクター
| Cosmos |
CosmosClient オブジェクト 新しいオブジェクトを作成します。 使用できるオプションの詳細については、CosmosClientOptions の を参照してください。 |
| Cosmos |
接続文字列から新しい CosmosClient オブジェクトを作成します。 データベース接続文字列は、Azure Portal で確認できます。 |
プロパティ
| databases | 新しいデータベースの作成、またはすべてのデータベースのクエリ/読み取りに使用されます。
例 新しいデータベースを作成する |
| offers | すべてのオファーの読み取り & クエリに使用されます。
|
メソッド
| database(string) | ID で既存のデータベースを読み取り、更新、または削除したり、そのデータベースに属するコンテナーにアクセスしたりするために使用されます。 これはネットワーク呼び出しを行いません。
Database オブジェクトを取得した後、 例 既存のデータベースから新しいコンテナーを作成する 例 既存のデータベースを削除する |
| dispose() | バックグラウンド エンドポイントリフレッシャーをクリアします。 別のプロセス内で CosmosClient を破棄する場合は、client.dispose() を使用します。 |
| get |
現在の DatabaseAccount (サポートされているリージョンなど) に関する情報を取得します |
| get |
現在使用されている読み取りエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。 場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。 |
| get |
現在使用されている読み取りエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。 場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。 |
| get |
現在使用されている書き込みエンドポイントの URL を取得します。 トラブルシューティングの目的で役立ちます。 場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。 |
| get |
既知の書き込みエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。 場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。 |
| offer(string) | ID による既存のオファーの読み取りまたは更新に使用されます。 |
コンストラクターの詳細
CosmosClient(CosmosClientOptions)
CosmosClient オブジェクト 新しいオブジェクトを作成します。 使用できるオプションの詳細については、CosmosClientOptions の を参照してください。
new CosmosClient(options: CosmosClientOptions)パラメーター
- options
- CosmosClientOptions
オプションの袋;少なくともエンドポイントと認証を構成する必要がある
CosmosClient(string)
接続文字列から新しい CosmosClient オブジェクトを作成します。 データベース接続文字列は、Azure Portal で確認できます。
new CosmosClient(connectionString: string)パラメーター
- connectionString
-
string
プロパティの詳細
databases
新しいデータベースの作成、またはすべてのデータベースのクエリ/読み取りに使用されます。
.database(id) を使用して、特定の既存のデータベースを ID で読み取り、置換、または削除します。
例
新しいデータベースを作成する
const {resource: databaseDefinition, database} = await client.databases.create({id: "<name here>"});
databases: Databasesプロパティ値
offers
メソッドの詳細
database(string)
ID で既存のデータベースを読み取り、更新、または削除したり、そのデータベースに属するコンテナーにアクセスしたりするために使用されます。
これはネットワーク呼び出しを行いません。
Database オブジェクトを取得した後、.read を使用してデータベースに関する情報を取得します。
例
既存のデータベースから新しいコンテナーを作成する
const container = client.database("<database id>").containers.create("<container id>");
例
既存のデータベースを削除する
await client.database("<id here>").delete();
function database(id: string): Databaseパラメーター
- id
-
string
データベースの ID。
戻り値
dispose()
バックグラウンド エンドポイントリフレッシャーをクリアします。 別のプロセス内で CosmosClient を破棄する場合は、client.dispose() を使用します。
function dispose()
getDatabaseAccount(RequestOptions)
現在の DatabaseAccount (サポートされているリージョンなど) に関する情報を取得します
function getDatabaseAccount(options?: RequestOptions): Promise<ResourceResponse<DatabaseAccount>>パラメーター
- options
- RequestOptions
戻り値
Promise<ResourceResponse<DatabaseAccount>>
getReadEndpoint()
現在使用されている読み取りエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。
場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。
function getReadEndpoint(): Promise<string>戻り値
Promise<string>
getReadEndpoints()
現在使用されている読み取りエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。
場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。
function getReadEndpoints(): Promise<readonly string[]>戻り値
Promise<readonly string[]>
getWriteEndpoint()
現在使用されている書き込みエンドポイントの URL を取得します。 トラブルシューティングの目的で役立ちます。
場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。
function getWriteEndpoint(): Promise<string>戻り値
Promise<string>
getWriteEndpoints()
既知の書き込みエンドポイントを取得します。 トラブルシューティングの目的で役立ちます。
場所固有のエンドポイントを使用している場合、URL にはリージョン サフィックス (例: "-eastus") が含まれる場合があります。
function getWriteEndpoints(): Promise<readonly string[]>戻り値
Promise<readonly string[]>
offer(string)
ID による既存のオファーの読み取りまたは更新に使用されます。
function offer(id: string): Offerパラメーター
- id
-
string
オファーの ID。