다음을 통해 공유


Databricks CLI 명령

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, 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 작업 영역에서 Notebook 및 폴더를 나열, 가져오기, 내보내기 및 삭제하는 명령:
delete, export, export-dir, get-status, import, import-dir, listmkdirs
get-permission-levels, get-permissions, set-permissionsupdate-permissions

컴퓨팅 명령

Group 설명 및 명령
cluster-policies 규칙 집합에 따라 클러스터를 구성하는 사용자의 기능을 제어하는 명령:
create, delete, edit, getlist
get-permission-levels, get-permissions, set-permissionsupdate-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-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
라이브러리 클러스터에서 라이브러리의 상태를 설치, 제거 및 가져오는 명령:
all-cluster-statuses, cluster-status, installuninstall
정책 패밀리 다음 명령을 사용하여 사용 가능한 정책 패밀리를 볼 수 있습니다.
get, list

작업 명령어

Group 설명 및 명령
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

Lakeflow 선언형 파이프라인 명령어

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

실시간 서비스 명령

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

ID 및 액세스 관리 명령

Group 설명 및 명령
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-integrationservice-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
Group 설명 및 명령
alerts 다음은 경고에 대한 작업을 수행하는 명령입니다.
create, delete, get, listupdate
alerts-legacy 레거시 경고에 대한 작업을 수행하는 명령:
create, delete, get, listupdate
데이터 원본 새 쿼리 개체를 만들기 위한 명령:
list
queries 쿼리 정의에 대한 작업을 수행하는 명령:
create, delete, get, list, restoreupdate
queries-legacy 레거시 쿼리 정의에 대한 작업을 수행하는 명령:
create, delete, get, list, restoreupdate
쿼리 기록 SQL 웨어하우스를 통해 쿼리 기록에 액세스하는 명령:
list
웨어하우스 다음은 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 카탈로그 명령

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

델타 공유 명령

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

설정 명령

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

개발자 도구 명령

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

벡터 검색 명령

Group 설명 및 명령
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

대시보드 명령

Group 설명 및 명령
dashboards 레거시 대시보드를 수정하기 위한 명령:
create, delete, get, list, restoreupdate
genie AI/BI로 구동되는 비즈니스 사용자에게 코드 없이 작업할 수 있는 환경을 제공하는 Genie 수정 명령:
create-message, execute-message-attachment-query, get-message, get-message-attachment-query-result, get-spacedstart-conversation
레이크뷰 AI/BI 대시보드에 대한 특정 관리 작업을 제공하는 명령:
create, create-schedule, create-subscription, delete-schedule, delete-subscription, get, , get-published, get-schedule, get-subscription, list, list-scheduleslist-subscriptionsmigratepublishtrashunpublishupdateupdate-schedule

마켓플레이스 명령

Group 설명 및 명령
소비자 처리 소비자가 설치를 미리 볼 수 있도록 하는 엔터티의 이행 관리 명령입니다.
get, list
소비자 설치 소비자가 Databricks Marketplace 목록과 상호 작용할 수 있도록 하는 엔터티인 설치를 관리하기 위한 명령입니다.
create, delete, list, list-listing-installationsupdate
소비자 목록 Databricks Marketplace 소비자 목록을 관리하기 위한 명령:
batch-get, get, listsearch
소비자-개인 설정 요청 고객이 개별화된 Marketplace 목록 흐름과 상호 작용할 수 있도록 하는 개인 설정 요청을 관리하기 위한 명령입니다.
create, , getlist
소비자 공급자 Marketplace에 목록을 게시하는 엔터티인 공급자를 관리하기 위한 명령입니다.
batch-get, , getlist
provider-exchange-filters Exchange에 액세스할 수 있는 그룹을 큐레이팅하는 Marketplace 교환 필터를 관리하기 위한 명령입니다.
create, delete, listupdate
provider-exchanges 공급자가 큐레이팅된 고객 집합과 목록을 공유할 수 있도록 하는 Marketplace 교환을 관리하기 위한 명령입니다.
add-listing-to-exchange,create, delete, delete-listing-from-exchange, get, listlist-exchanges-for-listing, list-listings-for-exchangeupdate
provider-files Marketplace 파일(예: 미리 보기 Notebook 및 공급자 아이콘)을 관리하기 위한 명령입니다.
create, delete, getlist
provider-listings 공급자 목록을 관리하기 위한 명령:
create, delete, get, listupdate
provider-personalization-requests 즉시 사용 가능한 목록의 대체 항목인 개인 설정 요청을 관리하기 위한 명령입니다.
list, update
provider-provider-analytics-dashboards 공급자에 대한 템플릿 분석 관리 명령:
create, get, get-latest-versionupdate
공급자 공급자 Marketplace에서 자산을 관리하는 공급자를 관리하는 명령입니다.
create, delete, get, listupdate

앱 명령

Group 설명 및 명령
apps Databricks 인스턴스에서 직접 실행되는 Databricks 앱을 관리하고, 데이터와 통합하고, Databricks 서비스를 사용 및 확장하고, 사용자가 Single Sign-On을 통해 상호 작용할 수 있도록 하는 명령입니다.
create, delete, deploy, get, get-deployment, list, list-deployments, run-localstart, stopupdate

회의실 정리 명령

Group 설명 및 명령
클린룸 자산 클린룸과 공유되는 테이블, 볼륨 및 Notebook과 같은 데이터 및 코드 개체인 클린룸 자산을 관리하는 명령입니다.
create, delete, get, listupdate
clean-room-task-runs 클린룸에서 노트북 실행을 관리하는 명령입니다.
list
클린룸 클린룸을 관리하는 명령입니다. 클린룸은 델타 공유 및 서버리스 컴퓨팅을 사용하여 서로의 데이터에 직접 액세스하지 않고도 여러 당사자가 중요한 엔터프라이즈 데이터에 대해 함께 작업할 수 있는 안전하고 개인 정보 보호 환경을 제공합니다.
create, create-output-catalog, delete, get, listupdate

데이터베이스 명령

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-uidgenerate-database-credential, get-database-catalogget-database-instanceget-database-tableget-synced-database-tablelist-database-instances,update-database-instance

추가 명령

Group 설명 및 명령
api Databricks REST API를 요청하는 명령:
delete, get, head, patch, postput
completion 지정된 셸에 대한 자동 완성 스크립트를 생성하는 명령:
bash, fish, powershellzsh
configure Databricks CL를 구성합니다.
help 모든 Databricks CLI 명령에 대한 출력 요약 정보입니다.
labs Databricks Labs 설치를 관리하는 명령:
clear-cache, install, installed, list, show, uninstallupgrade
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 문자열

    해당하는 경우 사용할 번들 대상