비고
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
Databricks CLI 내의 명령 그룹에는 external-metadata Unity 카탈로그 내의 외부 시스템에 대한 메타데이터를 등록하고 관리하는 명령이 포함되어 있습니다.
databricks external-metadata create-external-metadata
호출자가 metastore 관리자이거나 CREATE_EXTERNAL_METADATA 권한이 있는 경우 부모 메타스토어에 새 외부 메타데이터 개체를 만듭니다. 기본적으로 만들 때 모든 계정 사용자에게 BROWSE 를 부여합니다.
databricks external-metadata create-external-metadata NAME SYSTEM_TYPE ENTITY_TYPE [flags]
Arguments
NAME
외부 메타데이터 개체의 이름입니다.
SYSTEM_TYPE
외부 시스템의 유형입니다. 지원되는 값: AMAZON_REDSHIFT, AZURE_SYNAPSE,CONFLUENT, DATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, MICROSOFT_SQL_SERVERMICROSOFT_FABRIC, MONGODB, MYSQLORACLE,OTHER, POSTGRESQL, POWER_BI,SALESFORCE, , SAP, SERVICENOW, , SNOWFLAKE, STREAM_NATIVE, TABLEAU, , , TERADATA. WORKDAY
ENTITY_TYPE
외부 시스템 내의 엔터티 유형입니다.
옵션
--description string
사용자가 제공한 자유 형식 텍스트 설명입니다.
--json JSON
요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열
--owner string
외부 메타데이터 개체의 소유자입니다.
--url string
외부 메타데이터 개체와 연결된 URL입니다.
예시
다음 예제에서는 Snowflake 테이블에 대한 외부 메타데이터 개체를 만듭니다.
databricks external-metadata create-external-metadata my_snowflake_table SNOWFLAKE TABLE --description "Production sales table" --url "https://example.snowflakecomputing.com/table/sales"
다음 예제에서는 JSON을 사용하여 외부 메타데이터 개체를 만듭니다.
databricks external-metadata create-external-metadata tableau_dashboard TABLEAU DASHBOARD --json '{"description": "Sales dashboard", "owner": "user@example.com"}'
다음 예제에서는 JSON 파일을 사용하여 외부 메타데이터 개체를 만듭니다.
databricks external-metadata create-external-metadata bigquery_dataset GOOGLE_BIGQUERY DATASET --json @external-metadata.json
databricks external-metadata delete-external-metadata
제공된 이름과 일치하는 외부 메타데이터 개체를 삭제합니다. 호출자는 metastore 관리자, 외부 메타데이터 개체의 소유자 또는 MANAGE 권한이 있는 사용자여야 합니다.
databricks external-metadata delete-external-metadata NAME [flags]
Arguments
NAME
삭제할 외부 메타데이터 개체의 이름입니다.
옵션
예시
다음 예제에서는 외부 메타데이터 개체를 삭제합니다.
databricks external-metadata delete-external-metadata my_snowflake_table
databricks external-metadata get-external-metadata
메타스토어에서 지정된 외부 메타데이터 개체를 가져옵니다. 호출자는 metastore 관리자, 외부 메타데이터 개체의 소유자 또는 BROWSE 권한이 있는 사용자여야 합니다.
databricks external-metadata get-external-metadata NAME [flags]
Arguments
NAME
가져올 외부 메타데이터 개체의 이름입니다.
옵션
예시
다음 예제에서는 외부 메타데이터 개체를 가져옵니다.
databricks external-metadata get-external-metadata my_snowflake_table
databricks external-metadata list-external-metadata
메타스토어의 외부 메타데이터 개체를 나열합니다. 호출자가 metastore 관리자인 경우 모든 외부 메타데이터 개체가 검색됩니다. 그렇지 않으면 호출자가 BROWSE 를 사용하는 외부 메타데이터 개체만 검색됩니다. 배열에 있는 요소의 특정 순서는 보장되지 않습니다.
databricks external-metadata list-external-metadata [flags]
옵션
--page-size int
페이지당 반환할 외부 메타데이터 개체의 최대 수입니다.
--page-token string
결과의 다음 페이지를 검색하는 토큰입니다.
예시
다음 예제에서는 모든 외부 메타데이터 개체를 나열합니다.
databricks external-metadata list-external-metadata
다음 예제에서는 페이지 매김이 있는 외부 메타데이터 개체를 나열합니다.
databricks external-metadata list-external-metadata --page-size 10
databricks external-metadata update-external-metadata
제공된 이름과 일치하는 외부 메타데이터 개체를 업데이트합니다. 호출자는 하나의 요청에서 소유자 또는 다른 메타데이터 필드만 업데이트할 수 있습니다. 호출자는 metastore 관리자, 외부 메타데이터 개체의 소유자 또는 MODIFY 권한이 있는 사용자여야 합니다. 호출자가 소유자를 업데이트하는 경우 관리 권한도 있어야 합니다.
databricks external-metadata update-external-metadata NAME UPDATE_MASK SYSTEM_TYPE ENTITY_TYPE [flags]
Arguments
NAME
외부 메타데이터 개체의 이름입니다.
UPDATE_MASK
필드 마스크는 쉼표(공백 없음)로 구분된 여러 필드가 있는 단일 문자열이어야 합니다. 필드 경로는 리소스 개체를 기준으로 하며 점(.)을 사용하여 하위 필드(예: author.given_name)를 탐색합니다. 전체 컬렉션 필드만 지정할 수 있으므로 시퀀스 또는 맵 필드의 요소 사양은 허용되지 않습니다. 필드 이름은 리소스 필드 이름과 정확히 일치해야 합니다.
별표(*) 필드 마스크는 전체 대체를 나타냅니다. API가 나중에 변경될 경우 의도하지 않은 결과가 발생할 수 있으므로 항상 업데이트되는 필드를 명시적으로 나열하고 와일드카드를 사용하지 않는 것이 좋습니다.
SYSTEM_TYPE
외부 시스템의 유형입니다. 지원되는 값: AMAZON_REDSHIFT, AZURE_SYNAPSE,CONFLUENT, DATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, MICROSOFT_SQL_SERVERMICROSOFT_FABRIC, MONGODB, MYSQLORACLE,OTHER, POSTGRESQL, POWER_BI,SALESFORCE, , SAP, SERVICENOW, , SNOWFLAKE, STREAM_NATIVE, TABLEAU, , , TERADATA. WORKDAY
ENTITY_TYPE
외부 시스템 내의 엔터티 유형입니다.
옵션
--description string
사용자가 제공한 자유 형식 텍스트 설명입니다.
--json JSON
요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열
--owner string
외부 메타데이터 개체의 소유자입니다.
--url string
외부 메타데이터 개체와 연결된 URL입니다.
예시
다음 예제에서는 외부 메타데이터 개체에 대한 설명을 업데이트합니다.
databricks external-metadata update-external-metadata my_snowflake_table "description" SNOWFLAKE TABLE --description "Updated production sales table"
다음 예제에서는 외부 메타데이터 개체의 소유자를 업데이트합니다.
databricks external-metadata update-external-metadata my_snowflake_table "owner" SNOWFLAKE TABLE --owner "newowner@example.com"
다음 예제에서는 JSON을 사용하여 외부 메타데이터 개체를 업데이트합니다.
databricks external-metadata update-external-metadata my_snowflake_table "description,url" SNOWFLAKE TABLE --json '{"description": "Latest sales data", "url": "https://example.snowflakecomputing.com/table/sales_v2"}'
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상