Databricks CLI 자습서

참고

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

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

이 문서에서는 Databricks CLI를 신속하게 설치하고 구성하는 방법을 보여 줍니다.

로컬 컴퓨터 요구 사항 확인

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

Databricks CLI 설치

  1. Databricks CLI를 설치합니다.

    리눅스, macOS

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

    brew tap databricks/tap
brew trust databricks/tap
brew install databricks

    이 brew trust 명령은 Homebrew 6.0.0을 기준으로 필요합니다.

    Windows

    winget, Chocolatey 또는 Linux용 Windows 하위 시스템(WSL)를 사용하여 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 작업 영역에 대한 액세스를 구성합니다.

참고

이 자습서에서는 OAuth U2M(사용자 대 컴퓨터) 인증을 사용하여 Azure Databricks 사용자 계정을 사용하여 CLI를 인증합니다. 다른 Databricks 인증 유형을 사용하도록 CLI를 구성하려면 Databricks CLI에 대한 인증을 참조하세요.

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

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

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

    워크스페이스 수준 작업의 경우, 다음 명령에서 <workspace-url> Azure Databricks의 작업 공간별 URL(예: https://adb-1234567890123456.7.azuredatabricks.net)로 바꾸십시오.

    databricks auth login --host <workspace-url>

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

    기존 프로필 목록을 얻으려면 별도의 터미널 또는 명령 프롬프트에서 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-id 값을 가진 여러 프로필이 있는 경우 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>

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

다음 단계

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