SÉMA MÓDOSÍTÁSA
A következőkre vonatkozik: Databricks SQL Databricks Runtime
Módosítja a séma tulajdonosát, beállítja a prediktív optimalizálási viselkedést, vagy módosítja a sémához társított metaadatokat a beállítással DBPROPERTIES
. A megadott tulajdonságértékek felülírják az azonos tulajdonságnévvel rendelkező meglévő értékeket.
Bár a SCHEMA
használat és DATABASE
a felcserélhető, SCHEMA
előnyben részesített.
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 } }
Paraméterek
-
A módosítani kívánt séma neve. Ha a séma nem található, az Azure Databricks SCHEMA_NOT_FOUND hibát jelez.
DBPROPERTIES ( kulcs = val [, ...] )
A beállítani vagy feloldani kívánt sématulajdonságok.
[ SET ] TULAJDONOS – FŐ
Átviszi a séma tulajdonjogát a következőbe
principal
: .A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb
SET
választható kulcsszóként engedélyezett.CÍMKÉK BEÁLLÍTÁSA ( { tag_name = tag_value } [, ...] )
Címkék alkalmazása a sémára. Címkét kell
use_schema
alkalmaznia a sémára.A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb
UNSET TAGS ( tag_name [, ...] )
Távolítsa el a címkéket a sémából. El kell
use_schema
távolítania egy címkét a sémából.A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb
tag_name
Egy literál
STRING
. Atag_name
sémán belül egyedinek kell lennie.tag_value
Egy literál
STRING
.{ ENABLE | LETILTÁS | INHERIT } PREDIKTÍV OPTIMALIZÁLÁS
A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és a Unity Catalog felett csak
Fontos
Ez a funkció a nyilvános előzetes verzióban érhető el.
Módosítja a sémát a kívánt prediktív optimalizálási beállításra. A sémák létrehozásakor a viselkedés
INHERIT
alapértelmezés szerint a katalógusból származik. Alapértelmezés szerint a sémában létrehozott új objektumok öröklik a beállítást a sémából.Ha a séma módosul, a viselkedés kaszkádolni fog minden olyan objektumra, amely örökli a prediktív optimalizálást. A sémabeállítás nem befolyásolja a explicit vagy
ENABLE
DISABLE
prediktív optimalizálást biztosító objektumokat.A séma prediktív optimalizálásának beállításához a felhasználónak engedéllyel kell rendelkeznie
CREATE
a sémához.Csak a nem deltamegosztási sémák, a Unity Katalógus felügyelt katalógusai jogosultak prediktív optimalizálásra.
Példák
-- 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;