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 an einen neuen Prinzipal, ändert den verwalteten Speicherort eines Katalogs, wendet Tags auf einen Katalog an, aktiviert oder deaktiviert die prädiktive Optimierung für einen Katalog oder legt den Wiederherstellungszeitraum für verworfene verwaltete Tabellen fest.

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 [, ...] ) |
   SET MANAGED LOCATION location |
   [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

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 nicht openSharing, verwaltete Kataloge im Unity-Katalog sind für die predictive 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.

  • SET SPEICHERORT VERWALTETER SPEICHERORT

    Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above check marked yes Unity Catalog only

    Ändert den verwalteten Speicherort für den Katalog. Neue verwaltete Tabellen und verwaltete Volumes, die im Katalog erstellt wurden, verwenden den aktualisierten Speicherort. Bei Databricks werden vorhandene Objekte nicht verschoben.

    • Standort.

      Der Cloudspeicherpfad für den neuen verwalteten Speicherort. Er muss an einem externen Speicherort enthalten sein.

  • [ SET ] RETAIN DROPPED TO NUMBER { HOUR | STUNDEN | TAG | TAGE | WOCHE | WOCHEN }

    Gilt für:check marked yes Databricks Runtime 17.3 und höher als im Unity-Katalog markiert

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Legt den Wiederherstellungszeitraum für verworfene verwaltete Tabellen im Katalog fest, der Zeitraum, in dem gelöschte Tabellen mithilfe des UNDROP TABLE Befehls wiederhergestellt werden können. Der Standardwert ist 7 Tage. Der Wert muss 0 Stunden (zum Deaktivieren der Wiederherstellung) oder zwischen 7 bis 30 Tagen (einschließlich) betragen.

    Das Festlegen des Wiederherstellungszeitraums auf 0 bedeutet, dass gelöschte Tabellen nicht wiederhergestellt werden können UNDROP , und Datendateien werden innerhalb von 48 Stunden aus dem Cloudspeicher gelöscht.

    Wenn auch ein Wiederherstellungszeitraum für ein untergeordnetes Schema festgelegt ist, hat die Einstellung auf Schemaebene Vorrang für Tabellen in diesem Schema. Diese Einstellung gilt nur für Tabellen, die nach der Konfiguration des Wiederherstellungszeitraums gelöscht wurden. Nach Beendigung des Wiederherstellungszeitraums werden Datendateien für verwaltete Tabellen innerhalb von 48 Stunden aus Ihrem Cloudspeicher gelöscht.

    SET ist als optionales Schlüsselwort zulässig. Erfordert MANAGE Berechtigungen oder Besitzrechte für den Katalog. Siehe auch Ablegen einer verwalteten Tabelle.

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)

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';

-- Set a 30-day recovery period for dropped managed tables in a catalog
> ALTER CATALOG my_catalog RETAIN DROPPED TO 30 DAYS;

-- Set the recovery period to 0 (tables are not recoverable after drop)
> ALTER CATALOG my_catalog SET RETAIN DROPPED TO 0 DAYS;
  • Last updated on