Trabalhar com os dados usando o Gerenciador de Armazenamento do AzureWork with data using Azure Storage Explorer

O uso do Azure Cosmos DB no Gerenciador de Armazenamento do Azure permite que os usuários gerenciem entidades do Azure Cosmos DB, manipulem dados, atualizem procedimentos armazenados e gatilhos junto com outras entidades do Azure, como os blobs de armazenamento e as filas.Using Azure Cosmos DB in Azure Storage Explorer enables users to manage Azure Cosmos DB entities, manipulate data, update stored procedures and triggers along with other Azure entities like Storage blobs and queues. Agora você pode usar a mesma ferramenta para gerenciar suas diferentes entidades do Azure em um único local.Now you can use the same tool to manage your different Azure entities in one place. Neste momento, o Gerenciador de Armazenamento do Microsoft Azure oferece suporte para contas do Cosmos, configuradas para SQL, MongoDB, Graph e APIs de Tabela.At this time, Azure Storage Explorer supports Cosmos accounts configured for SQL, MongoDB, Graph, and Table APIs.

Pré-requisitosPrerequisites

Uma conta do Cosmos com API SQL ou API do Azure Cosmos DB para MongoDB.A Cosmos account with SQL API or Azure Cosmos DB's API for MongoDB. Caso não tenha uma conta, você pode criar uma no Portal do Azure, conforme descrito em Azure Cosmos DB: Compilar um aplicativo Web da API com o .NET e com o Portal do Azure.If you don't have an account, you can create one in the Azure portal, as described in Azure Cosmos DB: Build a SQL API web app with .NET and the Azure portal.

InstalaçãoInstallation

Instale os bits mais recentes do Gerenciador de Armazenamento do Azure aqui: Gerenciador de Armazenamento do Azure, agora há suporte para a versão do Windows, Linux e MAC.Install the newest Azure Storage Explorer bits here: Azure Storage Explorer, now we support Windows, Linux, and MAC version.

Conectar-se a uma assinatura do AzureConnect to an Azure subscription

  1. Depois de instalar o Gerenciador de Armazenamento do Azure, clique no ícone de plug-in à esquerda, conforme mostrado na imagem a seguir:After installing the Azure Storage Explorer, click the plug-in icon on the left as shown in the following image:

    Ícone do plug-in

  2. Selecione Adicionar uma Conta do Azure e, em seguida, clique em Entrar.Select Add an Azure Account, and then click Sign-in.

    Conectar-se a uma assinatura do Azure

  3. Na caixa de diálogo Entrar no Azure, selecione Entrar e insira suas credenciais do Azure.In the Azure Sign in dialog box, select Sign in, and then enter your Azure credentials.

    Entrar

  4. Selecione sua assinatura na lista e, em seguida, clique em Aplicar.Select your subscription from the list and then click Apply.

    Aplicar

    O painel do Explorer atualiza e exibe as contas na assinatura selecionada.The Explorer pane updates and displays the accounts in the selected subscription.

    Lista de contas

    Você conectou sua Conta do Cosmos DB à sua assinatura do Azure com êxito.You have successfully connected to your Cosmos DB account to your Azure subscription.

Conectar-se ao Azure Cosmos DB usando uma cadeia de conexãoConnect to Azure Cosmos DB by using a connection string

Um modo alternativo de se conectar a um Azure Cosmos DB é usar uma cadeia de conexão.An alternative way of connecting to an Azure Cosmos DB is to use a connection string. Siga as etapas abaixo para se conectar usando uma cadeia de conexão.Use the following steps to connect using a connection string.

  1. Encontre a opção Local e Anexo na árvore à esquerda, clique com o botão direito do mouse em Contas do Cosmos DB e escolha Conectar-se ao Cosmos DB...Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB...

    Conectar-se ao Cosmos DB por uma cadeia de conexão

  2. Atualmente, só há suporte para API do SQL e de Tabela.Only support SQL and Table API currently. Escolha a API, cole a Cadeia de Conexão, insira o Rótulo de conta, clique em Próximo para verificar o resumo e depois clique em Conectar para conectar a conta do Azure Cosmos DB.Choose API, paste Connection String, input Account label, click Next to check the summary, and then click Connect to connect Azure Cosmos DB account. Para obter informações sobre como recuperar a cadeia de conexão primária, consulte obter a cadeia de conexão.For information on retrieving the primary connection string, see Get the connection string.

    Cadeia de conexão

