Databricks CLI 명령

참고 항목

이 정보는 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 참조에 설명된 작업에 매핑됩니다.

작업 영역 명령

그룹	설명 및 명령
fs	파일 및 파일 시스템을 관리하기 위한 명령: cat, cp, ls, mkdirrm
git-credentials	사용자를 대신하여 작업을 수행하기 위해 Databricks에 개인 액세스 토큰을 등록하는 명령: create, delete, get, listupdate
repos	사용자가 git 리포지토리를 관리할 수 있도록 하는 명령: create, delete, get, listupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions
secrets	비밀, 비밀 범위 및 액세스 권한을 관리하기 위한 명령: create-scope, delete-acl, delete-scope, delete-secret, get-acl, get-secret, list-acls, list-scopeslist-secrets, put-aclput-secret
workspace	작업 영역에서 노트북 및 폴더를 나열, 가져오기, 내보내기 및 삭제하는 명령: delete, export, export-dir, get-status, import, import-dir, listmkdirs get-permission-levels, get-permissions, set-permissionsupdate-permissions

컴퓨팅 명령

그룹	설명 및 명령
cluster-policies	사용자에게 규칙 집합에 따라 클러스터를 구성할 수 있는 기능을 제어하는 명령: create, delete, edit, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
clusters	클러스터를 만들고, 시작하고, 편집하고, 나열하고, 종료하고, 삭제할 수 있는 명령 change-owner, create, delete, edit, events, get, , list, , permanent-deleterestartstartlist-zonespinresizespark-versionslist-node-typesunpin get-permission-levels, get-permissions, set-permissionsupdate-permissions
global-init-scripts	작업 영역 관리자가 작업 영역을 위한 전역 초기화 스크립트를 구성할 수 있도록 하는 명령: create, delete, get, listupdate
instance-pools	다음은 즉시 사용할 수 있는 클라우드 인스턴스를 사용하여 인스턴스 풀을 만들고, 편집하고, 삭제하고, 나열하는 명령으로, 클러스터 시작 및 자동 크기 조정 시간을 줄입니다. create, delete, edit, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
instance-profiles	관리자는 다음 명령을 사용하여 클러스터를 시작할 수 있는 인스턴스 프로필을 추가, 나열 및 제거할 수 있습니다. add, edit, listremove
libraries	다음 명령을 사용하여 클러스터에서 라이브러리를 설치, 제거 및 상태를 확인할 수 있습니다. all-cluster-statuses, cluster-status, installuninstall
policy-families	다음 명령을 사용하여 사용 가능한 정책 패밀리를 볼 수 있습니다. get, list

작업 명령

그룹	설명 및 명령
jobs	작업을 관리하는 명령: cancel-all-runs, cancel-run, create, delete, delete-run, export-run, , get, get-run, listget-run-output, list-runsrepair-runresetrun-nowsubmit,update get-permission-levels, get-permissions, set-permissionsupdate-permissions

Delta Live Tables 명령

그룹	설명 및 명령
pipelines	다음 명령을 사용해 파이프라인을 생성, 편집, 삭제, 시작하고 세부 정보를 조회할 수 있습니다. create, delete, get, get-update, list-pipeline-events, list-pipelines, list-updatesstart-update, stopupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions

기계 학습 명령

그룹	설명 및 명령
experiments	다음 명령을 사용하여 MLflow의 기본 조직 단위인 실험과 상호 작용할 수 있습니다. 모든 MLflow 실행은 하나의 실험에 속합니다. create-experiment, create-run, delete-experiment, delete-run, delete-runs, delete-tag, get-by-name, get-experiment, , get-history, , get-runGetlist-artifacts, log-batchlist-experiments, log-inputslog-metric, log-model, restore-experimentlog-param, restore-run, restore-runs, search-experiments, search-runs, set-experiment-tag, , set-tag, , update-experimentupdate-run get-permission-levels, get-permissions, set-permissionsupdate-permissions
model-registry	작업 영역 모델 레지스트리에 대한 명령: approve-transition-request, create-comment, create-model, create-model-version, create-transition-request, create-webhook,delete-comment, , delete-model-tagdelete-model, , delete-model-version, delete-model-version-tag, delete-transition-request, delete-webhook, get-modelget-latest-versions, ,get-model-version-download-uriget-model-version , list-models, list-transition-requests, list-webhooksreject-transition-request, search-modelstest-registry-webhookset-model-tagsearch-model-versionsrename-modeltransition-stageupdate-commentset-model-version-tag, , , update-model-versionupdate-modelupdate-webhook get-permission-levels, get-permissions, set-permissionsupdate-permissions

