Управление подключениями для федерации Lakehouse
В этой статье описывается, как перечислить все подключения Федерации Lakehouse, определенные в хранилище метаданных каталога Unity, получить сведения о подключении, предоставить разрешения на подключение и удалить подключения с помощью обозревателя каталогов и инструкций SQL в записных книжках или редакторе запросов Databricks SQL. Подключение — это защищаемый объект в каталоге Unity, указывающий путь и учетные данные для доступа к внешней системе базы данных.
См. также статью "Создание подключения".
Если вы предпочитаете использовать REST API, см . справочную документацию по Azure Databricks.
Вывод списка подключений
Необходимые разрешения: список возвращенных подключений зависит от роли и разрешений. Пользователи USE CONNECTION
с привилегиями в хранилище метаданных видят все подключения. В противном случае можно просмотреть только подключения, для которых вы являетесь владельцем объекта подключения или иметь некоторые привилегии.
Обозреватель каталогов
В рабочей области Azure Databricks щелкните "Каталог".
В верхней части области каталога щелкните значок шестеренки и выберите "Подключения " в меню.
Кроме того, на странице быстрого доступа нажмите кнопку "Внешние данные>" и перейдите на вкладку "Подключения".
Доступные подключения перечислены вместе с URL-адресом, датой создания, владельцем и комментарием.
SQL
Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks. При необходимости замените <pattern>
предикатом LIKE
.
SHOW CONNECTIONS [LIKE <pattern>];
Получение сведений о подключении
Необходимые разрешения: владелец подключения, USE CONNECTION
привилегия в хранилище метаданных или некоторые привилегии для подключения.
Обозреватель каталогов
В рабочей области Azure Databricks щелкните "Каталог".
В верхней части области каталога щелкните значок шестеренки и выберите "Подключения " в меню.
Кроме того, на странице быстрого доступа нажмите кнопку "Внешние данные>" и перейдите на вкладку "Подключения".
Найдите подключение и выберите его для просмотра сведений.
SQL
Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks.
DESCRIBE CONNECTION <connection-name>;
Предоставление и отмена разрешений на подключения
Вы можете предоставить разрешение на использование подключения для создания внешних каталогов или просмотра сведений о подключении:
CREATE FOREIGN CATALOG
предоставляет возможность создавать внешний каталог в виде зеркального отображения базы данных только для чтения в источнике данных, описанном подключением.USE CONNECTION
предоставляет возможность использовать подключение в Delta Live Tables для приема данных из источника данных в Azure Databricks. Однако, если оно предоставлено на уровне хранилища метаданных, оно позволяет просматривать только сведения о подключениях в хранилище метаданных. Пользователи по-прежнему должны быть предоставленыUSE CONNECTION
для отдельных подключений для их использования.
Необходимые разрешения: администратор хранилища метаданных или владелец подключения.
Обозреватель каталогов
Чтобы предоставить разрешение на использование подключения, выполните следующие действия.
В рабочей области Azure Databricks щелкните "Каталог".
В верхней части области каталога щелкните значок шестеренки и выберите "Подключения " в меню.
Кроме того, на странице быстрого доступа нажмите кнопку "Внешние данные>" и перейдите на вкладку "Подключения".
Найдите подключение и выберите его.
На вкладке "Разрешения" нажмите кнопку "Предоставить".
В диалоговом окне "Предоставление"
<connection-name>
начните вводить имя пользователя или группы или щелкните меню пользователя, чтобы просмотреть и выбрать пользователей и группы.Выберите привилегии, которые вы хотите предоставить.
Ознакомьтесь с описанием привилегий в разделе введение.
Нажмите кнопку "Предоставить".
Чтобы отменить привилегию подключения, выполните следующие действия.
- Выполните описанные выше действия, чтобы открыть вкладку "Разрешения " для подключения.
- Выберите пользователя или группу, привилегии которой требуется отменить.
- Нажмите кнопку " Отменить" на вкладке и в диалоговом окне подтверждения.
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>;
Удаление подключений
Необходимые разрешения: владелец подключения
Обозреватель каталогов
В рабочей области Azure Databricks щелкните "Каталог".
В верхней части области каталога щелкните значок шестеренки и выберите "Подключения " в меню.
Кроме того, на странице быстрого доступа нажмите кнопку "Внешние данные>" и перейдите на вкладку "Подключения".
Найдите подключение и выберите его.
Щелкните меню кебаб и нажмите кнопку "Удалить".
В диалоговом окне подтверждения нажмите кнопку "Удалить".
SQL
Выполните следующую команду в записной книжке или редакторе sql-запросов Databricks.
DROP CONNECTION [IF EXISTS] <connection-name>;