다음을 통해 공유

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 |
   OPTIONS (option value [, ...] )}

매개 변수

  • catalog_name

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

  • [ SET ] 소유자에서 원금

    카탈로그의 소유권을 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 이상

  • 태그 해제 ( tag_name [, ...] )

    카탈로그에서 태그를 제거합니다. 카탈로그에 태그를 적용하려면 use_catalog 권한이 있어야 합니다.

    적용 대상:체크 표시된 예 Databricks SQL 체크 표시된 예 Databricks Runtime 13.3 LTS 이상

  • tag_name

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

  • tag_value

    리터럴 STRING입니다.

  • { 사용 | 사용 안 함 | 상속 } 예측 최적화

    적용 대상:예로 표시됨 Databricks SQL 예로 표시됨 Databricks Runtime 12.2 LTS 이상

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

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

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

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

  • OPTIONS

    카탈로그별 매개 변수를 설정합니다. 기존 옵션 목록을 새 옵션 목록으로 바꿉니다.

    OPTIONS을(를) 사용하여 Hive 메타스토어 페더레이션으로 생성된 외국 카탈로그에 대해 authorized paths을(를) 설정하십시오.

    • 옵션

      속성의 키입니다. 키는 점으로 구분된 하나 이상의 식별자 또는 STRING로 구성될 수 있습니다.

      속성 키는 고유해야 하며 대/소문자를 구분해야 합니다.

    • 의 값

      속성의 값입니다. 값은 BOOLEAN, STRING, INTEGER 또는 DECIMAL 상수 식이어야 합니다.

      예를 들어 value가 password 대신 상수 식 secret('secrets.r.us', 'postgresPassword')을 사용하여 리터럴 암호를 입력하지 않을 수 있습니다.

예제

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

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

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