실시간 서비스 명령

그룹	설명 및 명령
serving-endpoints	모델 서비스 엔드포인트를 만들고 업데이트 및 삭제하는 명령: build-logs, create, delete, export-metrics, get, list, logs, patchput, queryupdate-config get-permission-levels, get-permissions, set-permissionsupdate-permissions

ID 및 액세스 관리 명령

그룹	설명 및 명령
account	Databricks 계정을 관리하기 위한 명령: - ID 및 액세스: access-control, groups, service-principals, users, workspace-assignment - Unity 카탈로그: metastore-assignments, metastores, storage-credentials - 설정: ip-access-lists, network-connectivity, settings - 프로비전: credentials, encryption-keys, networks, private-access, storage, vpc-endpoints, workspaces - 결제: billable-usage, log-delivery - OAuth: custom-app-integration, o-auth-published-apps, published-app-integration, service-principal-secrets
auth	인증 명령: describe, env, login, profilestoken
current-user	현재 인증된 사용자 또는 서비스 주체에 대한 정보를 검색하는 명령: me
groups	그룹은 다음 명령을 사용하여 ID 관리를 간소화하고, Databricks 작업 공간, 데이터 및 기타 보안 개체에 대한 액세스 할당을 더 쉽게 할 수 있습니다. create, delete, get, list, patchupdate
permissions	다음 명령을 사용해 다양한 사용자에 대해 여러 개체 및 엔드포인트에서 읽기, 쓰기, 편집, 업데이트를 수행하고 액세스를 관리할 수 있습니다. get, , setupdate get-permission-levels
service-principals	다음은 작업, 자동화된 도구, 스크립트, 앱, CI/CD 플랫폼과 같은 시스템에서 사용하기 위한 서비스 ID에 대한 명령입니다. create, delete, get, list, patchupdate
users	다음은 Databricks에서 인식되고 이메일 주소로 표시되는 사용자 ID에 대한 명령입니다. create, delete, get, list, patchupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions

SQL 관련 명령

그룹	설명 및 명령
alerts	다음은 경고에 대한 작업을 수행하는 명령입니다. create, delete, get, listupdate
data-sources	새 쿼리 개체를 만들기 위한 명령: list
queries	쿼리 정의에 대한 작업을 수행하는 명령: create, delete, get, list, restoreupdate
query-history	SQL 웨어하우스를 통해 쿼리 기록에 액세스하는 명령: list
warehouses	다음은 SQL 명령을 Databricks SQL 내의 데이터 개체에서 실행할 수 있는 컴퓨팅 리소스인 SQL 웨어하우스를 관리하는 명령입니다. create,delete, edit, get, get-workspace-warehouse-config, listset-workspace-warehouse-config, startstop get-permission-levels, get-permissions, set-permissionsupdate-permissions

Unity 카탈로그 명령

