ALTER SCHEMA

  • [アーティクル]

適用対象: 「はい」のチェック マーク Databricks SQL Databricks Runtime

スキーマの所有者を変更するか、予測最適化の動作を設定するか、DBPROPERTIES を設定することでスキーマに関連付けられているメタデータを変更します。 指定したプロパティ値によって、同じプロパティ名を持つ既存の値がオーバーライドされます。

SCHEMA と DATABASE の使用は交換可能ですが、SCHEMA をお勧めします。

構文

ALTER SCHEMA schema_name
   { SET DBPROPERTIES ( { key = val } [, ...] ) |
    [ SET ] OWNER TO principal
    SET TAGS ( { tag_name = tag_value } [, ...] ) |
    UNSET TAGS ( tag_name [, ...] ) |
    { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION } }

パラメーター

  • schema_name

    変更するスキーマの名前。 スキーマが見つからない場合、Azure Databricks では SCHEMA_NOT_FOUND エラーが生じます。

  • DBPROPERTIES ( key = val [, …] )

    設定または設定解除するスキーマ プロパティ。

  • [ SET ] OWNER TO プリンシパル

    スキーマの所有権を principal に譲渡します。

    適用対象: check marked yes Databricks SQL 「はい」のチェックマーク Databricks Runtime 11.3 LTS 以上

    SET は省略可能なキーワードとして使用できます。

  • SET TAGS ( { tag_name = tag_value } [, …] )

    スキーマにタグを適用します。 スキーマにタグを適用するには、use_schema が必要です。

    適用対象: check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上

  • UNSET TAGS ( tag_name [, …] )

    スキーマからタグを削除します。 スキーマからタグを削除するには、use_schema が必要です。

    適用対象: check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上

  • tag_name

    リテラル STRING。 tag_name はスキーマ内で一意である必要があります。

  • tag_value

    リテラル STRING。

  • { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

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

    重要

    この機能はパブリック プレビュー段階にあります。

    スキーマを目的の予測最適化設定に変更します。 既定では、スキーマが作成されたときの動作はカタログからの INHERIT です。 既定では、スキーマ内に作成された新しいオブジェクトは、スキーマから設定を継承します。

    スキーマが変更されると、その動作は予測最適化を継承するすべてのオブジェクトに連鎖していきます。 明示的に予測最適化の ENABLE または DISABLE を行うオブジェクトは、スキーマ設定の影響を受けません。

    スキーマの予測最適化を設定するには、ユーザーはそのスキーマに対する CREATE アクセス許可を持っている必要があります。

    予測最適化の対象となるのは、Unity Catalog 内の、Delta Sharing 以外のマネージド カタログ内のスキーマだけです。

例

-- Creates a schema named `inventory`.
> CREATE SCHEMA inventory;

-- Alters the schema to set properties `Edited-by` and `Edit-date`.
> ALTER SCHEMA inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
> DESCRIBE SCHEMA EXTENDED inventory;
 database_description_item                 database_description_value
 ------------------------- ------------------------------------------
             Database Name                                  inventory
               Description
                  Location    file:/temp/spark-warehouse/inventory.db
                Properties ((Edit-date,01/01/2001), (Edited-by,John))

-- Transfer ownership of the schema to another user
> ALTER SCHEMA inventory OWNER TO `alf@melmak.et`

-- Applies three tags to the schema named `test`.
> ALTER SCHEMA test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the schema named `test`.
> ALTER SCHEMA test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Enables predictive optimization for objects in schema my_schema
> ALTER SCHEMA my_schema ENABLE PREDICTIVE OPTIMIZATION;