Guia de Instrução: criar uma conta, base de dados, contentor e itens do Azure Cosmos a partir do portal do Azure

APLICA-SE A: SQL API DE 2010

O Azure Cosmos DB é o serviço de base de dados multi-modelo distribuído globalmente pela Microsoft. Pode utilizar o Azure Cosmos DB para criar e analisar rapidamente bases de dados de chave/valor, bases de dados de documentos e bases de dados de gráficos, todas estas vantagens das funcionalidades de distribuição e escala horizontal globais no centro do Azure Cosmos DB.

Este guia de instrução rápida demonstra como utilizar o portal do Azure para criar uma conta Azure Cosmos DB SQL API, criar uma base de dados de documentos e contentor e adicionar dados ao contentor.

Pré-requisitos

Uma subscrição 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 na Home page, selecione Criar um recurso.

  2. Na página Novo, procure e selecione Azure Cosmos DB.

  3. Na página Azure Cosmos DB, selecione Criar.

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

    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.
    Grupo de Recursos Nome do grupo de recursos Selecione um grupo de recursos ou selecione Criar novoe, em seguida, introduza um nome exclusivo para o novo grupo de recursos.
    Nome da Conta Um nome exclusivo Introduza um nome para identificar a sua conta do Azure Cosmos. Uma vez documents.azure.com nome é acrescentado ao nome que fornece para criar o seu URI, utilize um nome exclusivo.

    O nome só pode conter letras minúsculas, números e o caráter de hífen (-). Tem de ter entre 3 a 44 carateres de comprimento.
    API O tipo de conta a criar Selecione Base (SQL) para criar uma base de dados e consulta de documentos através SQL sintaxe.

    A API determina o tipo de conta a criar. O Azure Cosmos DB fornece cinco APIs: Core (SQL) e MongódB para dados de documentos, Gremlin para dados de gráficos, Tabela do Azure e Cassandra. Atualmente, tem de criar uma conta separada para cada API.

    Saiba mais sobre a SQL API.
    Localização A região mais próxima dos seus utilizadores Selecione uma localização geográfica para aloger a sua conta do Azure Cosmos DB. Utilize a localização mais próxima dos seus utilizadores para lhes dar o acesso mais rápido aos dados.
    Modo de capacidade Dí entrada aprovisionado ou Serverless Selecione Dóto aprovisionado para criar uma conta no modo de dóto de entrada aprovisionado. Selecione Servidor sem servidor para criar uma conta no modo de servidor.
    Aplicar o desconto de nível gratuito do Azure Cosmos DB Aplicarou Não aplicar Com a escalão gratuita do Azure Cosmos DB, irá obter gratuitamente os primeiros 1000 RU/s e 25 GB de armazenamento numa conta. Saiba mais sobre a escalão gratuita.

    Nota

    Pode ter até uma conta do Azure Cosmos DB de nível gratuito por subscrição do Azure e tem de optar ativamente por fazê-lo ao criar a conta. Se não vir a opção para aplicar o desconto de nível gratuito, isto significa que outra conta na subscrição já foi ativada com a escalão gratuita.

    The new account page for Azure Cosmos DB

  5. No separador Distribuição Global, configure os seguintes detalhes. Pode deixar os valores predefinido com o objetivo deste guia de intuição rápida:

    Definição Valor Descrição
    Geo-Redundancy Desativar Ative ou desativar a distribuição global na sua conta ao emparelhar a sua região com uma região emparelhada. Pode adicionar mais regiões à sua conta mais tarde.
    Multi-region Writes Desativar A capacidade de escrita de várias regiões permite-lhe tirar partido do dóto aprovisionado para as suas bases de dados e contentores em todo o mundo.

    Nota

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

    • Aplicar Desconto de Escalão Gratuito
    • Geo-redundância
    • Multi-region Writes
  6. Opcionalmente, pode configurar detalhes adicionais nos seguintes separadores:

    • Rede – configurar o acesso a partir de uma rede virtual.
    • Política de Cópia de Segurança - Configure uma política de cópia de segurança periódica ou contínua.
    • Encriptação : utilize uma chave gerida pelo serviço ou uma chave gerida pelo cliente.
    • Etiquetas - As etiquetas são pares nome/valor que lhe permitem categorizar recursos e ver a faturação consolidada ao aplicar a mesma etiqueta a múltiplos recursos e grupos de recursos.
  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 que a página do portal seja apresentada A sua implementação está concluída.

    The Azure portal Notifications pane

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

    The Azure Cosmos DB account page

Adicionar uma base de dados e um contentor

