Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
configure
Databricks CLI 내의 명령을 사용하면 Azure Databricks 개인용 액세스 토큰 또는 Microsoft Entra ID(이전의 Azure Active Directory) 토큰을 사용하여 Azure Databricks로 Databricks CLI를 인증할 수 있습니다.
Note
보안 모범 사례로, 자동화된 도구, 시스템, 스크립트, 앱을 사용하여 인증할 때 Databricks는 작업 영역 사용자 대신 서비스 주체에 속한 개인용 액세스 토큰을 사용하는 것을 권장합니다. 서비스 주체에 대한 토큰을 만들려면 서비스 주체에 대한 토큰 관리를 참조하세요.
이 문서에서는 작업 영역 수준 명령의 호출을 사용하도록 설정하기 위한 Azure Databricks 개인용 액세스 토큰 및 Microsoft Entra ID 토큰 인증만 다룹니다. 추가 인증 구성 옵션은 Databricks CLI에 대한 인증을 참조하세요.
databricks 구성 설정하십시오
~/.databrickscfg 파일에서 프로필을 설정합니다.
구성 프로필은 Azure Databricks 작업 영역 URL 및 액세스 토큰 값과 같은 인증 정보를 포함하는 설정의 컬렉션입니다.
구성 프로필에는 프로그래밍 방식 이름(예: DEFAULT, DEV또는 PROD.)이 있습니다. 파일에 여러 프로필을 .databrickscfg 추가하면 명령 옵션에서 대상 연결 프로필의 이름을 지정하여 다양한 작업 영역에서 명령을 --profile 빠르게 실행할 수 있습니다. 이 옵션을 지원하는 명령에서 옵션을 지정 --profile 하지 않으면 이 명령은 기본적으로 연결 프로필을 사용합니다 DEFAULT .
예를 들어 개발 워크로드에 사용하는 Azure Databricks 작업 영역을 참조하는 연결 DEV 프로필과 프로덕션 워크로드에 사용하는 다른 Azure Databricks 작업 영역을 참조하는 연결 프로필이라는 PROD 별도의 연결 프로필을 사용할 수 있습니다.
기존 구성 프로필에 대한 정보를 얻으려면 명령 그룹을 사용합니다auth.
환경 변수.databrickscfg를 설정하여 파일의 DATABRICKS_CONFIG_FILE 기본 경로를 변경할 수 있습니다.
이 명령이 비대화형 모드에서 호출되면 stdin에서 토큰을 읽습니다. 호스트는 플래그 또는 --host 환경 변수를 DATABRICKS_HOST 사용하여 지정해야 합니다.
databricks configure [flags]
Options
--configure-cluster
클러스터를 구성하라는 프롬프트
--host string
Databricks 작업 영역 호스트 URL
작업 영역 호스트 URL은 작업 영역별 URL이며 형식 https://adb-<workspace-id>.<random-number>.azuredatabricks.net은 다음과 같습니다. 작업 영역별 URL을 얻으려면 작업 영역별 URL을 참조하세요.
--profile string
구성할 연결 프로필의 이름입니다. (기본값 "DEFAULT")
Examples
다음 예제에서는 기본 프로필에 대한 인증을 구성합니다.
databricks configure
다음 예제에서는 특정 프로필에 대한 인증을 구성합니다.
databricks configure --profile my-profile
다음 예제에서는 특정 호스트를 사용하여 인증을 구성합니다.
databricks configure --host https://my-workspace.cloud.databricks.com
다음 예제에서는 클러스터 구성을 사용하여 인증을 구성합니다.
databricks configure --configure-cluster
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상
구성 프로필을 만듭니다.
구성 프로필을 만들려면 다음 명령을 실행합니다 configure .
databricks configure --host <workspace-url>
이 명령은 지정된 항목에 매핑되는 Azure Databricks 개인용 액세스 토큰 또는 Microsoft Entra ID(이전의 Azure Active Directory) 토큰 을 입력하라는 <workspace-url>메시지를 표시합니다.
✔ Databricks Token:
액세스 토큰을 입력하면 액세스 토큰이 Linux 또는 macOS의 파일 ~/.databrickscfg 또는 %USERPROFILE%\.databrickscfg Windows에 기본적으로 저장됩니다. 파일에는 다음과 같은 기본 연결 프로필 항목이 DEFAULT포함되어 있습니다.
[DEFAULT]
host = <workspace-url>
token = <access-token>
대신 연결 프로필DEFAULT에 다른 이름을 사용하려면 명령에 옵션을 --profile 추가 configure 합니다. 예를 들면 다음과 같습니다.
databricks configure --host <workspace-url> --profile <profile-name>
Tip
구성 프로필 이름을 수동으로 입력하는 대신 Tab 또는 --profile 이후에 -p을 눌러서 선택하려는 기존 사용 가능한 구성 프로필 목록을 표시할 수 있습니다.
지정된 연결 프로필 내의 모든 기존 호스트 및 토큰 정보는 새 호스트 및 토큰 정보로 덮어씁니다.