Conectar-se ao Azure Cosmos DB usando um emulador localConnect to Azure Cosmos DB by using local emulator

Use as seguintes etapas para se conectar a um Azure Cosmos DB pelo Emulador. Atualmente, só há suporte para conta do SQL.Use the following steps to connect to an Azure Cosmos DB by Emulator, only support SQL account currently.

  1. Instale o emulador e inicialize-o.Install Emulator and launch. Para saber como instalar o emulador, consulte Emulador Cosmos DBFor how to install Emulator, see Cosmos DB Emulator

  2. Encontre a opção Local e Anexo na árvore à esquerda, clique com o botão direito do mouse em Contas do Cosmos DB e escolha Conectar-se ao Emulador Cosmos DB...Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB Emulator...

    Conecte-se ao Cosmos DB pelo emulador

  3. Atualmente, só há suporte para API do SQL.Only support SQL API currently. Cole a Cadeia de Conexão, insira o Rótulo de conta, clique em Próximo para verificar o resumo e depois clique em Conectar para conectar a conta do Azure Cosmos DB.Paste Connection String, input Account label, click Next to check the summary, and then click Connect to connect Azure Cosmos DB account. Para obter informações sobre como recuperar a cadeia de conexão primária, consulte obter a cadeia de conexão.For information on retrieving the primary connection string, see Get the connection string.

    Conecte-se ao Cosmos DB pelo diálogo do emulador

Gerenciamento de recursos do Azure Cosmos DBAzure Cosmos DB resource management

Você pode gerenciar uma conta do Azure Cosmos DB seguindo as operações a seguir:You can manage an Azure Cosmos DB account by doing following operations:

  • Abra a conta no Portal do AzureOpen the account in the Azure portal
  • Adicione o recurso à lista de Acesso RápidoAdd the resource to the Quick Access list
  • Pesquise e atualize os recursosSearch and refresh resources
  • Criar e excluir bancos de dadosCreate and delete databases
  • Criar e excluir coleçõesCreate and delete collections
  • Crie, edite, exclua e filtre documentosCreate, edit, delete, and filter documents
  • Gerencie procedimentos armazenados, gatilhos e funções definidas pelo usuárioManage stored procedures, triggers, and user-defined functions

Tarefas de acesso rápidoQuick access tasks

Ao clicar com o botão direito do mouse em uma assinatura no painel do Explorer, você poderá executar várias tarefas de ação rápida:By right-clicking on a subscription in the Explorer pane, you can perform many quick action tasks:

  • Clique com o botão direito do mouse em uma conta ou banco de dados do Azure Cosmos DB. Você pode escolher a opção Abrir no Portal e gerenciar o recurso no navegador do Portal do Azure.Right-click an Azure Cosmos DB account or a database, you can choose Open in Portal and manage the resource in the browser on the Azure portal.

    Abrir no portal

  • Você também pode adicionar a conta, o banco de dados e a coleção do Azure Cosmos DB no Acesso Rápido.You can also add Azure Cosmos DB account, database, collection to Quick Access.

  • A opção Pesquisar daqui habilita a pesquisa de palavra-chave no caminho selecionado.Search from Here enables keyword search under the selected path.

    Pesquisar daqui

Gerenciamento de banco de dados e coleçãoDatabase and collection management

Criar um banco de dadosCreate a database

  • Clique com o botão direito do mouse na conta do Azure Cosmos DB, escolha Criar Banco de Dados, insira o nome do banco de dados e pressione Enter para concluir.Right-click the Azure Cosmos DB account, choose Create Database, input the database name, and press Enter to complete.

    Criar banco de dados

Excluir um banco de dadosDelete a database

  • Clique com o botão direito do mouse no banco de dados, clique em Excluir Banco de Dados e em Sim na janela pop-up.Right-click the database, click Delete Database, and click Yes in the pop-up window. O nó do banco de dados é excluído e a conta do Azure Cosmos DB é atualizada automaticamente.The database node is deleted, and the Azure Cosmos DB account refreshes automatically.

    Excluir database1

    Excluir database2

