共用方式為

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

    要建立的目錄名稱。

  • 使用SHARE provider_name.share_name

    選擇性地指定目錄是以 Delta Sharing 共用為基礎。

  • 受控位置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 和更新版本之叢集上受支援。

    另請參閱 適用於 Delta Lake 和 Apache Iceberg 的 Azure Databricks 中的 Unity 目錄受控數據表 和 建立 Unity 目錄中繼存放區。

  • 使用連線 connection_name

    指定來源目錄所在的連接。

  • 評論

    選擇性常 STRING 值。 目錄的描述。

  • 預設排序 default_collation_name

    適用於： ： 核取標記為是 Databricks SQL 核取標記為是 Databricks Runtime 17.1 和更新版本

    可選地定義在目錄中定義的物件的預設排序規則。 如果未指定，預設定序為 UTF8_BINARY。

  • 選項

    設定連線時識別目錄所需的連線類型特定參數。

    • option_name

      Option 鍵。 該鍵可以包含一或多個以點分隔的識別碼，或是 STRING 常值。

      Option 鍵必須是唯一的，而且區分大小寫。

    • 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