ALTER SCHEMA

Platí pro: Databricks SQL Databricks Runtime

Změní vlastníka schématu, nastaví prediktivní optimalizaci chování nebo změní metadata přidružená ke schématu nastavením DBPROPERTIES. Zadané hodnoty vlastností přepíší všechny existující hodnoty se stejným názvem vlastnosti.

I když je používání SCHEMA a DATABASE je zaměnitelné, SCHEMA je upřednostňované.

Syntaxe

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

Parametry

• schema_name

  Název schématu, který se má změnit. Pokud schéma nejde najít, Azure Databricks vyvolá SCHEMA_NOT_FOUND chybu.

• DBPROPERTIES ( klíč = val [; ...] )

  Vlastnosti schématu, které se mají nastavit nebo zrušit.

• [ SET ] VLASTNÍK OBJEKTu zabezpečení

  Přenese vlastnictví schématu do principal.

  Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší

  SET je povolený jako volitelné klíčové slovo.

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

  Přidejte značky k schématu. Abyste mohli na schéma použít značku, musíte mít use_schema.

  Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší

• ZNAČKY UNSET ( tag_name [, ...] )

  Odeberte značky ze schématu. Musíte mít use_schema k odebrání značky ze schématu.

  Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší

• tag_name

  Literál STRING. tag_name musí být v rámci schématu jedinečné.

• tag_value

  Literál STRING.

• { ENABLE | ZAKÁZAT | DĚDIT } PREDIKTIVNÍ OPTIMALIZACE

  platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší, Unity Catalog.

  Změní schéma na požadované nastavení prediktivní optimalizace. Ve výchozím nastavení je při vytváření schémat chování definováno jako INHERIT z katalogu. Ve výchozím nastavení budou nové objekty vytvořené ve schématu dědit nastavení ze schématu.

  Pokud je schéma změněno, chování se kaskádově změní na všechny objekty, které dědí prediktivní optimalizaci. Objekty, které explicitně využívají prediktivní optimalizaci ENABLE nebo DISABLE, nejsou ovlivněny nastavením schématu.

  Aby uživatel mohl nastavit prediktivní optimalizaci schématu, musí mít ke schématu oprávnění CREATE.

  K prediktivní optimalizaci mají nárok pouze schémata mimo Delta Sharing a spravovaná v katalogu Unity Catalog.

Příklady

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

Související články

• CREATE SCHEMA
• DESCRIBE SCHEMA
• DROP SCHEMA
• SHOW SCHEMAS