Criar uma coleçãoCreate a collection

  1. Clique com o botão direito do mouse no banco de dados, escolha criar coleçãoe forneça as informações a seguir, como ID da coleção, capacidade de armazenamento, etc. Clique em OK para concluir.Right-click your database, choose Create Collection, and then provide the following information like Collection ID, Storage capacity, etc. Click OK to finish.

    Criar collection1

    Criar collection2

  2. Selecione Unlimited para ser capaz de especificar a chave de partição, depois clique em OK para concluir.Select Unlimited to be able to specify partition key, then click OK to finish.

    Se uma chave de partição for usada ao criar uma coleção, depois que a criação for concluída, o valor da chave de partição não poderá ser alterado na coleção.If a partition key is used when creating a collection, once creation is completed, the partition key value can't be changed on the collection.

    Chave de partição

Excluir uma coleçãoDelete a collection

  • Clique com o botão direito do mouse na coleção, clique em Excluir Coleção e, em seguida, clique em Sim na janela pop-up.Right-click the collection, click Delete Collection, and then click Yes in the pop-up window.

    O nó da coleção é excluído e o banco de dados é atualizado automaticamente.The collection node is deleted, and the database refreshes automatically.

    Excluir coleção

Gerenciamento de documentosDocument management

Criar e modificar documentosCreate and modify documents

  • Para criar um novo documento, abra Documentos na janela esquerda, clique em Novo Documento, edite o conteúdo no painel direito e clique em Salvar.To create a new document, open Documents in the left window, click New Document, edit the contents in the right pane, then click Save. Você também pode atualizar um documento existente e, em seguida, clicar em Salvar.You can also update an existing document, and then click Save. As alterações podem ser descartadas clicando em Descartar.Changes can be discarded by clicking Discard.

    Documento

Excluir um documentoDelete a document

  • Clique no botão Excluir para excluir o documento selecionado.Click the Delete button to delete the selected document.

Consulta de documentosQuery for documents

  • Edite o filtro de documentos inserindo uma Consulta SQL e, em seguida, clique em Aplicar.Edit the document filter by entering a SQL query and then click Apply.

    Filtro de documentos

Gerenciamento de gráficoGraph management

Criar e modificar vérticeCreate and modify vertex

  1. Para criar um novo vértice, abra o Gráfico na janela esquerda, clique em Novo vértice, edite o conteúdo e clique em OK.To create a new vertex, open Graph from the left window, click New Vertex, edit the contents, then click OK.

  2. Para modificar um vértice existente, clique no ícone de caneta no painel direito.To modify an existing vertex, click the pen icon in the right pane.

    Graph

Excluir um gráficoDelete a graph

  • Para excluir um vértice, clique no ícone de lixeira ao lado do nome do vértice.To delete a vertex, click the recycle bin icon beside the vertex name.

Filtro para gráficosFilter for graph

  • Edite o filtro de gráficos inserindo uma consulta gremlin, depois clique em Aplicar Filtro.Edit the graph filter by entering a gremlin query and then click Apply Filter.

    Filtro do gráfico

Gerenciamento de tabelaTable management

Criar e modificar tabelaCreate and modify table

  1. Para criar uma nova tabela, abra Entidades na janela esquerda, clique em Adicionar, edite o conteúdo na caixa de diálogo Adicionar entidade, adicione a propriedade clicando no botão Adicionar Propriedade, em seguida, clique em Inserir.To create a new table, open Entities from the left window, click Add, edit the content in Add Entity dialog, add property by clicking button Add Property, then click Insert.

  2. Para modificar uma tabela, clique em Editar, modifique o conteúdo e clique em Atualizar.To modify a table, click Edit, modify the content, then click Update.

    Tabela

Importar e exportar tabelaImport and export table

  1. Para importar, clique no botão Importar e escolha uma tabela existente.To import, click Import button and choose an existing table.

  2. Para exportar, clique no botão Exportar e escolha uma tabela existente.To export, click Export button and choose a destination.

    Importação e exportação de tabela

