Databricks CLI 설치 또는 업데이트

참고 항목

이 정보는 공개 미리 보기에 있는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI 버전을 찾으려면 다음을 실행 databricks -v합니다.

이 문서에서는 Databricks CLI를 설치하거나 업데이트하는 방법을 설명합니다. Databricks CLI란?을 참조하세요.

설치

Databricks CLI 버전 0.205 이상을 설치하려면 다음을 수행합니다.

• Linux 또는 macOS: Homebrew, curl 또는 원본 빌드를 사용합니다.
• Windows: WinGet, Chocolatey, Linux용 Windows 하위 시스템(WSL) 또는 원본 빌드를 사용합니다.

Databricks CLI는 Azure Databricks 작업 영역 사용자 인터페이스 내에서도 사용할 수 있습니다. Azure Databricks 작업 영역 내에서 Databricks CLI 실행을 참조 하세요.

엽데이트

Databricks CLI 버전 0.205 이상의 이전 설치를 업데이트하려면 다음을 수행합니다.

• Linux 또는 macOS: Homebrew, curl 또는 원본 빌드를 사용합니다.
• Windows: WinGet, Chocolatey, Linux용 Windows 하위 시스템(WSL) 또는 원본 빌드를 사용합니다.

Linux 또는 macOS용 Homebrew 설치

이 설치 옵션의 경우 Homebrew를 사용하여 최신 Databricks CLI 실행 파일 릴리스를 자동으로 다운로드하고 설치합니다.

터미널에서 다음 두 개의 Homebrew 명령을 실행하여 CLI를 설치합니다.

brew tap databricks/tap
brew install databricks

그런 다음 Databricks CLI에 대한 인증을 계속 진행합니다.

Homebrew가 설치되어 있는지 또는 이전 Homebrew 명령이 실패하는지 확실하지 않은 경우 다음 긴 지침을 따르세요.

1. Linux 셸 프롬프트 또는 macOS 터미널에서 다음 명령을 실행하여 Homebrew가 이미 설치되어 있는지 확인합니다. Homebrew가 설치된 경우 Homebrew 버전 번호가 표시됩니다.

   brew -v
   

2. Homebrew가 아직 설치되지 않은 경우 다음 명령을 실행하여 설치합니다.

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   그런 다음, 다음 명령을 실행하여 Homebrew 버전 번호를 표시하는 Homebrew 설치를 확인합니다.

   brew -v
   

3. 다음 명령을 실행하여 Homebrew를 사용하여 GitHub의 databricks/homebrew-tap 리포지토리를 사용 가능한 Homebrew Tap 리포지토리 목록에 추가합니다.

   brew tap databricks/tap
   

4. Homebrew를 사용하여 다음 명령을 실행하여 Databricks CLI 실행 파일을 다운로드하고 설치하도록 리포지토리에 지시 databricks/homebrew-tap 합니다.

   brew install databricks
   

5. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   버전 번호 0.205.0 이상이 나열되면 Databricks CLI가 올바르게 설치되었음을 의미합니다.

   참고 항목

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

6. Databricks CLI에 대한 인증을 계속 진행합니다.

Windows용 WinGet 설치

이 설치 옵션의 경우 winget을 사용하여 최신 Databricks CLI 실행 파일 릴리스를 자동으로 다운로드하고 설치합니다.

1. 명령 프롬프트에서 다음 두 winget 명령을 실행하여 CLI를 설치한 다음 명령 프롬프트를 다시 시작합니다.

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   버전 번호 0.205.0 이상이 나열되면 Databricks CLI가 올바르게 설치되었음을 의미합니다.

   참고 항목

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

3. Databricks CLI에 대한 인증을 계속 진행합니다.

Windows용 Chocolatey 설치

참고 항목

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

이 설치 옵션의 경우 Chocolatey를 사용하여 최신 Databricks CLI 실행 파일을 자동으로 다운로드하고 설치합니다.

1. 명령 프롬프트에서 다음 choco 명령을 실행하여 CLI를 설치합니다.

   choco install databricks-cli
   

2. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   버전 번호 0.205.0 이상이 나열되면 Databricks CLI가 올바르게 설치되었음을 의미합니다.

   참고 항목

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

3. Databricks CLI에 대한 인증을 계속 진행합니다.

Linux, macOS 및 Windows용 curl 설치

이 설치 옵션의 경우 curl을 사용하여 최신 Databricks CLI 실행 파일 릴리스를 다운로드하고 설치합니다.

