Dela via

ÄNDRA KATALOG

  • Artikel

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

Överför ägarskapet för en katalog till ett nytt huvudnamn, tillämpar taggar på en katalog eller aktiverar eller inaktiverar förutsägelseoptimering för en katalog.

Syntax

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Parametrar

  • catalog_name

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

  • [ SET ] ÄGARE TILL huvudnamn

    Överför ägarskapet för katalogen 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.

  • ANGE TAGGAR ( { tag_name = tag_value } [, ...] )

    Tillämpa taggar på katalogen. Du måste ha use_catalog behörighet att tillämpa en tagg på en katalog. Se ANVÄND KATALOG.

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

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

    Ta bort taggar från katalogen. Du måste ha use_catalog behörighet att tillämpa en tagg på en katalog.

    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 unikt i katalogen.

  • 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 katalogen till önskad inställning för förutsägelseoptimering. När kataloger skapas är beteendet som standard till INHERIT från kontot. Som standard ärver nya objekt som skapats i katalogen inställningen från katalogen.

    Om katalogen ändras kommer beteendet att överlappa alla scheman och deras objekt, som ärver prediktiv optimering. Objekt i scheman som inte ärver prediktiv optimering eller objekt som uttryckligen ENABLE eller DISABLE förutsägande optimering inte påverkas av kataloginställningen.

    Om du vill ange förutsägelseoptimering för en katalog måste användaren ha CREATE behörighet till katalogen.

    Endast icke-Delta-delning, hanterade kataloger i Unity Catalog är berättigade till förutsägelseoptimering.

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)