Работа с данными с помощью Обозревателя службы хранилища AzureWork with data using Azure Storage Explorer

В Обозревателе службы хранилища Azure можно управлять объектами Azure Cosmos DB и работать с данными, хранимыми процедурами и триггерами, а также другими объектами Azure, такими как хранилища BLOB-объектов и очереди.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. Теперь это средство можно использовать для управления всеми объектами Azure в одном месте.Now you can use the same tool to manage your different Azure entities in one place. Сейчас обозреватель службы хранилища Azure поддерживает учетные записи Cosmos, настроенные для SQL, MongoDB, Graph и API таблиц.At this time, Azure Storage Explorer supports Cosmos accounts configured for SQL, MongoDB, Graph, and Table APIs.

Технические условияPrerequisites

Учетная запись Cosmos с API SQL или API Azure Cosmos DB для MongoDB.A Cosmos account with SQL API or Azure Cosmos DB's API for MongoDB. Если у вас нет учетной записи, вы можете создать ее на портале Azure, как описано в разделе Краткое руководство. Создание веб-приложения .NET при помощи Azure Cosmos DB с использованием API SQL и портала 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.

УстановкаInstallation

Установите последнюю версию Обозревателя службы хранилища Azure здесь: Обозреватель службы хранилища Azure. Теперь поддерживаются версии для Windows, Linux и MAC.Install the newest Azure Storage Explorer bits here: Azure Storage Explorer, now we support Windows, Linux, and MAC version.

Подключение к подписке AzureConnect to an Azure subscription

  1. После установки Обозревателя службы хранилища Azure щелкните значок подключаемого модуля слева, как показано на следующем рисунке.After installing the Azure Storage Explorer, click the plug-in icon on the left as shown in the following image:

    Значок подключаемого модуля

  2. Выберите Добавить учетную запись Azure, а затем щелкните Войти.Select Add an Azure Account, and then click Sign-in.

    Подключение к подписке Azure

  3. В диалоговом окне Вход в Azure нажмите кнопку Войти, а затем введите свои учетные данные Azure.In the Azure Sign in dialog box, select Sign in, and then enter your Azure credentials.

    Вход

  4. Выберите свою подписку и нажмите кнопку Применить.Select your subscription from the list and then click Apply.

    Применить

    На панели Обозревателя будут показаны учетные записи в выбранной подписке.The Explorer pane updates and displays the accounts in the selected subscription.

    Список учетных записей

    Вы успешно подключились к учетной записи Cosmos DB в подписке Azure.You have successfully connected to your Cosmos DB account to your Azure subscription.

Подключение к Azure Cosmos DB с помощью строки подключенияConnect to Azure Cosmos DB by using a connection string

Другой способ подключения к Azure Cosmos DB — с помощью строки подключения.An alternative way of connecting to an Azure Cosmos DB is to use a connection string. Для подключения с помощью строки подключения выполните следующие действия.Use the following steps to connect using a connection string.

  1. Найдите элемент Local and Attached (Локальные и присоединенные) в дереве слева, щелкните правой кнопкой мыши Учетные записи Cosmos DB и выберите Connect to Cosmos DB (Подключиться к Cosmos DB).Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB...

    Подключение к Cosmos DB с помощью строки подключения

  2. Сейчас поддерживаются только API SQL и API службы таблиц.Only support SQL and Table API currently. Выберите API, вставьте строку подключения, введите метку для учетной записи и нажмите кнопку Далее. Теперь проверьте сводные данные и нажмите кнопку Подключиться, чтобы подключиться к учетной записи 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. Сведения о том, как получить строку подключения, см. в разделе Получение строки подключения.For information on retrieving the connection string, see Get the connection string.

    Строка подключения

Подключение к Azure Cosmos DB с помощью локального эмулятораConnect to Azure Cosmos DB by using local emulator

Выполните следующие действия, чтобы подключиться к Azure Cosmos DB с помощью эмулятора. Эта возможность сейчас доступна только для учетной записи SQL.Use the following steps to connect to an Azure Cosmos DB by Emulator, only support SQL account currently.

  1. Установите и запустите эмулятор.Install Emulator and launch. Инструкции по установке эмулятора см. в статье об эмуляторе Cosmos DBFor how to install Emulator, see Cosmos DB Emulator

  2. Найдите элемент Local and Attached (Локальные и присоединенные) в дереве слева, щелкните правой кнопкой мыши Учетные записи Cosmos DB и выберите Connect to Cosmos DB Emulator (Подключиться к эмулятору Cosmos DB).Find Local and Attached in the left tree, right-click Cosmos DB Accounts, choose Connect to Cosmos DB Emulator...

    Подключение к Cosmos DB с помощью эмулятора

  3. Сейчас поддерживается только API SQL.Only support SQL API currently. Вставьте строку подключения, введите метку для учетной записи и нажмите кнопку Далее. Теперь проверьте сводные данные и нажмите кнопку Подключиться, чтобы подключиться к учетной записи 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. Сведения о том, как получить строку подключения, см. в разделе Получение строки подключения.For information on retrieving the connection string, see Get the connection string.

    Диалоговое окно подключения к Cosmos DB с помощью эмулятора

