다음을 통해 공유

Databricks CLI 명령

  • 아티클

참고 항목

이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.

Databricks CLI 사용은 사용량 현황 데이터 프로비저닝을 포함하여 Databricks 라이선스 및 Databricks 개인 정보 보호 고지의 적용을 받습니다.

이 문서에서는 사용 가능한 Databricks CLI 명령에 대한 정보를 제공합니다. 이 정보는 명령줄 도움말을 보완합니다. Databricks CLI 설치 및 사용에 대한 자세한 내용은 설치, Databricks CLI 및 update Databricks CLI란 무엇입니까? 을 참조하세요..

Databricks CLI에는 다음 tables에 나열된 명령 그룹이 포함되어 있습니다. 명령 그룹에는 하위 명령도 포함할 수 있는 관련 명령 집합이 포함되어 있습니다. 명령 그룹, 개별 명령 또는 하위 명령에 대한 사용량 및 구문 정보를 출력하려면 다음을 수행합니다.

  • 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 작업 영역에서 전자 필기장 및 폴더를 list, 가져오기, 내보내기 및 삭제하는 명령:

delete, export, export-dir, get-status, import, import-dir, listmkdirs

get-permission-levels, get-permissions, set-permissionsupdate-permissions

컴퓨팅 명령

그룹 설명 및 명령
cluster-policies 규칙의 set 따라 클러스터를 구성하는 사용자의 기능을 제어하는 명령:

create, delete, edit, getlist

get-permission-levels, get-permissions, set-permissionsupdate-permissions
clusters 클러스터를 만들고, 시작하고, 편집하고, list, 종료 및 삭제할 수 있는 명령:

change-owner, create, delete, edit, events, get, , list, , list-node-typeslist-zonespermanent-deletepinresizerestartspark-versionsstartunpin

get-permission-levels, get-permissions, set-permissionsupdate-permissions
global-init-scripts 작업 영역 관리자가 작업 영역을 위한 전역 초기화 스크립트를 구성할 수 있도록 하는 명령:

create, delete, get, listupdate
instance-pools 즉시 사용할 수 있는 클라우드 인스턴스를 활용하여 인스턴스 풀을 생성, 편집, 삭제, 그리고 list 하는 명령은 클러스터 시작 및 자동 확장 시간을 줄입니다.

create, delete, edit, getlist

get-permission-levels, get-permissions, set-permissionsupdate-permissions
instance-profiles 사용자가 클러스터를 시작할 수 있도록 관리자가 list및 remove 인스턴스 프로필을 추가할 수 있게 하는 명령어입니다.

add, edit, listremove
libraries 클러스터에서 라이브러리의 상태를 설치, 제거 및 get 명령:

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, get-run-outputlist, 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, list-experimentslog-batch, log-inputslog-metric, log-model, log-paramrestore-experiment, 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-modeldelete-model-tag, , delete-model-version, delete-model-version-tag, delete-transition-request, delete-webhook, get-latest-versionsget-model, ,get-model-versionget-model-version-download-uri , list-models, list-transition-requests, list-webhooksreject-transition-request, rename-modelsearch-model-versionssearch-modelsset-model-tagset-model-version-tagtest-registry-webhooktransition-stageupdate-comment, , , update-modelupdate-model-versionupdate-webhook

get-permission-levels, get-permissions, set-permissionsupdate-permissions

실시간 서비스 명령

그룹 설명 및 명령
serving-endpoints 모델 서비스 엔드포인트를 생성하고, update, 삭제하는 명령:

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 Catalog: 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 다양한 개체 및 엔드포인트에서 여러 사용자의 읽기, 쓰기, 편집, update 및 액세스 권한을 관리하기 위한 명령어:

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
그룹 설명 및 명령
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 Catalog 명령

그룹 설명 및 명령
artifact-allowlists 아티팩트 허용 목록을 관리하는 명령입니다. Databricks Runtime 13.3 이상에서는 사용자가 공유 액세스 모드로 구성된 컴퓨팅에서 이러한 아티팩트를 활용할 수 있도록 UC의 허용 목록에 라이브러리 및 init 스크립트를 추가할 수 있습니다.

get, update
catalogs Unity Catalog3개 수준 네임스페이스의 첫 번째 계층인 catalogs관리하는 명령:

create, delete, get, listupdate
connections 외부 데이터 원본에 대한 연결을 만드는 명령:

