Trabalhar com dados com o Explorador de Armazenamento do AzureWork with data using Azure Storage Explorer

A utilização do Azure Cosmos DB no Explorador de Armazenamento do Azure permite aos utilizadores gerir as entidades do Azure Cosmos DB, manipular dados, atualizar os procedimentos e acionadores armazenados, bem como outras entidades do Azure, como blobs e filas de Armazenamento.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, pode utilizar a mesma ferramenta para gerir as diferentes entidades do Azure num único local.Now you can use the same tool to manage your different Azure entities in one place. Neste momento, o Azure Storage Explorer suporta contas Cosmos configuradas para APIs SQL, MongoDB, Graph e Table.At this time, Azure Storage Explorer supports Cosmos accounts configured for SQL, MongoDB, Graph, and Table APIs.

Pré-requisitosPrerequisites

Uma conta cosmos com API SQL API ou Azure Cosmos DB para MongoDB.A Cosmos account with SQL API or Azure Cosmos DB's API for MongoDB. Se não tiver uma conta, pode criar uma no portal do Azure, conforme descrito em Azure Cosmos DB: criar uma aplicação Web da SQL API com .NET e 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 Explorador de Armazenamento do Azure aqui: Explorador de Armazenamento do Azure, suportamos agora a versão para Windows, Linux e MAC.Install the newest Azure Storage Explorer bits here: Azure Storage Explorer, now we support Windows, Linux, and MAC version.

Ligar a uma subscrição do AzureConnect to an Azure subscription

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

    Ícone de plug-in

  2. Selecione Adicionar uma Conta do Azure e clique em Iniciar sessão.Select Add an Azure Account, and then click Sign-in.

    Ligar a uma subscrição do Azure

  3. Na caixa de diálogo Início de sessão do Azure, selecione Iniciar sessão e, em seguida, introduza as credenciais do Azure.In the Azure Sign in dialog box, select Sign in, and then enter your Azure credentials.

    Iniciar sessão

  4. Selecione a sua subscrição na lista e clique em Aplicar.Select your subscription from the list and then click Apply.

    Aplicar

    O painel do Explorador atualiza e apresenta as contas na subscrição selecionada.The Explorer pane updates and displays the accounts in the selected subscription.

    Lista de contas

    Ligou com êxito a conta do Cosmos DB à subscrição do Azure.You have successfully connected to your Cosmos DB account to your Azure subscription.

Ligar ao Azure Cosmos DB através de uma cadeia de ligaçãoConnect to Azure Cosmos DB by using a connection string

Uma forma alternativa de ligar ao Azure Cosmos DB é utilizar uma cadeia de ligação.An alternative way of connecting to an Azure Cosmos DB is to use a connection string. Utilize os seguintes passos para ligar através de uma cadeia de ligação.Use the following steps to connect using a connection string.

  1. Localize Local e Ligada na árvore à esquerda, clique com o botão direito do rato em Contas do Cosmos DB e selecione Ligar ao Cosmos DB...Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB...

    Ligar ao Cosmos DB através de uma cadeia de ligação

  2. Atualmente, apenas suporta a API do SQL e de Tabela.Only support SQL and Table API currently. Escolha a API, cole a Cadeia de Ligação, introduza a Etiqueta de conta, clique em Seguinte para verificar o resumo e, em seguida, clique em Ligar para ligar 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 a recuperação da cadeia de ligação primária, consulte Obter a corda de ligação.For information on retrieving the primary connection string, see Get the connection string.

    Connection-string

Ligar ao Azure Cosmos DB através de um emulador localConnect to Azure Cosmos DB by using local emulator

Utilize os seguintes passos para ligar ao Azure Cosmos DB pelo Emulador, só suporta atualmente a conta de SQL.Use the following steps to connect to an Azure Cosmos DB by Emulator, only support SQL account currently.

  1. Instale o Emulador e inicie.Install Emulator and launch. Para saber como instalar o Emulador, veja Emulador do Cosmos DBFor how to install Emulator, see Cosmos DB Emulator

  2. Localize Local e Ligada na árvore à esquerda, clique com o botão direito do rato em Contas do Cosmos DB e selecione Ligar ao Emulador do Cosmos DB...Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB Emulator...

    Ligar ao Cosmos DB pelo Emulador

  3. Atualmente, apenas suporta a API do SQL.Only support SQL API currently. Cole a Cadeia de Ligação, introduza a Etiqueta de conta, clique em Seguinte para verificar o resumo e, em seguida, clique em Ligar para ligar 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 a recuperação da cadeia de ligação primária, consulte Obter a corda de ligação.For information on retrieving the primary connection string, see Get the connection string.

    Ligar ao Cosmos DB através da caixa de diálogo Emulador

