ALTER VIEW

適用対象:チェックマーク、はい 、Databricks、SQL 、チェックマーク、はい 、Databricksランタイム。

ビューに関連付けられているメタデータを変更します。 TBLPROPERTIESを設定することで、ビューの定義の変更、ビューの名前の変更、メタデータの設定または設定解除を行うことができます。 メトリックビューでは、 関係性の追加 や削除も可能です(Beta)。

ビューにコメントを追加または変更するには、 COMMENT ONを使用します。

ビューがキャッシュされている場合、このコマンドを使用して、ビューのキャッシュされたデータとそれを参照するすべての依存をクリアします。 ビューのキャッシュは、ビューが次にアクセスされるときに遅延で格納されます。 このコマンドは、ビューの依存ファイルをキャッシュされていない状態のままにします。

必要な特権

Unity カタログを使用する場合、次の操作ではビューの所有権は必要ありません。

  • SET TAGS: APPLY TAG特権が必要です。
  • UNSET TAGS: APPLY TAG特権が必要です。

次の操作では、ビューの所有権が必要です。

  • SET TBLPROPERTIES
  • UNSET TBLPROPERTIES
  • AS query (ビュー定義の変更)
  • WITH SCHEMA (スキーマバインディングの変更)

RENAME TO ビューに対する MANAGE 特権が必要です。

ADD CONSTRAINT DROP CONSTRAINTメトリックビューまたは所有権に対するMANAGE権限に加え、カタログおよびスキーマのUSE CATALOGおよびUSE SCHEMAが必要になります。 ADD CONSTRAINT リレーションシップには、ターゲットのメトリックビューに対する SELECT 権限に加え、ターゲットのカタログおよびスキーマに対する USE CATALOG および USE SCHEMA が必要です。

SET OWNER TOの場合、必要な特権は新しい所有者によって異なります。

  • プリンシパルが自分の場合は、ビューに対する MANAGE 特権が必要です。
  • プリンシパルがグループの場合は、そのグループのメンバーである必要があります。
  • それ以外の場合は、メタストア管理者である必要があります。

構文

ALTER VIEW view_name
  { rename |
    SET TBLPROPERTIES clause |
    UNSET TBLPROPERTIES clause |
    alter_body |
    schema_binding |
    owner_to |
    SET TAGS clause |
    UNSET TAGS clause |
    add_constraint |
    drop_constraint }

rename
  RENAME TO to_view_name

alter_body
  AS { query | yaml_definition }

yaml_definition
  $$
    yaml_string
  $$

schema_binding
  WITH SCHEMA { BINDING | [ TYPE ] EVOLUTION | COMPENSATION }

property_key
  { identifier [. ...] | string_literal }

owner_to
  [ SET ] OWNER TO principal

add_constraint
  ADD [ CONSTRAINT name ] relationship_constraint

relationship_constraint
  cardinality RELATIONSHIP TO target_view [ [ AS ] target_alias ]
    { ON condition | USING ( column [, ...] ) }

cardinality
  { MANY | ONE } TO { MANY | ONE }

drop_constraint
  DROP CONSTRAINT [ IF EXISTS ] name

