Exercício – Criar uma instância do Cosmos DB usando o Visual Studio Code

  • 5 minutos

Nesta unidade, você trabalhará no Visual Studio Code com a extensão de Bancos de Dados:

  • Instale a extensão de Bancos de Dados do Azure para o Visual Studio Code.
  • Use a extensão para se conectar à conta de área restrita do Azure.
  • Crie uma conta do Cosmos DB.
  • Adicione um banco de dados e um contêiner.
  • Crie alguns documentos de teste no contêiner, exiba-os e os exclua.

No cenário de exemplo, você deseja trabalhar no Visual Studio Code, tanto como um ambiente de desenvolvimento para a criação de aplicativos quanto como uma ferramenta para gerenciar seus bancos de dados do Azure. Este exercício é executado em seu computador desktop e usa uma assinatura gratuita da área restrita do Azure.

Observação

Este exercício pressupõe que você já tenha instalado o Visual Studio Code no computador desktop.

Instalar a extensão de Bancos de Dados do Azure para Visual Studio Code

  1. Iniciar o Visual Studio Code.

  2. No menu Exibir na parte superior, selecione Extensões para abrir o painel de extensões ou use o atalho de teclado Ctrl + Shift + X.

  3. Na caixa Pesquisar, digite Bancos de Dados do Azure e pressione Enter.

  4. Na lista de extensões, selecione a extensão Bancos de Dados do Azure publicada pela Microsoft e clique em Instalar.

    Screenshot of Visual Studio Code. The user has selected the Azure Databases extension.

    Aguarde enquanto a extensão é instalada.

Entrar no Azure com a assinatura da área restrita

  1. No menu Exibir, selecione Paleta de Comandos.

  2. Na paleta de comandos, insira Azure e selecione Azure: Focar no Modo de Exibição de Recursos ou use o atalho de teclado Shift + Alt + A.

    Screenshot of the command palette in Visual Studio Code. The user has selected the Focus on Azure Databases extension View command.

    O explorador do Azure será exibido (se ainda não estiver visível).

    Screenshot of the Azure explorer in Visual Studio Code.

  3. No menu Exibir, selecione Paleta de Comandos e a opção Azure: Entrar.

  4. Entre com as mesmas credenciais usadas para configurar a área restrita, depois feche a página do navegador.

  5. No explorador do Azure, clique em Selecionar assinaturas.... A assinatura da área restrita do Learn terá o seguinte nome e a seguinte ID de locatário:

    Solução de problemas: se não for possível encontrar a Assinatura do Concierge, altere os locatários e entre novamente. Use a seguinte ID de locatário para isso:

    • ID de locatário: 604c1504-c6a3-4080-81aa-b33091104187
    • Nome: Assinatura do Concierge

  6. Selecione Assinatura do Concierge e OK.

  7. No explorador do Azure, expanda Assinatura do Concierge.

Criar uma conta do Cosmos DB no Visual Studio Code

  1. Clique com o botão direito do mouse no Azure CosmosDB e selecione Criar Servidor.

    Screenshot of the Azure explorer in Visual Studio Code. The user has selected the **Create Account** command.

    Um assistente será iniciado e solicitará detalhes da nova conta. Use a seguinte tabela para concluir os prompts:

    Prompt Resposta
    Selecionar um servidor de banco de dados do Azure Core (SQL)
    Nome da conta Insira um nome de conta globalmente exclusivo, por exemplo, <seu nome ou iniciais>-contoso-retail.
    Selecione um modelo de capacidade Taxa de transferência provisionada: a definição da taxa de transferência provisionada em um contêiner é a opção usada com mais frequência. É possível dimensionar de forma elástica a taxa de transferência de um contêiner, provisionando qualquer quantidade de taxa de transferência usando RUs ( Unidades de Solicitação).
    Selecionar um grupo de recursos para novos recursos Selecione [grupo de recursos da área restrita] com relação ao grupo de recursos criado para você pela área restrita do Learn.
    Selecione uma localização para novos recursos Selecione uma localização próxima de você.

  2. Após a criação da conta, no explorador do Azure, expanda Assinatura do Concierge e Azure CosmosDB. Verifique se a nova conta do Cosmos DB é exibida.

    Screenshot of the Azure Resources extension pane in Visual Studio Code. The new Azure Databases extension account is listed under the user's Azure account.

