ALTER SCHEMA
Platí pro: Databricks SQL 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
-
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: Databricks SQL 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: Databricks SQL 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: Databricks SQL 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: Databricks SQL Databricks Runtime 12.2 LTS a vyšší 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
neboDISABLE
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;