Delen via

ALTER CATALOG

  • Artikel

Van toepassing op:vinkje met ja Databricks SQL vinkje met ja Databricks Runtime 10.4 LTS en hoger vinkje met ja Unity Catalog alleen

Hiermee wordt het eigendom van een catalog overgedragen aan een nieuwe -entiteit, worden tags toegepast op een catalog, en wordt voorspellende optimalisatie voor een catalogingeschakeld 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

  • catalog_name

    De naam van de catalog die moet worden gewijzigd. Als u geen naam opgeeft, is de standaardwaarde hive_metastore.

  • [ SET ] EIGENAAR NAAR hoofd

    Draagt het eigendom van de catalog over aan principal.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

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

    Tags toepassen op catalog. U moet use_catalog machtiging hebben om een tag toe te passen op een catalog. Zie USE CATALOG.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

  • UNSET TAGS ( tag_name [, ...] )

    Remove tags komen uit de catalog. U moet use_catalog machtiging hebben om een tag toe te passen op een catalog.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

  • tag_name

    Een letterlijke .STRING De tag_name moet uniek zijn binnen de catalog.

  • tag_value

    Een letterlijke .STRING

  • { ENABLE | UITSCHAKELEN | VOORSPELLENDE OPTIMALISATIE OVERNEMEN}

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger

    Hiermee wijzigt u de catalog naar de gewenste voorspellingsinstelling voor optimalisatie. Wanneer catalogs worden gemaakt, is het gedrag standaard het INHERIT van het account. Standaard nemen nieuwe objecten die zijn gemaakt in de catalog de instelling over van de catalog.

    Als de catalog 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 erven, of objecten die expliciet voorspellende optimalisatie gebruiken zoals ENABLE of DISABLE, worden niet beïnvloed door de catalog-instelling.

    Als u voorspellende optimalisatie voor een setwilt catalog, moet de gebruiker CREATE machtiging hebben voor de catalog.

    Alleen niet-Delta Sharing die beheerd zijn als catalogs 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)