Pode utilizar o Explorador de Dados no portal do Azure para criar uma base de dados e contentor.

  1. Selecione Explorador de Dados a partir da navegação esquerda na página da sua conta do Azure Cosmos DB e, em seguida, selecione Novo Contentor.

    Poderá ter de deslocar para a direita para ver a janela Adicionar Contentor.

    The Azure portal Data Explorer, Add Container pane

  2. No painel Adicionar contentor, introduza as definições para o novo contentor.

    Definição Valor sugerido Descrição
    ID da Base de Dados ToDoList Introduza ToDoList como o nome da nova base de dados. Os nomes das bases de dados têm de conter entre 1 e 255 carateres e não podem conter /, \\, #, ? ou um espaço à rasto. Verifique a opção Partilhar dótodo entre contentores, que lhe permite partilhar o dóto aprovisionado na base de dados em todos os contentores dentro da base de dados. Esta opção também ajuda com as poupanças de custos.
    Passagem da base de dados Pode aprovisionar o dílar Automático ou Manual. O débito manual permite-lhe dimensionar RU/s manualmente, enquanto que o débito da escala automática permite que o sistema dimensione RU/s com base na utilização. Selecione Manual para este exemplo.

    Deixe o díbito às 400 unidades de pedido por segundo (RU/s). Se quiser reduzir a latência, pode dimensionar o débito mais tarde estimando o número de RU/s necessários com a calculadora de capacidade.

    Nota:esta definição não está disponível ao criar um novo contentor numa conta sem servidor.
    Container ID Itens Introduza Itens como o nome para o seu novo contentor. Os IDs de Contentor têm os mesmos requisitos de carateres que os nomes das bases de dados.
    Tecla Partição /category O exemplo descrito neste artigo utiliza /category como a chave de partição.

    Não adicione chaves Exclusivas nem ativar o Loja Analítico para este exemplo. As chaves exclusivas permite-lhe adicionar uma camada de integridade de dados à base de dados assegurando a exclusivaidade de um ou mais valores por chave de partição. Para obter mais informações, consulte Teclas exclusivas no Azure Cosmos DB.O armazeno analítico é utilizado para ativar a análise de grande escala relativamente a dados operacionais sem qualquer impacto nas suas cargas de trabalho transais.

  3. Selecione OK. O Explorador de Dados apresenta a nova base de dados e o contentor que criou.

Adicionar dados à base de dados

Adicione dados à sua nova base de dados com o Explorador de Dados.

  1. No Explorador de Dados, expanda a base de dados ToDoList e expanda o contentor Itens. Em seguida, selecione Itense, em seguida, selecione Novo Item.

    Create new documents in Data Explorer in the Azure portal

  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. Selecione Guardar.

    Copy in json data and select Save in Data Explorer in the Azure portal

  4. Selecione Novo Item novamente e crie e guarde outro documento com um , e quaisquer outras propriedades e valores que queira. Os seus documentos podem ter qualquer estrutura, porque o Azure Cosmos DB não impõe esquemas nos seus dados.

Consulta os seus dados

Pode utilizar consultas no Explorador de Dados para obter e filtrar os seus dados.

  1. Na parte superior do separador Itens no Explorador de Dados, reveja a consulta predefinida. Esta consulta ocupe e apresenta todos os documentos do contentor ordenado pelo ID.

    Default query in Data Explorer is SELECT * FROM c

  2. Para alterar a consulta, selecione Editar Filtro, substitua a consulta predefinida por e, em seguida, selecione Aplicar Filtro.

    Change the default query by adding ORDER BY c._ts DESC and clicking Apply Filter

    A consulta modificada apresenta os documentos por ordem descendente com base no carimbo de data/hora, pelo que agora o segundo documento é listado em primeiro lugar.

    Changed query to ORDER BY c._ts DESC and clicking Apply Filter

Se estiver familiarizado com a SQL, pode introduzir todas as consultas de tipo SQL na caixa de predicado da consulta. Também pode utilizar o Explorador de Dados para criar procedimentos armazenados, UDFs e ativadores para a lógica empresarial do lado do servidor.

O Explorador de Dados fornece um acesso fácil ao portal do Azure a todas as funcionalidades de acesso a dados programáticos incorporadas disponíveis nas APIs. Também pode utilizar o portal para dimensionar o débito, obter teclas e cadeias de ligação e rever métricas e SLAs para a sua conta do Azure Cosmos DB.

Limpar recursos

Quando terminar a sua aplicação e a conta do Azure Cosmos DB, pode eliminar os recursos do Azure que criou para não incorrer em mais encargos. Para eliminar os recursos:

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

  2. A partir da lista, selecione o grupo de recursos que criou para este guia de instalamento rápido.

    Select the resource group to delete

  3. Na página Visão Geral do grupo de recursos, selecione Eliminar 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 quiser eliminar apenas a base de dados e utilizar a conta do Azure Cosmos no futuro, pode eliminar a base de dados com os seguintes passos:

  • Chegou à sua conta do Azure Cosmos.
  • Abra o Explorador de Dados, clique com o botão direito do rato na base de dados que pretende eliminar e selecione Eliminar Base de Dados.
  • Introduza o nome da Base de Dados ID/base de dados para confirmar a operação de eliminação.

Passos seguintes

Neste guia de instrução rápida, aprendeu a criar uma conta Azure Cosmos DB, a criar uma base de dados e um contentor com o Explorador de Dados. Agora pode importar dados adicionais para a sua conta do Azure Cosmos DB.

Está a tentar planear a capacidade de uma migração para o Azure Cosmos DB? Pode utilizar as informações sobre o seu cluster de bases de dados existente para o planeamento de capacidade.

  • Se tudo o que sabe é o número de vcores e servidores no seu cluster de bases de dados existente, leia sobre a estimativa das unidades de pedidos através de vCores ou vCPUs
  • Se conhecer taxas de pedidos típicas para a sua carga de trabalho da base de dados atual, leia sobre a estimativa das unidades de pedido utilizando o planeador de capacidade do Azure Cosmos DB