ALTER VIEW

2025-05-30

Gäller för: markerad ja Databricks SQL Databricks Runtime

Ändrar metadata som är associerade med vyn. Den kan ändra definitionen av vyn, ändra namnet på en vy till ett annat namn, ange och ta bort metadata för vyn genom att ange TBLPROPERTIES.

Om du vill lägga till eller ändra en kommentar i en vy använder du COMMENT ON.

Om vyn cachelagras rensar kommandot cachelagrade data i vyn och alla dess beroenden som refererar till den. Vyns cache fylls dynamiskt när vyn nås nästa gång. Kommandot lämnar vyns beroenden oåtkomliga.

Syntax

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

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
  { idenitifier [. ...] | string_literal }

owner_to
  [ SET ] OWNER TO principal

Parametrar

view_name

Identifierar vyn som ska ändras. Om vyn inte kan hittas genererar Azure Databricks ett TABLE_OR_VIEW_NOT_FOUND fel.
Byt namn till to_view_name

Byter namn på den befintliga vyn till to_view_name.

För Unity-katalogvyer måste vara to_view_name i samma katalog som view_name. För andra vyer to_view_name måste vara inom samma schema som view_name.

Om to_view_name är okvalificerad är det implicit kvalificerat med det aktuella schemat.

Det går inte att byta namn på materialiserade vyer.
- SET TBLPROPERTIES
Anger eller återställer en eller flera användardefinierade egenskaper.
AVSTÄLL TBLPROPERTIES

Tar bort en eller flera användardefinierade egenskaper.
AS-fråga

En sökfråga som konstruerar vyn från bastabeller eller andra vyer.

AS query stöds inte för måttvyer.

Den här satsen motsvarar en CREATE OR REPLACE VIEW-instruktion i en befintlig vy, förutom att behörigheter som beviljas för vyn bevaras.
AS-yaml_definition

Gäller för: Databricks SQL Databricks Runtime 16.4 och senare Endast Unity Catalog

En "yaml_definition" för en måttvy.

Den här satsen motsvarar en CREATE OR REPLACE VIEW-instruktion i en befintlig vy, förutom att behörigheter som beviljas för vyn bevaras.
schema_binding

Gäller för: Databricks SQL Databricks Runtime 15.3 och senare

Anger hur efterföljande frågor i vyn anpassas till ändringar i vyns schema på grund av ändringar i de underliggande objektdefinitionerna. Se CREATE VIEW... MED SCHEMA för information om schemabindningslägen.

Den här klausulen stöds inte för måttvyer.
[ SET ] ÄGARE TILL huvudman

Överför ägarskapet för vyn till principal. Om inte vyn definieras i hive_metastore kan du bara överföra ägarskapet till en grupp som du tillhör.

Gäller för: Databricks SQL Databricks Runtime 11.3 LTS och senare

SET tillåts som ett valfritt nyckelord.
SET TAGGAR ( { taggnamn = taggvärde } [, ...] )

Applicera taggar till vyn. Du måste ha APPLY TAG behörighet att lägga till taggar i vyn.

Gäller för: Databricks SQL Databricks Runtime 13.3 LTS och senare
TA BORT TAGGAR ( tag_name [, ...] )

Ta bort taggar från tabellen. Du måste ha behörighet APPLY TAG för att ta bort taggar från vyn.

Gäller för: Databricks SQL Databricks Runtime 13.3 LTS och senare
tag_name

En bokstavlig STRING. tag_name måste vara unikt i vyn.
tag_value

En bokstavlig STRING.

Exempel

-- Rename only changes the view name.
-- The source and target schemas of the view have to 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;

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

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

-- Alter a 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
 prder_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: prder_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']

Feedback

Var den här sidan till hjälp?

Dela via

ALTER VIEW

Syntax

Parametrar

Exempel

Relaterade artiklar

Feedback

Ytterligare resurser