Python Databricks Connect 설치

참고

이 문서에서는 Databricks Runtime 13.3 LTS 이상에 대한 Databricks Connect에 대해 설명합니다.

이 문서에서는 Python Databricks Connect를 설치하는 방법을 설명합니다. Databricks Connect를 참조하세요.

요구 사항

Databricks Connect를 설치하기 전에 작업 영역 및 로컬 환경이 요구 사항을 충족하는지 확인합니다. Databricks Connect 사용 요구 사항을 참조하세요.

Python 가상 환경 활성화

Databricks는 Databricks Connect에서 사용하는 각 Python 버전에 대해 Python virtual environment 활성화하는 것이 좋습니다. Python 가상 환경은 올바른 버전의 Python Databricks Connect를 함께 사용하는지 확인하는 데 도움이 됩니다. 이러한 도구 및 활성화 방법에 대한 자세한 내용은 venv 또는 Poetry를 참조하세요.

Databricks Connect 클라이언트 설치

이 섹션에서는 venv 또는 Poetry를 사용하여 Databricks Connect 클라이언트를 설치하는 방법을 설명합니다.

참고

이미 Databricks IDE 확장 프로그램을 설치해 두셨다면, 확장 프로그램을 사용해 Databricks Runtime 13.3 LTS 이상 버전을 설치할 수 있습니다. Databricks IDE 확장 기능에 대해서는 Databricks Connect 사용된 디버그 코드를 참조하세요.

venv를 사용하여 Databricks Connect 클라이언트 설치

1. 가상 환경이 활성화되면 명령을 실행 uninstall 하여 PySpark가 이미 설치된 경우 제거합니다. databricks-connect 패키지가 PySpark와 충돌하기 때문에 필요한 작업입니다. 자세한 내용은 PySpark 설치 충돌을 참조하세요. PySpark가 이미 설치되어 있는지 확인하려면 명령을 실행합니다 show .

   # Is PySpark already installed?
   pip3 show pyspark
   
   # Uninstall PySpark
   pip3 uninstall pyspark
   

2. 가상 환경이 계속 활성화된 상태에서 명령을 실행하여 Databricks Connect 클라이언트를 설치합니다 install . --upgrade 이 옵션을 사용하여 기존 클라이언트 설치를 지정된 버전으로 업그레이드합니다.

   pip3 install --upgrade "databricks-connect==17.3.*"  # Or X.Y.* to match your cluster version.
   

   참고

   Databricks는 가장 최근 패키지가 설치되도록 하려면 databricks-connect==X.Y.* 대신 databricks-connect=X.Y을 지정하고 "도트 아스터리스크" 표기법을 추가할 것을 권장합니다. 이는 요구 사항은 아니지만 해당 클러스터에 지원되는 최신 기능을 사용할 수 있는지 확인하는 데 도움이 됩니다.

시를 사용하여 Databricks Connect 클라이언트 설치

1. 가상 환경이 활성화되면 명령을 실행 remove 하여 PySpark가 이미 설치된 경우 제거합니다. databricks-connect 패키지가 PySpark와 충돌하기 때문에 필요한 작업입니다. 자세한 내용은 PySpark 설치 충돌을 참조하세요. PySpark가 이미 설치되어 있는지 확인하려면 명령을 실행합니다 show .

   # Is PySpark already installed?
   poetry show pyspark
   
   # Uninstall PySpark
   poetry remove pyspark
   

2. 가상 환경이 계속 활성화된 상태에서 명령을 실행하여 Databricks Connect 클라이언트를 설치합니다 add .

   poetry add databricks-connect@~17.3  # Or X.Y to match your cluster version.
   

   참고

   Databricks는 가장 최근 패키지가 설치되었는지 확인하기 위해 databricks-connect@~17.3 대신 databricks-connect==17.3를 지정하는 "at-tilde" 표기법을 사용하는 것을 권장합니다. 이는 요구 사항은 아니지만 해당 클러스터에 지원되는 최신 기능을 사용할 수 있는지 확인하는 데 도움이 됩니다.