共用方式為

CREATE CATALOG

  • 發行項

適用於：已勾選 Databricks SQL 已勾選 Databricks Runtime 10.4 LTS 和更新版本，已勾選 Unity Catalog

使用指定的名稱建立 catalog。 如果已經存在相同名稱的 catalog，則會拋出例外狀況。

當您建立 FOREIGNcatalog 時，它會填入驗證使用者可以看到的所有架構及其 tables。

語法

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

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

Parameters

  • FOREIGN

    適用於：核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本

    指定從 CONNECTION匯入 catalog。

  • IF NOT EXISTS

    如果指定名稱不存在，請建立具有指定名稱的 catalog。 如果具有相同名稱的 catalog 已經存在，則將不會有任何變化。

  • catalog_name

    要建立 catalog 的名稱。

  • 使用SHARE provider_name.share_name

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

  • 受控位置location_path

    選擇性地指定與中繼存放區根記憶體位置不同之 catalog 受控儲存位置的路徑。 此路徑必須在外部位置組態中定義，而且您必須具有外部位置組態的 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 和更新版本之叢集上受支援。

    另請參閱 使用受控 tables 和 建立 Unity Catalog 中繼存放區。

  • 使用連線 connection_name

    指定來源 catalog 所在的連接 where。

  • comment

    選擇性常 STRING 值。 catalog的描述。

  • OPTIONS

    設定連線類型特定的 parameters，以識別連線上的 catalog。

    • option_name

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

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

    • option_value

      該選項的值。 該值必須是 BOOLEAN、STRING、INTEGER 或 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 foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');