ALTER CATALOG

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 10.4 LTS 이상 검사 '예'로 표시 Unity 카탈로그만 해당

카탈로그의 소유권을 새 보안 주체로 이전하거나, 카탈로그에 태그를 적용하거나, 카탈로그에 대한 예측 최적화를 사용하거나 사용하지 않도록 설정합니다.

구문

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

매개 변수

  • catalog_name

    변경할 카탈로그의 이름입니다. 이름을 제공하지 않으면 기본값은 hive_metastore입니다.

  • [ SET ] OWNER TO principal

    카탈로그 소유권을 principal로 이전합니다.

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 11.3 LTS 이상

    SET는 선택적 키워드로 허용됩니다.

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

    카탈로그에 태그를 적용합니다. 카탈로그에 use_catalog 태그를 적용할 수 있는 권한이 있어야 합니다. USE CATALOG를 참조하세요.

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 13.3 LTS 이상

  • UNSET 태그 ( tag_name [, ...] )

    카탈로그에서 태그를 제거합니다. 카탈로그에 use_catalog 태그를 적용할 수 있는 권한이 있어야 합니다.

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 13.3 LTS 이상

  • tag_name

    리터럴 STRING. tag_name 카탈로그 내에서 고유해야 합니다.

  • tag_value

    리터럴 STRING.

  • { ENABLE | DISABLE | INHERIT } 예측 최적화

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 12.2 LTS 이상

    Important

    이 기능은 공개 미리 보기 상태입니다.

    카탈로그를 원하는 예측 최적화 설정으로 변경합니다. 기본적으로 카탈로그를 만들 때 동작은 INHERIT 계정에서 발생합니다. 기본적으로 카탈로그에서 만든 새 개체는 카탈로그에서 설정을 상속합니다.

    카탈로그가 변경되면 동작은 예측 최적화를 상속하는 모든 스키마 및 해당 개체로 계단식으로 이동됩니다. 예측 최적화를 상속하지 않는 스키마의 개체 또는 명시적으로 ENABLE 또는 DISABLE 예측 최적화를 수행하는 개체는 카탈로그 설정의 영향을 받지 않습니다.

    카탈로그에 대한 예측 최적화를 설정하려면 사용자에게 카탈로그에 대한 권한이 있어야 합니다 CREATE .

    Unity 카탈로그의 비 델타 공유 관리 카탈로그만 예측 최적화에 적합합니다.

예제

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