Управление ресурсами Azure Cosmos DBAzure Cosmos DB resource management

Для управления учетной записью Azure Cosmos DB вы можете выполнять следующие операции:You can manage an Azure Cosmos DB account by doing following operations:

  • Открытие учетной записи на портале AzureOpen the account in the Azure portal
  • Добавление ресурса в список быстрого доступаAdd the resource to the Quick Access list
  • Поиск и обновление ресурсовSearch and refresh resources
  • Создание и удаление баз данныхCreate and delete databases
  • Создание и удаление коллекцийCreate and delete collections
  • Создание, изменение, удаление и фильтрации документовCreate, edit, delete, and filter documents
  • Управление хранимыми процедурами, триггерами и определяемыми пользователем функциямиManage stored procedures, triggers, and user-defined functions

Задачи для быстрого доступаQuick access tasks

Щелкнув подписку на панели Обозревателя правой кнопкой мыши, вы сможете выполнить множество быстрых действий:By right-clicking on a subscription in the Explorer pane, you can perform many quick action tasks:

  • Щелкнув правой кнопкой мыши учетную запись Azure Cosmos DB или базу данных и выбрав Открыть на портале, вы сможете управлять этим ресурсом в браузере на портале 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.

    Открытие ресурса на портале

  • Вы также можете добавить на панель быстрого доступа учетную запись Azure Cosmos DB, базу данных или коллекцию.You can also add Azure Cosmos DB account, database, collection to Quick Access.

  • С помощью функции Найти здесь вы сможете выполнять поиск по ключевым словам по выбранному пути.Search from Here enables keyword search under the selected path.

    Найти здесь

Управление базами данных и коллекциямиDatabase and collection management

Создание базы данныхCreate a database

  • Щелкните правой кнопкой мыши учетную запись Azure Cosmos DB, выберите Создать базу данных, введите имя базы данных и нажмите клавишу ВВОД.Right-click the Azure Cosmos DB account, choose Create Database, input the database name, and press Enter to complete.

    Создание базы данных

удаление базы данных.Delete a database

  • Щелкните правой кнопкой мыши базу данных, выберите Удалить базу данныхи нажмите кнопку Да во всплывающем окне.Right-click the database, click Delete Database, and click Yes in the pop-up window. После удаления узла базы данных учетная запись Azure Cosmos DB будет обновлена автоматически.The database node is deleted, and the Azure Cosmos DB account refreshes automatically.

    Удаление базы данных 1

    Удаление базы данных 2

Создание коллекцииCreate a collection

  1. Щелкните правой кнопкой мыши базу данных, выберите Создать коллекцию и укажите параметры коллекции, такие как Идентификатор коллекции, Емкость хранилища и т. д. Нажмите кнопку ОК для завершения.Right-click your database, choose Create Collection, and then provide the following information like Collection ID, Storage capacity, etc. Click OK to finish.

    Создание коллекции 1

    Создание коллекции 2

  2. Выберите Без ограничений, чтобы иметь возможность указать ключ раздела, а затем нажмите кнопку ОК.Select Unlimited to be able to specify partition key, then click OK to finish.

    Если при создании коллекции использовался ключ секции, то после создания коллекции изменить значение этого ключа невозможно.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.

    Ключ секции

Удаление коллекцииDelete a collection

  • Щелкните коллекцию правой кнопкой мыши, выберите Удалить коллекцию, а затем нажмите кнопку Да во всплывающем окне.Right-click the collection, click Delete Collection, and then click Yes in the pop-up window.

    После удаления узла коллекции база данных будет обновлена автоматически.The collection node is deleted, and the database refreshes automatically.

    Удаление коллекции

Управление документамиDocument management

