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

A extensão do Azure Cosmos DB permite criar e gerenciar bancos de dados, contêineres e documentos do Cosmos DB no Visual Studio Code.

No cenário de exemplo, você deseja trabalhar no Visual Studio Code, como um ambiente de desenvolvimento para a criação de aplicativos e uma ferramenta para gerenciar seus bancos de dados do Cosmos DB.

Neste exercício, você instalará a extensão do Cosmos DB para Visual Studio Code. Em seguida, você usará a extensão para se conectar à sua conta do Azure e criar uma conta do Cosmos DB. Você adicionará um banco de dados e um contêiner para armazenar informações de notas dos cursos dos alunos na conta do Cosmos DB. Por fim, você criará alguns documentos de teste no contêiner e, em seguida, os exibirá e os atualizará.

Este exercício é executado no computador desktop e usa uma área restrita do Azure para seus recursos.

Observação

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

Instalar a extensão do Cosmos DB para Visual Studio Code

  1. Iniciar o Visual Studio Code. Clique em Continuar sem código

  2. No menu Extensões, na parte superior, clique em Gerenciar Extensões para abrir o painel de extensões.

  3. Na caixa Pesquisa, digite Azure Cosmos DB e pressione a tecla Enter.

  4. Na lista de extensões, selecione a extensão do Azure Cosmos DB publicada pela Microsoft e clique em Baixar. Instale o pacote quando o download terminar.

    Captura de tela do Visual Studio Code. O usuário selecionou a extensão do Azure Cosmos DB.

  5. Aguarde enquanto a extensão é instalada.

Criar uma conta do Cosmos DB

  1. No menu Exibir, selecione Paleta de Comandos.

  2. Na paleta de comandos, digite Azure e, em seguida, selecione Azure: Foco na Exibição do Cosmos DB.

    Captura de tela da paleta de comandos no Visual Studio Code. O usuário selecionou o comando Foco na Exibição do Cosmos DB.

    O painel do Azure Cosmos DB será exibido.

    Captura de tela do painel do Cosmos DB no Visual Studio Code.

  3. No painel do Cosmos DB clique em Entrar no Azure.

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

  5. Na barra de ferramentas acima do painel do Cosmos DB, clique em Criar Conta (o sinal de +).

    Captura de tela do painel do Cosmos DB no Visual Studio Code. O usuário selecionou o comando **Criar Conta**.

    Um assistente será iniciado para solicitar os detalhes da nova conta.

  6. Selecione Assinatura do Concierge no menu "Selecionar assinatura".

  7. Na caixa Nome da conta, insira o nome de uma conta. O nome precisa ser global e exclusivo. Sugerimos o uso de algo como <your name or initials>escola.

  8. Na lista Selecionar uma API para a sua conta do Cosmos DB, selecione SQL (DocumentDB).

  9. Na lista Selecionar um grupo de recursos para novos recursos, selecione [grupo de recursos de área restrita], o grupo de recursos criado para você pela área restrita do Learn.

  10. Na lista Selecionar uma localização para novos recursos, selecione uma localização perto de você.

  11. Aguarde enquanto a conta do Cosmos DB é criada. Isto pode levar alguns minutos.

  12. Quando a conta for criada, no painel do Cosmos DB, expanda a Assinatura do Concierge. Verifique se a nova conta do Cosmos DB é exibida em:

    Captura de tela do painel do Cosmos DB no Visual Studio Code. A nova conta do Cosmos DB é listada na conta do Azure do usuário.

Criar um banco de dados e um contêiner

  1. No painel do Cosmos DB, clique com o botão direito do mouse na conta do Cosmos DB que você criou e clique em Criar Banco de Dados.

    Captura de tela do painel do Cosmos DB no Visual Studio Code. O usuário selecionou o comando Criar Banco de Dados para a conta do Cosmos DB.

  2. Na caixa Nome do Banco de Dados digite SchoolDB e pressione Enter.

  3. Na caixa Insira uma ID para a coleção, insira StudentCourseGrades e, em seguida, pressione Enter.

  4. Na caixa Insira a chave de partição para a coleção, digite StudentNumber e, em seguida, pressione Enter.

    Esse contêiner armazenará os documentos de StudentCourseGrades. As notas dos cursos serão armazenadas como uma matriz de subdocumentos com cada aluno. Os dados serão particionados por ID do aluno.

  5. Na caixa Capacidade de taxa de transferência inicial, aceite o valor padrão de 1000 e, em seguida, pressione Enter.

  6. Verifique se o banco de dados SchoolDB que contém o contêiner StudentCourseGrades é exibido.

    Captura de tela do painel do Cosmos DB no Visual Studio Code mostrando o banco de dados SchoolDB e o contêiner StudentCourseGrades.

