Início Rápido: Criar uma conta, um banco de dados, um contêiner e itens do Azure Cosmos usando o portal do Azure

APLICA-SE A: API do SQL

O Azure Cosmos DB é o serviço de banco de dados multimodelo distribuído globalmente da Microsoft. É possível usar o Azure Cosmos DB para criar e consultar rapidamente bancos de dados de chave/valor, bancos de dados de documentos e bancos de dados de grafo. Todos se beneficiam de recursos de escala horizontal e distribuição global no núcleo do Azure Cosmos DB.

Este início rápido demonstra como usar o portal do Azure para criar uma conta de API de SQL do Azure Cosmos DB, criar um banco de dados de documentos e um contêiner e adicionar dados ao contêiner. Sem um cartão de crédito ou uma assinatura do Azure, você pode configurar para Experimentar uma conta do Azure Cosmos DB gratuitamente

Pré-requisitos

Uma assinatura do Azure ou uma conta de avaliação gratuita do Azure Cosmos DB

Criar uma conta do Azure Cosmos DB

  1. No menu do portal do Azure ou na Home page, selecione Criar um recurso.

  2. Na página Novo, pesquise pelo Azure Cosmos DB e selecione-o.

  3. Na página da opção Selecionar API, clique na opção Criar da seção Núcleo (SQL) – Recomendar. O Azure Cosmos DB fornece cinco APIs: Núcleo (SQL) e MongoDB para dados de documento, Gremlin para dados de grafo, Tabela do Azure e Cassandra. No momento, você deve criar uma conta separada para cada API. Saiba mais sobre a API do SQL.

  4. Na página Criar Conta do Azure Cosmos DB, insira as configurações básicas da nova conta do Azure Cosmos.

    Configuração Valor Descrição
    Subscription Nome da assinatura Selecione a assinatura do Azure que você deseja usar para essa conta do Azure Cosmos.
    Grupo de recursos Nome do grupo de recursos Selecione um grupo de recursos ou selecione Criar novo, então insira um nome exclusivo para o novo grupo de recursos.
    Nome da Conta Um nome exclusivo Insira um nome para identificar a conta do Azure Cosmos. Já que documents.Azure.com é acrescentado ao nome que você fornece para criar o URI, use um nome exclusivo.

    O nome pode conter apenas letras minúsculas, números e o caractere de hífen (-). Ele deve ter entre 3 e 44 caracteres.
    Location A região mais próxima dos usuários Selecione uma localização geográfica para hospedar a sua conta do Azure Cosmos DB. Use a localização mais próxima dos usuários para fornecer a eles acesso mais rápido aos dados.
    Modo de capacidade Taxa de transferência provisionada ou sem servidor Selecione Taxa de transferência provisionada para criar uma conta no modo taxa de transferência provisionada. Selecione Sem servidor para criar uma conta no modo sem servidor.
    Aplicar o desconto por nível gratuito do Azure Cosmos DB Aplicar ou Não aplicar Com a camada gratuita do Azure Cosmos DB, você recebe os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente em uma conta. Saiba mais sobre o nível gratuito.

    Observação

    Você pode ter no máximo uma conta do nível gratuito do Azure Cosmos DB por assinatura do Azure e deve aceitar ao criar a conta. Se você não vir a opção de aplicar o desconto por nível gratuito, significa que outra conta da assinatura já foi habilitada com o nível gratuito.

    A página da nova conta do Azure Cosmos DB

  5. Na guia Distribuição global, configure os detalhes a seguir. Para este início rápido, é possível usar os valores padrão:

    Configuração Valor Descrição
    Redundância geográfica Desabilitar Habilite ou desabilite a distribuição global em sua conta emparelhando sua região com uma região de par. Você poderá adicionar mais regiões à sua conta posteriormente.
    Gravações de várias regiões Desabilitar A capacidade de gravação de várias regiões permite que você aproveite a taxa de transferência provisionada para seus bancos de dados e contêineres em todo o mundo.

    Observação

    As seguintes opções não estarão disponíveis se você selecionar Sem servidor como Modo de capacidade:

    • Aplicar desconto por nível gratuito
    • Redundância geográfica
    • Gravações de várias regiões
  6. Você tem a opção de configurar mais detalhes nas seguintes guias:

    • Rede – configurar o acesso de uma rede virtual.
    • Política de Backup – configurar a política de backup periódica ou contínua.
    • Criptografia – use a chave gerenciada por serviço ou uma chave gerenciada pelo cliente.
    • Marcas – marcas são pares nome/valor que permitem categorizar recursos e exibir a cobrança consolidada por meio da aplicação da mesma marca a vários recursos e grupos de recursos.
  7. Selecione Examinar + criar.

  8. Examine as configurações da conta e selecione Criar. São necessários alguns minutos para criar a conta. Aguarde até que a página do portal exiba Sua implantação está concluída.

    O painel Notificações do portal do Azure

  9. Selecione Ir para recurso para ir para a página da conta do Azure Cosmos DB.

    A página da conta do Azure Cosmos DB

Adicionar um banco de dados e um contêiner

