ALTER CATALOG

A következőkre vonatkozik: igennel jelölt Databricks SQL Databricks Runtime 10.4 LTS és újabb igennel megjelölve csak Unity Catalog

Átviszi a katalógus tulajdonjogát egy új tagra, módosítja a katalógus felügyelt tárolási helyét, címkéket alkalmaz egy katalógusra, engedélyezi vagy letiltja a katalógus prediktív optimalizálását , vagy beállítja az elvetett felügyelt táblák helyreállítási idejét.

Important

Ha hitelesítő adatokat (például jelszót vagy jogkivonatot) tartalmazó katalógusbeállításokat ad meg a biztonság érdekében, adja meg az értéket a secret függvény használatával ahelyett, hogy közvetlenül a záradékba írja be a OPTIONS literális értéket. Ez lehetővé teszi, hogy a Databricks titkos szolgáltatásban tárolt titkos kódra hivatkozzon ahelyett, hogy belefogadja a hitelesítő adatokat az utasításba.

Szintaxis

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

Paraméterek

catalog_name

A módosítani kívánt katalógus neve. Ha nem ad meg nevet, az alapértelmezett érték.hive_metastore
ALAPÉRTELMEZETT BETŰREND default_collation_name

A következőre vonatkozik: Databricks SQL Databricks Runtime 17.1 és újabb

Módosítja a katalógusban definiált új sémák alapértelmezett rendezést. A katalógusban lévő meglévő sémák és objektumok alapértelmezett rendezése nem módosul.
[ SET ] TULAJDONOS fő

Átruházza a katalógus tulajdonjogát principal-ra.

A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

SET választható kulcsszóként engedélyezett.
SET CÍMKÉK ( { tag_name = tag_value } [, ...] )

Címkék alkalmazása a katalógusra. A címkék katalógusra való alkalmazásához USE CATALOG engedéllyel kell rendelkeznie. Lásd USE CATALOG.

A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb
UNSET TAGS ( tag_name [, ...] )

Távolítsa el a címkéket a katalógusból. A címkék katalógusra való alkalmazásához USE CATALOG engedéllyel kell rendelkeznie.

A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb
tag_name

Egy literál STRING. A tag_name egyedinek kell lennie a katalógusban.
tag_value

Egy literál STRING.
{ ENGEDÉLYEZÉS | LETILTÁS | ÖRÖKLÉS } PREDIKTÍV OPTIMALIZÁLÁS

A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb

Módosítja a katalógust a kívánt prediktív optimalizálási beállításra. Alapértelmezés szerint, amikor katalógusokat hoznak létre, a viselkedés a fiókból származik INHERIT. Alapértelmezés szerint a katalógusban létrehozott új objektumok öröklik a beállítást a katalógusból.

Ha a katalógus módosul, a viselkedés kaszkádolt lesz az összes sémára és azok objektumára, amelyek öröklik a prediktív optimalizálást. Sémákban található objektumok, amelyek nem öröklik a prediktív optimalizálást, vagy amelyek kifejezetten ENABLE vagy DISABLE prediktív optimalizálást alkalmaznak, nincsenek hatással a katalógusbeállításokra.

A katalógus prediktív optimalizálásának beállításához a felhasználónak CREATE engedéllyel kell rendelkeznie a katalógusban.

Csak a Unity Katalógus nem OpenSharing-alapú, felügyelt katalógusai jogosultak prediktív optimalizálásra.
BEÁLLÍTÁSOK

Katalógusspecifikus paramétereket állít be. Lecseréli a meglévő lehetőségek listáját egy új beállításlistára.

A OPTIONS segítségével állítsa be a authorized paths-et a Hive metaadattár-összevonással létrehozott idegen katalógusoknál.
- opció
  
  A tulajdonságkulcs. A kulcs egy vagy több azonosítóból állhat, amelyeket pont választ el, vagy egy STRING literálból.
  
  A tulajdonságkulcsnak egyedinek kell lennie, és megkülönbözteti a kis- és nagybetűket.
- érték
  
  A tulajdonság értéke. Az értéknek egy BOOLEAN, STRING, INTEGERvagy DECIMALállandó kifejezésnek kell lennie.
SET FELÜGYELT HELY

A következőre vonatkozik: Databricks Databricks Runtime 18.1 és újabb Unity Katalógust

Módosítja a katalógus felügyelt tárolóhelyét. A katalógusban létrehozott új felügyelt táblák és felügyelt kötetek a frissített helyet használják. A Databricks nem helyezi át a meglévő objektumokat.
- hely
  
  Az új felügyelt tárolóhely felhőalapú tárolási útvonala. Külső helyen kell tárolni.
[ SET ] MEGTARTVA A KÖVETKEZŐ SZÁMRA CSÖKKENTVE: { HOUR | ÓRA | NAP | NAPOK | HÉT | HETEK }

Érvényes: a Databricks Runtime 17.3-s és újabb verziója, és ellenőrizze, hogy csak igen Unity-katalógus

Important

Ez a funkció nyilvános előzetes verzióban van.

Beállítja az elvetett felügyelt táblák helyreállítási időszakát a katalógusban, azt az időszakot, amely alatt az elvetett táblák helyreállíthatók a UNDROP TABLE paranccsal. Az alapértelmezett érték 7 nap. Az értéknek 0 óra (a helyreállítás letiltásához) vagy 7–30 napnak kell lennie, beleértve a következőt:

A helyreállítási időszak 0-ra állítása azt jelenti, hogy a ledobott táblák nem állítanak vissza , és UNDROPegy aszinkron törlési folyamat törli az adatfájlokat a felhőalapú tárolóból.

Ha egy helyreállítási időszak gyermeksémában is be van állítva, a sémaszintű beállítás elsőbbséget élvez a sémában lévő tábláknál. Ez a beállítás csak a helyreállítási időszak konfigurálása után elvetett táblákra vonatkozik. A helyreállítási időszak lejárta után egy aszinkron törlési folyamat törli a kezelt táblák adatfájljait a felhőtárolódból.

SET választható kulcsszóként engedélyezett. Jogosultságot vagy tulajdonjogot igényel MANAGE a katalógusban. Lásd még: Felügyelt tábla elvetése.

Példák

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

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-09-17