entity-tag-assignments 명령 그룹

비고

이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.

Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.

Databricks CLI 내의 명령 그룹에는 entity-tag-assignments Unity 카탈로그 엔터티에서 태그 할당을 만들고, 업데이트하고, 삭제하고, 나열하는 명령이 포함되어 있습니다. 태그는 Unity 카탈로그에서 엔터티를 구성하고 분류하는 데 사용할 수 있는 키와 선택적 값을 포함하는 특성입니다. Unity Catalog 보안 개체에 태그를 적용하는 방법을 확인하세요.

databricks entity-tag-assignments create

Unity 카탈로그 엔터티에 대한 태그 할당을 만듭니다.

Unity 카탈로그 엔터티에 태그를 추가하려면 엔터티를 소유하거나 다음 권한이 있어야 합니다.

  • 엔터티에 태그 적용
  • USE SCHEMA 엔터티의 부모 스키마에서
  • USE CATALOG 엔터티의 부모 카탈로그에서

Unity 카탈로그 엔터티에 관리 태그를 추가하려면 태그 정책에 대한 ASSIGN 또는 MANAGE 권한도 있어야 합니다. 태그 정책 권한 관리를 참조하세요.

databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]

Arguments

ENTITY_NAME

    태그가 할당된 엔터티의 정규화된 이름입니다.

TAG_KEY

    태그의 키입니다.

ENTITY_TYPE

    태그가 할당되는 엔터티의 형식입니다. 허용되는 값은 다음과 catalogscolumnsschemastablesvolumes같습니다.

옵션

--json JSON

    요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열

--tag-value string

    태그의 값입니다.

전역 플래그

예시

다음 예제에서는 테이블에 대한 태그 할당을 만듭니다.

databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production

다음 예제에서는 JSON을 사용하여 태그 할당을 만듭니다.

databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'

databricks entity-tag-assignments delete

키로 Unity 카탈로그 엔터티에 대한 태그 할당을 삭제합니다.

Unity 카탈로그 엔터티에서 태그를 삭제하려면 엔터티를 소유하거나 다음 권한이 있어야 합니다.

  • 엔터티에 태그 적용
  • 엔터티의 부모 스키마에 대한 USE_SCHEMA
  • 엔터티의 부모 카탈로그에 대한 USE_CATALOG

Unity 카탈로그 엔터티에서 관리 태그를 삭제하려면 태그 정책에 대한 ASSIGN 또는 MANAGE 권한도 있어야 합니다. 태그 정책 권한 관리를 참조하세요.

databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    태그가 할당되는 엔터티의 형식입니다. 허용되는 값은 다음과 catalogscolumnsschemastablesvolumes같습니다.

ENTITY_NAME

    태그가 할당된 엔터티의 정규화된 이름입니다.

TAG_KEY

    삭제할 태그의 키입니다.

옵션

전역 플래그

예시

다음 예제에서는 테이블에서 태그 할당을 삭제합니다.

databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment

databricks entity-tag-assignments get

태그 키로 Unity 카탈로그 엔터티에 대한 태그 할당을 가져옵니다.

databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    태그가 할당되는 엔터티의 형식입니다. 허용되는 값은 다음과 catalogscolumnsschemastablesvolumes같습니다.

ENTITY_NAME

    태그가 할당된 엔터티의 정규화된 이름입니다.

TAG_KEY

    태그의 키입니다.

옵션

전역 플래그

예시

다음 예제에서는 테이블에 대한 태그 할당을 가져옵니다.

databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment

databricks entity-tag-assignments list

Unity 카탈로그 엔터티에 대한 태그 할당을 나열합니다.

중요합니다

API는 기본적으로 페이지가 매겨집니다. 페이지에는 next_page_token 제공하는 동안 0개의 결과가 포함될 수 있습니다. 클라이언트는 next_page_token 없을 때까지 페이지를 계속 읽어야 합니다. 이는 결과의 끝에 도달했음을 나타내는 유일한 표시입니다.

databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]

Arguments

ENTITY_TYPE

    태그가 할당되는 엔터티의 형식입니다. 허용되는 값은 다음과 catalogscolumnsschemastablesvolumes같습니다.

ENTITY_NAME

    태그가 할당된 엔터티의 정규화된 이름입니다.

옵션

--max-results int

    반환할 최대 결과 수입니다.

--page-token string

    결과의 다음 페이지를 검색하는 토큰입니다.

전역 플래그

예시

다음 예제에서는 테이블에 대한 모든 태그 할당을 나열합니다.

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table

다음 예제에서는 페이지 매김이 있는 태그 할당을 나열합니다.

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10

databricks entity-tag-assignments 업데이트

Unity 카탈로그 엔터티에 대한 기존 태그 할당을 업데이트합니다.

태그를 Unity 카탈로그 엔터티로 업데이트하려면 엔터티를 소유하거나 다음 권한이 있어야 합니다.

  • 엔터티에 태그 적용
  • USE SCHEMA 엔터티의 부모 스키마에서
  • USE CATALOG 엔터티의 부모 카탈로그에서

관리 태그를 Unity 카탈로그 엔터티로 업데이트하려면 태그 정책에 대한 ASSIGN 또는 MANAGE 권한도 있어야 합니다. 태그 정책 권한 관리를 참조하세요.

databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]

Arguments

ENTITY_TYPE

    태그가 할당되는 엔터티의 형식입니다. 허용되는 값은 다음과 catalogscolumnsschemastablesvolumes같습니다.

ENTITY_NAME

    태그가 할당된 엔터티의 정규화된 이름입니다.

TAG_KEY

    태그의 키입니다.

UPDATE_MASK

    필드 마스크는 쉼표(공백 없음)로 구분된 여러 필드가 있는 단일 문자열이어야 합니다. 필드 경로는 리소스 개체를 기준으로 하며 점(.)을 사용하여 하위 필드(예: author.given_name)를 탐색합니다. 전체 컬렉션 필드만 지정할 수 있으므로 시퀀스 또는 맵 필드의 요소 사양은 허용되지 않습니다. 필드 이름은 리소스 필드 이름과 정확히 일치해야 합니다.

    별표(*) 필드 마스크는 전체 대체를 나타냅니다. API가 나중에 변경될 경우 의도하지 않은 결과가 발생할 수 있으므로 항상 업데이트되는 필드를 명시적으로 나열하고 와일드카드를 사용하지 않는 것이 좋습니다.

옵션

--json JSON

    요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열

--tag-value string

    태그의 값입니다.

전역 플래그

예시

다음 예제에서는 테이블에 대한 태그 할당을 업데이트합니다.

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging

다음 예제에서는 JSON을 사용하여 태그 할당을 업데이트합니다.

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'

전역 표시기

--debug

  디버그 로깅을 사용할지 여부입니다.

-h 또는 --help

    Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.

--log-file 문자열

    출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.

--log-format 포맷

    로그 형식 형식 text 또는 json. 기본값은 text입니다.

--log-level 문자열

    로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.

-o, --output 유형

    명령 출력 형식 text 또는 json. 기본값은 text입니다.

-p, --profile 문자열

    명령을 실행하는 데 사용할 파일의 프로필 ~/.databrickscfg 이름입니다. 이 플래그를 지정하지 않으면, 존재하는 경우 DEFAULT로 명명된 프로필이 사용됩니다.

--progress-format 포맷

    진행률 로그를 표시할 형식: default, append, inplace또는 json

-t, --target 문자열

    해당하는 경우 사용할 번들 대상

  • Last updated on