ALTER SCHEMA

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

Změní vlastníka schématu, změní umístění spravovaného úložiště schématu, nastaví chování prediktivní optimalizace , změní metadata přidružená ke schématu nastavením DBPROPERTIESnebo nastaví dobu obnovení pro vyřazené spravované tabulky. 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
    { 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 |
      SET MANAGED LOCATION location |
      [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parametry

  • schema_name

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

  • výchozí kolace default_collation_name

    Platí pro:check označený jako ano Kontrola SQL Databricks označená jako ano Databricks Runtime 17.1 a vyšší

    Změní výchozí kolaci pro nové objekty definované v rámci schématu. Výchozí kolace existujících objektů v rámci schématu se nezmění.

  • 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: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 } [; ...] )

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

    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 mít USE SCHEMA k odebrání značky ze schématu.

    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. 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:zaškrtněte políčko Ano Databricks SQL zaškrtněte políčko Ano Databricks Runtime 12.2 LTS a vyšší, zaškrtněte políčko Ano pouze 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 v nesharingu spravovaných katalogů v katalogu Unity.

  • SET UMÍSTĚNÍ SPRAVOVANÉHO UMÍSTĚNÍ

    Platí pro:check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above check marked yes Unity Catalog only

    Změní umístění spravovaného úložiště pro standardní schéma. Nové spravované tabulky a spravované svazky vytvořené ve schématu používají aktualizované umístění. Databricks nepřesune existující objekty.

    • umístění

      Cesta cloudového úložiště pro nové spravované umístění úložiště. Musí být obsažen v externím umístění.

  • [ SET ] ZACHOVAT VYŘAZENO NA ČÍSLO { HODINA | HODINY | DEN | DNY | TÝDEN | TÝDNY }

    Platí pro:check označený jako ano Databricks Runtime 17.3 a vyšší kontrola označená pouze jako ano Unity Catalog

    Důležitý

    Tato funkce je ve verzi Public Preview.

    Nastaví období obnovení pro vyřazené spravované tabulky ve schématu, období, během kterého lze vyřazené tabulky obnovit pomocí UNDROP TABLE příkazu. Výchozí hodnota dědí z nadřazeného katalogu (7 dnů, pokud není nastavená). Hodnota musí být 0 hodin (k zakázání obnovení) nebo mezi 7 až 30 dny (včetně).

    Nastavení doby obnovení na 0 znamená, že vyřazené tabulky se nedají obnovit pomocí UNDROP a datové soubory se z cloudového úložiště odstraní do 48 hodin.

    Období obnovení na úrovni schématu má přednost před nastavením na úrovni katalogu pro tabulky ve schématu. Toto nastavení platí jenom pro tabulky vyřazené po nakonfigurování období obnovení. Po skončení období obnovení se datové soubory spravovaných tabulek odstraní z cloudového úložiště do 48 hodin.

    SET je povolený jako volitelné klíčové slovo. Vyžaduje MANAGE oprávnění nebo vlastnictví schématu. Viz také Vyřazení spravované tabulky.

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;

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

-- Change the managed storage location of a schema
> ALTER SCHEMA my_catalog.my_schema SET MANAGED LOCATION 's3://my-bucket/schemas/my_schema/';

-- Set a 14-day recovery period for dropped managed tables in a schema
> ALTER SCHEMA my_catalog.my_schema RETAIN DROPPED TO 14 DAYS;

-- Set a 7-day recovery period (overrides any catalog-level setting)
> ALTER SCHEMA my_catalog.my_schema SET RETAIN DROPPED TO 7 DAYS;
  • Last updated on