Início Rápido: criar uma conta, um banco de dados, um contêiner e itens do Azure Cosmos DB usando o portal do Azure

Artigo
03/09/2023

APLICA-SE A: NoSQL

O Azure Cosmos DB é o serviço de banco de dados multimodelo distribuído globalmente da Microsoft. É possível usar o Azure Cosmos DB para criar e consultar rapidamente bancos de dados de chave/valor, de documentos e de grafo. Essa abordagem se beneficia da distribuição global e dos recursos de escala horizontal no núcleo do Azure Cosmos DB.

Esse início rápido demonstra como usar o portal do Azure para criar uma conta do Azure Cosmos DB API for NoSQL. Nessa conta, você cria um banco de dados de documentos e um contêiner e adiciona dados ao contêiner. Sem um cartão de crédito ou uma assinatura do Azure, você pode configurar uma conta gratuita do Try do Azure Cosmos DB.

Pré-requisitos

Uma assinatura do Azure ou uma conta de avaliação gratuita do Azure Cosmos DB.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
Você pode experimentar o Azure Cosmos DB gratuitamente, sem uma assinatura do Azure e sem compromisso. Como alternativa, você pode criar uma conta de camada gratuita do Azure Cosmos DB, com as primeiras 1.000 RU/s e 25 GB de armazenamento gratuitos. Você também pode usar o emulador do Azure Cosmos DB com o URI https://localhost:8081. Quanto à chave a ser usada com o emulador, confira Autenticação de solicitações.

Criar uma conta do Azure Cosmos DB

No menu do portal do Azure ou na Home page, selecione Criar um recurso.
Pesquise por Azure Cosmos DB. Selecione Criar>Azure Cosmos DB.
Na página Criar uma conta do Azure Cosmos DB, selecione a opção Criar na seção Azure Cosmos DB for NoSQL.

O Azure Cosmos DB fornece várias APIs:
- NoSQL, para dados do documento
- PostgreSQL
- MongoDB, para dados do documento
- Apache Cassandra
- Tabela
- Apache Gremlin, para dados do grafo
Para saber mais sobre a API para NoSQL, confira Bem-vindo(a) ao Azure Cosmos DB.

Na página Criar uma Conta do Azure Cosmos DB, insira as configurações básicas da nova conta do Azure Cosmos DB.

Configuração	Valor	Descrição
Subscription	Nome da assinatura	Selecione a assinatura do Azure que você deseja usar para essa conta do Azure Cosmos DB.
Grupo de recursos	Nome do grupo de recursos	Selecione um grupo de recursos ou selecione Criar novo, então insira um nome exclusivo para o novo grupo de recursos.
Nome da Conta	Um nome exclusivo	Insira um nome para identificar a conta do Azure Cosmos DB. Já que documents.Azure.com é acrescentado ao nome que você fornece para criar o URI, use um nome exclusivo. O nome pode conter apenas letras minúsculas, números e o caractere de hífen (-). Deve ter de 3 a 44 caracteres.
Location	A região mais próxima dos usuários	Selecione uma localização geográfica para hospedar a sua conta do Azure Cosmos DB. Use a localização mais próxima dos usuários para fornecer a eles acesso mais rápido aos dados.
Modo de capacidade	Taxa de transferência provisionada ou sem servidor	Selecione Taxa de transferência provisionada para criar uma conta no modo taxa de transferência provisionada. Selecione Sem servidor para criar uma conta no modo sem servidor.
Aplicar o desconto por nível gratuito do Azure Cosmos DB	Aplicar ou Não aplicar	Com a camada gratuita do Azure Cosmos DB, você recebe os primeiros 1000 RU/s e 25 GB de armazenamento sem custos em uma conta. Saiba mais sobre o nível gratuito.
Limitar a taxa de transferência total da conta	Selecionado ou não	Limite a quantidade total da taxa de transferência que pode ser provisionada nessa conta. Esse limite impede encargos inesperados relacionados à taxa de transferência provisionada. Você pode atualizar ou remover esse limite depois que sua conta for criada.

Você pode ter até uma conta gratuita do Azure Cosmos DB por assinatura do Azure e deve aceitar ao criar a conta. Se você não vê a opção de aplicar o desconto por nível gratuito, outra conta da assinatura já foi habilitada com o nível gratuito.

Observação

As seguintes opções não estarão disponíveis se você selecionar Sem servidor como Modo de capacidade:

Aplicar desconto por nível gratuito
Limitar a taxa de transferência total da conta

Na guia Distribuição global, configure os detalhes a seguir. Para este início rápido, é possível usar os valores padrão:

Configuração	Valor	Descrição
Redundância geográfica	Desabilitar	Habilite ou desabilite a distribuição global em sua conta emparelhando sua região com uma região de par. Você poderá adicionar mais regiões à sua conta posteriormente.
Gravações de várias regiões	Desabilitar	A capacidade de gravação de várias regiões permite que você aproveite a taxa de transferência provisionada para seus bancos de dados e contêineres em todo o mundo.
Zonas de Disponibilidades	Desabilitar	As Zonas de Disponibilidade ajudam a aprimorar a disponibilidade e a resiliência do seu aplicativo.

Observação

As seguintes opções não estarão disponíveis se você selecionar Sem servidor como Modo de capacidade na página anterior Noções básicas:

Redundância geográfica
Gravações de várias regiões

Opcionalmente, você pode configurar mais detalhes nas seguintes guias:
- Redes. Configure o acesso a partir de uma rede virtual.
- Política de Backup. Configure uma política de backup periódica ou contínua.
- Criptografia. Use uma chave gerenciada pelo serviço ou uma chave gerenciada pelo cliente.
- Marcas. Marcas são pares nome/valor que permitem categorizar recursos e exibir a cobrança consolidada por meio da aplicação da mesma marca a vários recursos e grupos de recursos.
Selecione Examinar + criar.
Examine as configurações da conta e selecione Criar. São necessários alguns minutos para criar a conta. Aguarde até que a página do portal exiba Sua implantação está concluída.
Selecione Ir para recurso para ir para a página da conta do Azure Cosmos DB.