그룹	설명 및 명령
artifact-allowlists	아티팩트 허용 목록을 관리하는 명령입니다. Databricks Runtime 13.3 이상에서는 사용자가 공유 액세스 모드로 구성된 컴퓨팅에서 이러한 아티팩트를 활용할 수 있도록 UC의 허용 목록에 라이브러리 및 init 스크립트를 추가할 수 있습니다. get, update
catalogs	Unity 카탈로그의 3단계 네임스페이스 중 첫 번째 계층인 카탈로그를 관리하는 명령: create, delete, get, listupdate
connections	외부 데이터 원본에 대한 연결을 만드는 명령: create, delete, get, listupdate
external-locations	클라우드 스토리지 경로와 해당 경로에 대한 접근 권한을 부여하는 스토리지 자격 증명을 결합한 외부 위치를 관리하는 명령: create, delete, get, listupdate
functions	Unity 카탈로그에서 UDF(사용자 정의 함수)를 관리하는 명령: create, delete, get, listupdate
grants	Unity 카탈로그의 데이터에 대한 액세스 권한을 부여하는 명령: get, , get-effectiveupdate
metastores	Unity 카탈로그에서 개체의 최상위 컨테이너인 메타스토어를 관리하는 명령: assign, create, current, delete, get, list, summaryunassign, updateupdate-assignment
model-versions	다음은 모델 버전을 관리하는 명령입니다. Databricks는 Unity 카탈로그에서 호스팅 버전의 MLflow 모델 레지스트리를 제공합니다. delete, get, get-by-alias, listupdate
online-tables	델타 테이블의 데이터에 대해 낮은 대기 시간과 더 높은 QPS 액세스을 제공하는 온라인 테이블을 관리하는 명령: create, , deleteget
quality-monitors	테이블에 대해 시간에 따라 데이터 또는 모델 품질 메트릭을 컴퓨팅 및 모니터링하는 모니터를 관리하는 명령: create, delete, get, get-refresh, list-refreshes, run-refreshupdate
registered-models	다음은 등록된 모델을 관리하는 명령입니다. Databricks는 Unity 카탈로그에서 호스팅 버전의 MLflow 모델 레지스트리를 제공합니다. create, delete, delete-alias, get, list, set-aliasupdate
schemas	Unity 카탈로그의 3단계 네임스페이스의 두 번째 계층인 스키마를 관리하는 명령: create, delete, get, listupdate
storage-credentials	클라우드 테넌트에 저장된 데이터에 액세스하기 위한 인증 및 권한 부여 메커니즘인 스토리지 자격 증명을 관리하는 명령: create, delete, get, list, updatevalidate
system-schemas	시스템 카탈로그 내에 있는 스키마인 시스템 스키마를 관리하는 명령: disable, , enablelist
table-constraints	테이블의 필드 간 관계를 인코딩하는 기본 키 및 외래 키 제약 조건을 관리하는 명령: create, delete
tables	Unity 카탈로그의 3단계 네임스페이스의 세 번째 계층에 있는 테이블을 관리하는 명령: delete, exists, get, listlist-summaries
volumes	파일 액세스, 저장, 관리, 구성 및 처리를 위한 UC(Unity 카탈로그) 기능인 볼륨을 관리하는 명령: create, delete, list, readupdate
workspace-bindings	보안 작업 영역 바인딩을 관리하는 명령: Databricks의 보안 개체는 OPEN 또는 ISOLATED로 구성할 수 있습니다. get, get-bindings, updateupdate-bindings

델타 공유 명령

그룹	설명 및 명령
providers	데이터를 공유하는 조직을 나타내는 데이터 공급자를 관리하는 명령: create, delete, get, list, list-sharesupdate
recipient-activation	받는 사람 활성화를 관리하는 명령으로, 받는 사람 개체에 TOKEN 인증 유형이 있는 열린 공유 모델에만 적용됩니다. get-activation-url-info, retrieve-token
recipients	공유에 대한 액세스를 허용하려는 조직을 나타내기 위해 :method:recipients/create을 사용하여 만든 수신자를 관리하는 명령: create, delete, get, list, rotate-tokenupdate share-permissions
shares	다음은 :method:shares/create으로 인스턴스화된 컨테이너인 공유를 관리하는 명령입니다. create, delete, get, listupdate share-permissions, update-permissions

설정 명령