Windows의 경우 Databricks는 WSL(Linux용 Windows 하위 시스템)을 사용하는 것이 좋습니다. 또한 설치해야 unzip 합니다. 설치 지침은 운영 체제 설명서를 참조하세요. WSL을 사용할 수 없는 경우 이 절차를 건너뛰고 명령 프롬프트 또는 PowerShell을 사용하여 원본 에서 Databricks CLI를 대신 설치합니다.

1. curl 를 설치해야 합니다. Linux 셸 프롬프트, macOS 터미널 또는 WSL의 Bash에서 다음 명령을 실행하여 이미 설치되어 있는지 여부를 curl 검사 수 있습니다. 설치된 curl 경우 curl 버전 번호가 표시됩니다.

   curl -V
   

2. 아직 설치되지 않은 경우 curl 운영 체제 및 아키텍처에 대한 릴리스 및 다운로드 페이지의 지침에 curl따라 설치합니다. 컴퓨터의 아키텍처를 얻으려면 운영 체제 설명서를 참조하세요.

   그런 다음, 다음 명령을 실행하여 버전 번호를 표시하는 설치를 curl 확인 curl 합니다.

   curl -V
   

3. 다음 명령을 실행하여 Databricks CLI 실행 파일을 다운로드하고 설치하는 데 사용합니다 curl (모든 운영 체제에서 올바른 대문자와 소문자를 -fsSL 지정해야 합니다.)

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

   참고 항목

   스크립트의 내용을 실행 하기 전에 보려면 GitHub의 Databricks CLI 설치 리포지토리에 있는 install.sh 파일을 참조하세요.

   Windows의 경우 관리자 권한으로 이 명령을 실행해야 합니다.

   Linux 및 macOS의 경우 오류 메시지에 쓸 수 없는 상태 /usr/local/bin 인 경우 명령을 다시 실행합니다 sudo.

   이 명령은 macOS 및 Linux의 경로 /usr/local/bin/databricks 및 Windows에서 Databricks CLI 실행 파일을 다운로드하고 C:\Windows\databricks.exe 설치합니다.

   어떤 이유로 Databricks CLI가 이미 설치된 경우 다음 오류가 나타납니다. "대상 경로 <path> 가 이미 있습니다." 이 문제를 해결하려면 이전 경로에서 Databricks CLI 실행 파일을 수동으로 삭제한 다음 명령을 다시 실행 curl 해야 합니다.

4. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   버전 번호 0.205.0 이상이 나열되면 Databricks CLI가 올바르게 설치되었음을 의미합니다.

   참고 항목

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

5. Databricks CLI에 대한 인증을 계속 진행합니다.

Linux, macOS 및 Windows용 원본 설치

이 설치 옵션의 경우 파일을 수동으로 다운로드한 .zip 다음 다운로드한 .zip 파일에서 Databricks CLI 실행 파일을 수동으로 추출합니다.

1. GitHub의 Databricks CLI .zip 리포지토리 릴리스 섹션에 나열된 대로 최신 Databricks CLI 파일을 로컬 개발 머신에 다운로드합니다. 최신 릴리스의 Latest 옆에는 릴리스 목록에 레이블이 있습니다. 최신 시험판에는 레이블이 Pre-release 있으며 실험 및 얼리 어답터에 더 적합합니다. 릴리스 섹션에서 다운로드한 Assets 파일은 .zip 개발 머신의 운영 체제 및 아키텍처와 일치해야 합니다.

   Filename	아키텍처
   databricks_cli_X.Y.Z_darwin_amd64.zip	macOS, Intel 64비트/ x86_64
   databricks_cli_X.Y.Z_darwin_arm64.zip	macOS, Apple Silicon / Series / Marm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux, Intel 64비트/ x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux, ARM 64비트 / arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows, Intel 32비트/ x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel 64비트/ AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows, ARM 64비트/ ARM64

   컴퓨터의 아키텍처를 얻으려면 운영 체제 설명서를 참조하세요. 예시:

   • Linux: 터미널 명령 uname -m또는 lscpusudo lshw -c cpu.
   • macOS: Apple 아이콘 메뉴 >이 Mac 정보 또는 터미널 명령 uname -m.
   • Windows: 명령 프롬프트 또는 PowerShell 명령 echo %PROCESSOR_ARCHITECTURE%.

   이러한 .zip 파일 중 하나의 무결성을 확인해야 하는 경우 Databricks는 파일과 동일한 목록에 .zip 명명된 databricks_cli_X.Y.Z_SHA256SUMS 검사sum 파일을 제공합니다. 검사섬 확인을 실행하려면 운영 체제 설명서를 참조하세요.

