Udostępnij za pośrednictwem

ALTER SCHEMA

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

Zmienia właściciela schematu, zmienia zarządzaną lokalizację magazynu 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 i DATABASE jest zamiennie, SCHEMA jest preferowane.

Składnia

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 }

Parametry

  • schema_name

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

  • DOMYŚLNE SORTOWANIE default_collation_name

    Dotyczy:sprawdź, czy zaznaczono tak, sprawdź, czy usługa SQL databricks została oznaczona jako tak Databricks Runtime 17.1 lub nowsza

    Zmienia sortowanie domyślne dla nowych obiektów zdefiniowanych w schemacie. Domyślne sortowanie istniejących obiektów w schemacie nie jest zmieniane.

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

    Właściwości schematu, które należy ustawić lub zresetować.

  • [ 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.

  • SET LOKALIZACJA ZARZĄDZANA

    Dotyczy:sprawdź, czy zaznaczono tak , zaznacz pole wyboru SQL usługi Databricks oznaczone jako tak Databricks Runtime 18.1 i powyżej zaznacz pole wyboru oznaczone jako tak Tylko wykaz aparatu Unity

    Zmienia lokalizację magazynu zarządzanego dla standardowego schematu. Nowe tabele zarządzane i woluminy zarządzane utworzone w schemacie używają zaktualizowanej lokalizacji. Usługa Databricks nie przenosi istniejących obiektów.

    • lokalizacja

      Ścieżka magazynu w chmurze dla nowej zarządzanej lokalizacji magazynu. Musi on znajdować się w lokalizacji zewnętrznej.

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;

-- 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/';
  • Last updated on