Delen via

ALTER VIEW

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Hiermee worden metagegevens gewijzigd die aan de weergave zijn gekoppeld. Het kan de definitie van de weergave wijzigen, de naam van een weergave wijzigen in een andere naam, set en de metagegevens van de weergave opheffen door TBLPROPERTIESin te stellen.

Als u een opmerking aan een weergave of de bijbehorende columnswilt toevoegen of wijzigen, gebruikt u COMMENT ON.

Als de weergave in de cache is opgeslagen, worden met de opdracht gegevens in de cache van de weergave en alle afhankelijke items gewist die ernaar verwijzen. De cache van de weergave wordt vertraagd ingevuld wanneer de weergave de volgende keer wordt geopend. Met de opdracht blijven de afhankelijke items van de weergave ongewijzigd.

Syntaxis

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

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

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

owner_to
  [ SET ] OWNER TO principal

Parameters

  • view_name

    Identificeert de weergave die moet worden gewijzigd. Als de weergave niet kan worden gevonden, wordt er een TABLE_OR_VIEW_NOT_FOUND fout gegenereerd in Azure Databricks.

  • NAAM WIJZIGEN IN to_view_name

    Wijzigt de naam van de bestaande weergave in de schema. Gerealiseerde views kan niet hernoemd worden.

    to_view_name geeft de nieuwe naam van de weergave op. Als het to_view_name al bestaat, wordt er een TableAlreadyExistsException gegenereerd. Als to_view_name is gekwalificeerd, moet deze overeenkomen met de schema naam van view_name.

  • SET TBLPROPERTIES

    Hiermee stelt u een of meer door de gebruiker gedefinieerde eigenschappen in of stelt u deze opnieuw in.

  • NIET-INSTELLEN TBLPROPERTIES

    Hiermee verwijdert u een of meer door de gebruiker gedefinieerde eigenschappen.

  • AS-query

    Een query waarmee de weergave wordt gemaakt op basis van tables of andere views.

    Deze component is gelijk aan een CREATE OR REPLACE VIEW-instructie voor een bestaande weergave, behalve dat de bevoegdheden die voor de weergave zijn verleend, behouden blijven.

  • schema_binding

    Van toepassing op:vinkje als ja aan Databricks Runtime 15.3 en hoger

    Specificeert hoe latere queries van de weergave worden aangepast aan wijzigingen in de schema van de weergave vanwege wijzigingen in de onderliggende objectdefinities. Zie CREATE VIEW... MET SCHEMA voor meer informatie over schema bindingsmodi.

  • [ SET ] EIGENAAR TO principal

    Draagt het eigendom van de weergave over naar principal. Tenzij de weergave is gedefinieerd in de hive_metastore weergave, mag u alleen het eigendom overdragen aan een groep waartoe u behoort.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

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

    Tags toepassen op de weergave. U moet gemachtigd zijn APPLY TAG om tags toe te voegen aan de weergave.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

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

    Remove tags uit de table. U moet APPLY TAG machtiging hebben om tags uit de weergave te remove.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

  • tag_name

    Een letterlijke .STRING De tag_name naam moet uniek zijn in de weergave.

  • tag_value

    Een letterlijke .STRING

Voorbeelden

-- 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');