Criar e exibir documentos

  1. No painel do Cosmos DB, expanda o contêiner StudentCourseGrades. Duas subpastas deverão ser exibidas, chamadas Documentos e Procedimentos Armazenados.

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

    Captura de tela do painel do Cosmos DB no Visual Studio Code. O usuário selecionou o comando Criar Documento no contêiner StudentCourseGrades.

  3. Na caixa Insira uma ID do documento digite S101 e pressione Enter. Essa será a ID do documento de um aluno.

  4. Na caixa Insira um valor para a chave de partição, digite 101 e, em seguida, pressione Enter.

    O documento será criado e exibido no Visual Studio Code, em formato JSON. Os campos id e StudentNumber serão populados com os valores especificados. O documento também conterá outros campos que são adicionados automaticamente pelo Cosmos DB para uso interno próprio.

    Captura de tela do Visual Studio Code mostrando o documento recém-criado.

  5. No painel do Cosmos DB clique com o botão direito do mouse na pasta Documentos novamente e clique em Criar Documento.

  6. Na caixa Insira uma ID do documento, digite S102 e, em seguida, pressione Enter. Essa será a ID de outro aluno.

  7. Na caixa Insira um valor para a chave de partição, digite 102 e, em seguida, pressione Enter.

    O novo documento será exibido.

Editar documentos

  1. Na lista Documentos, selecione o documento S101.

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

  3. Adicione os campos a seguir ao documento. Não se esqueça de adicionar uma vírgula ao final de cada linha:

    "Forename": "AAA",
    "Lastname": "BBB",
    
  4. Clique com o botão direito do mouse em qualquer lugar do painel do documento e depois clique em Atualizar na Nuvem.

    Captura de tela do Visual Studio Code mostrando o documento editado. O aluno selecionou o comando Atualizar para Nuvem para salvar as alterações novamente no Cosmos DB.

    O documento será gravado novamente no Cosmos DB. A janela de log do Visual Studio Code será exibida. A mensagem final no log deverá ser semelhante ao seguinte exemplo:

    10:51:56: Updated entity "csschool (SQL)/SchoolDB/StudentCourseGrades/Documents/S101"
    
  5. Na lista Documentos, selecione o documento S102.

  6. Adicione os seguintes campos ao documento após o campo StudentNumber e, em seguida, salve o documento atualizado na nuvem:

    "Forename": "CCC",
    "Lastname": "DDD",
    
  7. Na lista Documentos, selecione o documento S101 novamente.

  8. Adicione o seguinte campo ao documento, após o campo Lastname:

    "CourseGrades": [
        {
            "Course": "Computer Science",
            "Grade": "A"
        },
        {
            "Course": "Applied Mathematics",
            "Grade": "B"
        }
    ],
    

    Esse é um campo de matriz que contém as notas de cada curso que o aluno fez. Cada par de campos Curso/Nota é um subdocumento. O uso de uma matriz possibilita registrar os detalhes de um número variável de cursos para cada aluno.

  9. Salve o documento atualizado na nuvem.

  10. Edite o documento S102, adicione os seguintes campos e salve o documento atualizado na nuvem:

    "CourseGrades": [
        {
            "Course": "Computer Science",
            "Grade": "C"
        }
    ],
    

    Esse aluno só fez o curso de ciência da computação.

Você acabou de usar a extensão do Cosmos DB no Visual Studio Code para criar um banco de dados e um contêiner do Cosmos DB. Você adicionou e exibiu documentos e editou esses documentos.