ALTER SCHEMA

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Změní vlastníka schématu, nastaví chování prediktivní optimalizace 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 K objektu zabezpečení

    Přenese vlastnictví schématu do principal.

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

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

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

    Použít značky na schéma. U schématu musíte use_schema použít značku.

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

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

    Odeberte značky ze schématu. Musíte use_schema ze schématu odebrat značku.

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

  • tag_name

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

  • tag_value

    Literál STRING.

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

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 12.2 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

    Důležité

    Tato funkce je ve verzi Public Preview.

    Změní schéma na požadované nastavení prediktivní optimalizace. Ve výchozím nastavení se při vytváření schémat jedná o INHERIT chování z katalogu. Ve výchozím nastavení zdědí nové objekty vytvořené ve schématu nastavení.

    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ě ENABLE nebo DISABLE prediktivní optimalizace nejsou nastavením schématu ovlivněny.

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

    K prediktivní optimalizaci mají nárok pouze schémata v jiných než rozdílových sdíleních a spravovaných katalogech v katalogu Unity.

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;