Gestão de recursos do Azure Cosmos DBAzure Cosmos DB resource management

Pode gerir uma conta do Azure Cosmos DB ao efetuar as seguintes operações: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
  • Procure e atualize os recursosSearch and refresh resources
  • Criar e eliminar bases de dadosCreate and delete databases
  • Criar e eliminar coleçõesCreate and delete collections
  • Crie, edite, elimine e filtre documentosCreate, edit, delete, and filter documents
  • Faça a gestão de procedimentos armazenados, acionadores e funções definidas pelo utilizadorManage stored procedures, triggers, and user-defined functions

Tarefas de acesso rápidoQuick access tasks

Ao clicar com o botão direito do rato numa subscrição no painel do Explorador, pode efetuar muitas 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 rato numa conta do Azure Cosmos DB ou numa base de dados, selecione Abrir no Portal e faça a gestão dos recursos no browser no 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

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

  • Procurar a partir daqui permite procurar por palavra-chave no caminho selecionado.Search from Here enables keyword search under the selected path.

    procurar a partir daqui

Gestão de bases de dados e coleçõesDatabase and collection management

Criar uma base de dadosCreate a database

  • Clique com o botão direito do rato na conta do Azure Cosmos DB, selecione Criar Base de Dados, introduza o nome da base de dados e prima Enter para concluir.Right-click the Azure Cosmos DB account, choose Create Database, input the database name, and press Enter to complete.

    Criar base de dados

Eliminar uma base de dadosDelete a database

  • Clique com o botão direito do rato na base de dados, clique em Eliminar Base de Dados e em Sim na janela de pop-up.Right-click the database, click Delete Database, and click Yes in the pop-up window. O nó da base de dados é eliminado e a conta do Azure Cosmos DB é atualizada automaticamente.The database node is deleted, and the Azure Cosmos DB account refreshes automatically.

    Eliminar base de dados1

    Eliminar base de dados2

Criar uma coleçãoCreate a collection

  1. Clique na sua base de dados, escolha Criar Coleção, e em seguida, forneça as seguintes informações como Id de Recolha, Capacidade de Armazenamento, etc. Clique em OK para terminar.Right-click your database, choose Create Collection, and then provide the following information like Collection ID, Storage capacity, etc. Click OK to finish.

    Criar coleção1

    Criar coleção2

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

    Se for utilizada uma chave de partição quando criar uma coleção, depois de concluída a criação, o valor da chave de partição não pode 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

Eliminar uma coleçãoDelete a collection

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

    O nó da coleção é eliminado e a base de dados é atualizada automaticamente.The collection node is deleted, and the database refreshes automatically.

    Eliminar coleção

Gestão 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, em seguida, clique em Guardar.To create a new document, open Documents in the left window, click New Document, edit the contents in the right pane, then click Save. Também pode atualizar um documento existente e, em seguida, clicar em Guardar.You can also update an existing document, and then click Save. As alterações podem ser eliminadas ao clicar em Eliminar.Changes can be discarded by clicking Discard.

    Documento

Eliminar um documentoDelete a document

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

Consulta de documentosQuery for documents

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

    Filtro de Documento

Gestão de gráficosGraph management

Criar e modificar um vérticeCreate and modify vertex

  1. Para criar um novo vértice, abra o Graph na janela esquerda, clique em Vértice Novo, 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

Eliminar um gráficoDelete a graph

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

Filtro para gráficoFilter for graph

  • Edite o filtro de gráfico ao introduzir uma consulta gremlin e, em seguida, clique em Aplicar Filtro.Edit the graph filter by entering a gremlin query and then click Apply Filter.

    Filtro de Gráfico

Gestão de tabelasTable 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 ao clicar no botão Adicionar Propriedade e 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 um destino.To export, click Export button and choose a destination.

    Importação e Exportação de Tabela