Excluir entidadesDelete entities

  • Selecione as entidades e clique no botão Excluir.Select the entities and click button Delete.

    Exclusão de tabela

Tabela de consultaQuery table

  • Clique no botão Consulta, insira a condição de consulta e clique no botão Executar consulta.Click Query button, input query condition, then click Execute Query button. Feche o painel de consulta clicando no botão Fechar consulta.Close Query pane by clicking Close Query button.

    Consulta de tabela

Gerenciar procedimentos armazenados, gatilhos e UDFsManage stored procedures, triggers, and UDFs

  • Para criar um procedimento armazenado, na árvore à esquerda, clique com botão direito do mouse em Procedimento Armazenado, escolha Criar Procedimento Armazenado, insira um nome à esquerda, digite os scripts do procedimento armazenado na janela à direita e, em seguida, clique em Criar.To create a stored procedure, in the left tree, right-click Stored Procedure, choose Create Stored Procedure, enter a name in the left, type the stored procedure scripts in the right window, and then click Create.

  • Você também pode editar os procedimentos armazenados existentes ao clicar neles duas vezes, fazer a atualização e, em seguida, clicar em Atualizar para salvar ou clicar em Descartar para cancelar a alteração.You can also edit existing stored procedures by double-clicking, making the update, and then clicking Update to save, or click Discard to cancel the change.

    Procedimento armazenado

  • As operações para Gatilhos e UDF são semelhantes aos Procedimentos Armazenados.The operations for Triggers and UDF are similar with Stored Procedures.

Solução de ProblemasTroubleshooting

Azure Cosmos DB no Gerenciador de Armazenamento é um aplicativo autônomo que permite que você se conecte a contas do Azure Cosmos DB hospedadas nas nuvens do Azure e soberanas do Windows, do macOS ou do Linux.Azure Cosmos DB in Azure Storage Explorer is a standalone app that allows you to connect to Azure Cosmos DB accounts hosted on Azure and Sovereign Clouds from Windows, macOS, or Linux. Ele permite a você gerenciar entidades do Azure Cosmos DB, manipular dados, atualizar procedimentos armazenados e gatilhos junto com outras entidades do Azure, como blobs e filas do Armazenamento.It enables you to manage Azure Cosmos DB entities, manipulate data, update stored procedures and triggers along with other Azure entities like Storage blobs and queues.

Estas são as soluções de problemas comuns do Azure Cosmos DB encontradas no Gerenciador de Armazenamento.These are solutions for common issues seen for Azure Cosmos DB in Storage Explorer.

Problemas de entradaSign in issues

Antes de continuar, tente reiniciar o aplicativo e ver se os problemas podem ser corrigidos.Before proceeding further, try restarting your application and see if the problems can be fixed.

Certificado autoassinado na cadeia confiávelSelf-signed certificate in certificate chain

Há alguns motivos que podem exibir esse erro. Os dois mais comuns são:There are a few reasons you may be seeing this error, the two most common ones are:

  • Você está por trás de um proxy transparente, o que significa que alguém (por exemplo, o departamento de TI) está interceptando o tráfego HTTPS, descriptografando-o e criptografando-o usando um certificado autoassinado.You're behind a transparent proxy, which means someone (such as your IT department) is intercepting HTTPS traffic, decrypting it, and then encrypting it using a self-signed certificate.

  • Você está executando software, por exemplo, um software antivírus, que está injetando certificados SSL autoassinados nas mensagens HTTPS recebidas.You're running software, such as anti-virus software, which is injecting a self-signed SSL certificates into the HTTPS messages you receive.

