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 przez ustawienie 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 podmiotu zabezpieczeń

    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.

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

    Zastosuj tagi do schematu. Musisz zastosować use_schema 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 use_schema 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. Element tag_name musi być unikatowy w schemacie.

  • tag_value

    Literał STRING.

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

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 12.2 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

    Ważne

    Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

    Zmienia schemat na żądane ustawienie optymalizacji predykcyjnej. Domyślnie po utworzeniu 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, zachowanie będzie kaskadowe dla wszystkich obiektów dziedzicujących optymalizację predykcyjną. Obiekty jawne ENABLE lub DISABLE optymalizacje predykcyjne nie mają wpływu na ustawienie schematu.

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

    Tylko schematy w udostępnianiu innych niż różnicowe wykazy zarządzane w wykazie aparatu 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;