Использование обозревателя данных 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

Вы можете напрямую получить доступ к Обозревателе данных и использовать существующие учетные данные, чтобы быстро приступить к работе с инструментом.

1. Перейдите к https://cosmos.azure.com.

2. Выберите Войти. Войдите с помощью существующих учетных данных, имеющих доступ к учетной записи Azure Cosmos DB.

3. Затем выберите подписку Azure и целевую учетную запись в меню "Выбор учетной записи базы данных".

   

Доступ к обозревателе данных из портал Azure с помощью подписки Azure

Если вам удобен портал Azure, вы можете перейти непосредственно из встроенного в портал обозревателя данных в самостоятельный обозреватель данных.

1. Войдите на портал Azure.

2. Перейдите к существующей учетной записи Azure Cosmos DB.

3. В меню ресурсов выберите Обозреватель данных.

4. Затем выберите пункт меню "Открыть полный экран ".

   

5. В диалоговом окне "Открыть полный экран " нажмите кнопку "Открыть".

Настройка представлений данных с помощью селектора настраиваемых столбцов

Селектор настраиваемых столбцов в обозревателе данных Azure Cosmos DB позволяет настроить представления данных, выбрав определенные столбцы, наиболее релевантные для анализа при использовании API NoSQL. Ранее в представлении элементов обозревателя данных можно было видеть только столбцы идентификатора и ключа раздела. Теперь с помощью этой новой функции можно выбрать один или несколько свойств из документа и создать дополнительные столбцы, чтобы легко просматривать данные. 

1. Войдите на портал Azure.

2. Перейдите к существующей учетной записи Azure Cosmos DB.

3. В меню ресурсов выберите Обозреватель данных.

4. (Необязательно) Затем выберите пункт меню "Открыть полный экран ".

   

5. В диалоговом окне "Открыть полный экран " нажмите кнопку "Открыть".

6. Когда вы окажетесь в Data Explorer, откройте коллекцию, которую хотите запросить, выберите "Элементы".

7. Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Изменить столбец"

8. Выберите столбцы, которые нужно отобразить и сохранить.

9. Теперь представление данных отражает только выбранные столбцы, что упрощает фокус на соответствующих данных.

10. Удаление настраиваемого столбца

11. Оказавшись в Data Explorer, откройте нужную коллекцию, выберите "Элементы".

12. Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Удалить столбец".

13. Сортировка представления столбцов по возрастанию или убыванию

14. Как только вы окажетесь в Data Explorer, откройте коллекцию, которую хотите запросить, и выберите "Элементы".

15. Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Удалить столбец".

16. Сброс отображения столбцов

17. Оказавшись в Data Explorer, откройте коллекцию, которую вы хотите запросить, и выберите "Элементы".

18. Щелкните меню с многоточием в правом верхнем углу любого столбца, выберите "Изменить столбец".

19. Выберите "Сброс", чтобы вернуться к представлению по умолчанию. Вы также можете очистить историю фильтров, столбцов и настроек вида, выбрав значок шестеренки в правом верхнем меню "Глобальный обозреватель данных" и выбрав "Очистить историю".

Использование журнала фильтров

Журнал фильтров позволяет быстро пересмотреть и применить предыдущие фильтры. Это избавляет вас от рутинной задачи ручного создания фильтров для повторяющихся запросов. С помощью журнала фильтров можно получить доступ к журналу прошлых фильтров и повторно применить их с помощью простого щелчка мыши.  Эта функция особенно полезна для пользователей, выполняющих регулярный анализ аналогичных наборов данных.

1. Применение сохраненного фильтра

2. В Data Explorer откройте коллекцию, которую нужно запросить, выберите "Элементы".

3. Нажмите кнопку "Изменить фильтр".

4. Примените фильтр к вашим данным, как обычно.

После применения фильтра он будет автоматически сохранён и добавлен в список фильтров по умолчанию в выпадающем меню окна фильтров.

1. Чтобы повторно применить предыдущий фильтр, нажмите кнопку "Изменить фильтр".

2. Снимите любой фильтр из окна фильтра. Этот шаг необходим для просмотра сохраненных фильтров.

3. Щелкните на стрелку в окне фильтра и выберите нужный фильтр из списка.

4. Выберите Применить фильтр

5. Очистка журнала фильтров

6. В обозревателе данных щелкните значок шестеренки в правом верхнем углу обозревателя данных, чтобы получить доступ к параметрам

7. Нажмите кнопку "Очистить журнал"

