Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
이 문서에서는 사용 가능한 Databricks CLI 명령에 대한 정보를 제공합니다. 이 정보는 명령줄 도움말을 보완합니다. Databricks CLI 설치 및 사용에 대한 자세한 내용은 Databricks CLI 설치 또는 업데이트 및 Databricks CLI란?을 참조하세요..
Databricks CLI에는 다음 표에 나열된 명령 그룹이 포함되어 있습니다. 명령 그룹에는 하위 명령도 포함할 수 있는 관련 명령 집합이 포함되어 있습니다. 명령 그룹, 개별 명령 또는 하위 명령에 대한 사용량 및 구문 정보를 출력하려면 다음을 수행합니다.
databricks <command-group> -hdatabricks <command-group> <command-name> -hdatabricks <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, listupdateget-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, listmkdirsget-permission-levels, get-permissions, set-permissionsupdate-permissions |
컴퓨팅 명령
| Group | 설명 및 명령 |
|---|---|
| cluster-policies | 규칙 집합에 따라 클러스터를 구성하는 사용자의 기능을 제어하는 명령:create, delete, edit, getlistget-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, unpinget-permission-levels, get-permissions, set-permissionsupdate-permissions |
| global-init-scripts | 작업 영역 관리자가 작업 영역을 위한 전역 초기화 스크립트를 구성할 수 있도록 하는 명령:create, delete, get, listupdate |
| instance-pools | 즉시 사용할 수 있는 클라우드 인스턴스를 사용하여 인스턴스 풀을 만들고, 편집하고, 삭제하고, 나열하는 명령은 클러스터 시작 및 자동 크기 조정 시간을 줄입니다.create, delete, edit, getlistget-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,updateget-permission-levels, get-permissions, set-permissionsupdate-permissions |
Lakeflow 선언형 파이프라인 명령어
| Group | 설명 및 명령 |
|---|---|
| pipelines | 다음 명령을 사용해 파이프라인을 생성, 편집, 삭제, 시작하고 세부 정보를 조회할 수 있습니다.create, delete, get, get-update, list-pipeline-events, list-pipelines, list-updatesstart-update, stopupdateget-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-runget-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-webhookget-permission-levels, get-permissions, set-permissionsupdate-permissions |
실시간 서비스 명령
| Group | 설명 및 명령 |
|---|---|
| 서비스 엔드포인트 | 엔드포인트를 제공하는 모델을 만들고, 업데이트하고, 삭제하는 명령:build-logs, create, delete, export-metrics, get, list, logs, patchput, queryupdate-configget-permission-levels, get-permissions, set-permissionsupdate-permissions |
ID 및 액세스 관리 명령
| Group | 설명 및 명령 |
|---|---|
| account | Databricks 계정을 관리하기 위한 명령:
|
| auth | 인증 명령:describe, env, login, profilestoken |
| current-user | 현재 인증된 사용자 또는 서비스 주체에 대한 정보를 검색하는 명령:me |
| groups | 그룹은 다음 명령을 사용하여 ID 관리를 간소화하고, Databricks 작업 공간, 데이터 및 기타 보안 개체에 대한 액세스 할당을 더 쉽게 할 수 있습니다.create, delete, get, list, patchupdate |
| permissions | 다양한 개체 및 엔드포인트에서 여러 사용자에 대한 읽기, 쓰기, 편집, 업데이트 및 접근 제어를 위한 명령어:get, , setupdateget-permission-levels |
| service-principals | 다음은 작업, 자동화된 도구, 스크립트, 앱, CI/CD 플랫폼과 같은 시스템에서 사용하기 위한 서비스 ID에 대한 명령입니다.create, delete, get, list, patchupdate |
| users | 다음은 Databricks에서 인식되고 이메일 주소로 표시되는 사용자 ID에 대한 명령입니다.create, delete, get, list, patchupdateget-permission-levels, get-permissions, set-permissionsupdate-permissions |
SQL 관련 명령
| 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, startstopget-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-tokenupdateshare-permissions |
| 공유 |
:method:shares/create사용하여 인스턴스화된 컨테이너인 공유를 관리하는 명령:create, delete, get, listupdateshare-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, getlistget-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 문자열
해당하는 경우 사용할 번들 대상