Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
이 문서에서는 사용 가능한 Databricks CLI 명령에 대한 정보를 제공합니다. 이 정보는 명령줄 도움말을 보완합니다. Databricks CLI 설치 및 사용에 대한 자세한 내용은 Databricks CLI 설치 또는 업데이트 및 Databricks CLI란?을 참조하세요..
Databricks CLI에는 다음 표에 나열된 명령 그룹이 포함되어 있습니다. 명령 그룹에는 하위 명령도 포함할 수 있는 관련 명령 집합이 포함되어 있습니다. 명령 그룹, 개별 명령 또는 하위 명령에 대한 사용량 및 구문 정보를 출력하려면 다음을 수행합니다.
databricks <command-group> -h
databricks <command-group> <command-name> -h
databricks <command-group> <command-name> <subcommand-name> -h
많은 CLI 명령은 Azure Databricks REST API 참조에 설명된 작업에 매핑됩니다.
작업 영역 명령
Group | 설명 및 명령 |
---|---|
fs | 파일 및 파일 시스템을 관리하기 위한 명령:cat , cp , ls , mkdir rm |
git-credentials | 사용자를 대신하여 작업을 수행하기 위해 Databricks에 개인 액세스 토큰을 등록하는 명령:create , delete , get , list update |
repos | 사용자가 git 리포지토리를 관리할 수 있도록 하는 명령:create , delete , get , list update get-permission-levels , get-permissions , set-permissions update-permissions |
secrets | 비밀, 비밀 범위 및 액세스 권한을 관리하기 위한 명령:create-scope , delete-acl , delete-scope , delete-secret , get-acl , get-secret , list-acls , list-scopes list-secrets , put-acl put-secret |
workspace | 작업 영역에서 Notebook 및 폴더를 나열, 가져오기, 내보내기 및 삭제하는 명령:delete , export , export-dir , get-status , import , import-dir , list mkdirs get-permission-levels , get-permissions , set-permissions update-permissions |
컴퓨팅 명령
Group | 설명 및 명령 |
---|---|
cluster-policies | 규칙 집합에 따라 클러스터를 구성하는 사용자의 기능을 제어하는 명령:create , delete , edit , get list get-permission-levels , get-permissions , set-permissions update-permissions |
clusters | 클러스터를 만들고, 시작하고, 편집하고, 나열하고, 종료하고, 삭제할 수 있는 명령:change-owner , create , delete , edit , events , get , list , list-node-types , list-zones , permanent-delete , pin , resize , restart , spark-versions , start , unpin get-permission-levels , get-permissions , set-permissions update-permissions |
global-init-scripts | 작업 영역 관리자가 작업 영역을 위한 전역 초기화 스크립트를 구성할 수 있도록 하는 명령:create , delete , get , list update |
instance-pools | 즉시 사용할 수 있는 클라우드 인스턴스를 사용하여 인스턴스 풀을 만들고, 편집하고, 삭제하고, 나열하는 명령은 클러스터 시작 및 자동 크기 조정 시간을 줄입니다.create , delete , edit , get list get-permission-levels , get-permissions , set-permissions update-permissions |
instance-profiles | 관리자가 사용자들이 클러스터를 시작할 수 있는 인스턴스 프로필을 추가하고 나열하며 제거할 수 있도록 하는 명령입니다.add , edit , list remove |
라이브러리 | 클러스터에서 라이브러리의 상태를 설치, 제거 및 가져오는 명령:all-cluster-statuses , cluster-status , install uninstall |
정책 패밀리 | 다음 명령을 사용하여 사용 가능한 정책 패밀리를 볼 수 있습니다.get , list |
작업 명령어
Group | 설명 및 명령 |
---|---|
jobs | 작업을 관리하는 명령:cancel-all-runs , cancel-run , create , delete , delete-run , export-run , , get , get-run , get-run-output list , list-runs repair-run reset run-now submit ,update get-permission-levels , get-permissions , set-permissions update-permissions |
Lakeflow 선언형 파이프라인 명령어
Group | 설명 및 명령 |
---|---|
pipelines | 다음 명령을 사용해 파이프라인을 생성, 편집, 삭제, 시작하고 세부 정보를 조회할 수 있습니다.create , delete , get , get-update , list-pipeline-events , list-pipelines , list-updates start-update , stop update get-permission-levels , get-permissions , set-permissions update-permissions |
기계 학습 명령
Group | 설명 및 명령 |
---|---|
experiments | 다음 명령을 사용하여 MLflow의 기본 조직 단위인 실험과 상호 작용할 수 있습니다. 모든 MLflow 실행은 하나의 실험에 속합니다.create-experiment , create-run , delete-experiment , delete-run , delete-runs , delete-tag , get-by-name , get-experiment , , get-history , , get-runGet list-artifacts , list-experiments log-batch , log-inputs log-metric , log-model , log-param restore-experiment , restore-run , restore-runs , search-experiments , search-runs , set-experiment-tag , , set-tag , , update-experiment update-run get-permission-levels , get-permissions , set-permissions update-permissions |
model-registry | 작업 영역 모델 레지스트리에 대한 명령:approve-transition-request , create-comment , create-model , create-model-version , create-transition-request , create-webhook , delete-comment , delete-model , delete-model-tag , delete-model-version , delete-model-version-tag , delete-transition-request , delete-webhook , get-latest-versions , get-model , get-model-version , get-model-version-download-uri , list-models , list-transition-requests , list-webhooks , reject-transition-request , rename-model , search-model-versions , search-models , set-model-tag , set-model-version-tag , test-registry-webhook , transition-stage , update-comment , update-model , update-model-version , update-webhook get-permission-levels , get-permissions , set-permissions update-permissions |
실시간 서비스 명령
Group | 설명 및 명령 |
---|---|
서비스 엔드포인트 | 엔드포인트를 제공하는 모델을 만들고, 업데이트하고, 삭제하는 명령:build-logs , create , delete , export-metrics , get , list , logs , patch put , query update-config get-permission-levels , get-permissions , set-permissions update-permissions |
ID 및 액세스 관리 명령
Group | 설명 및 명령 |
---|---|
account | Databricks 계정을 관리하기 위한 명령:
|
auth | 인증 명령:describe , env , login , profiles token |
current-user | 현재 인증된 사용자 또는 서비스 주체에 대한 정보를 검색하는 명령:me |
groups | 그룹은 다음 명령을 사용하여 ID 관리를 간소화하고, Databricks 작업 공간, 데이터 및 기타 보안 개체에 대한 액세스 할당을 더 쉽게 할 수 있습니다.create , delete , get , list , patch update |
permissions | 다양한 개체 및 엔드포인트에서 여러 사용자에 대한 읽기, 쓰기, 편집, 업데이트 및 접근 제어를 위한 명령어:get , , set update get-permission-levels |
service-principals | 다음은 작업, 자동화된 도구, 스크립트, 앱, CI/CD 플랫폼과 같은 시스템에서 사용하기 위한 서비스 ID에 대한 명령입니다.create , delete , get , list , patch update |
users | 다음은 Databricks에서 인식되고 이메일 주소로 표시되는 사용자 ID에 대한 명령입니다.create , delete , get , list , patch update get-permission-levels , get-permissions , set-permissions update-permissions |
SQL 관련 명령
Group | 설명 및 명령 |
---|---|
alerts | 다음은 경고에 대한 작업을 수행하는 명령입니다.create , delete , get , list update |
alerts-legacy | 레거시 경고에 대한 작업을 수행하는 명령:create , delete , get , list update |
데이터 원본 | 새 쿼리 개체를 만들기 위한 명령:list |
queries | 쿼리 정의에 대한 작업을 수행하는 명령:create , delete , get , list , restore update |
queries-legacy | 레거시 쿼리 정의에 대한 작업을 수행하는 명령:create , delete , get , list , restore update |
쿼리 기록 | SQL 웨어하우스를 통해 쿼리 기록에 액세스하는 명령:list |
웨어하우스 | 다음은 SQL 명령을 Databricks SQL 내의 데이터 개체에서 실행할 수 있는 컴퓨팅 리소스인 SQL 웨어하우스를 관리하는 명령입니다.create ,delete , edit , get , get-workspace-warehouse-config , list set-workspace-warehouse-config , start stop get-permission-levels , get-permissions , set-permissions update-permissions |
Unity 카탈로그 명령
Group | 설명 및 명령 |
---|---|
아티팩트 허용 목록 | 아티팩트 허용 목록을 관리하는 명령입니다. Databricks Runtime 13.3 이상에서는 UC의 허용 목록에 라이브러리 및 init 스크립트를 추가하여 사용자가 표준 액세스 모드로 구성된 컴퓨팅에서 이러한 아티팩트가 활용되도록 할 수 있습니다.get , update |
catalogs | Unity 카탈로그의 3개 수준 네임스페이스의 첫 번째 계층인 카탈로그를 관리하는 명령:create , delete , get , list update |
자격 증명 | 클라우드 테넌트에서 서비스에 액세스하기 위한 인증 및 권한 부여 메커니즘인 자격 증명을 관리하는 명령입니다. 각 자격 증명에는 자격 증명에 액세스할 수 있는 사용자 및 그룹을 제어하는 Unity 카탈로그 액세스 제어 정책이 적용됩니다.create-credential , delete-credential , generate-temporary-service-credential , get-credential , list-credentials , update-credential validate-credential |
connections | 외부 데이터 원본에 대한 연결을 만드는 명령:create , delete , get , list update |
external-locations |
클라우드 스토리지 경로와 해당 경로에 대한 접근 권한을 부여하는 스토리지 자격 증명을 결합한 외부 위치를 관리하는 명령:create , delete , get , list update |
functions | Unity 카탈로그에서 UDF(사용자 정의 함수) 를 관리하는 명령:create , delete , get , list update |
grants | Unity 카탈로그의 데이터에 대한 액세스 권한을 부여하는 명령:get , , get-effective update |
메타스토어 | Unity 카탈로그에서 개체의 최상위 컨테이너인 메타스토어 관리 명령:assign , create , current , delete , get , list , summary unassign , update update-assignment |
model-versions | 다음은 모델 버전을 관리하는 명령입니다. Databricks는 Unity 카탈로그에서 호스트된 버전의 MLflow 모델 레지스트리를 제공합니다.delete , get , get-by-alias , list update |
온라인 테이블 | 온라인 테이블을 관리하는 명령: 이 명령은 델타 테이블의 데이터에 대한 대기 시간을 줄이고 QPS를 높여줍니다.create , , delete get |
품질 모니터 | 시간에 따라 테이블에 대한 데이터 또는 모델 품질 메트릭을 컴퓨팅 및 모니터링하는 모니터를 관리하는 명령:create , delete , get , get-refresh , list-refreshes , run-refresh update |
registered-models | 다음은 등록된 모델을 관리하는 명령입니다. Databricks는 Unity 카탈로그에서 호스트된 버전의 MLflow 모델 레지스트리를 제공합니다.create , delete , delete-alias , get , list , set-alias update |
리소스 할당량 | 만들 수 있는 리소스 수를 제한하는 모든 보안 개체에 대해 Unity 카탈로그에 의해 적용되는 리소스 할당량을 관리하는 명령입니다.get-quota , list-quotas |
schemas | Unity 카탈로그의 3개 수준 네임스페이스의 두 번째 계층인 스키마를 관리하는 명령:create , delete , get , list update |
storage-credentials | 클라우드 테넌트에 저장된 데이터에 액세스하기 위한 인증 및 권한 부여 메커니즘인 스토리지 자격 증명을 관리하는 명령:create , delete , get , list , update validate |
시스템 스키마 | 시스템 카탈로그 내에 있는 스키마인 시스템 스키마를 관리하는 명령:disable , , enable list |
테이블 제약 조건 | 테이블의 필드 간 관계를 인코딩하는 기본 키 및 외래 키 제약 조건을 관리하는 명령:create , delete |
tables | Unity 카탈로그의 세 번째 수준 네임스페이스의 세 번째 계층에 있는 테이블을 관리하는 명령:delete , exists , get , list list-summaries |
temporary-table-credentials | 테이블 데이터가 Databricks에 저장되는 클라우드 스토리지 위치에 액세스하는 데 사용되는 수명이 짧고 범위가 짧은 자격 증명인 임시 테이블 자격 증명을 관리하는 명령입니다.generate-temporary-table-credentials |
volumes | 파일 액세스, 저장, 관리, 구성 및 처리를 위한 UC(Unity 카탈로그) 기능인 볼륨을 관리하는 명령:create , delete , list , read update |
workspace-bindings | 보안 작업 영역 바인딩을 관리하는 명령: Databricks의 보안 개체는 OPEN 또는 ISOLATED 로 구성할 수 있습니다.get , get-bindings , update update-bindings |
델타 공유 명령
Group | 설명 및 명령 |
---|---|
providers | 데이터를 공유하는 조직을 나타내는 데이터 공급자를 관리하는 명령:create , delete , get , list , list-shares update |
recipient-activation | 받는 사람 활성화를 관리하는 명령으로, 받는 사람 개체에 TOKEN 인증 유형이 있는 열린 공유 모델에만 적용됩니다.get-activation-url-info , retrieve-token |
받는 사람 | 당신이 공유에 대한 액세스를 허용하려는 조직을 나타낼 수 있도록 :method:recipients/create 를 사용하여 만드는 받는 사람을 관리하기 위한 명령은 다음과 같습니다.create , delete , get , list , rotate-token update share-permissions |
공유 |
:method:shares/create 사용하여 인스턴스화된 컨테이너인 공유를 관리하는 명령:create , delete , get , list update share-permissions , update-permissions |
설정 명령
Group | 설명 및 명령 |
---|---|
ip-access-lists | 관리자가 IP 액세스 목록을 구성할 수 있도록 하는 명령:create , delete , get , list , replace update |
알림 대상 | 작업 영역의 알림 대상을 관리하는 명령:create , delete , get , list update |
settings | 사용자가 작업 영역 수준에서 설정을 관리할 수 있도록 하는 명령:automatic-cluster-update , csp-enablement , default-namespace , esm-enablement restrict-workspace-admins |
토큰 관리 | 관리자가 다른 사용자의 모든 토큰을 가져오고 토큰을 삭제할 수 있도록 하는 명령:create-obo-token , delete , get list get-permission-levels , get-permissions , set-permissions update-permissions |
토큰 | Databricks REST API를 인증하고 액세스하는 데 사용할 수 있는 토큰을 만들고 나열하고 해지하는 명령:create , , delete list |
workspace-conf | 작업 영역 설정을 업데이트하는 명령:get-status , set-status |
개발자 도구 명령
Group | 설명 및 명령 |
---|---|
bundle | 다음은 Databricks 자산 번들을 관리하는 명령으로, Databricks 프로젝트를 코드로 표현할 수 있습니다.deploy , deployment , destroy , generate , init , open , run , schema summary , sync validate |
sync | 로컬 디렉터리를 작업 영역 디렉터리에 동기화합니다. |
벡터 검색 명령
Group | 설명 및 명령 |
---|---|
vector-search-endpoints | 벡터 검색 인덱스를 호스트하는 컴퓨팅 리소스를 나타내는 벡터 검색 엔드포인트를 관리하는 명령:create-endpoint , delete-endpoint , get-endpoint list-endpoints |
vector-search-indexes | 다음은 실시간 및 효율적인 가장 인접한 항목(ANN) 검색 쿼리를 지원하는 임베딩 벡터의 효율적인 표현인 벡터 검색 인덱스를 관리하는 명령입니다.create-index , delete-data-vector-index , delete-index , get-index , list-indexes , query-index , sync-index upsert-data-vector-index |
대시보드 명령
Group | 설명 및 명령 |
---|---|
dashboards | 레거시 대시보드를 수정하기 위한 명령:create , delete , get , list , restore update |
genie | AI/BI로 구동되는 비즈니스 사용자에게 코드 없이 작업할 수 있는 환경을 제공하는 Genie 수정 명령:create-message , execute-message-attachment-query , get-message , get-message-attachment-query-result , get-spaced start-conversation |
레이크뷰 | AI/BI 대시보드에 대한 특정 관리 작업을 제공하는 명령:create , create-schedule , create-subscription , delete-schedule , delete-subscription , get , , get-published , get-schedule , get-subscription , list , list-schedules list-subscriptions migrate publish trash unpublish update update-schedule |
마켓플레이스 명령
Group | 설명 및 명령 |
---|---|
소비자 처리 | 소비자가 설치를 미리 볼 수 있도록 하는 엔터티의 이행 관리 명령입니다.get , list |
소비자 설치 | 소비자가 Databricks Marketplace 목록과 상호 작용할 수 있도록 하는 엔터티인 설치를 관리하기 위한 명령입니다.create , delete , list , list-listing-installations update |
소비자 목록 | Databricks Marketplace 소비자 목록을 관리하기 위한 명령:batch-get , get , list search |
소비자-개인 설정 요청 | 고객이 개별화된 Marketplace 목록 흐름과 상호 작용할 수 있도록 하는 개인 설정 요청을 관리하기 위한 명령입니다.create , , get list |
소비자 공급자 | Marketplace에 목록을 게시하는 엔터티인 공급자를 관리하기 위한 명령입니다.batch-get , , get list |
provider-exchange-filters | Exchange에 액세스할 수 있는 그룹을 큐레이팅하는 Marketplace 교환 필터를 관리하기 위한 명령입니다.create , delete , list update |
provider-exchanges | 공급자가 큐레이팅된 고객 집합과 목록을 공유할 수 있도록 하는 Marketplace 교환을 관리하기 위한 명령입니다.add-listing-to-exchange ,create , delete , delete-listing-from-exchange , get , list list-exchanges-for-listing , list-listings-for-exchange update |
provider-files | Marketplace 파일(예: 미리 보기 Notebook 및 공급자 아이콘)을 관리하기 위한 명령입니다.create , delete , get list |
provider-listings | 공급자 목록을 관리하기 위한 명령:create , delete , get , list update |
provider-personalization-requests | 즉시 사용 가능한 목록의 대체 항목인 개인 설정 요청을 관리하기 위한 명령입니다.list , update |
provider-provider-analytics-dashboards | 공급자에 대한 템플릿 분석 관리 명령:create , get , get-latest-version update |
공급자 공급자 | Marketplace에서 자산을 관리하는 공급자를 관리하는 명령입니다.create , delete , get , list update |
앱 명령
Group | 설명 및 명령 |
---|---|
apps |
Databricks 인스턴스에서 직접 실행되는 Databricks 앱을 관리하고, 데이터와 통합하고, Databricks 서비스를 사용 및 확장하고, 사용자가 Single Sign-On을 통해 상호 작용할 수 있도록 하는 명령입니다.create , delete , deploy , get , get-deployment , list , list-deployments , run-local start , stop update |
회의실 정리 명령
Group | 설명 및 명령 |
---|---|
클린룸 자산 | 클린룸과 공유되는 테이블, 볼륨 및 Notebook과 같은 데이터 및 코드 개체인 클린룸 자산을 관리하는 명령입니다.create , delete , get , list update |
clean-room-task-runs | 클린룸에서 노트북 실행을 관리하는 명령입니다.list |
클린룸 | 클린룸을 관리하는 명령입니다. 클린룸은 델타 공유 및 서버리스 컴퓨팅을 사용하여 서로의 데이터에 직접 액세스하지 않고도 여러 당사자가 중요한 엔터프라이즈 데이터에 대해 함께 작업할 수 있는 안전하고 개인 정보 보호 환경을 제공합니다.create , create-output-catalog , delete , get , list update |
데이터베이스 명령
Group | 설명 및 명령 |
---|---|
데이터베이스 | Lakebase 데이터베이스 인스턴스를 관리하는 명령입니다.create-database-catalog , create-database-instance , create-database-table , create-synced-database-table , delete-database-catalog , delete-database-instance , , delete-database-table , delete-synced-database-table , find-database-instance-by-uid generate-database-credential , get-database-catalog get-database-instance get-database-table get-synced-database-table list-database-instances ,update-database-instance |
추가 명령
Group | 설명 및 명령 |
---|---|
api | Databricks REST API를 요청하는 명령:delete , get , head , patch , post put |
completion | 지정된 셸에 대한 자동 완성 스크립트를 생성하는 명령:bash , fish , powershell zsh |
configure | Databricks CL를 구성합니다. |
help |
모든 Databricks CLI 명령에 대한 출력 요약 정보입니다. |
labs | Databricks Labs 설치를 관리하는 명령:clear-cache , install , installed , list , show , uninstall upgrade |
version | 현재 사용 중인 CLI의 버전을 검색합니다. |
전역 표시기
다음 플래그는 모든 Databricks CLI 명령에서 사용할 수 있습니다. 일부 명령에는 이러한 플래그가 적용되지 않을 수 있습니다. 특정 명령 및 해당 플래그에 대한 자세한 내용은 명령줄 도움말을 참조하세요.
--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
문자열
해당하는 경우 사용할 번들 대상