Поделиться через

CREATE CATALOG

Область применения:отмечен Databricks SQL отмечен Databricks Runtime 10.4 LTS и более поздней версии отмечен только для каталога Unity

Создает каталог с указанным именем. Если каталог с тем же именем уже существует, создается исключение.

При создании каталога FOREIGN он будет заполнен всеми схемами и их таблицами, видимыми для пользователя проверки подлинности.

Синтаксис

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      COMMENT comment |
      DEFAULT COLLATION default_collation_name |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
    USING CONNECTION connection_name
    [ COMMENT comment ]
    OPTIONS ( { option_name = option_value } [ , ... ] )

Параметры

  • ИНОСТРАННЫЙ

    Область применения:флажок Databricks SQL флажок Databricks Runtime 13.3 LTS и выше

    Указывает, что каталог импортируется из CONNECTION.

  • ЕСЛИ НЕ СУЩЕСТВУЕТ

    Создает каталог с заданным именем, если он не существует. Если каталог с тем же именем уже существует, ничего не произойдет.

  • catalog_name

    Имя создаваемого каталога.

  • ИСПОЛЬЗОВАНИЕ provider_name.share_name

    При необходимости указывает, что каталог основан на разделе Delta Sharing.

    • provider_name

      Имя поставщика Delta Sharing, который предоставил долю.

    • share_name

      Имя доли, предоставленное поставщиком provider_name.

  • Управляемое расположение location_path

    При необходимости указывает путь к управляемому расположению хранилища для каталога, отличного от расположения корневого хранилища хранилища метаданных. Этот путь должен быть определен в конфигурации внешнего расположения, и у вас должна быть CREATE MANAGED STORAGE привилегия на эту конфигурацию. Можно использовать путь, определенный в конфигурации внешнего расположения или подпате (другими словами, 'abfss://container@storageaccount.dfs.core.windows.net/finance' или 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Поддерживается в Databricks SQL или в кластерах под управлением Databricks Runtime 11.3 LTS и более поздних версий.

    См. также управляемые таблицы каталога Unity в Azure Databricks для Delta Lake и Apache Iceberg исоздание хранилища метаданных каталога Unity.

  • ИСПОЛЬЗОВАНИЕ ПОДКЛЮЧЕНИЯ connection_name

    Указывает подключение, в котором находится исходный каталог.

  • комментарий

    Необязательный литерал STRING. Описание каталога.

  • СОРТИРОВКА ПО УМОЛЧАНИЮ default_collation_name

    Применимо к:отмечено Databricks SQL отмечено Databricks Runtime 17.1 и более поздние версии.

    При необходимости определяет параметры сортировки по умолчанию для объектов, определенных в каталоге. Если значение сортировки по умолчанию не указано, будет использоваться UTF8_BINARY.

  • ПАРАМЕТРЫ

    Задает параметры конкретного типа подключения, необходимые для идентификации каталога в соединении.

    • option_name

      клавиша Option. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой, или STRING литерального значения.

      Ключи параметров должны быть уникальными и чувствительны к регистру.

    • option_value

      Значение параметра. Значение должно быть выражением BOOLEAN, STRINGINTEGERили DECIMALконстантой. Это значение также может быть вызовом SECRET функции SQL. Например, value для password может включать secret('secrets.r.us', 'postgresPassword') вместо ввода буквального пароля.

Примеры

-- Create catalog `customer_cat`. This throws exception if catalog with name customer_cat
-- already exists.
> CREATE CATALOG customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist.
> CREATE CATALOG IF NOT EXISTS customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist, with a comment.
> CREATE CATALOG IF NOT EXISTS customer_cat COMMENT 'This is customer catalog';

-- Create a catalog from a Delta Sharing share.
> CREATE CATALOG customer_cat USING SHARE cdc.vaccinedata;

-- Create a catalog with a different managed storage location than the metastore's.
> CREATE CATALOG customer_cat MANAGED LOCATION 'abfss://container@storageaccount.dfs.core.windows.net/finance';

-- Create a catalog with a case insesnitive and accent insensitive default collation.
> CREATE CATALOG customer_cat DEFAULT COLLATION UNICODE_CI_AI;

-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');
  • Last updated on