Панели мониторинга управления версиями с помощью Git

На этой странице объясняется, как использовать папки Databricks Git для управления версиями и разработки панели мониторинга совместной работы. В нем также описывается реализация процессов CI/CD для разработки и развертывания панелей мониторинга в разных рабочих областях.

Важный

Эта функция доступна в общедоступной предварительной версии.

Обзор

Папки Git в Databricks отслеживают изменения и историю панели мониторинга, поддерживают командную работу, позволяют развертывать панели мониторинга в рабочей среде и восстанавливать предыдущие версии.

Включение системы контроля версий для панели мониторинга

Администраторы рабочей области могут управлять доступом к общедоступной предварительной версии рабочей области на странице "Предварительные версии". По умолчанию предварительный просмотр панели мониторинга поддержки в папке Gitвключен.

Как интеграция Git работает с панелями мониторинга

Папки Databricks Git отслеживают и управляют изменениями черновиков панелей мониторинга. Черновик панели мониторинга отражает все изменения в отслеживаемой панели мониторинга. Git не отслеживает конфигурации публикации и планирования, например выбор хранилища и создание расписания. Чтобы управлять этими конфигурациями, используйте пользовательский интерфейс или автоматизируйте изменения с помощью пакетов ресурсов Databricks или REST API ИИ/BI.

• Чтобы использовать пакеты для управления панелями мониторинга, см. dashboard.
• Сведения о публикации и планировании панелей мониторинга с помощью REST API см. в справочнике по API Lakeview .

Замечание

API Lakeview использует предыдущее имя для панелей мониторинга AI/BI.

Папки Databricks Git управляют общими операциями Git для панелей мониторинга и других объектов рабочей области. Дополнительные сведения см. в папках Azure Databricks Git.

Применение системы управления версиями к информационным панелям

Чтобы отслеживать панели мониторинга с помощью Git, поместите их в папку Databricks Git. Используйте один из следующих вариантов:

• Новые панели мониторинга: Создайте панель мониторинга в существующей папке Databricks Git, чтобы применить систему контроля версий с самого начала.
• Существующие панели мониторинга: Переместите существующую панель мониторинга в папку Databricks Git, чтобы отслеживать ее с помощью Git.

Управление разрешениями для управляемых источником панелей мониторинга

Разрешения на уровне папки применяются ко всем объектам в этой папке, включая панели мониторинга. Панели мониторинга в папке Git наследуют разрешения родительской папки в дополнение к любым разрешениям для определенных панелей мониторинга. Для большинства операций Git требуется разрешение CAN MANAGE. Дополнительные сведения см. в статье "Списки управления доступом к папкам " и списки управления доступом к папкам Git.

Рекомендуемый рабочий процесс разработки

Клонируйте репозиторий в свою папку Databricks Git, используйте фичевые ветки и отправляйте pull-запросы. В следующей таблице описывается использование папок Git для управления панелями мониторинга на различных этапах разработки и развертывания.

Важный

Переключение ветвей Git — это деструктивная операция для панелей мониторинга. Azure Databricks удаляет панели мониторинга, которые не существуют в целевой ветви. При переключении панели мониторинга снова появляются с новыми URL-адресами и идентификаторами, что нарушает опубликованные ссылки, закладки и интеграции API. Проверьте целевую ветвь перед переключением и обновлением всех ссылок после этого.

Этап проекта	Рабочий процесс	Ожидаемый результат	Известные ограничения
Начальный коммит	Переместите панель мониторинга в папку Git в рабочей области. Закоммитьте и отправьте в удаленный репозиторий Git.	Git отслеживает панель мониторинга в удаленном репозитории.
Развитие	Разработчики создают папки Git в отдельных ветвях разработки, как правило, в своих домашних папках. Зафиксируйте изменения в ветви разработки. Объединяйте ветки разработки с основной с помощью запросов на вытягивание.	Разработчики работают независимо. Git отслеживает версии панели мониторинга.	Файлы панели мониторинга используют JSON формат. Запросы SQL отображаются как одна строка, что может сделать различия сложными для проверки в пулл-реквестах.
Развертывание	Создайте папку Git в ветви развертывания в корневой папке, не связанной с пользователем. См. CI/CD с каталогами Databricks Git. Загрузите изменения в папку развертывания. Публикация панелей мониторинга из этой папки. Удалить доступ edit+ и ограничить обновления в Git. Совместное использование панелей мониторинга с потребителями.	Потребители получают доступ к согласованной опубликованной версии панели мониторинга. Панели мониторинга можно совместно использовать в одной папке с разными аудиториями.	Databricks не предоставляет встроенную поддержку синхронизации удаленной ветви с папкой Git в рабочей области или развертывания пакетов ресурсов Databricks с ресурсом панели мониторинга из удаленной среды. Настройте автоматизацию CI/CD для автоматизации: Извлечение обновлений из удаленного репозитория. Публикация панелей мониторинга после синхронизации. Развертывание пакетов активов Databricks после обновления.

Дополнительные рекомендации по совместной работе в папках Databricks Git см. в статье "Совместная работа с помощью папок Git".

Ограничения

Управление исходным кодом с помощью AI/BI панелей управления имеет следующие ограничения:

• Вы можете зафиксировать не более 100 панелей мониторинга в одной папке Git. Это ограничение может измениться во время общедоступной предварительной версии.
• Задания на основе Git, такие как задания, ссылающиеся на URL-адреса Git, а не идентификаторы ресурсов рабочей области или пути, не работают с панелями мониторинга.
• Сериализация панели мониторинга создает длинные строки, что затрудняет чтение и оценку различий во время пулл-реквестов.
• Формат файла панели мониторинга периодически изменяется, чтобы включить новые поля и другие улучшения. В общедоступной предварительной версии эти изменения могут отображаться как различия в Git, которые вы не инициировали.