Databricks CLI 자습서

Databricks 명령줄 인터페이스(Databricks CLI라고도 함) 유틸리티는 터미널, 명령 프롬프트 또는 자동화 스크립트에서 Azure Databricks 플랫폼을 자동화하는 사용하기 쉬운 인터페이스를 제공합니다.

이 문서에서는 로컬 개발 머신을 사용하여 Databricks CLI를 get 빠르게 시작하는 방법을 보여 줍니다. Databricks CLI란?을 참조하세요.

다음 실습 자습서에서는 다음을 가정합니다.

• Linux 또는 macOS의 경우 Homebrew가 설치되어 있습니다.

  참고 항목

  Homebrew를 사용할 수 없는 경우 CLI를 설치하는 다른 방법에 대해서는 설치 섹션 또는 update Databricks CLI를 참조하세요.

• Windows의 경우 winget, Chocolatey 또는 WSL(Linux용 Windows 하위 시스템)이 설치되어 있습니다. 설치 지침은 운영 체제 설명서를 참조하세요.

  참고 항목

  Chocolatey를 사용하여 Databricks CLI를 설치하는 것은 실험적입니다.

  , Chocolatey 또는 WSL을 사용할 수 없는 경우 CLI를 설치하는 다른 방법은 Databricks CLI설치를 참조하거나 설치 또는 를 참조하세요.

다음 단계를 완료합니다.

1. 아직 설치되지 않은 경우 다음과 같이 Databricks CLI를 설치합니다.

   Linux, macOS

   Homebrew를 사용하여 다음 두 명령을 실행하여 Databricks CLI를 설치합니다.

   brew tap databricks/tap
   brew install databricks
   

   Windows

   winget, Chocolatey 또는 WSL(Linux용 Windows 하위 시스템)을 사용하여 Databricks CLI를 설치할 수 있습니다. , Chocolatey 또는 WSL을 사용할 winget수 없는 경우 이 절차를 건너뛰고 명령 프롬프트 또는 PowerShell을 사용하여 원본 에서 Databricks CLI를 설치해야 합니다.

   참고 항목

   Chocolatey를 사용하여 Databricks CLI를 설치하는 것은 실험적입니다.

   Databricks CLI를 설치하는 데 사용 winget 하려면 다음 두 명령을 실행한 다음 명령 프롬프트를 다시 시작합니다.

   winget search databricks
   winget install Databricks.DatabricksCLI
   

   Chocolatey를 사용하여 Databricks CLI를 설치하려면 다음 명령을 실행합니다.

   choco install databricks-cli
   

   WSL을 사용하여 Databricks CLI를 설치하려면:

   1. WSL을 설치하고 curl 통해 설치 zip 합니다. 자세한 내용은 운영 체제 설명서를 참조하세요.

   2. WSL을 사용하여 다음 명령을 실행하여 Databricks CLI를 설치합니다.

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
      

2. 설치된 Databricks CLI의 현재 버전을 표시하는 다음 명령을 실행하여 Databricks CLI가 설치되어 있는지 확인합니다. 이 버전은 0.205.0 이상이어야 합니다.

   databricks -v
   

   참고 항목

   databricks 실행하지만 command not found: databricks같은 오류가 get 또는 databricks -v 실행하고 버전 번호가 0.18 이하인 경우 컴퓨터가 올바른 버전의 Databricks CLI 실행 파일을 찾을 수 없음을 의미합니다. 이 문제를 해결하려면 CLI 설치 확인을 참조하세요.

Databricks CLI를 설치한 후 다음 단계를 완료합니다.

1. Databricks CLI를 사용하여 각 대상 계정 또는 작업 영역에 대해 다음 명령을 실행하여 OAuth 토큰 관리를 로컬로 시작합니다.

   계정 수준 작업의 경우 다음 명령에서 다음 자리 표시자를 바꿉니다.

   • <account-console-url>을 Azure Databricks https://accounts.azuredatabricks.net으로 바꿉니다.
   • <account-id>를 Azure Databricks 계정 ID로 바꿉니다. 계정 ID 찾기를 참조하세요.

   databricks auth login --host <account-console-url> --account-id <account-id>
   

   작업 영역 수준 작업의 경우 https://adb-1234567890123456.7.azuredatabricks.net

   databricks auth login --host <workspace-url>
   

2. Databricks CLI는 Azure Databricks 구성 프로필로 입력한 정보를 저장하라는 메시지를 표시합니다. Enter를 눌러 제안된 프로필 이름을 수락하거나 새 프로필 또는 기존 프로필의 이름을 입력합니다. 이름이 같은 기존 프로필은 입력한 정보로 덮어쓰여집니다. 프로필을 사용하여 여러 계정 또는 작업 영역 간에 인증 컨텍스트를 빠르게 전환할 수 있습니다.

   기존 프로필의 listget 별도의 터미널 또는 명령 프롬프트에서 Databricks CLI를 사용하여 명령 databricks auth profiles실행합니다. 특정 프로필의 기존 설정을 보려면 databricks auth env --profile <profile-name> 명령을 실행합니다.

3. 웹 브라우저에서 화면의 지침을 완료하여 Azure Databricks 계정 또는 작업 영역에 로그인합니다.

4. 프로필의 현재 OAuth 토큰 값과 토큰의 예정된 만료 타임스탬프를 보려면 다음 명령 중 하나를 실행합니다.

   계정 수준 작업의 경우 다음 명령을 실행합니다.

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url> --account-id <account-id>
   • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

   동일한 --host 및 --account-idvalues가진 여러 프로필이 있는 경우 Databricks CLI가 일치하는 OAuth 토큰 정보를 찾는 데 도움이 되도록 --host, --account-id및 -p 옵션을 함께 지정해야 할 수 있습니다.

   작업 영역 수준 작업의 경우 다음 명령을 실행합니다.

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url>
   • databricks auth token --host <workspace-url> -p <profile-name>

   동일한 --hostvalues가진 여러 프로필이 있는 경우 Databricks CLI가 올바른 일치하는 OAuth 토큰 정보를 찾을 수 있도록 --host 및 -p 옵션을 함께 지정해야 할 수 있습니다.

다음 단계

Databricks CLI를 set 후:

• CLI를 사용하는 방법을 알아보려면 Databricks CLI에 대한 기본 사용을 참조하세요.
• 사용 가능한 CLI 명령에 대한 개요는 Databricks CLI 명령을 참조 하세요.
• CLI가 실행되지 않거나 예기치 않은 결과를 생성하는 경우 CLI 설치 확인을 참조하세요.