Criar um banco de dados e um contêiner

  1. No explorador do Azure (Shift + Alt + A), clique com o botão direito do mouse na conta de banco de dados criada e selecione Criar banco de dados.

    Screenshot of the Azure explorer in Visual Studio Code. The user has selected the Create Database command for the Azure Databases extension account.

  2. Um assistente é iniciado e solicita detalhes. Use a seguinte tabela para concluir os prompts:

    Prompt Resposta
    Nome do Banco de Dados ContosoRetail
    Inserir uma ID para a coleção Produtos
    Inserir a chave de partição da coleção ou deixar em branco para tamanho fixo categoryName
    Capacidade de taxa de transferência inicial 1000

    Esse contêiner armazenará os documentos de Products. Marcas e inventário são matrizes de subdocumentos com cada produto. O documento a seguir é um exemplo de um produto.

    {
    "id": "08225A9E-F2B3-4FA3-AB08-8C70ADD6C3C2",
    "categoryId": "75BF1ACB-168D-469C-9AA3-1FD26BB4EA4C",
    "categoryName": "Bikes, Touring Bikes",
    "sku": "BK-T79U-50",
    "name": "Touring-1000 Blue, 50",
    "description": "The product called \"Touring-1000 Blue, 50\"",
    "price": 2384.0700000000002,
    "tags": [
        {
            "_id": "27B7F8D5-1009-45B8-88F5-41008A0F0393",
            "name": "Tag-61"
        }
    ],
    "inventory": [
        { "location": "Dallas", "inventory": 42 },
        { "location": "Seattle", "inventory": 3 },
        { "location": "Boston", "inventory": 15 },
        { "location": "Miami", "inventory": 89 },
        { "location": "San Diego", "inventory": 19 }
    ]
}

  3. No explorador do Azure, verifique se o banco de dados ContosoRetail, que contém o contêiner Produtos, é exibido.

    Screenshot of the Azure explorer in Visual Studio Code, showing the SchoolDB database and the StudentCourseGrades container.

Criar e exibir documentos

  1. No explorador do Azure, expanda o contêiner Produtos. Duas subpastas deverão ser exibidas, chamadas Documentos e Procedimentos Armazenados.

  2. Clique com o botão direito do mouse na pasta Documentos, depois clique em Criar Documento.

    Screenshot of the Azure Databases pane in Visual Studio Code. The user has selected the Create Document command in the StudentCourseGrades container.

  3. Um assistente é iniciado e solicita detalhes. Use a seguinte tabela para concluir os prompts:

    Prompt Resposta
    Inserir uma ID de documento 08225A9E-F2B3-4FA3-AB08-8C70ADD6C3C2
    Chave de partição Bicicletas, bicicletas de passeio

  4. O documento será criado e exibido no Visual Studio Code, em formato JSON. Os campos id e categoryName serão preenchidos com os valores que você especificou.

    Screenshot of Visual Studio Code showing the newly created document.

  5. Adicione um segundo documento. No explorador do Azure, clique com o botão direito do mouse novamente na pasta Documentos e selecione Criar documento.

  6. Um assistente é iniciado e solicita detalhes. Use a seguinte tabela para concluir os prompts:

    Prompt Resposta
    Inserir uma ID de documento 0F124781-C991-48A9-ACF2-249771D44029
    Chave de partição Bicicletas, bicicletas de montanha

    O novo documento será exibido.

Editar documentos

  1. Na lista Documentos, selecione o documento 08225A9E-F2B3-4FA3-AB08-8C70ADD6C3C2.

  2. No documento JSON exibido, vá para o final da linha id e pressione Enter.

  3. Adicione os campos a seguir ao documento.

    "categoryId": "75BF1ACB-168D-469C-9AA3-1FD26BB4EA4C",
"sku": "BK-T79U-50",
"name": "Touring-1000 Blue, 50",
"description": "The product called \"Touring-1000 Blue, 50\"",
"price": 2384.0700000000002,
"tags": [
    {
        "_id": "27B7F8D5-1009-45B8-88F5-41008A0F0393",
        "name": "Tag-61"
    }
],
"inventory": []

    A propriedade marcas é um campo de matriz que contém as marcas associadas a um produto. O uso de uma matriz possibilita que um produto tenha diversas marcas.

  4. No menu Arquivo, selecione Salvar.

  5. Quando solicitado a atualizar a entidade para a nuvem, selecione Sempre carregar.

    Screenshot of Visual Studio Code showing the edited document. The student has selected the Update to Cloud command to save the changes back to Azure.

    O documento será atualizado na nuvem. O nó no contêiner “Produtos” é alterado para a propriedade nome do documento.

  6. Na lista Documentos, selecione o outro documento, 0F124781-C991-48A9-ACF2-249771D44029.

  7. Adicione os campos a seguir ao documento depois do campo id.

    "categoryId": "56400CF3-446D-4C3F-B9B2-68286DA3BB99",
"sku": "BK-M68B-42",
"name": "Mountain-200 Black, 42",
"description": "The product called \"Mountain-200 Black, 42\"",
"price": 2294.9899999999998,
"tags": [
    {
        "_id": "4F67013C-3B5E-4A3D-B4B0-8C597A491EB6",
        "name": "Tag-82"
    }
]

  8. No menu Arquivo, selecione Salvar.

    Você adicionou e editou documentos do Cosmos DB.

  9. A lista “Documentos” agora mostra nomes legíveis, usando o campo name de cada objeto. Ao trabalhar localmente com documentos, é útil localizá-los quando eles usam a propriedade name.

Verificar seu trabalho

  • No Visual Studio Code, na extensão de Bancos de Dados do Azure, você vê a conta, o banco de dados e o contêiner do Cosmos DB.
  • Ao expandir o nó do contêiner, você vê dois documentos.