configure
명령 그룹
참고 항목
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 사용량 현황 데이터 프로비저닝을 포함하여 Databricks 라이선스 및 Databricks 개인 정보 보호 고지의 적용을 받습니다.
Databricks CLI 내의 명령 그룹을 사용하면 Azure Databricks 개인용 액세스 토큰 또는 Microsoft Entra ID(이전의 Azure Active Directory) 토큰을 사용하여 Azure Databricks로 Databricks CLI를 인증할 수 있습니다.configure
참고 항목
보안 모범 사례로, 자동화된 도구, 시스템, 스크립트, 앱을 사용하여 인증할 때 Databricks는 작업 영역 사용자 대신 서비스 주체에 속한 개인용 액세스 토큰을 사용하는 것을 권장합니다. 서비스 주체에 대한 토큰을 만들려면 서비스 주체에 대한 토큰 관리를 참조하세요.
이 문서에서는 작업 영역 수준 명령의 호출을 사용하도록 설정하기 위한 Azure Databricks 개인용 액세스 토큰 및 Microsoft Entra ID 토큰 인증만 다룹니다. 추가 인증 구성 옵션은 Databricks CLI에 대한 인증을 참조하세요.
Important
이 명령을 실행하기 전에 Databricks CLI를 설정해야 합니다.
configure
명령을 databricks configure
에 추가하여 실행합니다. configure
명령에 대한 도움말을 표시하려면 databricks configure -h
를 실행합니다.
구성 프로필을 만듭니다.
구성 프로필은 Azure Databricks 작업 영역 URL 및 액세스 토큰 값과 같은 인증 정보를 포함하는 설정의 컬렉션입니다. 구성 프로필에는 프로그래밍 방식 이름(예: DEFAULT
, DEV
또는 PROD
.)이 있습니다.
구성 프로필을 만들려면 다음과 같이 명령을 실행 configure
합니다.
databricks configure --host <workspace-url>
의 경우 <workspace-url>
작업 영역별 URL을 형식 https://adb-<workspace-id>.<random-number>.azuredatabricks.net
으로 입력합니다. 작업 영역별 URL을 얻으려면 작업 영역별 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
에 다른 이름을 사용하려면 명령에 옵션을 configure
추가 --profile
합니다. 예를 들면 다음과 같습니다.
databricks configure --host <workspace-url> --profile <profile-name>
팁
구성 프로필 이름을 수동으로 입력하는 대신 --profile
또는 -p
이후에 Tab
을 눌러서 선택하려는 기존 사용 가능한 구성 프로필 목록을 표시할 수 있습니다.
지정된 연결 프로필 내의 모든 기존 호스트 및 토큰 정보는 새 호스트 및 토큰 정보로 덮어씁니다.
파일에 여러 연결 프로필을 .databrickscfg
추가하면 명령 옵션에서 대상 연결 프로필의 이름을 지정하여 다양한 작업 영역에서 명령을 --profile
빠르게 실행할 수 있습니다. 이 옵션을 지원하는 명령에서 옵션을 지정 --profile
하지 않으면 이 명령은 기본적으로 연결 프로필을 사용합니다 DEFAULT
.
예를 들어 개발 워크로드에 사용하는 Azure Databricks 작업 영역을 참조하는 연결 DEV
프로필과 프로덕션 워크로드에 사용하는 다른 Azure Databricks 작업 영역을 참조하는 연결 프로필이라는 PROD
별도의 연결 프로필을 사용할 수 있습니다.
환경 변수DATABRICKS_CONFIG_FILE
를 설정하여 이 .databrickscfg
파일의 기본 경로를 변경할 수 있습니다. 환경 변수 설정 방법을 알려면 운영 체제 설명서를 참조하세요.
기존 구성 프로필에 대한 정보를 얻으려면 인증 명령 그룹을 사용합니다.