ALTER CATALOG

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen gesetzt ja nur für Unity Catalog

Überträgt den Besitz eines Katalogs auf einen neuen Prinzipal, wendet Tags auf einen Katalog an oder aktiviert bzw. deaktiviert prädiktive Optimierung für einen Katalog.

Syntax

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

Parameter

  • catalog_name

    Name des Katalogs, der geändert werden soll. Wenn Sie keinen Namen angeben, wird der Standardwert hive_metastore verwendet.

  • [ SET ] OWNER TO principal

    Überträgt den Besitz des Katalogs an principal.

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 11.3 LTS und höher

    SET ist als optionales Schlüsselwort zulässig.

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

    Wenden Sie Tags auf den Katalog an. Sie benötigen die Berechtigung use_catalog, um ein Tag auf einen Katalog anzuwenden. Weitere Informationen finden Sie unter USE CATALOG.

    Gilt für:Häkchen gesetzt ja Databricks SQL Häkchen gesetzt ja Databricks Runtime ab Version 13.3 LTS

  • UNSET TAGS ( tag_name [, …] )

    Entfernen Sie Tags aus dem Katalog. Sie benötigen die Berechtigung use_catalog, um ein Tag auf einen Katalog anzuwenden.

    Gilt für:Häkchen gesetzt ja Databricks SQL Häkchen gesetzt ja Databricks Runtime ab Version 13.3 LTS

  • tag_name

    Ein STRING-Literal. tag_name muss innerhalb des Katalogs eindeutig sein.

  • tag_value

    Ein STRING-Literal.

  • { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

    Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 12.2 LTS und höher

    Wichtig

    Dieses Feature befindet sich in der Public Preview.

    Ändert den Katalog in die gewünschte Einstellung für die prädiktive Optimierung. Wenn Kataloge erstellt werden, wird standardmäßig aus dem Konto geerbt (INHERIT). Standardmäßig erben neue Objekte, die im Katalog erstellt wurden, die Einstellung vom Katalog.

    Wenn der Katalog geändert wird, wird das Verhalten an alle Schemas und deren Objekte kaskadiert, die die prädiktive Optimierung erben. Objekte in Schemas, die keine prädiktive Optimierung erben, oder Objekte, die prädiktive Optimierung explizit aktivieren (ENABLE) oder deaktivieren (DISABLE), sind von der Katalogeinstellung nicht betroffen.

    Um die prädiktive Optimierung für einen Katalog festzulegen, muss der Benutzer oder die Benutzerin über die Berechtigung CREATE für den Katalog verfügen.

    Nur verwaltete Kataloge ohne Delta Sharing in Unity Catalog sind für die prädiktive Optimierung berechtigt.

Beispiele

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

–– 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)