Dev & EngARTIGO

Criação de Collection no Azure Cosmos DB

No seguinte artigo, a autora explica passo a passo como criar uma Collection e um novo registro no Azure Cosmos DB.

DocumentDB ou Azure↳Azure76 conteúdosDeploy de Azure Stream Analytics job com CI/CD usando Azure PipelinesDevSecOps · mai 2019Azure – Como criar uma base de dados SQL no Microsoft Azure pronta para ser utilizadaData · abr 2019Azure Static Web Apps com Vue.js e Visual Studio CodeDevSecOps · out 2023Ver tudo em DevSecOps → Cosmos DB – evolução do DocumentDB com distribuição global, escalabilidade e SLA melhorado – é a plataforma de banco de dados↳Banco de dados134 conteúdosSQL ou NoSQL: eis a questão!!Data · mar 2020Banco de dados: como organizar e dar segurança para milhões de dados de loteriasData · mai 20215 serviços gratuitos na cloud para bancos de dados PostgresData · fev 2025Ver tudo em Data → NoSQL da Microsoft, que é executada no Azure. Ele foi projetado tendo em mente os requisitos de gerenciamento de dados para as últimas aplicações.

Neste artigo, vou explicar passo a passo como criar uma Collection e um novo registro no Azure Cosmos DB com exemplos ilustrativos.

Vamos começar?

Passos

O procedimento será muito simples. Utilizaremos um projeto de exemplo.

  1. Baixe no GitHub a POC que faz o CRUD das informações. (Num próximo artigo entraremos nos detalhes da aplicação).
  2. Abra-o no seu editor favorito. Aqui, estou usando o Microsoft Visual Studio.
  3. Perceba que no arquivo Web.config temos duas informações necessárias que vamos precisar preencher para a solução rodar perfeitamente:
<add key=”endpoint” value=”https://XXXX.documents.azure.com:433/” />
<add key=”authKey” value=”XXXXX” />

4. Acesse o portal Azure e no menu lateral selecione Criando Novo → Databases → Azure Cosmos DB

5. Será solicitado uma série de informações para a sua conta. Coloque-as conforme o quadro abaixo:

Configuração Valor Sugerido Descrição
ID Valor exclusivo Um nome exclusivo que identifica sua conta Azure Cosmos DB. A string documents.azure.com é anexada à ID que você fornece para criar seu URI, então use uma identificação única, mas identificável. O ID pode conter apenas letras minúsculas, números e o hífen (-), e deve conter de 3 a 50 caracteres.
API SQL (DocumentDB) Programamos contra a API DocumentDB mais adiante neste artigo.
Inscrição Sua assinatura A assinatura do Azure que você deseja usar para sua conta Azure Cosmos DB.
 

Grupo de Recursos

 

O mesmo valor que ID

O novo nome do grupo de recursos para sua conta. Por simplicidade, você pode usar o mesmo nome que seu ID.
Localização A região mais próxima dos seus usuários A localização geográfica em que hospeda sua conta Azure Cosmos DB. Escolha o local mais próximo dos seus usuários para dar-lhes o acesso mais rápido aos dados.

Ao final, ficará semelhante a este:

6. Para criar a Collection, selecione: Azure Cosmos DB → Data Explorer → New Collection. Preencha-o de acordo com os dados da tabela a seguir:

Configuração Valor sugerido Descrição
ID da base de dados Tarefas O ID para o seu novo banco de dados. Os nomes de banco de dados devem conter de 1 a 255 caracteres, e eles não podem conter /, \, #,? ou um espaço final.
ID da coleção Unid O ID para a sua nova coleção. Os nomes de coleção têm os mesmos requisitos de caracteres que os IDs de banco de dados.
Capacidade de armazenamento Fixo (10GB) Use o valor padrão. Esta é a capacidade de armazenamento do banco de dados.
Taxa de transferência 400 RU Use o valor padrão. Se você quiser reduzir a latência, você pode ampliar o throughput mais tarde.
Rum Fora Deixe o valor padrão. Se você precisar lidar com as cargas de trabalho com precisão, você pode ativar o recurso RU/m naquele momento
Tecla Partição /categoria Uma chave de partição que distribui dados uniformemente para cada partição correta é importante na criação de uma coleção executada. Para saber mais, consulte Designado para particionamento.

Ao final, deverá ficar assim:

7. Por padrão, o Azure cria uma tabela “c” com os registros. Existe a opção para renomear, mas para este teste vamos usar a mesma. Clique com o botão direito na sua Collection, selecione Nova Query e pressione Run.

8. Agora vamos criar um novo registro. Para isso, selecione Document → New Document. Escreva os dados que deseja no formato JSON – lembrando que de preferência, use o campo “id” minúsculo, pois ele vai substituir o id RANDOM que o Azure gera automaticamente. E para criação, edição e exclusão via API, será mais complexo gerenciar este valor randômico.

9. Agora na sua aplicação, você vai verificar que no NuGet Microsoft.Azure.DbDocument está baixado e será necessário configurar as informações de endpoint e authKey no Web.config. Para isso, selecione Chaves no mesmo menu acima e copie as informações.

E pronto, você criou sua collection no Azure Cosmos DB!

Tábata Gonçalves trabalha há 14 anos com desenvolvimento de software, hoje atua como Programadora Sênior. Técnica em processamento de dados, também cursou Bacharel em Sistema da Informação na FIAP, entre outro cursos como DotNet (FIAP), IOS Swift Code (Standford). Apaixona por C#(Sharp) trabalha desde 2008 na plataforma .dotNet. Aspirante em AngularJS, NodeJS, já programou em paralelo em Java, ASP, VB6, Assembly, C, ADVP, mas hoje ela foca seus esforços para se aprofundar em Xamarim e Arquitetura. Quando não esta ocupada programando ou estudando, ela esta presente palestrando e participando de grupos de mulheres desenvolvedoras no Brasil.

Ver perfil →