Freigeben über

ALTER CATALOG

Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „Ja“ Databricks Runtime 10.4 LTS und höher Häkchen für „Ja“ Nur 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 ]
 { 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 [, ...] ) }

Parameter

  • catalog_name

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

  • STANDARDKOLLATION default_collation_name

    Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

    Ändert die Standardsortierung für neue Schemas, die im Katalog definiert sind. Die Standardsortierung vorhandener Schemas und Objekte innerhalb des Katalogs wird nicht geändert.

  • [ SET ] OWNER TO Prinzipal

    Überträgt den Besitz des Katalogs an principal.

    Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „Ja“ 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. Siehe USE CATALOG.

    Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „Ja“ Databricks Runtime 13.3 LTS und höher

  • 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 für „Ja“ Databricks SQL Häkchen für „Ja“ Databricks Runtime 13.3 LTS und höher

  • tag_name

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

  • tag_value

    Ein STRING-Literal.

  • { AKTIVIEREN | DEAKTIVIEREN | VERERBEN } PROGNOSTISCHE OPTIMIERUNG

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

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

  • OPTIONEN

    Legt katalogspezifische Parameter fest. Ersetzt die vorhandene Liste der Optionen durch eine neue Liste mit Optionen.

    Verwenden Sie OPTIONS, um authorized paths für Fremdkataloge festzulegen, die mit der Hive-Metastore-Federation erstellt wurden.

    • Option

      Der Eigenschaftenschlüssel. Der Schlüssel kann aus einem oder mehreren Bezeichnern bestehen, die durch einen Punkt oder ein STRING-Literal getrennt sind.

      Eigenschaftenschlüssel müssen eindeutig sein, und die Groß-/Kleinschreibung muss beachtet werden.

    • Wert

      Der Wert für die Eigenschaft. Der Wert muss ein BOOLEAN, STRING, , INTEGERoder DECIMALkonstanter Ausdruck sein.

      Zum Beispiel kann ein value für password den konstanten Ausdrucksecret('secrets.r.us', 'postgresPassword') verwenden, anstatt das Literalkennwort einzugeben.

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

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