ALTER CATALOG
Van toepassing op: Alleen Databricks SQL Databricks Runtime 10.4 LTS en hoger dan Unity Catalog
Hiermee wordt het eigendom van een catalogus overgedragen aan een nieuwe principal, worden tags toegepast op een catalogus of wordt voorspellende optimalisatie voor een catalogus ingeschakeld of uitgeschakeld.
Syntaxis
ALTER CATALOG [ catalog_name ]
{ [ SET ] OWNER TO principal
SET TAGS ( { tag_name = tag_value } [, ...] ) |
UNSET TAGS ( tag_name [, ...] ) } |
{ ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }
Parameters
-
De naam van de catalogus die moet worden gewijzigd. Als u geen naam opgeeft, is de standaardwaarde
hive_metastore
. [ SET ] EIGENAAR AAN principal
Hiermee wordt het eigendom van de catalogus overgedragen naar
principal
.Van toepassing op: Databricks SQL Databricks Runtime 11.3 LTS en hoger
SET
is toegestaan als een optioneel trefwoord.TAGS INSTELLEN ( { tag_name = tag_value } [, ...] )
Tags toepassen op de catalogus. U moet gemachtigd zijn
use_catalog
om een tag toe te passen op een catalogus. Zie USE CATALOG.Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger
UNSET TAGS ( tag_name [, ...] )
Verwijder tags uit de catalogus. U moet gemachtigd zijn
use_catalog
om een tag toe te passen op een catalogus.Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger
tag_name
Een letterlijke .
STRING
Detag_name
naam moet uniek zijn binnen de catalogus.tag_value
Een letterlijke .
STRING
{ ENABLE | UITSCHAKELEN | VOORSPELLENDE OPTIMALISATIE OVERNEMEN}
Van toepassing op: Databricks SQL Databricks Runtime 12.2 LTS en hoger
Belangrijk
Deze functie is beschikbaar als openbare preview.
Hiermee wijzigt u de catalogus in de gewenste instelling voor voorspellende optimalisatie. Wanneer catalogi worden gemaakt, is het gedrag standaard van
INHERIT
het account. Nieuwe objecten die in de catalogus zijn gemaakt, nemen standaard de instelling over van de catalogus.Als de catalogus wordt gewijzigd, wordt het gedrag trapsgewijs uitgevoerd op alle schema's en hun objecten, die voorspellende optimalisatie overnemen. Objecten in schema's die geen voorspellende optimalisatie of objecten overnemen die expliciet
ENABLE
ofDISABLE
voorspellende optimalisatie niet worden beïnvloed door de catalogusinstelling.Als u voorspellende optimalisatie voor een catalogus wilt instellen, moet de gebruiker gemachtigd zijn
CREATE
voor de catalogus.Alleen niet-Delta Sharing, beheerde catalogi in Unity Catalog komen in aanmerking voor voorspellende optimalisatie.
Voorbeelden
-- 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)