Udostępnij za pośrednictwem

ALTER SCHEMA

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Zmienia właściciela schematu, ustawia zachowanie optymalizacji predykcyjnej lub zmienia metadane skojarzone ze schematem, ustawiając DBPROPERTIES. Określone wartości właściwości zastępują dowolną istniejącą wartość o tej samej nazwie właściwości.

Chociaż użycie SCHEMA elementów i DATABASE jest wymienne, SCHEMA jest preferowane.

Składnia

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

    Nazwa schematu, który ma zostać zmieniony. Jeśli nie można odnaleźć schematu, usługa Azure Databricks zgłasza błąd SCHEMA_NOT_FOUND.

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

    Właściwości schematu do ustawienia lub usunięcia.

  • [ SET ] WŁAŚCICIEL DO główny

    Przenosi własność schematu na principal.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    SET jest dozwolone jako opcjonalne słowo kluczowe.

  • tagi SET ( { tag_name = tag_value } [, ...] )

    Zastosuj tagi do schematu. Musisz mieć use_schema, aby zastosować tag do schematu.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

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

    Usuń tagi ze schematu. Musisz mieć use_schema, aby usunąć tag ze schematu.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

  • tag_name

    Literał STRING. tag_name musi być unikatowa w schemacie.

  • tag_value

    Literał STRING.

  • { WŁĄCZ | WYŁĄCZ | DZIEDZICZ } OPTYMALIZACJĘ PREDYKCYJNĄ

    Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 12.2 LTS i nowsze zaznaczone jako tak tylko Unity Catalog

    Zmienia schemat na żądane ustawienie optymalizacji predykcyjnej. Domyślnie podczas tworzenia schematów zachowanie to INHERIT z katalogu. Domyślnie nowe obiekty utworzone w schemacie będą dziedziczyć ustawienie ze schematu.

    Jeśli schemat zostanie zmieniony, zmiana zachowania przejdzie kaskadowo na wszystkie obiekty dziedziczące optymalizację predykcyjną. Obiekty, które jawnie określają ENABLE lub DISABLE dla optymalizacji predykcyjnej, nie są dotknięte ustawieniem schematu.

    Aby ustawić optymalizację predykcyjną schematu, użytkownik musi mieć CREATE uprawnienia do schematu.

    Tylko schematy w zarządzanych katalogach nie w Delta Sharing w katalogu Unity kwalifikują się do optymalizacji predykcyjnej.

Przykłady

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