次の方法で共有

CREATE CATALOG

適用対象:check marked yes Databricks SQL Databricks Runtime 10.4 LTS 以降 「はい」のチェック マーク Unity Catalog のみ

指定した名前のカタログを作成します。 同じ名前のカタログが既に存在する場合は、例外が発生します。

FOREIGN カタログを作成すると、認証ユーザーに表示されるすべてのスキーマとそのテーブルが設定されます。

構文

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 } [ , ... ] )

パラメーター

  • 外国人

    適用対象:check marked yes 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 リテラル (省略可能)。 カタログの説明。

  • オプション

    接続でカタログを識別するために必要な接続の種類固有のパラメータを設定します。

    • option_name

      オプション キー。 キーは、ドットで区切られた 1 つまたは複数の識別子、あるいは STRING リテラルで構成できます。

      オプション キーは一意である必要があり、大文字と小文字が区別されます。

    • オプション値

      オプションの値。 値は、BOOLEAN、STRING、INTEGER、または DECIMAL 定数式である必要があります。 値は、SQL 関数の SECRET 呼び出しである場合もあります。 たとえば、 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');