create, delete, get, listupdate
external-locations 클라우드 스토리지 경로와 해당 경로에 대한 접근 권한을 부여하는 스토리지 자격 증명을 결합한 외부 위치를 관리하는 명령:

create, delete, get, listupdate
functions Unity Catalog에서 User-Defined 사용자 정의 함수(UDF)를 관리하는 명령:

create, delete, get, listupdate
grants Unity Catalog데이터 접근을 위한 grant 명령:

get, , get-effectiveupdate
metastores Unity Catalog개체의 최상위 컨테이너인 metastores를 관리하는 명령:

assign, create, current, delete, get, list, summaryunassign, updateupdate-assignment
model-versions 다음은 모델 버전을 관리하는 명령입니다. Databricks는 Unity CatalogMLflow 모델 레지스트리의 호스트된 버전을 제공합니다.

delete, get, get-by-alias, listupdate
online-tables 델타 tables데이터에 대해 대기 시간이 짧고 더 높은 QPS 액세스를 제공하는 온라인 tables을 관리하는 명령:

create, , deleteget
quality-monitors table의 데이터 또는 모델 품질 메트릭을 시간에 따라 계산하고 모니터링하는 모니터를 관리하기 위한 명령:

create, delete, get, get-refresh, list-refreshes, run-refreshupdate
registered-models 다음은 등록된 모델을 관리하는 명령입니다. Databricks는 Unity CatalogMLflow 모델 레지스트리의 호스트된 버전을 제공합니다.

create, delete, delete-alias, get, list, set-aliasupdate
schemas Unity Catalog3개 수준 네임스페이스의 두 번째 계층인 스키마를 관리하는 명령:

create, delete, get, listupdate
storage-credentials 클라우드 테넌트에 저장된 데이터에 액세스하기 위한 인증 및 권한 부여 메커니즘인 스토리지 credentials관리하는 명령:

create, delete, get, list, updatevalidate
system-schemas 시스템 catalog내에 있는 스키마인 시스템 스키마를 관리하는 명령:

disable, , enablelist
table-constraints tables필드 간의 관계를 인코딩하는 기본 키 및 외래 키 제약 조건을 관리하는 명령:

create, delete
tables Unity Catalog의 3단계 네임스페이스 세 번째 계층에 있는 tables을(를) 관리하기 위한 명령:

delete, exists, get, listlist-summaries
volumes 파일 액세스, 저장, 관리, 구성 및 처리를 위한 UC(Unity Catalog) 기능인 volumes관리하는 명령:

create, delete, list, readupdate
workspace-bindings 보안 작업 영역 바인딩을 관리하는 명령: Databricks의 보안 개체는 OPEN 또는 ISOLATED로 구성할 수 있습니다.

get, get-bindings, updateupdate-bindings

델타 공유 명령

그룹 설명 및 명령
providers 데이터를 공유하는 조직을 나타내는 데이터 providers를 관리하는 명령:

create, delete, get, list, list-sharesupdate
recipient-activation 받는 사람 활성화를 관리하는 명령으로, 받는 사람 개체에 TOKEN 인증 유형이 where 열린 공유 모델에만 적용됩니다.

get-activation-url-info, retrieve-token
recipients :method:recipients/create을 사용하여 shares에 대한 액세스를 허용하려는 조직을 나타내는 recipients을 만들고 관리하기 위한 명령어:

create, delete, get, list, rotate-tokenupdate

share-permissions
shares :method:shares/create으로 인스턴스화된 컨테이너인 shares을 관리하기 위한 명령:

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 관리자가 모든 토큰을 "get"하고, 다른 사용자의 토큰을 삭제할 수 있게 하는 명령:

create-obo-token, delete, getlist

get-permission-levels, get-permissions, set-permissionsupdate-permissions
tokens Databricks REST API를 인증 및 액세스하는 데 사용할 수 있는 list및 revoke 토큰을 생성하는 명령:

create, , deletelist
workspace-conf update 작업 영역 설정에 대한 명령:

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
완료 지정된 셸에 대한 자동 완성 스크립트를 실행하기 위한 generate 명령들:

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 눌러 구성 프로필 이름을 수동으로 입력하는 대신 선택할 수 있는 기존 구성 프로필의 list 표시할 수 있습니다.
--progress-format 진행률 로그를 표시할 형식입니다 (default(기본값), append, inplace, 또는 json 중 하나).