Создание и изменение документовCreate and modify documents

  • Чтобы создать новый документ, откройте раздел Документы в левом окне, щелкните Новый документ, измените содержимое документа на правой панели и нажмите кнопку Сохранить.To create a new document, open Documents in the left window, click New Document, edit the contents in the right pane, then click Save. Вы также можете изменить существующий документ, а затем нажмите кнопку Сохранить.You can also update an existing document, and then click Save. Чтобы отменить изменения, нажмите кнопку Отменить.Changes can be discarded by clicking Discard.

    Документ

Удаление документаDelete a document

  • Нажмите кнопку Удалить, чтобы удалить выбранный документ.Click the Delete button to delete the selected document.

Запросы для документовQuery for documents

  • Измените фильтр документов, указав SQL-запрос, и нажмите кнопку Применить.Edit the document filter by entering a SQL query and then click Apply.

    Фильтр документов

Управление графомGraph management

Создание и изменение вершиныCreate and modify vertex

  1. Чтобы создать новую вершину, откройте раздел Graph (Граф) в окне слева, выберите New Vertex (Создать вершину), отредактируйте содержимое, а затем нажмите кнопку ОК.To create a new vertex, open Graph from the left window, click New Vertex, edit the contents, then click OK.

  2. Чтобы изменить существующую вершину, щелкните значок карандаша справа.To modify an existing vertex, click the pen icon in the right pane.

    График

Удаление графаDelete a graph

  • Чтобы удалить вершину, щелкните значок корзины рядом с именем вершины.To delete a vertex, click the recycle bin icon beside the vertex name.

Фильтр графаFilter for graph

  • Чтобы изменить фильтр графа, укажите запрос Gremlin и нажмите кнопкуПрименить фильтр.Edit the graph filter by entering a gremlin query and then click Apply Filter.

    Фильтр графа

Управление таблицейTable management

Создание и изменение таблицыCreate and modify table

  1. Чтобы создать новую таблицу, откройте раздел Сущности слева, нажмите кнопку Добавить и измените содержимое в диалоговом окне Добавление сущности. Чтобы добавить свойство, нажмите кнопку Добавить свойство, а затем щелкните Вставить.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. Чтобы изменить таблицу, нажмите кнопку Изменить, измените содержимое, а затем щелкните Обновить.To modify a table, click Edit, modify the content, then click Update.

    Таблица

Импорт и экспорт таблицыImport and export table

  1. Чтобы импортировать таблицу, нажмите кнопку Импорт и выберите существующую таблицу.To import, click Import button and choose an existing table.

  2. Чтобы экспортировать таблицу, нажмите кнопку Экспорт и выберите место назначения.To export, click Export button and choose a destination.

    Импорт и экспорт таблицы

Удаление сущностейDelete entities

  • Выберите сущности и нажмите кнопку Удалить.Select the entities and click button Delete.

    Удаление таблицы

Запрос к таблицеQuery table

  • Нажмите кнопку Запрос, введите условие для запроса, а затем нажмите кнопку Выполнить запрос.Click Query button, input query condition, then click Execute Query button. Закройте панель запросов, нажав кнопку Закрыть запрос.Close Query pane by clicking Close Query button.

    Запрос к таблице

Управление хранимыми процедурами, триггерами и определяемыми пользователем функциямиManage stored procedures, triggers, and UDFs

  • Чтобы создать хранимую процедуру, щелкните раздел Хранимая процедура в дереве слева правой кнопкой мыши, выберите Создать хранимую процедуру, введите имя процедуры слева, скрипты для этой хранимой процедуры в окне справа и нажмите кнопку Создать.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.

  • Вы также можете изменять существующие хранимые процедуры. Для этого дважды щелкните хранимую процедуру, внесите изменения и нажмите кнопку Обновить, чтобы сохранить изменения, или кнопку Отменить, чтобы отменить изменения.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.

    Хранимая процедура

  • Операции для триггеров и определяемых пользователем функций похожи на хранимые процедуры.The operations for Triggers and UDF are similar with Stored Procedures.

Устранение неполадокTroubleshooting

Azure DB Cosmos в Обозревателе службы хранилища Azure является изолированным приложением, которое позволяет подключиться к учетным записям Azure Cosmos DB, размещенным в Azure и национальных облаках, из Windows, macOS или 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. Оно позволяет управлять сущностями Azure Cosmos DB, работать с данными, обновлять хранимые процедуры и триггеры, а также работать с такими сущностями Azure, как большие двоичные объекты и очереди Azure.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.

Это решения для распространенных проблем, возникающих с Azure Cosmos DB в Обозревателе службы хранилища.These are solutions for common issues seen for Azure Cosmos DB in Storage Explorer.

Проблемы входаSign in issues

