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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

spark.databricks.sql.initial.catalog.name

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

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

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

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

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

SQL

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

SELECT current_catalog();