Databricks CLI에 대한 구성 프로필

아티클
10/30/2024

참고 항목

이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.

Databricks CLI 사용은 사용량 현황 데이터 프로비저닝을 포함하여 Databricks 라이선스 및 Databricks 개인 정보 보호 고지의 적용을 받습니다.

이 문서에서는 Databricks CLI와 Azure Databricks 계정 및 작업 영역 간에 인증을 설정하는 방법을 설명합니다. Databricks CLI란?을 참조하세요.

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

구성 프로필에 대한 정보 가져오기

파일에 여러 구성 프로필을 .databrickscfg 추가하면 이 옵션을 지원하는 명령에 대해 명령 또는 -p 옵션에서 대상 구성 프로필의 이름을 지정하여 다양한 작업 영역에서 명령을 --profile 빠르게 실행할 수 있습니다. 이 옵션을 지원하는 명령에서 또는 옵션을 지정 --profile 하지 않으면 명령은 기본적으로 구성 프로필을 사용합니다DEFAULT.-p

팁

구성 프로필 이름을 수동으로 입력하는 대신 --profile 또는 -p 이후에 Tab을 눌러서 선택하려는 기존 사용 가능한 구성 프로필 목록을 표시할 수 있습니다.

예를 들어 개발 워크로드에 사용하는 Azure Databricks 작업 영역을 참조하는 구성 DEV 프로필과 프로덕션 워크로드에 사용하는 다른 Azure Databricks 작업 영역을 참조하는 별도의 PROD 구성 프로필을 사용할 수 있습니다.

기본적으로 Databricks CLI는 Unix, Linux 또는 macOS의 (사용자 홈) 폴더 또는 Windows의 사용자 %USERPROFILE% (사용자 홈) 폴더에서 파일을 ~ 찾 .databrickscfg 습니다. 환경 변수DATABRICKS_CONFIG_FILE를 설정하여 파일의 .databrickscfg 기본 경로를 변경할 수 있습니다. 환경 변수 설정 방법을 알려면 운영 체제 설명서를 참조하세요.

기존 구성 프로필에 대한 정보를 얻으려면 다음 명령을 실행합니다 auth env .

databricks auth env --profile <configuration-profile-name>

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

예를 들어 Azure Databricks 개인용 액세스 토큰 인증으로 구성된 프로필의 출력은 다음과 같습니다.

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

사용 가능한 모든 프로필에 대한 정보를 얻으려면 다음 명령을 실행합니다 auth profiles .

databricks auth profiles

출력(줄임표는 간결하게 하기 위해 생략된 콘텐츠를 나타냅니다.)

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

auth profiles 명령의 출력에는 액세스 토큰이 표시되지 않습니다. 액세스 토큰을 표시하려면 이전 명령을 실행합니다 auth env .

Important

Databricks CLI는 .netrc 파일에서 작동하지 않습니다. 다른 용도로 .netrc 사용자 환경에 파일을 가질 수 있지만 Databricks CLI는 해당 .netrc 파일을 사용하지 않습니다.

DEFAULT 구성 프로필 설정 테스트

인증을 올바르게 설정했는지 확인하려면 프로필과 연결된 Azure Databricks 작업 영역에 사용 가능한 Databricks 런타임 버전을 나열하는 다음과 같은 명령을 실행할 수 있습니다 DEFAULT .

다음 호출에서는 프로필의 설정 DEFAULT 보다 우선하는 특수 환경 변수가 설정되어 있지 않다고 가정합니다. 자세한 내용은 평가의 인증 순서를 참조하세요.

databricks clusters spark-versions

구성 프로필 테스트

구성 프로필을 올바르게 설정했는지 확인하려면 작업 영역 수준 구성 프로필 이름 중 하나를 사용하여 다음과 같은 명령을 실행할 수 있습니다. 이 명령은 자리 표시자로 표시된 지정된 구성 프로필과 연결된 Azure Databricks 작업 영역에 사용 가능한 Databricks 런타임 버전을 나열합니다 <configuration-profile-name>.

databricks clusters spark-versions -p <configuration-profile-name>

팁

특정 프로필에 대한 세부 정보를 나열하려면 다음 명령을 실행합니다.

databricks auth env --profile <configuration-profile-name>

사용 가능한 모든 프로필에 대한 세부 정보를 나열하려면 다음 명령을 실행합니다.

databricks auth profiles

다음을 통해 공유

Databricks CLI에 대한 구성 프로필

구성 프로필에 대한 정보 가져오기

DEFAULT 구성 프로필 설정 테스트

구성 프로필 테스트

피드백

추가 리소스