Прежде чем продолжать, попытайтесь перезапустить приложение: возможно, это поможет решить проблему.Before proceeding further, try restarting your application and see if the problems can be fixed.

Самозаверяющий сертификат в цепочке сертификатовSelf-signed certificate in certificate chain

Существует несколько причин, по которым вы можете видеть эту ошибку. Двумя основными являются:There are a few reasons you may be seeing this error, the two most common ones are:

  • Подключение через прозрачный прокси-сервер. Это означает, кто-то (например, ваш ИТ-отдел) перехватывает трафик HTTPS, расшифровывает его, а затем шифрует с помощью самозаверяющего сертификата.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.

  • Работает программное обеспечение, например антивирусная программа, которое вставляет самозаверяющие сертификаты SSL в получаемые сообщения HTTPS.You're running software, such as anti-virus software, which is injecting a self-signed SSL certificates into the HTTPS messages you receive.

Когда Обозреватель службы хранилища встречает один из этих самозаверяющихся сертификатов, он не может знать, было ли незаконно изменено сообщение HTTPS, которое он получает.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. Однако если у вас есть копия самозаверяющего сертификата, то в Обозревателе службы хранилища вы можете настроить доверие к нему.If you have a copy of the self-signed certificate though, then you can tell Storage Explorer to trust it. Если нет уверенности в том, кто вставляет сертификат, можно попробовать найти источник самостоятельно, сделав следующее:If you're unsure of who is injecting the certificate, then you can try to find it yourself by doing the following steps:

  1. Установите Open SSL.Install Open SSL
    • Windows (подойдет любая из облегченных версий).Windows (any of the light versions is ok)
    • Mac и Linux: этот компонент должен быть включен в операционную систему.Mac and Linux: Should be included with your operating system
  2. Запустите Open SSL.Run Open SSL
    • Windows: перейдите в каталог установки, затем /bin/ и дважды щелкните файл openssl.exe.Windows: Go to the install directory, then /bin/, then double-click on openssl.exe.
    • MAC и Linux: выполните openssl из терминала.Mac and Linux: execute openssl from a terminal
  3. Выполните команду s_client -showcerts -connect microsoft.com:443.Execute s_client -showcerts -connect microsoft.com:443
  4. Найдите самозаверяющие сертификаты.Look for self-signed certificates. Если вы не знаете, какие из сертификатов являются самозаверяющими, то найдите сертификаты, в которых субъект ("s:") и издатель ("i:") совпадают.If you're unsure, which are self-signed, then look for anywhere the subject ("s:") and issuer ("i:") are the same.
  5. Найдя самозаверяющие сертификаты, скопируйте и вставьте все содержимое от ---BEGIN CERTIFICATE--- до ---END CERTIFICATE--- включительно в новый CER-файл для каждого из них.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. Откройте Обозреватель службы хранилища, а затем выберите Изменить > SSL-сертификаты > Импорт сертификатов.Open Storage Explorer and then go to Edit > SSL Certificates > Import Certificates. Используя средство выбора файлов, найдите, выберите и откройте созданные CER-файлы.Using the file picker, find, select, and open the .cer files you created.

Если вам не удалось найти самозаверяющие сертификаты, используя приведенные выше действия, то для дополнительных сведений свяжитесь с нами.If you're unable to find any self-signed certificates using the above steps, could send feedback for more help.

Не удается получить подпискиUnable to retrieve subscriptions

Если после успешного входа вам не удается получить подписки:If you're unable to retrieve your subscriptions after you successfully signed in:

  • Убедитесь, что учетная запись имеет доступ к подпискам, выполнив вход на портал Azure.Verify your account has access to the subscriptions by signing into the Azure Portal
  • Убедитесь, что вы выполнили вход в правильную среду (Azure, Azure для Китая, Azure для Германии, Azure для государственных организаций США, пользовательскую среду или 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)
  • При подключении через прокси-сервер убедитесь, что прокси-сервер Обозревателя службы хранилища настроен правильно.If you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Попробуйте удалить и снова добавить учетную запись.Try removing and readding the account
  • Попробуйте удалить следующие файлы из домашнего каталога (например: C:\Users\ContosoUser), а затем снова добавьте учетную запись: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
  • При выполнении входа проверьте наличие сообщений об ошибках в консоли средств разработчика (F12).Watch the developer tools console (f12) while signing in for any error messages

console

Не отображается страница аутентификацииUnable to see the authentication page