Quando o Gerenciador de Armazenamento encontrar um desses "certificados autoassinados", ele pode não saber se a mensagem HTTPS recebida foi adulterada.When Storage Explorer encounters one of these "self-signed certificates", it can no longer know if the HTTPS message it's receiving has been tampered with. No entanto, se você tiver uma cópia do certificado autoassinado, poderá ordenar o Gerenciador de Armazenamento para confiar nele.If you have a copy of the self-signed certificate though, then you can tell Storage Explorer to trust it. Se você não tiver certeza de quem está injetando o certificado, tente localizá-lo por conta própria seguindo as etapas abaixo:If you're unsure of who is injecting the certificate, then you can try to find it yourself by doing the following steps:

  1. Instalar o Open SSLInstall Open SSL
    • Windows (qualquer uma das versões leves serve)Windows (any of the light versions is ok)
    • Mac e Linux: deve estar incluído com o sistema operacionalMac and Linux: Should be included with your operating system
  2. Executar Open SSLRun Open SSL
    • Windows: vá para o diretório de instalação; em seguida, para /bin/ e clique duas vezes em openssl.exe.Windows: Go to the install directory, then /bin/, then double-click on openssl.exe.
    • Mac e Linux: execute openssl em um terminalMac and Linux: execute openssl from a terminal
  3. Execute s_client -showcerts -connect microsoft.com:443Execute s_client -showcerts -connect microsoft.com:443
  4. Procurar certificados autoassinados.Look for self-signed certificates. Se você não tiver certeza quais são autoassinados, procure onde o assunto ("s") e o emissor ("i") são os mesmos.If you're unsure, which are self-signed, then look for anywhere the subject ("s:") and issuer ("i:") are the same.
  5. Depois de encontrar os certificados autoassinados, copie e cole tudo desde, e incluindo, ---BEGIN CERTIFICATE--- até ---END CERTIFICATE--- em um novo arquivo .cer para cada um.Once you have found any self-signed certificates, copy and paste everything from and including -----BEGIN CERTIFICATE----- to -----END CERTIFICATE----- to a new .cer file for each one.
  6. Abra o Gerenciador de Armazenamento e vá para Editar > Certificados SSL > Importar Certificados.Open Storage Explorer and then go to Edit > SSL Certificates > Import Certificates. Usando o seletor de arquivos, encontre, selecione e abra os arquivos .cer criados.Using the file picker, find, select, and open the .cer files you created.

Se você não conseguir localizar todos os certificados autoassinados usando as etapas acima, envie comentários para obter mais ajuda.If you're unable to find any self-signed certificates using the above steps, could send feedback for more help.

Não é possível recuperar as assinaturasUnable to retrieve subscriptions

Se não for possível recuperar suas assinaturas depois de entrar com êxito:If you're unable to retrieve your subscriptions after you successfully signed in:

  • Verifique se sua conta tem acesso às assinaturas entrando no Portal do AzureVerify your account has access to the subscriptions by signing into the Azure Portal
  • Verifique se você entrou usando o ambiente certo (Azure, Azure China, Azure Alemanha, Azure US Government ou Ambiente Personalizado/Azure Stack)Make sure you have signed in using the correct environment (Azure, Azure China, Azure Germany, Azure US Government, or Custom Environment/Azure Stack)
  • Se você estiver atrás de um proxy, verifique se configurou o proxy do Gerenciador de Armazenamento apropriadamenteIf you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Tentar remover e readicionar a contaTry removing and readding the account
  • Tente excluir os seguintes arquivos do diretório inicial (por exemplo,C:\Users\ContosoUser) e adicione a conta novamente:Try deleting the following files from your home directory (such as: C:\Users\ContosoUser), and then readding the account:
    • .adalcache.adalcache
    • .devaccounts.devaccounts
    • .extaccounts.extaccounts
  • Veja se aparecem mensagens de erro no console de ferramentas de desenvolvedor (F12) ao entrarWatch the developer tools console (f12) while signing in for any error messages

console

Não é possível ver a página de autenticaçãoUnable to see the authentication page

Se você não conseguir ver a página de autenticação:If you're unable to see the authentication page:

  • Dependendo da velocidade de sua conexão, talvez demore algum tempo para a página de entrada carregar. Aguarde pelo menos um minuto antes de fechar o diálogo de autenticaçãoDepending on the speed of your connection, it may take a while for the sign-in page to load, wait at least one minute before closing the authentication dialog
  • Se você estiver atrás de um proxy, verifique se configurou o proxy do Gerenciador de Armazenamento apropriadamenteIf you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Exiba o console do desenvolvedor pressionando a tecla F12.Bring up the developer console by pressing F12 key. Veja as respostas no console do desenvolvedor e tente encontrar alguma dica do motivo do não funcionamento da autenticaçãoWatch the responses from developer console and see if you can find any clue for why authentication is not working

