CosmosClient class

Pacote:: @azure/cosmos

Fornece uma representação lógica do lado do cliente da conta de banco de dados do Azure Cosmos DB. Esse cliente é usado para configurar e executar solicitações no serviço de banco de dados do Azure Cosmos DB.

exemplo

Instanciar um cliente e criar um novo banco de dados

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

exemplo

Criar uma instância de um cliente com a Política de Conexão personalizada

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({
  endpoint,
  key,
  connectionPolicy: {
    requestTimeout: 10000,
  },
});

exemplo

Instanciar um cliente com autenticação do AAD e escopo personalizado

import { DefaultAzureCredential } from "@azure/identity";
import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const aadCredentials = new DefaultAzureCredential();
const client = new CosmosClient({
  endpoint,
  aadCredentials,
  aadScope: "https://cosmos.azure.com/.default", // Optional custom scope
});

Construtores

CosmosClient(CosmosClientOptions)	Cria um novo objeto CosmosClient. Consulte CosmosClientOptions para obter mais detalhes sobre quais opções você pode usar.
CosmosClient(string)	Cria um novo objeto CosmosClient de uma cadeia de conexão. Sua cadeia de conexão de banco de dados pode ser encontrada no Portal do Azure

Propriedades

databases

Usado para criar novos bancos de dados ou consultar/ler todos os bancos de dados.

Use .database(id) para ler, substituir ou excluir um banco de dados específico existente por ID.

exemplo

Criar um novo banco de dados

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { resource: databaseDefinition, database } = await client.databases.create({
  id: "<name here>",
});

offers

Usado para consultar & ler todas as ofertas.

Use .offer(id) para ler ou substituir ofertas existentes.

Métodos

database(string)	Usado para ler, atualizar ou excluir um banco de dados existente por ID ou acessar contêineres pertencentes a esse banco de dados. Isso não faz uma chamada de rede. Use `.read` para obter informações sobre o banco de dados depois de obter o objeto banco de dados. exemplo Criar um novo contêiner de um banco de dados existente `import { CosmosClient } from "@azure/cosmos"; const endpoint = "https://your-account.documents.azure.com"; const key = "<database account masterkey>"; const client = new CosmosClient({ endpoint, key }); const container = client.database("<database id>").containers.create({ id: "<name here>", });` exemplo Excluir um banco de dados existente `import { CosmosClient } from "@azure/cosmos"; const endpoint = "https://your-account.documents.azure.com"; const key = "<database account masterkey>"; const client = new CosmosClient({ endpoint, key }); await client.database("<id here>").delete();`
dispose()	Limpa o atualizador de ponto de extremidade em segundo plano. Use client.dispose() ao destruir o CosmosClient em outro processo.
getDatabaseAccount(RequestOptions)	Obter informações sobre o DatabaseAccount atual (incluindo quais regiões têm suporte etc.)
getReadEndpoint()	Obtém o ponto de extremidade de leitura usado no momento. Útil para fins de solução de problemas. A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
getReadEndpoints()	Obtém o ponto de extremidade de leitura usado no momento. Útil para fins de solução de problemas. A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
getWriteEndpoint()	Obtém a URL do ponto de extremidade de gravação usada no momento. Útil para fins de solução de problemas. A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
getWriteEndpoints()	Obtém os pontos de extremidade de gravação conhecidos. Útil para fins de solução de problemas. As urls poderão conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
offer(string)	Usado para ler ou atualizar uma oferta existente por ID.

Detalhes do construtor

CosmosClient(CosmosClientOptions)

Cria um novo objeto CosmosClient. Consulte CosmosClientOptions para obter mais detalhes sobre quais opções você pode usar.

new CosmosClient(options: CosmosClientOptions)

Parâmetros

options: CosmosClientOptions

bag de opções; exigir pelo menos ponto de extremidade e autenticação a serem configurados

CosmosClient(string)

Cria um novo objeto CosmosClient de uma cadeia de conexão. Sua cadeia de conexão de banco de dados pode ser encontrada no Portal do Azure

new CosmosClient(connectionString: string)

Parâmetros

connectionString: string

Detalhes da propriedade

databases

Usado para criar novos bancos de dados ou consultar/ler todos os bancos de dados.

Use .database(id) para ler, substituir ou excluir um banco de dados específico existente por ID.

exemplo

Criar um novo banco de dados

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { resource: databaseDefinition, database } = await client.databases.create({
  id: "<name here>",
});

databases: Databases

Valor da propriedade

Databases

offers

Usado para consultar & ler todas as ofertas.

Use .offer(id) para ler ou substituir ofertas existentes.

offers: Offers

Valor da propriedade

Offers

Detalhes do método

database(string)

Usado para ler, atualizar ou excluir um banco de dados existente por ID ou acessar contêineres pertencentes a esse banco de dados.

Isso não faz uma chamada de rede. Use .read para obter informações sobre o banco de dados depois de obter o objeto banco de dados.

exemplo

Criar um novo contêiner de um banco de dados existente

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const container = client.database("<database id>").containers.create({
  id: "<name here>",
});

exemplo

Excluir um banco de dados existente

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
await client.database("<id here>").delete();

function database(id: string): Database

Parâmetros

id: string

A ID do banco de dados.

Retornos

Database

dispose()

Limpa o atualizador de ponto de extremidade em segundo plano. Use client.dispose() ao destruir o CosmosClient em outro processo.

function dispose()

getDatabaseAccount(RequestOptions)

Obter informações sobre o DatabaseAccount atual (incluindo quais regiões têm suporte etc.)

function getDatabaseAccount(options?: RequestOptions): Promise<ResourceResponse<DatabaseAccount>>

Parâmetros

options: RequestOptions

Retornos

Promise<ResourceResponse<DatabaseAccount>>

getReadEndpoint()

Obtém o ponto de extremidade de leitura usado no momento. Útil para fins de solução de problemas.

A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.

function getReadEndpoint(): Promise<string>

Retornos

Promise<string>

getReadEndpoints()

Obtém o ponto de extremidade de leitura usado no momento. Útil para fins de solução de problemas.

A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.

function getReadEndpoints(): Promise<readonly string[]>

Retornos

Promise<readonly string[]>

getWriteEndpoint()

Obtém a URL do ponto de extremidade de gravação usada no momento. Útil para fins de solução de problemas.

A url poderá conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.

function getWriteEndpoint(): Promise<string>

Retornos

Promise<string>

getWriteEndpoints()

Obtém os pontos de extremidade de gravação conhecidos. Útil para fins de solução de problemas.

As urls poderão conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.

function getWriteEndpoints(): Promise<readonly string[]>

Retornos

Promise<readonly string[]>

offer(string)

Usado para ler ou atualizar uma oferta existente por ID.

function offer(id: string): Offer

Parâmetros

id: string

A ID da oferta.

Retornos

Offer

Compartilhar via

CosmosClient class

Construtores

Propriedades

Métodos

Detalhes do construtor

CosmosClient(CosmosClientOptions)

Parâmetros

CosmosClient(string)

Parâmetros

Detalhes da propriedade

databases

Valor da propriedade

offers

Valor da propriedade

Detalhes do método

database(string)

Parâmetros

Retornos

dispose()

getDatabaseAccount(RequestOptions)

Parâmetros

Retornos

getReadEndpoint()

Retornos

getReadEndpoints()

Retornos

getWriteEndpoint()

Retornos

getWriteEndpoints()

Retornos

offer(string)

Parâmetros

Retornos