ALTER SCHEMA

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 és DATABASE használata felcserélhető, a SCHEMA előnyben részesítendő.

Szintaxis

ALTER SCHEMA schema_name
    { DEFAULT COLLATION default_collation_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

• schema_name

  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.

• ALAPÉRTELMEZETT BETŰREND default_collation_name

  A következőre vonatkozik: Databricks SQL Databricks Runtime 17.1 és újabb

  Módosítja a sémában definiált új objektumok alapértelmezett rendezési módját. A séma meglévő objektumainak alapértelmezett rendezése nem módosul.

• DBPROPERTIES ( kulcs = val [, ...] )

  A beállítani vagy feloldani kívánt sématulajdonságok.

• [ SET ] TULAJDONOS A FŐ

  Átadja a séma tulajdonjogát a principal részére.

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

  SET választható kulcsszóként engedélyezett.

• SET CÍMKÉK ( { tag_name = tag_value } [, ...] )

  Címkék alkalmazása a sémára. A sémára címkét kell alkalmaznia USE SCHEMA.

  A következőkre vonatkozik: Databricks SQL igen Databricks Runtime 13.3 LTS és újabb

• UNSET TAGS ( tag_name [, ...] )

  Távolítsa el a címkéket a sémából. Ahhoz, hogy eltávolítson egy címkét a sémából, szüksége van USE SCHEMA.

  A következőkre vonatkozik: Databricks SQL igen Databricks Runtime 13.3 LTS és újabb

• tag_name

  Egy literál STRING. A tag_name sémán belül egyedinek kell lennie.

• tag_value

  Egy literál STRING.

• { ENGEDÉLYEZÉS | LETILTÁS | ÖRÖKLÉS } PREDIKTÍV OPTIMALIZÁLÁS

  A következőkre vonatkozik:Databricks SQL Databricks Runtime 12.2 LTS és a Unity Catalog felett csak

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

-- Alter the default collation of a schema
> ALTER SCHEMA my_schema DEFAULT COLLATION UNICODE_CI_AI;

Kapcsolódó cikkek

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