8. Убедитесь, что вы хотите очистить историю.  Это включало фильтрацию позиций разделения столбцов, настраиваемых столбцов и макета вкладки.

Изменение представления окна запроса

Мы представили новую функцию в представлении запроса, которая позволяет переключаться между горизонтальными и вертикальными представлениями для панели запросов и результатов. Вы можете легко переключаться между этими представлениями, выбрав параметр "Представления" в меню панели команд.

1. Сохранение настроек представления окна запроса

2. В обозревателе данных щелкните значок шестеренки в правом верхнем углу обозревателя данных для доступа к параметрам.

3. В раскрывающемся меню выберите "Представление результатов запросов по умолчанию".

4. Выберите горизонтальное или вертикальное представление по умолчанию.

5. Нажмите кнопку "Сохранить", чтобы применить параметры.

Настройка порогового значения единицы запроса

В обозревателе данных можно настроить ограничение единиц запросов в секунду (ЕЗ/с), которые используют запросы. Используйте эту функцию для управления затратами и производительностью в запросных единицах (RU) ваших запросов. Эта функция также может автоматически отменять дорогостоящие запросы.

1. Запустите обозреватель для целевой учетной записи Azure Cosmos DB.

2. Выберите пункт меню "Параметры".

   

3. В диалоговом окне "Параметры" настройте, надо ли включить порог RU и установите фактическое значение порога RU.

   

   Совет

   Порог RUs включен автоматически со значением по умолчанию 5000 RUs.

Использовать с аутентификацией Microsoft Entra

Вы можете использовать проверку подлинности на основе Microsoft Entra в обозревателе, включив его с помощью конфигурации. Дополнительные сведения об управлении доступом на основе ролей см. в руководстве по безопасности.

1. Запустите обозреватель для целевой учетной записи Azure Cosmos DB.

2. Выберите пункт меню "Параметры".

3. В диалоговом окне "Параметры" настройте, следует Enable Entra ID (RBAC) ли использовать одно из трех возможных значений:

4. Обозреватель данных автоматически войдет в систему с помощью учетной записи. Это может показать краткое всплывающее окно, не запрашивая запись учетных данных. Если автоматический вход завершается ошибкой или если всплывающие окна заблокированы в браузере, перед выполнением запросов к данным необходимо использовать кнопку входа для идентификатора записи RBAC (расположенную на панели команд Обозревателя данных) и разрешить всплывающие окна для обозревателя данных.

   Совет

   Обозреватель данных Azure Cosmos DB также поддерживает параметр вручную задать значение Enable Entra ID (RBAC)Truehttps://cosmos.azure.com?feature.enableAadDataPlane=true URL-адреса.

Выбор клиентского региона Обозревателя данных

При доступе к учетной записи NoSQL с помощью проверки подлинности Entra (управление доступом на основе ролей) вы увидите опцию выбора региона в параметрах. При выборе региона обозреватель данных отправляет все запросы в этот конкретный регион.

Чтобы выбрать регион, выполните приведенные действия.

1. Войдите в учетную запись с помощью проверки подлинности Entra через портал или непосредственно через подписку Azure.

2. Откройте меню "Параметры ".

3. Используйте раскрывающийся список "Выбор региона ", чтобы выбрать глобальный или обязательный регион.

Если выбрать регион только для чтения , обозреватель данных отключает операции записи, обновления и удаления.

При выборе "Глобальный" клиент использует глобальную конечную точку учетной записи и включает функцию автоматического обнаружения конечных точек для маршрутизации запросов в оптимальный регион.  Если выбрать определенный регион, клиент отключает обнаружение конечных точек и отправляет все запросы только в выбранный регион. 

Известные проблемы

Ниже приведены некоторые известные проблемы:

• Просмотр элементов, содержащих идентификатор UUID, не поддерживается в обозревателе данных. Это ограничение не влияет на загрузку контейнеров, просматривая только отдельные элементы или запросы, которые включают эти элементы. Чтобы просмотреть эти элементы и управлять ими, пользователи должны продолжать использовать те же средства и пакеты SDK, которые изначально использовались для создания этих элементов.

• Ошибки HTTP 401 могут возникать из-за нехватки разрешений управления доступом на основе ролей для учетной записи идентификатора Microsoft Entra. Это условие может быть истинным, особенно если у учетной записи есть пользовательская роль. Все пользовательские роли должны содержать действие Microsoft.DocumentDB/databaseAccounts/listKeys/*, необходимое для использования средства просмотра данных.

Следующий шаг