Explorar o Azure Cosmos DB

Neste exercício, você vai provisionar um banco de dados do Azure Cosmos DB na assinatura do Azure e explorar as várias maneiras de usá-lo para armazenar dados não relacionais.

Este laboratório levará aproximadamente 15 minutos para ser concluído.

Antes de começar

É necessário ter uma assinatura do Azure com acesso de nível administrativo.

Criar uma conta do BD Cosmos

Para usar o Cosmos DB, você precisa provisionar uma conta do Cosmos DB na sua assinatura do Azure. Neste exercício, você provisionará uma conta do Cosmos DB que usa o Azure Cosmos DB para NoSQL.

  1. No portal do Azure, selecione + Criar um recurso na parte superior esquerda e procure por Azure Cosmos DB. Nos resultados, selecione Azure Cosmos DB e, em seguida, Criar.
  2. No bloco do Azure Cosmos DB para NoSQL, selecione Criar.
  3. Insira os seguintes detalhes, depois selecione Examinar + Criar:
    • Assinatura: se você estiver usando uma área restrita, selecione Assinatura do Concierge. Caso contrário, escolha sua assinatura do Azure.
    • Grupo de recursos: se você estiver usando uma área restrita, selecione o grupo de recursos existente (que terá um nome como learn-xxxx… ). Caso contrário, crie um grupo de recursos com o nome de sua escolha.
    • Nome da Conta: insira um nome exclusivo
    • Local: escolha qualquer local recomendado
    • Modo de capacidade: taxa de transferência provisionada
    • Aplicar desconto de Camada Gratuita: selecione Aplicar se disponível
    • Limitar a taxa de transferência total da conta: não selecionado
  4. Quando a configuração tiver sido validada, selecione Criar.
  5. Aguarde o fim da implantação. Em seguida, vá para o recurso implantado.

Criar banco de dados de exemplo

Ao longo deste procedimento, feche todas as dicas exibidas no portal.

  1. Na página de sua nova conta do Cosmos DB, no painel à esquerda, selecione Data Explorer.
  2. Na página Data Explorer, selecione Lançar início rápido.
  3. Na guia Novo contêiner, examine as configurações preenchidas para o banco de dados de amostra e selecione OK.
  4. Observe o status no painel na parte inferior da tela do banco de dados SampleDB e seu contêiner SampleContainer foi criado (o que pode levar aproximadamente um minuto).

Exibir e criar itens

  1. Na página Data Explorer, expanda o banco de dados SampleDB e o contêiner SampleContainer e selecione Itens para ver uma lista de itens no contêiner. Os itens representam dados de produto, cada um com uma ID exclusiva e outras propriedades.
  2. Selecione qualquer um dos itens na lista para ver uma representação dos dados do item em JSON.
  3. Na parte superior da página, selecione Novo Item para criar um item em branco.

  4. Modifique o JSON para o novo item conforme mostrado a seguir e selecione Salvar.

     {
     "name": "Road Helmet,45",
     "id": "123456789",
     "categoryID": "123456789",
     "SKU": "AB-1234-56",
     "description": "The product called \"Road Helmet,45\" ",
     "price": 48.74
 }
  5. Depois de salvar o novo item, observe que as propriedades de metadados adicionais são adicionadas automaticamente.

Consultar o banco de dados

  1. Na página Data Explorer, selecione o ícone Nova Consulta SQL.
  2. No editor de consultas SQL, examine a consulta padrão (SELECT * FROM c) e use o botão SELECT * FROM c para executá-la.
  3. Examine os resultados, que incluem a representação JSON completa de todos os itens.

  4. Modifique a consulta conforme o seguinte exemplo:

     SELECT *
 FROM c
 WHERE CONTAINS(c.name,"Helmet")
  5. Use o botão Executar Consulta para executar a consulta revisada e examinar os resultados, que inclui entidades JSON para quaisquer itens com um campo de nome que contenha o texto “Helmo”.

  6. Feche o editor de consultas SQL, descartando suas alterações.

    Você viu como criar e consultar entidades JSON em um banco de dados do Cosmos DB usando a interface do Data Explorer no portal do Azure. Em um cenário real, um desenvolvedor de aplicativos usaria um dos vários SDKs (Software Development Kits) específicos da linguagem de programação para chamar a API NoSQL e trabalhar com os dados no banco de dados.

Dica: se você tiver concluído a exploração do Azure Cosmos DB, exclua o grupo de recursos criado neste exercício.