Partilhar via


Guia de início rápido: criar uma conta do Azure Cosmos DB para NoSQL usando o portal do Azure

APLICA-SE A: NoSQL

Neste início rápido, você cria uma nova conta do Azure Cosmos DB para NoSQL no portal do Azure. Em seguida, use a experiência do Data Explorer no portal do Azure para criar um banco de dados e contêiner definindo todas as configurações necessárias. Finalmente, você adiciona dados de exemplo ao contêiner e emite uma consulta básica.

Pré-requisitos

Criar uma conta

Comece criando uma nova conta do Azure Cosmos DB para NoSQL

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

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

    Captura de ecrã da barra de pesquisa global no portal do Azure.

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

    Captura de ecrã da opção Azure Cosmos DB selecionada no menu de pesquisa.

  4. No painel Azure Cosmos DB, selecione Criar e, em seguida, Azure Cosmos DB para NoSQL.

    Captura de ecrã 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 selecione Revisar + criar:

    Value
    Subscrição Selecione a sua subscrição do Azure
    Grupo de Recursos Criar um novo grupo de recursos ou selecionar um grupo de recursos existente
    Nome da Conta Forneça um nome globalmente exclusivo
    Zonas de Disponibilidade Desativar
    Location Selecione uma região do Azure suportada para a sua subscrição

    Captura de ecrã do painel 'Básicos' de criação de recursos do Azure Cosmos DB para NoSQL.

    Gorjeta

    Você pode deixar quaisquer opções não especificadas para seus valores padrão. Você também pode configurar a conta para limitar a taxa de transferência total da conta a 1.000 unidades de solicitação por segundo (RU/s) e habilitar o nível gratuito para minimizar seus custos.

  6. No painel Rever + criar, aguarde até que a validação da sua conta termine com êxito e, em seguida, selecione 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 pela conclusão da implementação.

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

  8. Quando a implantação estiver concluída, selecione Ir para o recurso para navegar até a nova conta do Azure Cosmos DB para NoSQL.

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

Criar uma base de dados e um contentor

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, selecione Data Explorer no menu de serviço.

    Captura de ecrã da opção Data Explorer no menu de serviço da conta.

  2. No painel Data Explorer, selecione a opção Novo Contêiner.

    Captura de ecrã da opção 'Novo Contentor' no Explorador de Dados.

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

    Value
    Base de dados Criar novo
    ID da base de dados cosmicworks
    Compartilhar taxa de transferência entre contêineres Não selecione
    ID do contentor employees
    Chave de partição department/name
    Taxa de transferência do contêiner (dimensionamento automático) Dimensionamento Automático
    Contentor Max RU/s 1000

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

  4. Crie um novo arquivo chamado 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.

    Gorjeta

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

Adicionar e consultar dados de exemplo

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

  1. Expanda o nó para o contêiner de funcionários na árvore do Data Explorer. Em seguida, selecione a opção Itens .

    Captura de tela da opção 'Itens' dentro de um contêiner na hierarquia do Data Exploer.

  2. No menu do Data Explorer, selecione Novo Item.

    Captura de ecrã da opção 'Novo Item' no menu Data Explorer.

  3. Agora, insira o seguinte JSON para um novo item no contêiner de funcionários e selecione 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 de um novo item no Data Explorer.

  4. No menu do Data Explorer, selecione Nova Consulta SQL.

    Captura de ecrã da opção 'New SQL Query' no menu Data Explorer.

  5. Agora, insira a seguinte consulta NoSQL para obter todos os itens para o logistics departamento usando uma pesquisa que não diferencia maiúsculas de minúsculas. Em seguida, a consulta formata a saída como um objeto JSON estruturado. Execute a consulta selecionando 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 ecrã 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 ecrã dos resultados da execução da consulta NoSQL anterior no Data Explorer.