Introdução ao Azure Cosmos DB for NoSQL por meio do Python

APLICA-SE A: NoSQL

Este artigo mostra como se conectar ao Azure Cosmos DB for NoSQL por meio do SDK do JavaScript. Depois de conectado, você pode executar operações em bancos de dados, contêineres e itens.

Pacote (npm) | Amostras | Referência de API | Código-fonte da biblioteca | Fazer comentários

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Conta do Azure Cosmos DB for NoSQL. Criar uma conta da API para o NoSQL.
• Node.js LTS
• CLI (interface de linha de comando) do Azure ou Azure PowerShell

Criar seu projeto local

1. Crie um novo diretório para seu projeto JavaScript em um shell bash.

   mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples
   

2. Crie um novo aplicativo .NET por meio do comando npm init com o modelo de console .

   npm init -y
   

3. Instale a dependência necessária para o SDK JavaScript do Azure Cosmos DB for NoSQL.

   npm install @azure/cosmos
   

Conectar-se ao Azure Cosmos DB for NoSQL

Para se conectar à API do NoSQL para o Azure Cosmos DB, crie uma instância da classe CosmosClient. Essa classe é o ponto de partida para executar todas as operações em bancos de dados.

Para se conectar à conta da API para NoSQL usando o Microsoft Entra, use uma entidade de segurança. O tipo exato de entidade de segurança dependerá de onde você hospeda o código do aplicativo. A tabela abaixo serve como um guia de referência rápida.

Importe @azure/identity.

O pacote @azure/identity contém a funcionalidade de autenticação principal que é compartilhada entre todas as bibliotecas do SDK do Azure.

1. Importe o pacote de NuGet @azure/identity por meio do comando npm install.

   npm install @azure/identity
   

2. No editor de código, adicione as dependências.

   const { DefaultAzureCredential } = require("@azure/identity");
   

Criar o CosmosClient com implementação de credencial padrão

Se você estiver testando em um computador local ou seu aplicativo será executado nos serviços do Azure com suporte direto para identidades gerenciadas, obtenha um token OAuth criando uma instância DefaultAzureCredential. Crie uma nova instância da classe CosmosClient com a variável de ambiente COSMOS_ENDPOINT e o objeto TokenCredential como parâmetros.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Crie seu aplicativo

Conforme você compila seu aplicativo, seu código interagirá principalmente com quatro tipos de recursos:

• A conta da API para o NoSQL, que é o namespace exclusivo de nível superior dos dados do Azure Cosmos DB.

• Bancos de dados, que organizam os contêineres em sua conta.

• Contêineres, que contêm um conjunto de itens individuais em seu banco de dados.

• Itens, que representam um documento JSON em seu contêiner.

O diagrama a seguir mostra a relação entre esses recursos.

Cada tipo de recurso é representado por uma ou mais classes associadas. Aqui está uma lista das classes mais comuns:

Os guias a seguir mostram como usar cada uma dessas classes para compilar seu aplicativo.

Confira também

• Pacote npm
• Amostras
• Referência de API
• Código-fonte da biblioteca
• Enviar comentários

Próximas etapas