Eliminar entidadesDelete entities

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

    Eliminação da tabela

Tabela de consultaQuery table

  • Clique no botão Consulta, introduza 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, ao clicar no botão Fechar Consulta.Close Query pane by clicking Close Query button.

    Consulta de Tabela

Gerir procedimentos armazenados, acionadores e UDFsManage stored procedures, triggers, and UDFs

  • Para criar um procedimento armazenado, na árvore à esquerda, clique com o botão direito do rato em Procedimento Armazenado, selecione Criar Procedimento Armazenado, introduza um nome à esquerda, escreva 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.

  • Também pode editar procedimentos armazenados existentes ao fazer duplo clique, ao efetuar a atualização e, em seguida, ao clicar em Atualizar para guardar ou em Eliminar 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 de Acionadores e UDF são semelhantes às dos Procedimentos Armazenados.The operations for Triggers and UDF are similar with Stored Procedures.

Resolução de problemasTroubleshooting

O Azure Cosmos DB no Explorador de armazenamento do Azure é uma aplicação autónoma que permite ligar a contas do Azure Cosmos DB alojadas no Azure e Clouds Soberanas do Windows, macOS ou 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. Permite aos utilizadores gerir as entidades do Azure Cosmos DB, manipular dados, atualizar os procedimentos e acionadores armazenados, bem como outras entidades do Azure, como blobs e filas de 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.

São soluções para problemas comuns detetados para o Azure Cosmos DB no Explorador de Armazenamento.These are solutions for common issues seen for Azure Cosmos DB in Storage Explorer.

Problemas de início de sessãoSign in issues

Antes de prosseguir, tente reiniciar a aplicação e verifique 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 de certificadosSelf-signed certificate in certificate chain

Existem algumas razões pelas quais pode estar a ver este erro, sendo as duas mais comuns:There are a few reasons you may be seeing this error, the two most common ones are:

  • Está por detrás de um proxy transparente, o que significa que alguém (como o seu departamento de TI) está a intercetar o tráfego HTTPS, desencriptando-o e, em seguida, encriptando-o usando um certificado auto-assinado.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.

  • Está a executar software, como software antivírus, que está a injetar um certificado TLS/SSL auto-assinado nas mensagens HTTPS que recebe.You're running software, such as anti-virus software, which is injecting a self-signed TLS/SSL certificates into the HTTPS messages you receive.

Quando o Explorador de Armazenamento encontra um destes "certificados autoassinados", já não consegue saber se a mensagem HTTPS que está a receber 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 tiver uma cópia do certificado autoassinado, pode indicar ao Explorador de Armazenamento para confiar no mesmo.If you have a copy of the self-signed certificate though, then you can tell Storage Explorer to trust it. Se não tiver a certeza de quem está a injetar o certificado, pode tentar descobrir através dos seguintes passos: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 opensslInstall OpenSSL
    • Windows (qualquer uma das versões simples)Windows (any of the light versions is ok)
    • Mac e Linux: devem estar incluídos no sistema operativoMac and Linux: Should be included with your operating system
  2. Run OpenSSLRun OpenSSL
    • Windows: aceda ao diretório de instalação, a /bin/ e faça duplo clique em openssl.exe.Windows: Go to the install directory, then /bin/, then double-click on openssl.exe.
    • Mac e Linux: execute openssl a partir de 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. Procure certificados autoassinados.Look for self-signed certificates. Se não tiver a certeza de quais são autoassinados, verifique se 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 certificados autoassinados, copie e cole tudo entre -----BEGIN CERTIFICATE----- e -----END CERTIFICATE----- num novo ficheiro .cer para cada um deles.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. Open Storage Explorer e, em seguida, ir para Editar > Certificados SSL > Import Certificates.Open Storage Explorer and then go to Edit > SSL Certificates > Import Certificates. Com o seletor de ficheiros, procure, selecione e abra os ficheiros .cer que criou.Using the file picker, find, select, and open the .cer files you created.

Se não conseguir encontrar nenhum certificado autoassinado com os passos acima, pode enviar 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 obter subscriçõesUnable to retrieve subscriptions