Não é possível remover a contaCannot remove account

Se você não conseguir remover uma conta, ou se o link de nova autenticação não fizer nadaIf you're unable to remove an account, or if the reauthenticate link does not do anything

  • Tente excluir os seguintes arquivos do diretório inicial e adicione a conta novamente:Try deleting the following files from your home directory, and then readding the account:
    • .adalcache.adalcache
    • .devaccounts.devaccounts
    • .extaccounts.extaccounts
  • Se você quiser remover SAS associado a recursos de Armazenamento, exclua:If you want to remove SAS attached Storage resources, delete:
    • Pasta %AppData%/StorageExplorer para Windows%AppData%/StorageExplorer folder for Windows
    • /Usuários/<seu_nome>/Library/Application SUpport/StorageExplorer para Mac/Users/<your_name>/Library/Application SUpport/StorageExplorer for Mac
    • ~/.config/StorageExplorer para Linux~/.config/StorageExplorer for Linux
    • Será necessário reinserir todas as suas credenciais se você excluir esses arquivosYou will have to reenter all your credentials if you delete these files

Problema de proxy HTTP/HTTPSHttp/Https proxy issue

Não é possível listar os nós do Azure Cosmos DB na árvore à esquerda na hora de configurar o proxy HTTP/HTTPS no ASE.You cannot list Azure Cosmos DB nodes in left tree when configuring http/https proxy in ASE. Esse é um problema conhecido e será corrigido na próxima versão.It's a known issue, and will be fixed in next release. Você pode usar o Data Explorer do Azure Cosmos DB no Portal do Azure como uma solução alternativa no momento.You could use Azure Cosmos DB data explorer in Azure portal as a work-around at this moment.

Problema de nó "Desenvolvimento" em "Local e Anexado""Development" node under "Local and Attached" node issue

Não há nenhuma resposta depois de clicar no nó "Desenvolvimento" no nó "Local e Anexado" na árvore à esquerda.There is no response after clicking the "Development" node under "Local and Attached" node in left tree. O comportamento é esperado.The behavior is expected. O emulador de local do Azure Cosmos DB terá suporte a partir da próxima versão.Azure Cosmos DB local emulator will be supported in next release.

Nó de desenvolvimento

Erro de anexação de conta do Azure Cosmos DB ao nó "Local e Anexado"Attaching Azure Cosmos DB account in "Local and Attached" node error

Se você vir o erro abaixo depois de anexar a conta do Azure Cosmos DB ao nó "Local e Anexado", verifique se você está usando a cadeia de conexão certa.If you see below error after attaching Azure Cosmos DB account in "Local and Attached" node, then check if you're using the right connection string.

Erro de anexação do Azure Cosmos DB a "Local e Anexado"

Erro de expansão do nó do Azure Cosmos DBExpand Azure Cosmos DB node error

Você pode ver o erro abaixo ao tentar expandir os nós da árvore à esquerda.You may see below error while trying to expand the tree nodes in left.

Erro de expansão

Tente as seguintes sugestões:Try the following suggestions:

  • Verifique se a conta do Azure Cosmos DB está sendo provisionada e tente novamente quando a conta for criada com êxito.Check if the Azure Cosmos DB account is in provision progress and try again when the account is being created successfully.
  • Se a conta estiver no nó "Acesso Rápido" ou "Local e Anexado", verifique se a conta foi excluída.If the account is under "Quick Access" node or "Local and Attached" nodes, then check if the account has been deleted. Nesse caso, você precisará remover o nó manualmente.If so, you need to remove the node manually.

Contate-nosContact us

Se nenhuma das soluções funcionar, envie um email à equipe das Ferramentas de Desenvolvimento do Azure Cosmos DB (cosmosdbtooling@microsoft.com) com detalhes sobre o problema, para que possa ser corrigido.If none of the solutions work for you, send email to Azure Cosmos DB Dev Tooling Team (cosmosdbtooling@microsoft.com) with details about the issue, for fixing the issues.

Próximos passosNext steps