Если страница аутентификации не отображается:If you're unable to see the authentication page:

  • В зависимости от скорости подключения загрузка страницы входа может занять некоторое время. Подождите по крайней мере одну минуту, прежде чем закрывать диалоговое окно аутентификации.Depending 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
  • При подключении через прокси-сервер убедитесь, что прокси-сервер Обозревателя службы хранилища настроен правильно.If you're behind a proxy, make sure that you have configured the Storage Explorer proxy properly
  • Вызовите консоль разработчика, нажав клавишу F12.Bring up the developer console by pressing F12 key. Просмотрите ответы от консоли разработчика: возможно, вам удастся понять, почему страница аутентификации не работает.Watch the responses from developer console and see if you can find any clue for why authentication is not working

Невозможно удалить учетную записьCannot remove account

Если не удается удалить учетную запись или при щелчке ссылки повторной аутентификации ничего не происходит:If you're unable to remove an account, or if the reauthenticate link does not do anything

  • Попробуйте удалить следующие файлы из домашнего каталога, а затем снова добавить учетную запись:Try deleting the following files from your home directory, and then readding the account:
    • adalcache-файл;.adalcache
    • devaccounts-файл;.devaccounts
    • extaccounts-файл..extaccounts
  • Если вы хотите удалить подключенные ресурсы хранилища SAS, удалите:If you want to remove SAS attached Storage resources, delete:
    • папку %AppData%/StorageExplorer в Windows;%AppData%/StorageExplorer folder for Windows
    • /Users/<ваше_имя>/Library/Applicaiton SUpport/StorageExplorer в Mac;/Users/<your_name>/Library/Application SUpport/StorageExplorer for Mac
    • ~/.config/StorageExplorer в Linux.~/.config/StorageExplorer for Linux
    • Если вы удалите эти файлы, вам потребуется повторно ввести все учетные данные.You will have to reenter all your credentials if you delete these files

Неполадки с прокси-сервером HTTP/HTTPSHttp/Https proxy issue

При настройке прокси-сервера HTTP/HTTPS в ASE невозможно отобразить узлы Azure Cosmos DB в левом дереве узлов.You cannot list Azure Cosmos DB nodes in left tree when configuring http/https proxy in ASE. Это известная проблема, и она будет исправлена в следующем выпуске.It's a known issue, and will be fixed in next release. Пока в качестве временного решения можно использовать обозреватель данных Azure Cosmos DB на портале Azure.You could use Azure Cosmos DB data explorer in Azure portal as a work-around at this moment.

Неполадки с узлом "Development" (Разработка) в узле "Local and Attached" (Локальные и присоединенные)"Development" node under "Local and Attached" node issue

Отсутствие ответа после нажатия узла "Development" (Разработка) в узле "Local and Attached" (Локальные и присоединенные) в левом дереве узлов.There is no response after clicking the "Development" node under "Local and Attached" node in left tree. Такое поведение ожидаемо.The behavior is expected. Локальный эмулятор Azure Cosmos DB будет поддерживаться в следующем выпуске.Azure Cosmos DB local emulator will be supported in next release.

Узел разработки

Ошибка при подключении учетной записи Azure Cosmos DB в узле "Local and Attached" (Локальные и присоединенные)Attaching Azure Cosmos DB account in "Local and Attached" node error

Если после присоединения учетной записи Azure Cosmos DB в узле "Local and Attached" (Локальные и присоединенные) отображается приведенная ниже ошибка, проверьте, используется ли правильная строка подключения.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.

Ошибка при подключении Azure Cosmos DB в узле "Local and Attached" (Локальные и присоединенные)

Ошибка развертывания узла Azure Cosmos DBExpand Azure Cosmos DB node error

При попытке развернуть узлы дерева слева вы можете увидеть ошибку.You may see below error while trying to expand the tree nodes in left.

Ошибка развертывания

Попробуйте использовать рекомендации, приведенные ниже.Try the following suggestions:

  • Проверьте, находится ли учетная запись Azure Cosmos DB в состоянии подготовки, и после успешного создания учетной записи повторите попытку.Check if the Azure Cosmos DB account is in provision progress and try again when the account is being created successfully.
  • Если учетная запись находится в узле "Быстрый доступ" или "Local and Attached" (Локальные и присоединенные), проверьте, не была ли она удалена.If the account is under "Quick Access" node or "Local and Attached" nodes, then check if the account has been deleted. Если да, то необходимо удалить узел вручную.If so, you need to remove the node manually.

Свяжитесь с намиContact us

Если ни одно из решений вам не помогло, то для устранения проблемы отправьте электронное письмо команде по инструментарию разработчика Azure Cosmos DB (cosmosdbtooling@microsoft.com) со сведениями о ней.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.

Дальнейшие действияNext steps