ÄNDRA SCHEMA

  • Artikel

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

Ändrar ägaren av ett schema, anger förutsägelseoptimeringsbeteende 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 huvudnamn

    Ö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.

  • ANGE TAGGAR ( { tag_name = tag_value } [, ...] )

    Tillämpa taggar på schemat. Du måste use_schema tillämpa 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 use_schema 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 endast för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare markerad ja i Unity Catalog

    Viktigt!

    Den här funktionen finns som allmänt tillgänglig förhandsversion.

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

    Om schemat ändras kommer beteendet att överlappa alla objekt som ärver förutsägelseoptimering. Objekt som uttryckligen ENABLE eller DISABLE förutsägande optimering inte påverkas 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;