Dela via

ALTER SCHEMA

  • Artikel

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

Ändrar ägaren av ett schema, anger förutsägande optimering beteende eller ändrar metadata som är associerade med ett schema genom att ange DBPROPERTIES. De angivna egenskapsvärdena åsidosätter alla befintliga värden med samma egenskapsnamn.

Även om användning av SCHEMA och DATABASE är utbytbar, SCHEMA är att föredra.

Syntax

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

Parametrar

  • schema_name

    Namnet på schemat som ska ändras. Om schemat inte kan hittas genererar Azure Databricks ett SCHEMA_NOT_FOUND fel.

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

    De schemaegenskaper som ska anges eller tas bort.

  • [ SET ] ÄGARE TILL huvudman

    Överför ägarskapet för schemat till principal.

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

    SET tillåts som ett valfritt nyckelord.

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

    Tillämpa taggar på schemat. Du måste ha use_schema för att applicera en tagg på schemat.

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

  • TA BORT TAGGAR ( tag_name [, ...] )

    Ta bort taggar från schemat. Du måste ha use_schema för att ta bort en tagg från schemat.

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

  • tag_name

    En literal STRING. tag_name måste vara unikt i schemat.

  • tag_value

    En literal STRING.

  • { AKTIVERA | INAKTIVERA | ÄRV } FÖRUTSÄGANDE OPTIMERING

    gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 12.2 LTS och senare markerad som ja endast Unity Catalog

    Ändrar schemat till önskad inställning för förutsägelseoptimering. När scheman skapas är standardbeteendet att INHERIT från katalogen. Som standard ärver nya objekt som skapats i schemat inställningen från schemat.

    Om schemat ändras kommer beteendet att påverka alla objekt som ärver prediktiv optimering. Objekt som uttryckligen använder ENABLE- eller DISABLE-prediktiv optimering påverkas inte av schemainställningen.

    Om du vill ange förutsägelseoptimering för ett schema måste användaren ha CREATE behörighet för schemat.

    Endast scheman i icke-Delta-delning, hanterade kataloger i Unity Catalog är berättigade till förutsägelseoptimering.

Exempel

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