Databricks CLI에 대한 기본 사용

참고 항목

이 정보는 공개 미리 보기에 있는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI 버전을 찾으려면 다음을 실행 databricks -v합니다.

이 문서에서는 Databricks CLI 명령 그룹 및 명령을 나열하고, Databricks CLI 도움말을 표시하고, Databricks CLI 출력을 사용하는 방법을 보여 줍니다. Databricks CLI란?을 참조하세요.

이 문서에서는 Databricks CLI를 이미 설치하고 인증을 위해 CLI를 설정했다고 가정합니다. 참조

CLI 명령 그룹 나열

또는 -h 옵션을 사용하여 --help 명령 그룹을 나열합니다. 예시:

databricks -h

CLI 명령 나열

또는 -h 옵션을 사용하여 --help 명령 그룹에 대한 명령을 나열합니다. 예를 들어 명령을 나열하려면 다음을 clusters 수행합니다.

databricks clusters -h

CLI 명령 도움말 표시

또는 -h 옵션을 사용하여 명령에 대한 도움말을 --help 표시합니다. 예를 들어 명령에 대한 도움말을 표시하려면 다음을 수행합니다 clusters list .

databricks clusters list -h

CLI JSON 출력 구문 분석에 사용 jq

일부 Databricks CLI 명령 출력 응답은 JSON 형식으로 지정됩니다. 대부분의 경우 Databricks CLI는 읽기 쉽도록 JSON 출력의 형식을 지정합니다. 그러나 경우에 따라 전체 응답을 나열하는 대신 JSON의 일부를 구문 분석하는 것이 유용할 수 있습니다. 예를 들어 지정된 클러스터 ID를 사용하여 Azure Databricks 클러스터의 표시 이름만 나열하려면 유틸리티 jq를 사용할 수 있습니다.

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

출력

My-11.3-LTS-Cluster

예를 들어 Homebrew를 사용하거나 Windows에서 Chocolatey를 brew install jqchoco install jq사용하여 macOS에 설치 jq 할 수 있습니다. 자세한 jq내용은 jq Manual을 참조하세요.

JSON 문자열 매개 변수

문자열 매개 변수의 형식은 운영 체제에 따라 JSON에서 다르게 처리됩니다.

Linux 또는 macos

JSON 문자열 매개 변수를 큰따옴표로 묶어야 하며 전체 JSON 페이로드를 작은따옴표로 묶어야 합니다. 몇 가지 예는 다음과 같습니다.

'{"cluster_id": "1234-567890-abcde123"}'
'["20230323", "Amsterdam"]'

Windows

JSON 문자열 매개 변수와 전체 JSON 페이로드를 큰따옴표로 묶어야 하며 JSON 페이로드 내의 큰따옴표 문자 앞에 와야 합니다 \. 몇 가지 예는 다음과 같습니다.

"{\"cluster_id\": \"1234-567890-abcde123\"}"
"[\"20230323\", \"Amsterdam\"]"

프록시 서버 구성

프록시 서버를 통해 Databricks CLI 요청 및 응답을 라우팅하려면 Databricks CLI가 설치된 컴퓨터에서 환경 변수를 프록시 서버의 URL로 설정합니다 HTTPS_PROXY .

환경 변수를 설정하려면 운영 체제 설명서를 참조하세요.

전역 플래그

다음 플래그는 모든 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 프로필이 있는 경우 사용됩니다. 구성 프로필 이름을 수동으로 입력하는 대신 선택할 수 있는 기존 구성 프로필 목록을 누르 Tab--profile 거나 -p 표시할 수 있습니다.
--progress-format 표시default 할 진행률 로그(기본값) 또는 append 또는 inplacejson)의 형식입니다.