Se não conseguir obter as suas subscrições depois de iniciar sessão com êxito:If you're unable to retrieve your subscriptions after you successfully signed in:

  • Certifique-se de que a conta tem acesso às subscrições ao iniciar sessão no Portal do AzureVerify your account has access to the subscriptions by signing into the Azure Portal
  • Certifique-se de que tem sessão iniciada no ambiente correto (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 estiver por trás de um proxy, certifique-se de que configurou o proxy do Explorador de Armazenamento corretamenteIf you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Tente remover e adicionar novamente a contaTry removing and readding the account
  • Tente eliminar os seguintes ficheiros do diretório raiz (como: C:\Users\ContosoUser) e, em seguida, adicionar novamente a conta: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
  • Ver mensagens de erro na consola das ferramentas de programação (f12) ao iniciar sessãoWatch the developer tools console (f12) while signing in for any error messages

consola

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

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

  • Consoante a velocidade da sua ligação, pode demorar algum tempo a carregar a página de início de sessão. Aguarde, pelo menos, um minuto antes de fechar a caixa de 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 estiver por trás de um proxy, certifique-se de que configurou o proxy do Explorador de Armazenamento corretamenteIf you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Abra a consola de programador ao premir a tecla F12.Bring up the developer console by pressing F12 key. Veja as respostas na consola de programador e se consegue encontrar alguma pista para a autenticação não estar a funcionarWatch 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 não conseguir remover uma conta ou se a ligação de reautenticação não fizer nadaIf you're unable to remove an account, or if the reauthenticate link does not do anything

  • Tente eliminar os seguintes ficheiros do diretório raiz e, em seguida, adicionar novamente a conta:Try deleting the following files from your home directory, and then readding the account:
    • .adalcache.adalcache
    • .devaccounts.devaccounts
    • .extaccounts.extaccounts
  • Se quiser remover os recursos de Armazenamento SAS anexados, elimine:If you want to remove SAS attached Storage resources, delete:
    • a pasta %AppData%/StorageExplorer do Windows%AppData%/StorageExplorer folder for Windows
    • /Utilizadores/<your_name>/Biblioteca/Aplicação SUpport/StorageExplorer para Mac/Users/<your_name>/Library/Application SUpport/StorageExplorer for Mac
    • ~/.config/StorageExplorer para Linux~/.config/StorageExplorer for Linux
    • Terá de reintroduzir todas as suas credenciais se eliminar estes ficheirosYou 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 quando configurar um proxy http/https num ASE.You cannot list Azure Cosmos DB nodes in left tree when configuring http/https proxy in ASE. Este é um problema conhecido e será corrigido na versão seguinte.It's a known issue, and will be fixed in next release. Pode utilizar o explorador de dados do Azure Cosmos DB no portal do Azure como uma solução neste momento.You could use Azure Cosmos DB data explorer in Azure portal as a work-around at this moment.

Problema do nó "Desenvolvimento" no nó "Local e Anexado""Development" node under "Local and Attached" node issue

Não existe nenhuma resposta depois de clicar no nó de "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 local do Azure Cosmos DB será suportado na versão seguinte.Azure Cosmos DB local emulator will be supported in next release.

Nó de desenvolvimento

Erro ao anexar a conta do Azure Cosmos DB no nó "Local e Anexado"Attaching Azure Cosmos DB account in "Local and Attached" node error

Se vir o erro abaixo depois de anexar uma conta do Azure Cosmos DB no nó "Local e Anexado", verifique se está a utilizar a cadeia de ligação correta.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 ao anexar o Azure Cosmos DB no nó Local e Anexado

Erro ao expandir o nó do Azure Cosmos DBExpand Azure Cosmos DB node error

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 ao expandir

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

  • Verifique se a conta do Azure Cosmos DB está em aprovisionamento e tente novamente quando a conta estiver a ser 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 nos nós "Acesso Rápido" ou "Local e Anexado", verifique se a conta foi eliminada.If the account is under "Quick Access" node or "Local and Attached" nodes, then check if the account has been deleted. Se for o caso, tem de remover o nó manualmente.If so, you need to remove the node manually.

Contacte-nosContact us

Se nenhuma das soluções funcionar para si, envie um e-mailcosmosdbtooling@microsoft.compara a Equipa de Ferramentas DDD DDD ( ) com detalhes sobre o problema, para corrigir os problemas.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.

Passos seguintesNext steps