2. 다운로드한 파일의 내용을 추출 .zip 합니다. 파일을 추출 .zip 하려면 운영 체제 설명서를 참조하세요.

3. 추출된 콘텐츠에서 폴더는 파일과 같은 이름으로 .zip 나타납니다. 이 폴더 안에는 Databricks CLI 실행 파일이 있습니다. Databricks CLI 실행 파일을 그대로 두거나 복사하거나 다른 위치로 이동할 수 있습니다.

4. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 Linux 셸 프롬프트, macOS 터미널 또는 Windows 명령 프롬프트에서 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   버전 번호 0.205.0 이상이 나열되면 Databricks CLI가 올바르게 설치되었음을 의미합니다.

   참고 항목

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

   macOS의 경우 먼저 Databricks CLI를 실행할 수 있도록 시스템에 권한을 부여해야 할 수 있습니다. 확인되지 않은 개발자의 Mac 앱 열기를 참조하세요.

5. Databricks CLI에 대한 인증을 계속 진행합니다.

Linux 또는 macOS용 Homebrew 업데이트

이 업데이트 옵션의 경우 Homebrew를 사용하여 Databricks CLI 버전 0.205 이상의 이전 설치를 최신 버전으로 자동으로 업데이트합니다.

1. Linux 셸 프롬프트 또는 macOS 터미널에서 Homebrew를 사용하여 다음 명령을 실행하여 최신 버전의 Databricks CLI 실행 파일을 다운로드하고 업데이트합니다.

   brew upgrade databricks
   

2. Databricks CLI가 올바르게 업데이트되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   예상 업데이트된 버전 번호가 표시되면 Databricks CLI가 올바르게 설치됩니다.

   Databricks CLI 버전 목록은 GitHub에 있는 Databricks CLI 리포지토리의 릴리스 섹션을 참조하세요. 최신 릴리스의 Latest 옆에는 릴리스 목록에 레이블이 있습니다.

   참고 항목

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

Windows용 WinGet 업데이트

이 업데이트 옵션의 경우 winget을 사용하여 이전 버전의 Databricks CLI 버전 0.205 이상을 최신 버전으로 자동으로 다운로드하고 업데이트합니다.

1. 명령 프롬프트에서 다음 명령을 실행하여 최신 버전의 Databricks CLI 실행 파일을 다운로드하고 업데이트하는 데 사용합니다 winget .

   winget upgrade Databricks.DatabricksCLI
   

2. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   예상 업데이트된 버전 번호가 표시되면 Databricks CLI가 올바르게 설치됩니다.

   Databricks CLI 버전 목록은 GitHub에 있는 Databricks CLI 리포지토리의 릴리스 섹션을 참조하세요. 최신 릴리스의 Latest 옆에는 릴리스 목록에 레이블이 있습니다.

   참고 항목

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

Windows용 Chocolatey 업데이트

참고 항목

Chocolatey로 Databricks CLI를 업데이트하는 것은 실험적입니다.

이 업데이트 옵션의 경우 Chocolatey를 사용하여 이전 버전의 Databricks CLI 버전 0.205 이상을 최신 버전으로 자동으로 다운로드하고 업데이트합니다.

1. 명령 프롬프트에서 다음 명령을 실행하여 최신 버전의 Databricks CLI 실행 파일을 다운로드하고 업데이트하는 데 사용합니다 choco .

   choco upgrade databricks-cli
   

2. Databricks CLI가 올바르게 설치되었는지 확인합니다. 이렇게 하려면 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   예상 업데이트된 버전 번호가 표시되면 Databricks CLI가 올바르게 설치됩니다.

   Databricks CLI 버전 목록은 GitHub에 있는 Databricks CLI 리포지토리의 릴리스 섹션을 참조하세요. 최신 릴리스의 Latest 옆에는 릴리스 목록에 레이블이 있습니다.

   참고 항목

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

Linux, macOS 및 Windows용 curl 업데이트

이 업데이트 옵션의 경우 curl을 사용하여 Databricks CLI 버전 0.205 이상의 이전 설치를 최신 버전으로 자동으로 다운로드하고 업데이트합니다.

Windows의 경우 Databricks는 WSL(Linux용 Windows 하위 시스템)을 사용하는 것이 좋습니다. 설치해야 unzip 합니다. 설치 지침은 운영 체제 설명서를 참조하세요. WSL을 사용할 수 없는 경우 이 절차를 건너뛰고 명령 프롬프트 또는 PowerShell을 사용하여 원본 에서 Databricks CLI를 대신 업데이트해야 합니다.

1. macOS 및 Linux의 경로 /usr/local/bin/databricks 또는 C:\Windows\databricks.exe Windows에서 Databricks CLI 실행 파일의 기존 설치를 삭제합니다.

