CosmosClient class
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
const client = new CosmosClient({endpoint: "<URL HERE>", key: "<KEY HERE>"});
await client.databases.create({id: "<database name here>"});
Exemplo
Instanciar um cliente com uma Política de Conexão personalizada
const client = new CosmosClient({
endpoint: "<URL HERE>",
key: "<KEY HERE>",
connectionPolicy: {
requestTimeout: 10000,
},
});
Construtores
Cosmos |
Cria um novo objeto CosmosClient. Consulte CosmosClientOptions para obter mais detalhes sobre quais opções você pode usar. |
Cosmos |
Cria um novo objeto CosmosClient a partir 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 Exemplo Criar uma nova base de dados
|
offers | Usado para consultar & ler todas as ofertas. Use |
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 Exemplo Criar um novo contêiner fora de um banco de dados existente
Exemplo Excluir um banco de dados existente
|
dispose() | Limpa a atualização do ponto de extremidade em segundo plano. Use client.dispose() ao destruir o CosmosClient dentro de outro processo. |
get |
Obtenha informações sobre o DatabaseAccount atual do (incluindo quais regiões são suportadas, etc.) |
get |
Obtém o ponto de extremidade de leitura usado atualmente. Útil para fins de solução de problemas. O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local. |
get |
Obtém o ponto de extremidade de leitura usado atualmente. Útil para fins de solução de problemas. O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local. |
get |
Obtém a URL do ponto de extremidade de gravação usada atualmente. Útil para fins de solução de problemas. O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local. |
get |
Obtém os pontos de extremidade de gravação conhecidos. Útil para fins de solução de problemas. As urls podem 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
saco de opções; Exigir que pelo menos o ponto de extremidade e a autenticação sejam configurados
CosmosClient(string)
Cria um novo objeto CosmosClient a partir 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 de 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 uma nova base de dados
const {resource: databaseDefinition, database} = await client.databases.create({id: "<name here>"});
databases: Databases
Valor de Propriedade
offers
Usado para consultar & ler todas as ofertas.
Use .offer(id)
para ler ou substituir ofertas existentes.
offers: Offers
Valor de Propriedade
Detalhes de 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 Database.
Exemplo
Criar um novo contêiner fora de um banco de dados existente
const container = client.database("<database id>").containers.create("<container id>");
Exemplo
Excluir um banco de dados existente
await client.database("<id here>").delete();
function database(id: string): Database
Parâmetros
- id
-
string
O id do banco de dados.
Devoluções
dispose()
Limpa a atualização do ponto de extremidade em segundo plano. Use client.dispose() ao destruir o CosmosClient dentro de outro processo.
function dispose()
getDatabaseAccount(RequestOptions)
Obtenha informações sobre o DatabaseAccount atual do (incluindo quais regiões são suportadas, etc.)
function getDatabaseAccount(options?: RequestOptions): Promise<ResourceResponse<DatabaseAccount>>
Parâmetros
- options
- RequestOptions
Devoluções
Promise<ResourceResponse<DatabaseAccount>>
getReadEndpoint()
Obtém o ponto de extremidade de leitura usado atualmente. Útil para fins de solução de problemas.
O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
function getReadEndpoint(): Promise<string>
Devoluções
Promise<string>
getReadEndpoints()
Obtém o ponto de extremidade de leitura usado atualmente. Útil para fins de solução de problemas.
O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
function getReadEndpoints(): Promise<readonly string[]>
Devoluções
Promise<readonly string[]>
getWriteEndpoint()
Obtém a URL do ponto de extremidade de gravação usada atualmente. Útil para fins de solução de problemas.
O url pode conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
function getWriteEndpoint(): Promise<string>
Devoluções
Promise<string>
getWriteEndpoints()
Obtém os pontos de extremidade de gravação conhecidos. Útil para fins de solução de problemas.
As urls podem conter um sufixo de região (por exemplo, "-eastus") se estivermos usando pontos de extremidade específicos do local.
function getWriteEndpoints(): Promise<readonly string[]>
Devoluções
Promise<readonly string[]>
offer(string)
Usado para ler ou atualizar uma oferta existente por id.
function offer(id: string): Offer
Parâmetros
- id
-
string
O id da oferta.