Dela via

ALTER CATALOG

  • Artikel

gäller för:markerad med ja Databricks SQL markerad med ja Databricks Runtime 10.4 LTS och senare markerad med ja Unity Catalog endast

Överför ägarskapet för en catalog till en ny huvudansvarig, tillämpar taggar på en catalogeller aktiverar eller inaktiverar prediktiv optimering för en catalog.

Syntax

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

    Namnet på catalog ändras. Om du inte anger något namn är hive_metastorestandardvärdet .

  • [ SET ] ÄGARE TILL huvudsaklig

    Överför ägarskapet för catalog till principal.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    SET tillåts som ett valfritt nyckelord.

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

    Tillämpa taggar på catalog. Du måste ha use_catalog behörighet för att använda en tagg på en catalog. Se USE CATALOG.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

  • TA BORT TAGGAR ( tag_name [, ...] )

    Remove taggar från catalog. Du måste ha behörighet use_catalog för att applicera en tagg på en catalog.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

  • tag_name

    En literal STRING. tag_name måste vara unik i catalog.

  • tag_value

    En literal STRING.

  • { AKTIVERA | INAKTIVERA | ÄRV } FÖRUTSÄGANDE OPTIMERING

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare

    Ändrar catalog till önskad inställning för förutsägelseoptimering. När catalogs skapas är standardbeteendet att INHERIT från kontot. Som standard ärver nya objekt som skapas i catalog inställningen från catalog.

    Om catalog ändras kommer effekten att påverka alla scheman och deras objekt, som ärver förutsägelseoptimering. Objekt i scheman som inte ärver förutsägelseoptimering eller objekt som uttryckligen använder ENABLE eller DISABLE förutsägelseoptimering påverkas inte av inställningen catalog.

    För att set förutsägelseoptimering för en catalogmåste användaren ha behörighet CREATE på catalog.

    Endast icke-Delta-sharing, hanterade catalogs i Unity Catalog är kvalificerade för prediktiv optimering.

Exempel

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