ALTER VIEW

Применяется к:установлен Databricks SQL установлен Databricks Runtime

Изменяет метаданные, связанные с представлением. Он может изменить определение представления, переименовать представление и задать или отменить набор метаданных, задав параметр TBLPROPERTIES. Для метрического представления он также может добавлять и отбрасывать отношения (бета).

Чтобы добавить или изменить комментарий в представлении, используйте 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 CATALOGUSE SCHEMA на каталог и схему. ADD CONSTRAINT Для отношений также требуется SELECT привилегия в виде метрики цели, а также USE CATALOGUSE 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 Catalog to_view_name должен находиться в том же каталоге, что и view_name. Для других представлений, to_view_name должен быть в той же схеме, что и view_name.

    Если to_view_name этот параметр не определен, он неявно квалифицируется с текущей схемой.

    Материализованные представления нельзя переименовать.

  • SET Свойства TBL

    Задает или сбрасывает одно или несколько свойств, определяемых пользователем.

  • Незачетные свойства TBL

    Удаляет одно или несколько свойств, определяемых пользователем.

  • AS ЗАПРОС

    Запрос, который создает представление из базовых таблиц или других представлений.

    AS query не поддерживается для представлений метрик.

    Это предложение эквивалентно инструкции CREATE OR REPLACE VIEW в существующем представлении, за исключением того, что права, предоставленные в представлении, сохраняются.

  • КАК yaml_definition

    Применяется к:отмечено да Databricks SQL отмечено да Databricks Runtime 16.4 и выше только каталог Unity отмечен.

    yaml_определение для представления метрик.

    Это предложение эквивалентно инструкции CREATE OR REPLACE VIEW в существующем представлении, за исключением того, что права, предоставленные в представлении, сохраняются.

    Повторное указание определения YAML добавляет, удаляет или изменяет представление parameters метрик без каких-либо изменений синтаксиса. Синтаксис параметра см. в разделе CREATE VIEW. Параметры требуют Databricks Runtime 18.2 и более поздних версий.

  • схема_связывание

    Применяется для:отмечено да Databricks SQL отмечено да Databricks Runtime 15.3 и выше

    Указывает, как последующий запрос представления адаптируется к изменениям схемы представления из-за изменений в определениях базовых объектов. См. CREATE VIEW… SCHEMA для получения сведений о режимах привязки схемы.

    Эта клауза не поддерживается для видов метрик.

  • [ SET ] ВЛАДЕЛЕЦ К principal

    Передает права владения представлением субъекту principal. Если представление не определено в этом hive_metastoreразделе, вы можете передать только группе, к которой вы принадлежите.

    Область применения:отмечено да Databricks SQL отмечено да Databricks Runtime 11.3 LTS и выше

    SET разрешено в качестве необязательного ключевого слова.

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

    Применяет теги к представлению. Для добавления тегов в представление требуется APPLY TAG привилегия.

    Применяется к:Отмечено галочкой: Да Databricks SQL Отмечено галочкой: Да Databricks Runtime 13.3 LTS и выше

  • UNSET TAGS ( tag_name [, ...] )

    Удаляет теги из представления. Для удаления тегов из представления требуется привилегия APPLY TAG .

    Применяется к:Отмечено галочкой: Да Databricks SQL Отмечено галочкой: Да Databricks Runtime 13.3 LTS и выше

  • tag_name

    Литерал STRING. Он tag_name должен быть уникальным в представлении.

  • tag_value

    Литерал STRING.

  • add_constraint

    Применимо к:отмечен галочкой да Databricks SQL отмечен галочкой да Databricks Runtime 19 и выше отмечен галочкой да Unity Catalog только

    Добавляет информационную связь из метрического представления к целевому метрическому виду. Этот пункт находится в бета-версии. Оба view_name и target_view должны быть метричными представлениями Unity Catalog. Временные метрические просмотры не поддерживаются. Azure Databricks не принуждает к отношениям. См. Взаимосвязи между метрическими представлениями.

    • CONSTRAINT Название

      По желанию называет их отношения. Название должно быть уникальным среди всех ограничений схемы. Если вы его опустите, Azure Databricks называет это <source>_to_<target>отношение , используя неуточнённые имена двух представлений метрик.

    • мощность

      Один из MANY TO ONE, ONE TO MANYONE TO ONEили MANY TO MANY. Azure Databricks не проверяет данные по кардинальности.

    • К target_view

      Определяет вид целевой метрики. Цель может находиться в любом каталоге или схеме того же метамагазина.

    • КАК target_alias

      Опционально указывает цель в condition. Отношение с метрической точки зрения с самой собой требует псевдонима, отличающегося от названия view_name.

    • В состоянии ON

      Детерминированное BOOLEAN выражение над столбцами и view_nametarget_view, с теми же правилами, что и ON предложение объединения. Выражение не может отсылать к мере. Он не может вызвать агрегированную функцию, включая MEASURE и AGG, функцию окна или генератор. Может быть до 1 024 символов.

    • ИСПОЛЬЗОВАНИЕ ( столбец [, ...] )

      От одного до 20 столбцов с одинаковым названием в обоих метрических представлениях.

  • drop_constraint

    Применимо к:отмечен галочкой да Databricks SQL отмечен галочкой да Databricks Runtime 19 и выше отмечен галочкой да Unity Catalog только

    Отбрасывает отношение name из метрического взгляда. Этот пункт находится в бета-версии. Если указать IF EXISTS, утверждение успешно работает, когда с этим именем нет никакой связи. В противном случае он завершается ошибкой NO_SUCH_CONSTRAINT_EXCEPTION.

    Предупреждение

    Не уточняйте 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;