그룹	설명 및 명령
ip-access-lists	관리자가 IP 액세스 목록을 구성할 수 있도록 하는 명령: create, delete, get, list, replaceupdate
settings	사용자가 작업 영역 수준에서 설정을 관리할 수 있도록 하는 명령: automatic-cluster-update, csp-enablement, default-namespace, esm-enablementrestrict-workspace-admins
token-management	관리자가 다른 사용자의 모든 토큰을 가져오고 토큰을 삭제할 수 있도록 하는 명령: create-obo-token, delete, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
tokens	Databricks REST API에 대한 인증 및 액세스에 사용할 수 있는 토큰을 생성, 나열 및 취소하는 명령: create, , deletelist
workspace-conf	작업 영역 설정을 업데이트하는 명령: get-status, set-status

개발자 도구 명령

그룹	설명 및 명령
bundle	다음은 Databricks 자산 번들을 관리하는 명령으로, Databricks 프로젝트를 코드로 표현할 수 있습니다. deploy, deployment, destroy, generate, init, open, run, schemasummary, syncvalidate
sync	로컬 디렉터리를 작업 영역 디렉터리에 동기화합니다.

벡터 검색 명령

그룹	설명 및 명령
vector-search-endpoints	벡터 검색 인덱스를 호스트하는 컴퓨팅 리소스를 나타내는 벡터 검색 엔드포인트를 관리하는 명령: create-endpoint, delete-endpoint, get-endpointlist-endpoints
vector-search-indexes	다음은 실시간 및 효율적인 가장 인접한 항목(ANN) 검색 쿼리를 지원하는 임베딩 벡터의 효율적인 표현인 벡터 검색 인덱스를 관리하는 명령입니다. create-index, delete-data-vector-index, delete-index, get-index, list-indexes, query-index, sync-indexupsert-data-vector-index

대시보드 명령

그룹	설명 및 명령
dashboards	대시보드 수정 명령: create, delete, get, list, restoreupdate
lakeview	AI/BI 대시보드에 대한 특정 관리 작업을 제공하는 명령: create, get, get-published, migrate, publish, trash, unpublishupdate

추가 명령

그룹	설명 및 명령
api	Databricks REST API를 요청하는 명령: delete, get, head, patch, postput
완료	다음은 지정된 셀에 대한 자동 완성 스크립트를 생성하는 명령입니다. bash, fish, powershellzsh
configure	Databricks CL를 구성합니다.
help	모든 명령에 대한 사용량 정보를 출력합니다.
LABS	Databricks Labs 설치를 관리하는 명령: clear-cache, install, installed, list, show, uninstallupgrade
version	현재 사용 중인 CLI의 버전을 검색합니다.

전역 플래그

다음 플래그는 모든 Databricks CLI 명령에서 사용할 수 있습니다. 일부 명령에는 이러한 플래그가 적용되지 않을 수 있습니다. 특정 명령 및 해당 플래그에 대한 자세한 내용은 명령줄 도움말을 참조하세요.

Flag	설명
-h 또는 --help	Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.
-e 또는 --environment string	해당하는 경우 관련 명령에 적용할 번들 환경을 나타내는 문자열입니다.
--log-file	출력 로그를 기록할 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.
--log-format	text로 출력 로그를 텍스트로 기록하거나 json으로 출력 로그를 JSON으로 기록합니다. 이 플래그를 지정하지 않으면 출력 로그가 텍스트로 기록됩니다.
--log-level	로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.
-o 또는 --output	text로 출력을 텍스트로 쓰거나 json으로 출력을 JSON으로 기록합니다. 이 플래그를 지정하지 않으면 출력이 텍스트로 작성됩니다.
-p 또는 --profile	.databrickscfg 파일 내에 지정된 이름이 있는 구성 프로필을 나타내는 문자열입니다. 이 플래그를 지정하지 않으면 명명된 DEFAULT 프로필이 있는 경우 사용됩니다. 구성 프로필 이름을 수동으로 입력하는 대신 --profile 또는 -p 이후에 Tab을 눌러 사용 가능한 기존 구성 프로필 목록을 표시할 수 있습니다.
--progress-format	진행률 로그를 표시할 형식입니다 (default(기본값), append, inplace, 또는 json 중 하나).