2. Linux 셸 프롬프트, macOS 터미널 또는 Windows 명령 프롬프트에서 다음 명령을 실행하여 최신 버전의 Databricks CLI 실행 파일을 다운로드하고 설치하는 데 사용합니다 curl (올바른 대문자와 소문자를 -fsSL지정해야 합니다.)

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

   참고 항목

   스크립트의 내용을 실행 하기 전에 보려면 GitHub의 Databricks CLI 설치 리포지토리에 있는 install.sh 파일을 참조하세요.

   Windows의 경우 관리자 권한으로 이 명령을 실행해야 합니다.

   Linux 및 macOS의 경우 오류 메시지에 쓸 수 없는 상태 /usr/local/bin 인 경우 명령을 다시 실행합니다 sudo.

   이 명령은 macOS 및 Linux의 경로 /usr/local/bin/databricks 및 Windows에서 Databricks CLI 실행 파일을 다운로드하고 C:\Windows\databricks.exe 설치합니다.

   다음 오류가 표시되면 이전 경로에서 Databricks CLI 실행 파일을 수동으로 삭제한 다음 "대상 경로 <path> 가 이미 있습니다."라는 명령을 다시 실행 curl 해야 합니다.

3. Databricks CLI가 올바르게 업데이트되었는지 확인합니다. 이렇게 하려면 터미널에서 옵션을 사용 -v 하거나 명령을 실행 version 하여 Databricks CLI 실행 파일의 버전을 확인합니다.

   databricks -v
   
   # Or:
   databricks version
   

   예상 업데이트된 버전 번호가 표시되면 Databricks CLI가 올바르게 설치됩니다.

   Databricks CLI 버전 목록은 GitHub에 있는 Databricks CLI 리포지토리의 릴리스 섹션을 참조하세요. 최신 릴리스의 Latest 옆에는 릴리스 목록에 레이블이 있습니다.

   참고 항목

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

Linux, macOS 및 Windows에 대한 원본 업데이트

이 업데이트 옵션의 경우 파일을 수동으로 다운로드한 .zip 다음 다운로드한 .zip 파일에서 Databricks CLI 실행 파일을 수동으로 추출합니다.

1. 필요에 따라 이전 수동 원본 설치 절차에서 Databricks CLI 실행 파일, .zip 파일 및 .zip 파일의 추출된 폴더를 삭제합니다.
2. Linux, macOS 및 Windows용 원본 설치의 지침 에 따라 계속 진행합니다.

Azure Databricks 작업 영역 내에서 Databricks CLI 실행

실행 중인 클러스터에 연결된 Notebook 내의 웹 터미널에서 또는 실행 중인 클러스터의 웹 터미널에서 직접 Databricks CLI에 액세스할 수 있습니다. 사용 가능한 CLI는 항상 최신 버전이며 인증은 현재 사용자를 기반으로 합니다. 클러스터는 다음 요구 사항을 충족해야 합니다.

• 클러스터에 Databricks Runtime 15.0 이상이 설치되어 있어야 합니다.
• 클러스터는 단일 사용자 또는 격리 공유 없음의 클러스터 액세스 모드를 사용해야 합니다. 공유 클러스터 액세스 모드는 지원되지 않습니다.
• 서버리스 컴퓨팅은 지원되지 않습니다.
• Private Link에 작업 영역을 사용하도록 설정하면 안 됩니다.

Notebook의 웹 터미널에서 CLI에 액세스하려면 다음을 수행합니다.

1. 이전 요구 사항을 충족하는 클러스터에 Notebook을 커넥트.

2. 전자 필기장 오른쪽 사이드바의 맨 아래에서 아래쪽 패널 열기 아이콘을 클릭합니다.

3. 표시되는 터미널 창에서 CLI를 사용합니다. 예를 들어 다음 명령은 현재 사용자에 대한 정보를 출력합니다.

   databricks current-user me
   

클러스터의 웹 터미널에서 CLI에 액세스하려면 다음을 수행합니다.

1. 작업 영역의 사이드바에서 컴퓨팅을 클릭합니다.

2. 다목적 컴퓨팅 탭에서 이전 요구 사항을 충족하는 클러스터의 이름을 클릭합니다.

3. 시작을 클릭합니다.

4. 클러스터가 시작되면 앱 탭에서 웹 터미널을 클릭합니다.

5. 표시되는 Databricks 웹 터미널에서 CLI를 사용합니다. 예를 들어 다음 명령은 현재 사용자에 대한 정보를 출력합니다.

   databricks current-user me