Início Rápido: crie uma conta do Azure Cosmos DB for NoSQL usando o portal do Azure

APLICA-SE A: NoSQL

Neste início rápido, você criará uma nova conta do Azure Cosmos DB for NoSQL no portal do Azure. Em seguida, usará a experiência do Data Explorer no portal do Azure para criar um banco de dados e um contêiner definindo todas as configurações necessárias. Por fim, você adicionará exemplos de dados ao contêiner e emitirá uma consulta básica.

Pré-requisitos

Criar uma conta

Comece criando uma nova conta do Azure Cosmos DB for NoSQL

  1. Entre no portal do Azure (https://portal.azure.com).

  2. Insira Azure Cosmos DB na barra de pesquisa global.

    Captura de tela da barra de pesquisa global no portal do Azure.

  3. Em Serviços, escolha Azure Cosmos DB.

    Captura de tela da opção Azure Cosmos DB escolhida no menu de pesquisa.

  4. No painel do Azure Cosmos DB, escolha Criar e, em seguida, Azure Cosmos DB for NoSQL.

    Captura de tela da opção Criar no painel de um serviço do Azure.

    Captura de tela do painel de seleção da API do Azure Cosmos DB com a API para NoSQL realçada.

  5. No painel Noções básicas, configure as seguintes opções e, em seguida, escolha Revisar + criar:

    Valor
    Assinatura Selecione sua Assinatura do Azure.
    Grupo de Recursos Crie um novo grupo de recursos ou escolha um grupo de recursos existente
    Account Name Forneça um nome global exclusivo
    Zonas de Disponibilidade Desabilitar
    Localidade Escolha uma região do Azure compatível com sua assinatura

    Captura de tela do painel de Noções básicas de criação de recursos do Azure Cosmos DB for NoSQL.

    Dica

    Você pode deixar as opções não especificadas com os valores padrão. Você também pode configurar a conta para limitar a produtividade total da conta a mil unidades de solicitação por segundo (RU/s) e habilitar a camada gratuita para minimizar seus custos.

  6. No painel Revisar + criar , aguarde a conclusão bem-sucedida da validação da conta e escolha Criar.

    Captura de tela da etapa de validação de recursos na experiência de criação.

  7. O portal navega automaticamente para o painel Implantação. Aguarde até que a implantação seja concluída.

    Captura de tela do painel de implantação com uma implantação pendente, no momento.

  8. Depois que a implantação for concluída, escolha Ir para o recurso para navegar até a nova conta do Azure Cosmos DB for NoSQL.

    Captura de tela de um recurso totalmente implantado com a opção “Ir para o recurso” realçada.

Criar um banco de dados e um contêiner

Em seguida, use o Data Explorer para criar um banco de dados e um contêiner no portal.

  1. No painel de recursos da conta, escolha Data Explorer no menu de serviço.

    Captura de tela da opção Data Explorer no menu de serviço da contabilização.

  2. No painel do Data Explorer, escolha a opção Novo contêiner.

    Captura de tela da opção “Novo contêiner” no Data Explorer.

  3. Na caixa de diálogo Novo contêiner, configure os seguintes valores e escolha OK:

    Valor
    Backup de banco de dados Criar novo
    ID do banco de dados cosmicworks
    Compartilhar a taxa de transferência entre contêineres Não selecionar
    ID do contêiner employees
    Chave de partição department/name
    Taxa de transferência do contêiner (escala automática) Autoescala
    Máximo de RU/s do Contêiner 1000

    Captura de tela da caixa de diálogo para criar um banco de dados e um contêiner novos com as opções especificadas preenchidas.

  4. Crie um novo arquivo denominado demo.bicepparam ou (demo.bicepparam).

  5. Observe o banco de dados e o contêiner recém-criados na hierarquia do Data Explorer.

    Captura de tela da hierarquia do Data Explorer com um contêiner de banco de dados presente.

    Dica

    Opcionalmente, você pode expandir o nó do contêiner para observar propriedades adicionais e definições de configuração.

Adicionar e consultar exemplos de dados

Por fim, use o Data Explorer para criar um item de amostra e, em seguida, emita uma consulta básica para o contêiner.

  1. Expanda o nó do contêiner employees na árvore do Data Explorer. Em seguida, escolha a opção Itens.

    Captura de tela da opção “Itens” em um contêiner na hierarquia do Data Exploer.

  2. No menu do Data Explorer, escolha Novo item.

    Captura de tela da opção “Novo item” no menu do Data Explorer.

  3. Agora, insira o seguinte JSON para um novo item no contêiner employees escolha Salvar:

    {
      "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": {
        "first": "Kai",
        "last": "Carter"
      },
      "email": "<kai@adventure-works.com>",
      "department": {
        "name": "Logistics"
      }
    }
    

    Captura de tela do conteúdo JSON para um novo item no Data Explorer.

  4. No menu do Data Explorer, escolha Nova consulta SQL.

    Captura de tela da opção “Nova Consulta SQL” no menu do Data Explorer.

  5. Agora, insira a seguinte consulta NoSQL para obter todos os itens do departamento logistics usando uma pesquisa sem diferenciação de maiúsculas e minúsculas. A consulta, em seguida, formata a saída como um objeto JSON estruturado. Execute a consulta escolhendo Executar consulta:

    SELECT VALUE {
        "name": CONCAT(e.name.last, " ", e.name.first),
        "department": e.department.name,
        "emailAddresses": [
            e.email
        ]
    }
    FROM
        employees e
    WHERE
        STRINGEQUALS(e.department.name, "logistics", true)
    

    Captura de tela do texto da consulta NoSQL no Data Explorer.

  6. Observe a saída da matriz JSON da consulta.

    [
      {
        "name": "Carter Kai",
        "department": "Logistics",
        "emailAddresses": [
          "kai@adventure-works.com"
        ]
      }
    ]
    

    Captura de tela dos resultados da execução da consulta NoSQL anterior no Data Explorer.