Управление подключениями для федерации Lakehouse

Внимание

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

В этой статье описывается, как перечислить все подключения Федерации Lakehouse, определенные в хранилище метаданных каталога Unity, получить сведения о подключении, предоставить разрешения на подключение и удалить подключения с помощью обозревателя каталогов и инструкций SQL в записных книжках или редакторе запросов Databricks SQL.

См. также статью "Создание подключения".

Если вы предпочитаете использовать REST API, см . справочную документацию по Azure Databricks.

Вывод списка подключений

Необходимые разрешения: список возвращенных подключений зависит от роли и разрешений. Пользователи USE CONNECTION с привилегиями в хранилище метаданных видят все подключения. В противном случае можно просмотреть только подключения, для которых вы являетесь владельцем объекта подключения или иметь некоторые привилегии.

Обозреватель каталогов

1. В рабочей области Azure Databricks щелкните "Каталог".

2. В левой области разверните меню "Внешние данные" и выберите "Подключения".

   Доступные подключения перечислены вместе с URL-адресом, датой создания, владельцем и комментарием.

SQL

Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks. При необходимости замените <pattern>предикатом LIKE.

SHOW CONNECTIONS [LIKE <pattern>];

Получение сведений о подключении

Необходимые разрешения: владелец подключения, USE CONNECTION привилегия в хранилище метаданных или некоторые привилегии для подключения.

Обозреватель каталогов

1. В рабочей области Azure Databricks щелкните "Каталог".
2. В левой области разверните меню "Внешние данные" и выберите "Подключения".
3. Найдите подключение и выберите его для просмотра сведений.

SQL

Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks.

DESCRIBE CONNECTION <connection-name>;

Предоставление и отмена разрешений на подключения

Вы можете предоставить разрешение на использование подключения для создания внешних каталогов или просмотра сведений о подключении:

• CREATE FOREIGN CATALOG предоставляет возможность создавать внешний каталог в виде зеркального отображения базы данных только для чтения в источнике данных, описанном подключением.
• USE CONNECTION предоставляет возможность использовать подключение в Delta Live Tables для приема данных из источника данных в Azure Databricks. Однако, если оно предоставлено на уровне хранилища метаданных, оно позволяет просматривать только сведения о подключениях в хранилище метаданных. Пользователи по-прежнему должны быть предоставлены USE CONNECTION для отдельных подключений для их использования.

Необходимые разрешения: администратор хранилища метаданных или владелец подключения.

Обозреватель каталогов

Чтобы предоставить разрешение на использование подключения, выполните следующие действия.

1. В рабочей области Azure Databricks щелкните "Каталог".

2. В левой области разверните меню "Внешние данные" и выберите "Подключения".

3. Найдите подключение и выберите его.

4. На вкладке "Разрешения" нажмите кнопку "Предоставить".

5. В диалоговом окне "Предоставление" <connection-name> начните вводить имя пользователя или группы или щелкните меню пользователя, чтобы просмотреть и выбрать пользователей и группы.

6. Выберите привилегии, которые вы хотите предоставить.

   Ознакомьтесь с описанием привилегий в разделе введение.

7. Нажмите кнопку "Предоставить".

Чтобы отменить привилегию подключения, выполните следующие действия.

1. Выполните описанные выше действия, чтобы открыть вкладку "Разрешения " для подключения.
2. Выберите пользователя или группу, привилегии которой требуется отменить.
3. Нажмите кнопку " Отменить" на вкладке и в диалоговом окне подтверждения.

SQL

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

GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;

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

GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;

Чтобы отменить привилегию, выполните следующую команду, где <privilege> одно из привилегий для подключения, предоставленного пользователю:

REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;

Удаление подключений

Необходимые разрешения: владелец подключения

Обозреватель каталогов

1. В рабочей области Azure Databricks щелкните "Каталог".
2. В левой области разверните меню "Внешние данные" и выберите "Подключения".
3. Найдите подключение и выберите его.
4. Щелкните меню кебаб и нажмите кнопку "Удалить".
5. В диалоговом окне подтверждения нажмите кнопку "Удалить".

SQL

Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks.

DROP CONNECTION [IF EXISTS] <connection-name>;