Delen via

ALTER SCHEMA

  • Artikel

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

Wijzigt de eigenaar van een schema, stelt voorspellend optimalisatiegedrag in of wijzigt metagegevens die zijn gekoppeld aan een schema door de instelling in te stellen DBPROPERTIES. De opgegeven eigenschapswaarden overschrijven een bestaande waarde met dezelfde eigenschapsnaam.

Hoewel het gebruik van SCHEMA en DATABASE uitwisselbaar is, SCHEMA heeft dit de voorkeur.

Syntaxis

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 } }

Parameters

  • schema_name

    De naam van het schema dat moet worden gewijzigd. Als het schema niet kan worden gevonden, genereert Azure Databricks een SCHEMA_NOT_FOUND fout.

  • DBPROPERTIES ( key = val [, ...] )

    De schema-eigenschappen die moeten worden ingesteld of uitgeschakeld.

  • [ SET ] EIGENAAR AAN principal

    Hiermee wordt het eigendom van het schema overgedragen naar principal.

    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.

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

    Tags toepassen op het schema. U moet use_schema een tag toepassen op het schema.

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

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

    Verwijder tags uit het schema. U moet use_schema een tag uit het schema verwijderen.

    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 binnen het schema.

  • tag_value

    Een letterlijke .STRING

  • { ENABLE | UITSCHAKELEN | VOORSPELLENDE OPTIMALISATIE OVERNEMEN}

    Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger vinkje als ja aan dan Unity Catalog

    Hiermee wijzigt u het schema in de gewenste instelling voor voorspellende optimalisatie. Wanneer schema's worden gemaakt, is het gedrag standaard afkomstig INHERIT van de catalogus. Standaard nemen nieuwe objecten die in het schema zijn gemaakt, de instelling over van het schema.

    Als het schema wordt gewijzigd, wordt het gedrag trapsgewijs uitgevoerd op alle objecten die voorspellende optimalisatie overnemen. Objecten die expliciet ENABLE of DISABLE voorspellende optimalisatie niet worden beïnvloed door de schema-instelling.

    Als u voorspellende optimalisatie voor een schema wilt instellen, moet de gebruiker gemachtigd zijn CREATE voor het schema.

    Alleen schema's in niet-Delta Sharing, beheerde catalogi in Unity Catalog komen in aanmerking voor voorspellende optimalisatie.

Voorbeelden

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