Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
catalogs
Databricks CLI 내의 명령 그룹을 사용하면 Unity 카탈로그에서 카탈로그를 관리할 수 있습니다. 카탈로그는 Unity 카탈로그의 3개 수준 네임스페이스의 첫 번째 계층입니다. 데이터 자산을 구성하는 데 사용됩니다.
Unity Catalog란 무엇인가요?.
databricks 카탈로그 만들기
호출자가 metastore 관리자이거나 권한이 있는 경우 부모 메타스토어에 새 카탈로그 인스턴스를 CREATE_CATALOG 만듭니다.
databricks catalogs create NAME [flags]
Arguments
NAME
카탈로그 이름
Options
--comment string
사용자가 제공한 자유 형식 텍스트 설명
--connection-name string
외부 데이터 원본에 대한 연결의 이름입니다.
--json JSON
요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열
--provider-name string
델타 공유 공급자의 이름
--share-name string
공유 공급자 아래의 공유 이름
--storage-root string
카탈로그 내의 관리되는 테이블에 대한 스토리지 루트 URL
Examples
다음 예제에서는 이름이 지정된 sales카탈로그를 만듭니다.
databricks catalogs create sales
다음 예제에서는 주석이 있는 카탈로그를 만듭니다.
databricks catalogs create sales --comment "Sales data catalog"
Databricks 카탈로그 삭제
제공된 이름과 일치하는 카탈로그를 삭제합니다. 호출자는 메타스토어 관리자이거나 카탈로그의 소유자여야 합니다.
databricks catalogs delete NAME [flags]
Arguments
NAME
카탈로그의 이름
Options
--force
카탈로그가 비어 있지 않은 경우에도 강제 삭제
Examples
다음 예제에서는 이름이 지정된 sales카탈로그를 삭제합니다.
databricks catalogs delete sales
다음 예제에서는 비어있지 않은 카탈로그를 강제로 삭제합니다.
databricks catalogs delete sales --force
databricks 카탈로그 가져오기
메타스토어에서 지정된 카탈로그를 가져옵니다. 호출자는 메타스토어 관리자, 카탈로그 소유자 또는 계정에 대한 권한이 설정된 사용자 USE_CATALOG 여야 합니다.
databricks catalogs get NAME [flags]
Arguments
NAME
카탈로그의 이름
Options
--include-browse
보안 주체가 특정 메타데이터에만 액세스할 수 있는 카탈로그를 응답에 포함할지 여부
Examples
다음 예제에서는 이름이 지정된 sales카탈로그에 대한 정보를 가져옵니다.
databricks catalogs get sales
다음 예제에서는 찾아보기 전용 카탈로그를 포함한 카탈로그 정보를 가져옵니다.
databricks catalogs get sales --include-browse
databricks 카탈로그 목록
메타스토어의 카탈로그를 나열합니다. 호출자가 metastore 관리자인 경우 모든 카탈로그가 검색됩니다. 그렇지 않으면 호출자가 소유하거나 호출자에게 USE_CATALOG 권한이 있는 카탈로그만 검색됩니다. 배열에 있는 요소의 특정 순서는 보장되지 않습니다.
databricks catalogs list [flags]
Options
--include-browse
보안 주체가 특정 메타데이터에만 액세스할 수 있는 카탈로그를 응답에 포함할지 여부
--max-results int
반환할 카탈로그의 최대 수
--page-token string
이전 쿼리에 따라 다음 페이지로 이동하는 불투명 페이지 매김 토큰
Examples
다음 예제에서는 모든 카탈로그를 나열합니다.
databricks catalogs list
다음 예제에서는 최대 10개의 결과가 있는 카탈로그를 나열합니다.
databricks catalogs list --max-results 10
다음 예제에서는 찾아보기 전용 카탈로그를 포함한 카탈로그를 나열합니다.
databricks catalogs list --include-browse
databricks 카탈로그 업데이트
제공된 이름과 일치하는 카탈로그를 업데이트합니다. 호출자는 카탈로그의 소유자이거나 메타스토어 관리자여야 합니다(카탈로그의 소유자 필드를 변경하는 경우).
databricks catalogs update NAME [flags]
Arguments
NAME
카탈로그의 이름
Options
--comment string
사용자가 제공한 자유 형식 텍스트 설명
--enable-predictive-optimization EnablePredictiveOptimization
이 개체와 그 아래의 개체에 대해 예측 최적화를 사용하도록 설정해야 하는지 여부입니다. 지원되는 값: DISABLE, ENABLE, INHERIT
--isolation-mode CatalogIsolationMode
전 작업 영역 또는 특정 작업 영역 그룹에서 현재 보안 개체에 액세스할 수 있는지 여부입니다. 지원되는 값: ISOLATED, OPEN
--json JSON
요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열
--new-name string
카탈로그의 새 이름
--owner string
카탈로그의 현재 소유자의 사용자 이름
Examples
다음 예제에서는 카탈로그의 주석을 업데이트합니다.
databricks catalogs update sales --comment "Updated sales data catalog"
다음 예제에서는 카탈로그의 이름을 바꿉니다.
databricks catalogs update sales --new-name sales-prod
다음 예제에서는 카탈로그의 소유자를 변경합니다.
databricks catalogs update sales --owner someone@example.com
다음 예제에서는 카탈로그에 대한 예측 최적화를 사용하도록 설정합니다.
databricks catalogs update sales --enable-predictive-optimization ENABLE
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상