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