Guia de início rápido: criar uma conta, banco de dados, contêiner e itens do Azure Cosmos DB no portal do Azure

APLICA-SE A: NoSQL

A Base de Dados Cosmos do Azure é um serviço de bases de dados com vários modelos da Microsoft distribuído globalmente. Você pode 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 gráficos. Essa abordagem se beneficia dos recursos de distribuição global e escala horizontal no núcleo do Azure Cosmos DB.

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

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. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.

  2. Procure o Azure Cosmos DB. Selecione Criar>Azure Cosmos DB.

  3. Na página Criar uma conta do Azure Cosmos DB, selecione a opção Criar na seção Azure Cosmos DB para NoSQL.

    O Azure Cosmos DB fornece várias APIs:

    • NoSQL, para dados de documentos
    • PostgreSQL
    • MongoDB, para dados de documentos
    • Apache Cassandra
    • Table
    • Apache Gremlin, para dados gráficos

    Para saber mais sobre a API para NoSQL, consulte Bem-vindo ao Azure Cosmos DB.

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

    Definição valor Descrição
    Subscrição Nome da subscrição Selecione a subscrição do Azure que pretende utilizar para esta conta do Azure Cosmos DB.
    Grupo de Recursos Nome do grupo de recursos Selecione um grupo de recursos ou selecione Criar novo e, em seguida, introduza um nome exclusivo para o novo grupo de recursos.
    Nome da Conta Um nome exclusivo Insira um nome para identificar sua conta do Azure Cosmos DB. Uma vez que documents.azure.com é anexado ao nome que indicar para criar o URI, utilize um nome exclusivo. O nome pode conter apenas letras minúsculas, números e o caractere hífen (-). Deve ter de 3 a 44 caracteres.
    Localização A região mais próxima dos seus utilizadores Selecione a localização geográfica para alojar a sua conta do Azure Cosmos DB. Utilize a localização mais próxima dos utilizadores para lhes dar o 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 de taxa de transferência provisionada. Selecione Serverless para criar uma conta no modo serverless.
    Aplicar desconto de nível gratuito do Azure Cosmos DB Candidatar-se ou Não aplicar Com o nível gratuito do Azure Cosmos DB, você obtém os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente em uma conta. Saiba mais sobre o nível gratuito.
    Limitar a taxa de transferência total da conta Selecionado ou não Limite a quantidade total de taxa de transferência que pode ser provisionada nessa conta. Esse limite evita cobranças inesperadas relacionadas à taxa de transferência provisionada. Você pode atualizar ou remover esse limite depois que sua conta for criada.

    Você pode ter até uma conta gratuita do Azure Cosmos DB por assinatura do Azure e deve optar por participar ao criar a conta. Se você não vir a opção de aplicar o desconto de nível gratuito, outra conta na assinatura já foi habilitada com o nível gratuito.

    Screenshot shows the Create Azure Cosmos DB Account page.

    Nota

    As seguintes opções não estarão disponíveis se você selecionar Serverless como o modo de Capacidade:

    • Aplicar Desconto de Escalão Gratuito
    • Limitar a taxa de transferência total da conta
  5. Na guia Distribuição Global, configure os seguintes detalhes. Você pode deixar os valores padrão para este início rápido:

    Definição valor Descrição
    Georredundância Desativar Habilite ou desative a distribuição global em sua conta emparelhando sua região com uma região par. Pode adicionar mais regiões à sua conta mais tarde.
    Escritas de várias regiões Desativar O recurso de gravação em 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.
    Zonas de Disponibilidade Desativar As zonas de disponibilidade ajudam a melhorar ainda mais a disponibilidade e a resiliência do seu aplicativo.

    Nota

    As opções a seguir não estarão disponíveis se você selecionar Serverless como o modo de capacidade na página Noções básicas anterior:

    • Georredundância
    • Escritas de várias regiões
  6. Opcionalmente, você pode configurar mais detalhes nas seguintes guias:

  7. Selecione Rever + criar.

  8. Reveja as definições da conta e, em seguida, selecione Criar. A criação da conta demora alguns minutos. Aguarde até que a página do portal apresente A implementação está concluída.

    Screenshot shows that your deployment is complete.

  9. Selecione Ir para recurso para aceder à página da conta do Azure Cosmos DB.

    Screenshot shows the Azure Cosmos DB account page.

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 contêiner.

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

    Talvez seja necessário rolar para a direita para ver a janela Novo contêiner .

    Screenshot shows the Azure portal Data Explorer page with the New Container pane open.

  2. No painel Novo contêiner, insira as configurações para o novo contêiner.

    Definição Valor sugerido Descrição
    ID da base de dados ToDoList Insira ToDoList como o nome do novo banco de dados. Os nomes dos bancos de dados devem conter de 1 a 255 caracteres e não podem conter /, , , , \#?ou um espaço à direita. Marque a opção Taxa de transferência de compartilhamento entre contêineres . Ele permite que você compartilhe a taxa de transferência provisionada no banco de dados em todos os contêineres dentro do banco de dados. Esta opção também ajuda na redução de custos.
    Taxa de transferência do banco de dados Dimensionamento automático ou manual A taxa de transferência manual permite dimensionar unidades de solicitação por segundo (RU/s), 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.
    Banco de dados Max RU/s 400 RU/s Se quiser reduzir a latência, você pode aumentar a taxa de transferência posteriormente estimando o RU/s necessário com a calculadora de capacidade. Observação: essa configuração não está disponível ao criar um novo contêiner em uma conta sem servidor.
    ID do contentor Items Insira Itens como o nome do novo contêiner. Os IDs dos contentores têm os mesmos requisitos em termos de carateres que os nomes das bases de dados.
    Chave de partição /Category O exemplo descrito neste artigo usa /category como a chave de partição.

    Não adicione teclas exclusivas nem ative o repositório analítico para este exemplo.

    • As chaves exclusivas permitem adicionar 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, consulte Chaves exclusivas no Azure Cosmos DB.
    • O armazenamento analítico é usado para permitir análises em larga escala em relação a dados operacionais sem qualquer efeito sobre 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 à sua base de dados

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

  1. No Data Explorer, expanda o banco de dados ToDoList e expanda o contêiner Items.

  2. Em seguida, selecione Itens e, em seguida, selecione Novo Item.

    Screenshot shows the New Item option in Data Explorer in the Azure portal.

  3. 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
    }
    
  4. Selecione Guardar.

    Screenshot shows where you can copy json data and select Save in Data Explorer in the Azure portal.

  5. Selecione Novo Item novamente e crie e salve outro documento com um , exclusivo ide quaisquer outras propriedades e valores desejados. Seus documentos podem ter qualquer estrutura, porque o Azure Cosmos DB não impõe nenhum esquema aos seus dados.