Adicionar um banco de dados e um contêiner

Você pode usar o Data Explorer no portal do Azure para criar um banco de dados e um contêiner.

Selecione Data Explorer na navegação à esquerda na página da sua conta do Azure Cosmos DB e, em seguida, selecione Novo Contêiner>Novo Contêiner.

Talvez seja necessário rolar para a direita para ver a janela Novo Contêiner.

No painel Novo Contêiner, insira as configurações do novo contêiner.

Configuração	Valor sugerido	Descrição
ID do banco de dados	ToDoList	Insira ToDoList como o nome para o novo banco de dados. Os nomes dos bancos de dados devem conter de 1 a 255 caracteres e não podem conter `/`, `\`, `#`, `?`, nem um espaço à direita. Marque a opção Compartilhar taxa de transferência entre contêineres. Ele permite que você compartilhe a taxa de transferência provisionada no banco de dados em todos os contêineres do banco de dados. Essa opção também ajuda na economia de custo.
Taxa de transferência do banco de dados	Dimensionamento automático ou Manual	A taxa de transferência manual permite que você dimensione unidades de solicitação por segundo (RU/s), enquanto a taxa de transferência de dimensionamento automático permite que o sistema dimensione RU/s com base no uso. Selecione Manual para este exemplo.
Máximo de RU/s do banco de dados	400 RU/s	Se você quiser reduzir a latência, poderá escalar verticalmente a taxa de transferência depois, estimando os RU/s necessários com a calculadora de capacidade. Observação: essa configuração não está disponível ao criar um novo contêiner em uma conta sem servidor.
ID do contêiner	Itens	Insira Itens como o nome do novo contêiner. As IDs do contêiner têm os mesmos requisitos de caractere dos nomes de bancos de dados.
Chave de partição	/category	O exemplo descrito neste artigo usa /category como a chave de partição.

Não adicione Chaves exclusivas ou ative o Armazenamento analítico para este exemplo.

Chaves exclusivas permitem que você adicione uma camada de integridade de dados ao banco de dados garantindo a exclusividade de um ou mais valores por chave de partição. Para obter mais informações, veja Chaves exclusivas no Azure Cosmos DB.
O Armazenamento analítico é usado para permitir análises em larga escala em relação a dados operacionais sem nenhum efeito em suas cargas de trabalho transacionais.

Selecione OK. O Data Explorer exibe o novo banco de dados e o contêiner que você criou.

Adicionar dados a seu banco de dados

Adicione dados a seu novo banco de dados usando o Data Explorer.

No Data Explorer, expanda o banco de dados ToDoList e, em seguida, expanda o contêiner Itens.
Em seguida, selecione Itens e, em seguida, selecione Novo Item.

Adicione a seguinte estrutura ao documento no lado direito do painel Documentos:

{
    "id": "1",
    "category": "personal",
    "name": "groceries",
    "description": "Pick up apples and strawberries.",
    "isComplete": false
}

Selecione Salvar.
Selecione Novo Item novamente e crie e salve outro documento com uma única id e quaisquer outras propriedades e valores desejados. Os documentos podem ter qualquer estrutura, pois o Azure Cosmos DB não impõe nenhum esquema a seus dados.

Consultar seus dados

Você pode usar consultas no Data Explorer para recuperar e filtrar os dados.

Na parte superior da guia Itens no Data Explorer, examine a consulta padrão SELECT * FROM c. Essa consulta recupera e exibe todos os documentos do contêiner ordenados por ID.
Para alterar a consulta, selecione Editar Filtro, substitua a consulta padrão por ORDER BY c._ts DESC e selecione Aplicar Filtro.

A consulta modificada exibe os documentos em ordem decrescente com base no seu carimbo de data/hora, portanto, agora o segundo documento é listado primeiro.

Se você estiver familiarizado com a sintaxe SQL, poderá inserir qualquer consulta SQL compatível na caixa de predicado de consulta. Você também pode usar o Data Explorer para criar procedimentos armazenados, funções definidas pelo usuário e gatilhos para a lógica de negócios do lado do servidor.

O Data Explorer fornece acesso fácil no portal do Azure a todos os recursos de acesso a dados programáticos internos disponíveis nas APIs. Você também pode usar o portal do Azure para dimensionar a taxa de transferência, obter chaves e cadeias de conexão e revisar métricas e SLAs para sua conta do Azure Cosmos DB.

Limpar os recursos

Quando o aplicativo e a conta do Azure Cosmos DB estiverem prontos, você poderá excluir os recursos do Azure criados para não incorrer em mais cobranças. Para excluir os recursos:

Na barra de pesquisa do portal do Azure, procure e selecione Grupos de recursos.
Na lista, selecione o grupo de recursos criado neste início rápido.
Na página Visão geral do grupo de recursos, selecione Excluir grupo de recursos.
Na próxima janela, insira o nome do grupo de recursos a ser excluído e selecione Excluir.

Se você quiser excluir apenas o banco de dados e usar a conta do Azure Cosmos DB no futuro, poderá excluir o banco de dados com as seguintes etapas:

Acesse a sua conta do Azure Cosmos DB.
Abra o Data Explorer, selecione Mais (...) para o banco de dados que deseja excluir e selecione Excluir Banco de dados.
Insira a ID do banco de dados ou o nome do banco de dados para confirmar a operação de exclusão.

Próximas etapas

Agora, é possível importar mais dados para a conta do Azure Cosmos DB.