Управление каталогом по умолчанию

В этой статье представлен каталог каталога Unity по умолчанию, объясняется, как решить, какой каталог использовать в качестве стандартного каталога и как изменить его.

Что такое каталог по умолчанию в каталоге Unity?

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

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

Команды, которые не указывают каталог (например, GRANT CREATE TABLE ON SCHEMA myschema TO mygroup) оцениваются для каталога в следующем порядке:

1. Задан ли каталог для сеанса с помощью инструкции USE CATALOG или параметра JDBC?
2. Настроена ли конфигурация Spark spark.databricks.sql.initial.catalog.namespace в кластере?
3. Существует ли набор каталога рабочей области по умолчанию для кластера?

Важный

Конфигурация конвейера для delta Live Tables задает каталог по умолчанию, переопределяющий рабочую область по умолчанию.

Конфигурация каталога по умолчанию при включении каталога Unity

Каталог по умолчанию, настроенный для вашей рабочей области, зависит от того, как ваша рабочая область была включена для каталога Unity:

• Для некоторых рабочих областей, которые были автоматически подключены к каталогу Unity, каталог рабочего пространства был установлен как каталог по умолчанию в. См. автоматическое включение каталога Unity.
• Для всех остальных рабочих областей каталог hive_metastore был задан в качестве каталога по умолчанию.

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

Изменение каталога по умолчанию

Администратор рабочей области может изменить каталог по умолчанию для рабочей области. Любой пользователь с разрешением на создание или изменение вычислительного ресурса может задать другой каталог по умолчанию для вычислительного ресурса.

Предупреждение

Изменение каталога по умолчанию может нарушить существующие операции с данными, которые зависят от него.

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

1. Войдите в рабочую область в качестве администратора рабочей области.
2. Щелкните имя пользователя в верхней панели рабочего пространства и выберите Настройки администратора в раскрывающемся списке.
3. Перейдите на вкладку Дополнительно.
4. В каталоге по умолчанию для строки рабочей области введите имя каталога и нажмите кнопку Сохранить.

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

Вы также можете переопределить каталог по умолчанию для определенного кластера, задав следующую конфигурацию Spark в кластере. Этот подход недоступен для хранилищ SQL:

spark.databricks.sql.initial.catalog.namespace

Инструкции см. в разделе "Конфигурация Spark".

Просмотр текущего каталога по умолчанию

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

Параметры администратора

1. Войдите в рабочую область в качестве администратора рабочей области.
2. Щелкните ваше имя пользователя на верхней панели рабочей области и выберите Параметры администратора в раскрывающемся списке.
3. Перейдите на вкладку Дополнительно.
4. В каталоге по умолчанию для строки рабочей области просмотрите имя каталога.

SQL

Выполните следующую команду в записной книжке или запросе редактора SQL, работающем в хранилище SQL или в кластере, совместимом с каталогом Unity. Каталог рабочей области по умолчанию возвращается до тех пор, пока для сеанса не задан параметр USE CATALOG или настройка JDBC, и пока для кластера не задана конфигурация spark.databricks.sql.initial.catalog.namespace.

SELECT current_catalog();