Использование обозревателя данных Azure Cosmos DB для управления данными
Область применения: 
Nosql Mongodb Кассандра Гремлин Таблица
Обозреватель данных Azure Cosmos DB — это веб-интерфейс, позволяющий просматривать и управлять данными, хранящимися в Azure Cosmos DB.
Выделенный обозреватель данных Azure Cosmos DB (https://cosmos.azure.com) имеет несколько ключевых преимуществ по сравнению с интерфейсом обозревателя данных портал Azure, в том числе:
- Полноэкранная недвижимость для просмотра данных, выполнения запросов и наблюдения за результатами запроса
- Возможность предоставления пользователям доступа к портал Azure или возможностям чтения или записи подписки Azure через данные в контейнерах
- Возможность совместного использования результатов запроса пользователями, у которых нет подписки Azure или портал Azure доступа
Необходимые компоненты
- Существующая учетная запись Azure Cosmos DB.
- Если у вас нет подписки Azure, попробуйте использовать Azure Cosmos DB бесплатно.
Доступ к обозревателе данных напрямую с помощью подписки Azure
Вы можете напрямую получить доступ к Обозревателе данных и использовать существующие учетные данные, чтобы быстро приступить к работе с инструментом.
Перейдите к https://cosmos.azure.com.
Выберите Войти. Войдите с помощью существующих учетных данных, имеющих доступ к учетной записи Azure Cosmos DB.
Затем выберите подписку Azure и целевую учетную запись в меню "Выбор учетной записи базы данных".
Доступ к обозревателе данных из портал Azure с помощью подписки Azure
Если вы уже комфортно с портал Azure, вы можете перейти непосредственно из обозревателя данных на портале в автономный обозреватель данных.
Войдите на портал Azure.
Перейдите к существующей учетной записи Azure Cosmos DB.
В меню ресурсов выберите Обозреватель данных.
Затем выберите пункт меню "Открыть полный экран ".
В диалоговом окне "Открыть полный экран " нажмите кнопку "Открыть".
Настройка представлений данных с помощью селектора настраиваемых столбцов
Селектор настраиваемых столбцов в обозревателе данных Azure Cosmos DB позволяет настроить представления данных, выбрав определенные столбцы, наиболее релевантные для анализа при использовании API NoSQL. Ранее в представлении элементов обозревателя данных можно увидеть только столбцы ключа секции и идентификатора. Теперь с помощью этой новой функции можно выбрать один или несколько свойств из документа и создать дополнительные столбцы, чтобы легко просматривать данные.
Войдите на портал Azure.
Перейдите к существующей учетной записи Azure Cosmos DB.
В меню ресурсов выберите Обозреватель данных.
Затем (необязательно) выберите пункт меню "Открыть полный экран ".
В диалоговом окне "Открыть полный экран " нажмите кнопку "Открыть".
После этого откройте коллекцию, которую нужно запросить, выберите "Элементы".
Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Изменить столбец"
Выберите столбцы, которые нужно отобразить и сохранить.
Теперь представление данных отражает только выбранные столбцы, что упрощает фокус на соответствующих данных.
Удаление настраиваемого столбца
После этого откройте коллекцию, которую нужно запросить, выберите "Элементы".
Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Удалить столбец".
Сортировка представления столбцов по возрастанию или убыванию
После этого откройте коллекцию, которую нужно запросить, выберите "Элементы".
Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Удалить столбец".
Сброс представления столбцов
После этого откройте коллекцию, которую нужно запросить, выберите "Элементы".
Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Изменить столбец".
Выберите "Сброс", чтобы вернуться к представлению по умолчанию. Вы также можете очистить параметры журнала фильтров, столбцов и представлений, выбрав значок шестеренки в правом верхнем правом меню "Глобальный обозреватель данных" и выбрав "Очистить журнал".
Использование журнала фильтров
Журнал фильтров позволяет быстро пересмотреть и применить предыдущие фильтры. Это позволяет сохранить вас из повторяющейся задачи ручного восстановления фильтров для повторяющихся запросов. С помощью журнала фильтров можно получить доступ к журналу прошлых фильтров и повторно применить их с помощью простого щелчка мыши. Эта функция особенно полезна для пользователей, выполняющих регулярный анализ аналогичных наборов данных.
Применение сохраненного фильтра
После этого откройте коллекцию, которую нужно запросить, выберите "Элементы".
Нажмите кнопку "Изменить фильтр".
Примените фильтр к данным, как правило.
После применения фильтра фильтр будет автоматически сохранен и добавлен в список фильтров по умолчанию в раскрывающемся окне фильтра.
Чтобы повторно применить предыдущий фильтр, нажмите кнопку "Изменить фильтр".
Снимите любой фильтр из окна фильтра. Этот шаг необходим для просмотра сохраненных фильтров.
Щелкните раскрывающийся список в окне фильтра и выберите нужный фильтр из списка.
Выбор фильтра "Применить"
Очистка журнала фильтров
В обозревателе данных щелкните значок шестеренки в правом верхнем углу обозревателя данных, чтобы получить доступ к параметрам
Нажмите кнопку "Очистить журнал"
Убедитесь, что вы хотите очистить историю. Это включало фильтрацию позиций разделения столбцов, настраиваемых столбцов и макета вкладки.
Изменение представления окна запроса
Мы представили новую функцию в представлении запроса, которая позволяет переключаться между горизонтальными и вертикальными представлениями для панели запросов и результатов. Вы можете легко переключаться между этими представлениями, выбрав параметр "Представления" в меню панели команд.
Сохранение настроек представления окна запроса
В обозревателе данных щелкните значок шестеренки в правом верхнем углу обозревателя данных для доступа к параметрам.
В раскрывающемся меню выберите "Представление результатов запросов по умолчанию".
Выберите горизонтальное или вертикальное представление по умолчанию.
Нажмите кнопку "Сохранить", чтобы применить параметры.
Настройка порогового значения единицы запроса
В обозревателе данных можно настроить ограничение единиц запросов в секунду (ЕЗ/с), которые используют запросы. Используйте эту функцию для управления затратами и производительностью в единицах запросов (ЕЗ) запросов. Эта функция также может автоматически отменять высокопроизводительные запросы.
Запустите обозреватель для целевой учетной записи Azure Cosmos DB.
Выберите пункт меню "Параметры".
В диалоговом окне "Параметры" укажите, нужно ли включить пороговое значение ЕЗ и фактическое пороговое значение ЕЗ.
> [!TIP]Порог ЕЗ включен автоматически со значением по умолчанию 5000 единиц запросов.
Использование с проверкой подлинности Microsoft Entra
Вы можете использовать проверку подлинности на основе Microsoft Entra в обозревателе, включив его с помощью конфигурации. Дополнительные сведения об управлении доступом на основе ролей см. в руководстве по безопасности.
Запустите обозреватель для целевой учетной записи Azure Cosmos DB.
Выберите пункт меню "Параметры".
В диалоговом окне "Параметры" настройте, следует
Enable Entra ID (RBAC)ли использовать одно из трех возможных значений:
| Description | |
|---|---|
| Автоматический (по умолчанию) | Управление доступом на основе ролей (RBAC) автоматически используется, если для учетной записи отключена проверка подлинности на основе ключей. В противном случае Data Explorer использует проверку подлинности на основе ключей для запросов данных. |
| True | Управление доступом на основе ролей всегда используется для запросов данных. Если управление доступом на основе ролей настроено неправильно для учетной записи или удостоверения, запросы завершаются сбоем. |
| False | Проверка подлинности на основе ключей всегда используется для запросов данных. Если проверка подлинности на основе ключей отключена, запросы завершаются сбоем. |
Примечание.
Изменение этого параметра на параметр, использующий проверку подлинности на основе ключей, может активировать запрос на получение первичного ключа от имени удостоверения, вошедшего в систему.
Обозреватель данных автоматически войдет в систему с помощью учетной записи. Это может показать краткое всплывающее окно, не запрашивая запись учетных данных. Если автоматический вход завершается ошибкой или если всплывающие окна заблокированы в браузере, перед выполнением запросов к данным необходимо использовать кнопку входа для идентификатора записи RBAC (расположенную на панели команд Обозревателя данных) и разрешить всплывающие окна для обозревателя данных.
Совет
Обозреватель данных Azure Cosmos DB также поддерживает параметр вручную задать значение
Enable Entra ID (RBAC)Truehttps://cosmos.azure.com?feature.enableAadDataPlane=true URL-адреса.
Известные проблемы
Ниже приведены некоторые известные проблемы:
Просмотр элементов, содержащих идентификатор UUID, не поддерживается в обозревателе данных. Это ограничение не влияет на загрузку контейнеров, просматривая только отдельные элементы или запросы, которые включают эти элементы. Чтобы просмотреть эти элементы и управлять ими, пользователи должны продолжать использовать те же средства и пакеты SDK, которые изначально использовались для создания этих элементов.
Ошибки HTTP 401 могут возникать из-за нехватки разрешений управления доступом на основе ролей для учетной записи идентификатора Microsoft Entra. Это условие может быть истинным, особенно если у учетной записи есть пользовательская роль. Все пользовательские роли должны содержать
Microsoft.DocumentDB/databaseAccounts/listKeys/*действие, включаемое для использования обозревателя данных.