Você pode usar o Data Explorer no portal do Azure para criar um banco de dados e um contêiner.

  1. Selecione Data Explorer no painel de navegação à esquerda na página de sua conta do Azure Cosmos DB e, em seguida, selecione Novo Contêiner.

    Talvez seja necessário rolar a página para a direita para ver a janela Adicionar Contêiner.

    O Data Explorer do portal do Azure, painel Adicionar Contêiner

  2. No painel Adicionar contêiner, insira as configurações do novo contêiner.

    Configuração Valor sugerido Descrição
    ID do banco de dados ToDoList Insira ToDoList como o nome para o novo banco de dados. Os nomes dos banco de dados devem conter de 1 a 255 caracteres e não podem conter /, \\, #, ? nem um espaço à direita. Marque a opção Provisionar a taxa de transferência entre os contêineres; ela permite que você compartilhe a taxa de transferência provisionada para o banco de dados em todos os contêineres no banco de dados. Essa opção também ajuda na economia de custo.
    Taxa de transferência do banco de dados Você pode provisionar a taxa de transferência de forma Manual ou em Dimensionamento automático. A taxa de transferência manual permite dimensionar RU/s por conta própria enquanto a taxa de transferência de dimensionamento automático permite que o sistema dimensione RU/s com base no uso. Selecione Manual para este exemplo.

    Deixe a taxa de transferência em 400 unidades de solicitação por segundo (RU/s). Se você quiser reduzir a latência, poderá escalar verticalmente a taxa de transferência depois, estimando os RU/s necessários com a calculadora de capacidade.

    Observação: esta configuração não está disponível ao criar um contêiner em uma conta sem servidor.
    ID do contêiner Itens Insira Itens como o nome do novo contêiner. As IDs do contêiner têm os mesmos requisitos de caractere dos nomes de bancos de dados.
    Chave de partição /category O exemplo descrito neste artigo usa /category como a chave de partição.

    Não adicione Chaves exclusivas ou ative o Armazenamento analítico para este exemplo. Chaves exclusivas permitem que você adicione uma camada de integridade de dados ao banco de dados garantindo a exclusividade de um ou mais valores por chave de partição. Para obter mais informações, confira Chaves exclusivas no Azure Cosmos DB. OArmazenamento analítico é usado para habilitar a análise em larga escala contra dados operacionais sem nenhum impacto em suas cargas de trabalho transacionais.

  3. Selecione OK. O Data Explorer exibe o novo banco de dados e o contêiner que você criou.

Adicionar dados a seu banco de dados

Adicione dados a seu novo banco de dados usando o Data Explorer.

  1. No Data Explorer, expanda o banco de dados ToDoList e, em seguida, expanda o contêiner Itens. Em seguida, selecione Itens e, em seguida, selecione Novo Item.

    Criar documentos no Data Explorer no portal do Azure

  2. Adicione a seguinte estrutura ao documento no lado direito do painel Documentos:

    {
        "id": "1",
        "category": "personal",
        "name": "groceries",
        "description": "Pick up apples and strawberries.",
        "isComplete": false
    }
    
  3. Clique em Salvar.

    Copie nos dados json e selecione em Salvar no Data Explorer no portal do Azure

  4. Selecione Novo Item novamente e crie e salve outro documento com uma única id e quaisquer outras propriedades e valores desejados. Os documentos podem ter qualquer estrutura, pois o Azure Cosmos DB não impõe nenhum esquema a seus dados.

Consultar seus dados

Você pode usar consultas no Data Explorer para recuperar e filtrar os dados.

  1. Na parte superior da guia Itens no Data Explorer, examine a consulta padrão SELECT * FROM c. Essa consulta recupera e exibe todos os documentos do contêiner ordenados por ID.

    A consulta padrão no Data Explorer é SELECT * FROM c

  2. Para alterar a consulta, selecione Editar Filtro, substitua a consulta padrão por ORDER BY c._ts DESC e selecione Aplicar Filtro.

    Alterar a consulta padrão adicionando ORDER BY c._ts DESC e clicando Aplicar Filtro

    A consulta modificada exibe os documentos em ordem decrescente com base em seu carimbo de data/hora, portanto, agora o segundo documento é listado primeiro.

    Consulta alterada para ORDER BY c._ts DESC e clique em Aplicar Filtro

Se você estiver familiarizado com a sintaxe SQL, poderá inserir qualquer consulta SQL compatível na caixa de predicado de consulta. Você também pode usar o Data Explorer para criar procedimentos armazenados, UDFs e gatilhos para lógica de negócios do lado do servidor.

O Data Explorer fornece acesso fácil ao portal do Azure para todos os recursos de acesso a dados programático interno por disponível nas APIs. Você também pode usar o portal para dimensionar a taxa de transferência, obter as chaves e as cadeias de conexão e examinar as métricas e os SLAs para sua conta do Azure Cosmos DB.

Limpar os recursos

Quando o aplicativo e a conta do Azure Cosmos DB estiverem prontos, você poderá excluir os recursos do Azure criados para não incorrer em mais cobranças. Para excluir os recursos:

  1. Na barra de pesquisa do portal do Azure, procure e selecione Grupos de recursos.

  2. Na lista, selecione o grupo de recursos criado neste início rápido.

    Selecione o grupo de recursos a excluir

  3. Na página Visão geral do grupo de recursos, selecione Excluir grupo de recursos.

    Exclua o grupo de recursos

  4. Na próxima janela, insira o nome do grupo de recursos a ser excluído e selecione Excluir.

Se você quiser excluir apenas o banco de dados e usar a conta do Azure Cosmos no futuro, poderá excluir o banco de dados com as seguintes etapas:

  • Navegue até a conta do Azure Cosmos.
  • Abra Data Explorer, clique com o botão direito do mouse no banco de dados que você deseja excluir e selecione Excluir Banco de Dados.
  • Insira a ID/nome do banco de dados para confirmar a operação de exclusão.

Próximas etapas

Neste início rápido, você aprendeu a criar uma conta do Azure Cosmos DB, como criar um banco de dados e contêiner usando o Data Explorer. Agora, é possível importar outros dados para sua conta do Azure Cosmos DB.

Tentando fazer um planejamento de capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre o cluster de banco de dados existente para fazer isso.