パラメーター

  • view_name

    変更するビューを指定します。 ビューが見つからない場合、Azure Databricks によって TABLE_OR_VIEW_NOT_FOUND エラーが発生します。

  • 名前をto_view_nameにリネーム

    既存のビューの名前を to_view_nameに変更します。

    Unity カタログ ビューの場合、 to_view_name は view_nameと同じカタログ内にある必要があります。 他のビューの場合、 to_view_name は view_nameと同じスキーマ内にある必要があります。

    to_view_nameが修飾されていない場合は、現在のスキーマで暗黙的に修飾されます。

    具体化されたビューの名前を変更することはできません。

  • SET TBLプロパティ

    1 つ以上のユーザー定義プロパティを設定またはリセットします。

  • UNSET TBLPROPERTIES

    1 つ以上のユーザー定義プロパティを削除します。

  • AS クエリ

    ベース テーブルまたはその他のビューからビューを構築するクエリです。

    AS query メトリックビューではサポートされていません。

    この句は、ビューに付与された権限が保持される点を除いて、既存のビューの CREATE OR REPLACE VIEW ステートメントと同じです。

  • As yaml_definition

    適用対象:チェックチェック済み [はい ] Databricks SQL チェックチェック [はい ] Databricks ランタイム 16.4 以上 チェック チェック済み Unity カタログのみ

    メトリックビューのYAML定義。

    この句は、ビューに付与された権限が保持される点を除いて、既存のビューの CREATE OR REPLACE VIEW ステートメントと同じです。

    YAML 定義を再指定すると、構文を変更することなく、メトリック ビューの parameters が追加、削除、または変更されます。 パラメーターの構文については、 CREATE VIEWを参照してください。 パラメーターには、Databricks Runtime 18.2 以降が必要です。

  • schema_binding

    適用対象:チェックチェック済み Databricks SQL チェックチェック はい Databricks ランタイム 15.3 以上

    基になるオブジェクト定義の変更により、ビューの後続のクエリがビューのスキーマの変更にどのように適応するかを指定します。 スキーマ バインド モードの詳細については、CREATE VIEWを参照してください。SCHEMA も一緒にご覧ください。

    この句は、メトリック ビューではサポートされていません。

  • [SET] オーナーから校長へ

    ビューの所有権を principal に移します。 ビューが hive_metastoreで定義されていない限り、所有しているグループにのみ所有権を譲渡できます。 他のプリンシパルに所有権を移転できるのはメタストア管理者だけです。 「必須権限」を参照してください。

    適用対象:チェックで「はい」とマークされています Databricks SQL チェックで「はい」とマークされています Databricks Runtime 11.3 LTS以上

    SET オプションキーワードとして許可されています。

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

    ビューにタグを適用します。 ビューにタグを追加するには、 APPLY TAG 権限が必要です。

    適用対象:チェックマーク はい Databricks SQL チェック はい Databricks ランタイム 13.3 LTS 以上

  • 未設定タグ(tag_name[...])

    ビューからタグを削除します。 ビューからタグを削除するには、 APPLY TAG 特権が必要です。

    適用対象:チェックマーク はい Databricks SQL チェック はい Databricks ランタイム 13.3 LTS 以上

  • tag_name

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

  • tag_value

    リテラル STRING。

  • add_constraint

    対象:チェックマーク はい Databricks SQL チェック チェック はい Databricks ランタイム 19 以上 はい チェックマーク Unity カタログのみ

    メトリックビューからターゲットメトリックビューへの情報的関係性を追加します。 この条項は ベータ版です。 view_nameとtarget_viewの両方がUnity Catalogのメトリクスビューでなければなりません。 一時的なメトリックビューはサポートされていません。 Azure Databricksは関係を強制しません。 「 メトリックビュー間の関係」を参照してください。

    • CONSTRAINT 名称

      関係性に名前を付けるのは任意です。 名前はスキーマ内のすべての制約の中で一意でなければなりません。 もし省略すると、Azure Databricksは関係を2つの計量ビューの無条件の名前で<source>_to_<target>名付けます。

    • 基数

      MANY TO ONE、ONE TO MANY、ONE TO ONE、またはMANY TO MANYのいずれか。 Azure Databricksはデータを基数と照合しません。

    • target_view

      ターゲットメトリックビューを識別します。 ターゲットは同じメタストアの任意のカタログやスキーマに存在できます。

    • target_alias

      オプションでターゲットを conditionに設定することもできます。 計量観から自身との関係は、 view_nameの名前とは異なる別名を必要とします。

    • 条件付き

      view_name と target_view の列に対する決定論的 BOOLEAN 式で、結合の ON 節と同じ規則を持つ。 この表現は小節を指すことはできません。 MEASUREやAGGを含む集計関数、ウィンドウ関数、ジェネレーターを呼び出すことはできません。 最大1,024文字まで可能です。

    • 使用中(列[, ...])

      同じ名前の列が両方のメトリックビューで存在する1列から20列までです。

  • drop_constraint

    対象:チェックマーク はい Databricks SQL チェック チェック はい Databricks ランタイム 19 以上 はい チェックマーク Unity カタログのみ

    メートル法の視点から関係性 name を外します。 この条項は ベータ版です。 IF EXISTSを指定すると、その名前に関係が存在しない場合に文が成功します。 それ以外の場合は、 NO_SUCH_CONSTRAINT_EXCEPTIONで失敗します。

    Warning

    関係を終わらせるときに RESTRICT や CASCADE を明言しないでください。 ALTER TABLE DROP CONSTRAINTとは異なり、これらのキーワードには関係性における明確な挙動がなく、今後のリリースでその挙動が変わる可能性もあります。

例

-- Rename only changes the view name.
-- The source and target schemas of the view must be the same.
-- Use qualified or unqualified name for the source and target view.
> ALTER VIEW tempsc1.v1 RENAME TO tempsc1.v2;

-- Verify that the new view is created.
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2

