Udostępnij przez

ALTER CATALOG

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczone jako tak tylko katalog Unity

Przenosi własność katalogu do nowego podmiotu zabezpieczeń, stosuje tagi do katalogu lub umożliwia lub blokuje optymalizację predykcyjną dla katalogu.

Składnia

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) }

Parametry

  • catalog_name

    Nazwa katalogu, który ma zostać zmieniony. Jeśli nie podasz nazwy, wartość domyślna to hive_metastore.

  • 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 schematów zdefiniowanych w wykazie. Domyślne sortowanie istniejących schematów i obiektów w wykazie nie jest zmieniane.

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

    Przenosi własność katalogu do 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 katalogu. Musisz mieć uprawnienia USE CATALOG, aby zastosować tag do katalogu. Zobacz USE CATALOG.

    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 z wykazu. Musisz mieć uprawnienia USE CATALOG, aby zastosować tag do katalogu.

    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 katalogu.

  • 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 nowsze

    Zmienia katalog na żądane ustawienie optymalizacji predykcyjnej. Domyślnie, gdy katalogi są tworzone, domyślnym działaniem jest INHERIT z konta. Domyślnie nowe obiekty utworzone w wykazie będą dziedziczyć ustawienie z wykazu.

    Jeśli katalog zostanie zmieniony, zachowanie rozprzestrzeni się kaskadowo na wszystkie schematy i ich obiekty, które dziedziczą predyktywną optymalizację. Obiekty w schematach, które nie dziedziczą optymalizacji predykcyjnej, ani obiekty, które jawnie definiują optymalizację predykcyjną jako ENABLE lub DISABLE, nie są zależne od ustawienia katalogu.

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

    Do optymalizacji predykcyjnej kwalifikują się tylko zarządzane katalogi w Unity Catalog, które nie są katalogami Delta Sharing.

  • OPCJE

    Ustawia parametry specyficzne dla wykazu. Zamienia istniejącą listę opcji na nową listę opcji.

    Użyj OPTIONS, aby ustawić authorized paths dla zewnętrznych katalogów utworzonych przy użyciu federacji magazynu metadanych Hive.

    • opcja

      Klucz właściwości. Klucz może składać się z co najmniej jednego identyfikatora oddzielonego kropką lub literałem STRING .

      Klucze właściwości muszą być unikatowe i uwzględniane są wielkość liter.

    • wartość

      Wartość właściwości. Wartość musi być BOOLEANSTRING stałym , INTEGER, DECIMALlub .

      Na przykład element value dla password może używać stałego wyrażeniasecret('secrets.r.us', 'postgresPassword') zamiast wprowadzania literału hasła.

Przykłady

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)
  • Last updated on