Trabalhar com os dados usando o Azure Cosmos DB Explorer

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Table

O Azure Cosmos DB Explorer é uma interface baseada na Web autônoma que permite exibir e gerenciar os dados armazenados no Azure Cosmos DB. O Azure Cosmos DB Explorer é equivalente à guia Data Explorer existente disponível no portal do Azure quando você cria uma conta do Azure Cosmos DB. As principais vantagens do Azure Cosmos DB Explorer sobre o Data Explorer existente são:

  • Você tem um estado real de tela inteira para exibir os dados, executar consultas, procedimentos armazenados, gatilhos e exibir os resultados.

  • Você pode fornecer acesso temporário ou permanente de leitura ou leitura/gravação à conta do banco de dados e coleções para outros usuários que não tenham acesso à assinatura ou portal do Azure.

  • Você pode compartilhar os resultados da consulta com outros usuários que não tenham acesso à assinatura ou portal do Azure.

Acessar o Azure Cosmos DB Explorer

  1. Entre no Portal do Azure.

  2. Em Todos os recursos, localize e navegue até a conta do Azure Cosmos DB, selecione Chaves e copie a Cadeia de Conexão Primária.

  3. Vá para https://cosmos.azure.com/, cole a cadeia de conexão e selecione Conectar. Usando a cadeia de conexão, é possível acessar o Azure Cosmos DB Explorer sem quaisquer limites de tempo.

    Se quiser fornecer a outros usuários o acesso temporário à sua conta do Azure Cosmos DB, você poderá fazer isso usando as URLs de acesso de leitura e leitura/gravação.

  4. Abra a folha Data Explorer, selecione Abrir Modo de Exibição de Tela Inteira. Na caixa de diálogo pop-up, é possível exibir duas URLs de acesso – Leitura/Gravação e Leitura. Essas URLs permitem que você compartilhe a conta do Azure Cosmos DB temporariamente com outros usuários. O acesso à conta expira em 24 horas, após esse período será possível conectar novamente usando uma nova URL de acesso ou a cadeia de conexão.

    Leitura/Gravação – Ao compartilhar a URL de leitura/gravação com outros usuários, eles poderão exibir e modificar os bancos de dados, as coleções, consultas e outros recursos associados a essa conta específica.

    Leitura - Ao compartilhar a URL somente leitura com outros usuários, eles poderão exibir os bancos de dados, as coleções, consultas e outros recursos associados a essa conta específica. Por exemplo, se quiser compartilhar os resultados de uma consulta com os colegas de equipe que não tenham acesso ao portal do Azure ou à conta do Azure Cosmos DB, forneça essa URL aos colegas.

    Escolha o tipo de acesso com o qual gostaria de abrir a conta e clique em Abrir. Após abrir o gerenciador, a experiência é a mesma que você tinha com a guia Data Explorer no portal do Azure.

    Abrir o Azure Cosmos DB Explorer

Problemas conhecidos

Atualmente, a experiência de Abrir Modo de Exibição de Tela Inteira que permite compartilhar acesso de leitura ou leitura/gravação temporário ainda não tem suporte para contas da API do Azure Cosmos DB for Gremlin e for Table. Ainda é possível exibir as contas do Gremlin e da API for Table passando a cadeia de conexão para o Azure Cosmos DB Explorer.

No momento, não há suporte no Data Explorer para a exibição de documentos que contenham um UUID. Isso não afeta o carregamento de coleções, apenas a exibição de documentos individuais ou consultas que incluam esses documentos. Para exibir e gerenciar esses documentos, os usuários deverão continuar a usar a ferramenta que foi usada originalmente para criar esses documentos.

Pode ser que quando os clientes recebem erros HTTP-401, isso se deve a permissões insuficientes do RBAC do Azure para a conta do Azure do cliente, especialmente se a conta tiver uma função personalizada. Qualquer função personalizada deve ter a ação Microsoft.DocumentDB/databaseAccounts/listKeys/* para usar o Data Explorer se estiver entrando usando suas credenciais do Azure Active Directory.

Próximas etapas

Agora que você aprendeu como começar a usar o Azure Cosmos DB Explorer para gerenciar os dados, em seguida, poderá: