Partilhar via


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

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:

    Valor
    Subscription Selecione sua assinatura 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 Disable
    Localização 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.

    Sugestão

    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 conclua com sucesso 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 até que a implementação seja concluída.

    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:

    Valor
    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) Autoscale
    Capacidade Máxima 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.

    Sugestão

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

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 Explorer.

  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, para o logistics departamento, todos os itens 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.

Explore mais orientações de configuração e otimização

Depois de criar e consultar seus dados, use a seção Visão geral para experimentar diferentes recursos do Azure Cosmos DB.

  1. No painel de recursos da conta, selecione Visão geral no menu de serviço.

  2. Analise os recursos no Hub Visão Geral , incluindo, entre outros:

    • Guias de início rápido para ajudá-lo a criar e testar seu aplicativo.

    • Configuração e orientação de otimização para apoiar todas as etapas da sua jornada, desde o aprendizado até a produção. As seções incluem particionamento, indexação, modelagem, controle de custos, configuração de backup e ajuste de desempenho.

    • Contêineres & Acesso a dados para consultar seus dados, ajustar a taxa de transferência e abrir contêineres no Data Explorer ou Visual Studio Code.

    • Ferramentas de monitoramento , como Insights, Métricas, Alertas e Configurações de diagnóstico, além de um scorecard que apresenta disponibilidade, alertas e recomendações do Azure Advisor.

    • Recursos de aprendizagem , como tutoriais em vídeo, aplicativos de exemplo e documentação.

    • Recomendações acionáveis personalizadas para sua conta para confiabilidade, segurança e eficiência de custos.

    Captura de ecrã da secção de configuração e otimização do Hub de Descrição Geral no portal do Azure.

Sugestão

O conteúdo mostrado no Hub Visão geral se adapta à sua atividade e tipo de carga de trabalho para facilitar a localização do que é mais relevante para você.