-- Before ALTER VIEW SET TBLPROPERTIES
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   null
                            c2    string   null

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Set properties in TBLPROPERTIES
> ALTER VIEW tempsc1.v2 SET TBLPROPERTIES ('created.by.user' = "John", 'created.date' = '01-01-2001' );

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                                                   int   NULL
                            c2                                                string   NULL

  # Detailed Table Information
                      Database                                               tempsc1
                         Table                                                    v2
              Table Properties [created.by.user=John, created.date=01-01-2001, ....]

-- Remove the key created.by.user and created.date from `TBLPROPERTIES`
> ALTER VIEW tempsc1.v2 UNSET TBLPROPERTIES (`created`.`by`.`user`, created.date);

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify the changes
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Change the view definition
> ALTER VIEW tempsc1.v2 AS SELECT * FROM tempsc1.v1;

-- Use `DESCRIBE TABLE EXTENDED` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                        int   NULL
                            c2                     string   NULL

  # Detailed Table Information
                      Database                    tempsc1
                         Table                         v2
                          Type                       VIEW
                     View Text   select * from tempsc1.v1
            View Original Text   select * from tempsc1.v1

-- Transfer ownership of a view to another user
> ALTER VIEW v1 OWNER TO `alf@melmak.et`

-- Change the view schema binding to adopt type evolution
> ALTER VIEW v1 WITH SCHEMA TYPE EVOLUTION;

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

-- Remove three tags from the view named `test`.
> ALTER VIEW test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Alter the metric view `region_sales_metrics` defined in CREATE VIEW
-- to drop the `total_revenue_for_open_orders` measure.
> ALTER VIEW region_sales_metrics
  AS $$
   version: 0.1
   source: samples.tpch.orders
   filter: o_orderdate > '1990-01-01'
   dimensions:
   - name: month
     expr: date_trunc('MONTH', o_orderdate)
   - name: status
     expr: case
       when o_orderstatus = 'O' then 'Open'
       when o_orderstatus = 'P' then 'Processing'
       when o_orderstatus = 'F' then 'Fulfilled'
       end
   - name: order_priority
     expr: split(o_orderpriority, '-')[1]
   measures:
   - name: count_orders
     expr: count(1)
   - name: total_revenue
     expr: SUM(o_totalprice)
   - name: total_revenue_per_customer
     expr: SUM(o_totalprice) / count(distinct o_custkey)
  $$;

> DESCRIBE EXTENDED region_sales_metrics;
 col_name                    data_type
 month                       timestamp
 status                      string
 order_priority              string
 count_orders                bigint measure
 total_revenue               decimal(28,2) measure
 total_revenue_per_customer  decimal(38,12) measure

 # Detailed Table Information
 Catalog                     main
 Database                    default
 Table                       region_sales_metrics
 Owner                       alf@melmak.et
 Created Time                Sun May 18 23:45:25 UTC 2025
 Last Access                 UNKNOWN
 Created By                  Spark
 Type                        METRIC_VIEW
 Comment                     A metric view for regional sales metrics.
 View Text                   "
    version: 0.1
    source: samples.tpch.orders
    filter: o_orderdate > '1990-01-01'
    dimensions:
    - name: month
      expr: date_trunc('MONTH', o_orderdate)
    - name: status
      expr: case
        when o_orderstatus = 'O' then 'Open'
        when o_orderstatus = 'P' then 'Processing'
        when o_orderstatus = 'F' then 'Fulfilled'
        end
    - name: order_priority
      expr: split(o_orderpriority, '-')[1]
    measures:
    - name: count_orders
      expr: count(1)
    - name: total_revenue
      expr: SUM(o_totalprice)
    - name: total_revenue_per_customer
      expr: SUM(o_totalprice) / count(distinct o_custkey)
   "
 Language                    YAML
 Table Properties            [metric_view.from.name=samples.tpch.orders, metric_view.from.type=ASSET, metric_view.where=o_orderdate > '1990-01-01']

-- Declare that each order in the `orders_mv` metric view matches one customer
-- in the `customers_mv` metric view, joined on the shared `customer_id` column.
> ALTER VIEW main.sales.orders_mv ADD CONSTRAINT orders_customer
    MANY TO ONE RELATIONSHIP TO main.sales.customers_mv
    USING (customer_id);

-- Declare a relationship that refers to the target by an alias in the ON condition.
> ALTER VIEW main.travel.flights_mv ADD CONSTRAINT departure_city
    MANY TO ONE RELATIONSHIP TO main.travel.cities_mv AS c
    ON flights_mv.departure_city_id = c.city_id;

-- Drop the relationship.
> ALTER VIEW main.travel.flights_mv DROP CONSTRAINT IF EXISTS departure_city;