Consultar os seus dados

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

  1. Na parte superior do separador Itens no Explorador de Dados, reveja a consulta SELECT * FROM cpredefinida . Esta consulta recupera e exibe todos os documentos do contêiner ordenado pelo ID.

    Screenshot shows the default query in Data Explorer, SELECT * FROM c.

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

    Screenshot shows a change to the default query to ORDER BY c._ts DESC.

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

    Screenshot shows the result of the changed query.

Se estiver familiarizado com a sintaxe SQL, pode introduzir quaisquer consultas SQL suportadas na caixa de predicados de consulta. Você também pode usar o Data Explorer para criar procedimentos armazenados, funções definidas pelo usuário e gatilhos para lógica de negócios do lado do servidor.

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

Clean up resources (Limpar recursos)

Quando terminar de usar seu aplicativo e sua conta do Azure Cosmos DB, você poderá excluir os recursos do Azure criados para não incorrer em mais cobranças. Para eliminar 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 que você criou para este início rápido.

    Select the resource group to delete

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

    Delete the resource group

  4. Na janela seguinte, introduza o nome do grupo de recursos a eliminar e, em seguida, selecione Eliminar.

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

  1. Vá para sua conta do Azure Cosmos DB.
  2. Abra o Data Explorer, selecione Mais (...) para o banco de dados que você deseja excluir e selecione Excluir banco de dados.
  3. Insira o ID do banco de dados ou o nome do banco de dados para confirmar a operação de exclusão.

Próximos passos

Agora você pode importar mais dados para sua conta do Azure Cosmos DB.