Добавление ресурса Lakebase в приложение Databricks

Добавьте экземпляры базы данных Lakebase в качестве ресурсов Databricks Apps для сохранения данных в разных развертываниях. Эти ресурсы с поддержкой PostgreSQL позволяют приложению создавать схемы и таблицы, которые сохраняют состояние.

Это важно

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

Добавление ресурса базы данных

Перед добавлением экземпляра базы данных Lakebase в качестве ресурса просмотрите предварительные требования к ресурсу приложения.

1. При создании или изменении приложения перейдите к шагу "Настройка ".
2. В разделе "Ресурсы приложения" нажмите кнопку +Добавить ресурс.
3. Выберите базу данных в качестве типа ресурса.
4. Выберите экземпляр базы данных.
5. Выберите базу данных в этом экземпляре.
6. Выберите соответствующий уровень разрешений для приложения. В настоящее время единственным доступным разрешением является возможность подключения и создания.
7. (Необязательно) Укажите пользовательский ключ ресурса, который является ссылкой на базу данных в конфигурации приложения. Ключ по умолчанию — database.

При добавлении ресурса базы данных:

• Azure Databricks создает роль PostgreSQL в выбранном экземпляре базы данных. Имя роли соответствует идентификатору клиента субъекта-службы . Если роль уже существует, Azure Databricks повторно использует ее.
• Azure Databricks предоставляет субъекту-службе CONNECT и CREATE привилегии для выбранной базы данных. Эти привилегии позволяют приложению создавать схемы и таблицы в базе данных.

Переменные среды

При развертывании приложения с ресурсом базы данных Azure Databricks задает следующие переменные среды для первого ресурса базы данных.

Если приложение использует несколько баз данных, эти переменные отражают только первую. Используйте valueFrom ключ ресурса для получения имени узла базы данных. См. раздел "Использование переменных среды для доступа к ресурсам".

Переменная	Описание
PGAPPNAME	Имя приложения
PGDATABASE	Имя базы данных.
PGHOST	Имя узла сервера PostgreSQL
PGPORT	Порт для сервера PostgreSQL
PGSSLMODE	Режим SSL для подключения
PGUSER	Идентификатор клиента и имя роли субъекта-службы

Удаление ресурса базы данных

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

Логика, которую приложение использует в основном, зависит от того, есть ли у вас роль в экземпляре базы данных:

Ваши разрешения	Роль в экземпляре базы данных?	Результат
CAN MANAGE	Да	Azure Databricks переназначает все объекты, принадлежащие субъекту-службе, вам и удаляет роль субъекта-службы.
CAN MANAGE	нет	Azure Databricks создает для вас роль, переназначает вам все объекты, принадлежащие роли учетной записи службы, и удаляет саму роль этой учетной записи службы.
Нет CAN MANAGE	Не применимо	Azure Databricks удаляет ресурс, но не удаляет роль или не переназначает владение. Предупреждение отображается в пользовательском интерфейсе, и позже необходимо вручную очистить роль и принадлежащие объекты.

Примечания.

При добавлении баз данных в качестве ресурсов приложения следует учитывать следующее:

• Если вы отмените CONNECT и CREATE из одной базы данных и предоставьте их другим в том же обновлении, Azure Databricks обновляет привилегии, но не повторно создает роль субъекта-службы.
• Базы данных сохраняют состояние. Все схемы или таблицы, созданные приложением, остаются даже после повторного развертывания или остановки приложения.