다음을 통해 공유


Visual Studio Code용 Databricks 확장에 Databricks Connect를 사용하여 코드 디버그

이 문서에서는 Visual Studio Code용 Databricks 확장에서 Databricks Connect 통합을 사용하여 개별 Python(.py) 파일을 실행하고 디버그하는 방법을 설명합니다. Visual Studio Code용 Databricks 확장이란?을 참조하세요.

Databricks Connect 통합을 사용하면 Notebook 셀을 실행하고 디버그할 수도 있습니다. Visual Studio Code용 Databricks 확장을 사용하여 Databricks Connect로 Notebook 셀 실행 및 디버그를 참조하세요.

요구 사항

Visual Studio Code용 Databricks 확장 내에서 Databricks Connect를 사용하려면 먼저 Databricks Connect 요구 사항을 충족해야 합니다. 이러한 요구 사항에는 Unity 카탈로그 사용 작업 영역, 컴퓨팅 요구 사항 및 Python의 로컬 설치에 대한 버전 요구 사항과 같은 항목이 포함됩니다.

Python 가상 환경 활성화

Python 프로젝트에 대한 Python 가상 환경을 활성화합니다. Python 가상 환경은 프로젝트가 호환되는 버전의 Python 및 Python 패키지(이 경우 Databricks Connect 패키지)를 사용하는지 확인하는 데 도움이 됩니다.

구성 창에서 다음을 수행 합니다.

  1. Python 환경에서 빨간색 가상 환경 활성화 항목을 클릭합니다.
  2. 명령 팔레트에서 Venv 또는 Conda를 선택합니다.
  3. 설치하려는 종속성을 선택합니다(있는 경우).

Databricks Connect 설치

Python 환경의 구성 보기에서 다음을 수행합니다.

  1. red Install databricks-connect play 단추를 클릭합니다.
  2. 클러스터를 연결합니다.
    • 확장에 클러스터 섹션이 아직 구성되지 않은 경우 다음 메시지가 나타납니다. "Databricks Connect를 사용하려면 클러스터를 연결하세요." 클러스터 연결을 클릭하고 Databricks Connect 요구 사항을 충족하는 클러스터를 선택합니다.
    • 클러스터 섹션이 구성되었지만 클러스터가 Databricks Connect와 호환되지 않는 경우 빨간색 Databricks Connect 사용 안 함 단추를 클릭하고 클러스터 연결을 클릭한 다음 호환되는 클러스터를 선택합니다.
  3. Databricks Connect 패키지(및 해당 종속성)가 아직 설치되지 않은 경우 다음과 같은 메시지가 나타납니다. "대화형 디버깅 및 자동 완성의 경우 Databricks Connect가 필요합니다. 환경에 설치하시겠습니까 <environment-name>?" 설치를 클릭합니다.
  4. Visual Studio Code 상태 표시줄에서 빨간색 Databricks Connect 사용 안 함 단추가 나타나면 해당 단추를 클릭하고 화면의 지침을 완료하여 사용하도록 설정합니다.
  5. Databricks Connect 사용 단추가 나타나면 이제 Databricks Connect를 사용할 준비가 되었습니다.

참고 항목

시를 사용하는 경우 다음 명령을 실행하여 설치된 Databricks Connect 패키지(및 해당 종속성)와 파일을 pyproject.toml poetry.lock 동기화할 수 있습니다. 프로젝트의 Visual Studio Code용 Databricks 확장에서 설치한 패키지와 일치하는 Databricks Connect 패키지 버전으로 바꿔 13.3.2 야 합니다.

poetry add databricks-connect==13.3.2

Python 코드 실행 또는 디버그

Databricks Connect를 사용하도록 설정한 후 Python 파일()을 실행하거나 디버그합니다..py

  1. 프로젝트에서 실행하거나 디버그하려는 Python 파일을 엽니다.

  2. Python 파일 내에서 디버깅 중단점을 설정합니다.

  3. 편집기 탭 목록 옆에 있는 Databricks에서 실행 아이콘을 클릭한 다음 Databricks Connect: 현재 파일 디버그를 클릭합니다.

    아이콘에서 현재 파일 디버그

    출력이 디버그 콘솔 창에 나타납니다.

    파일을 마우스 오른쪽 단추로 .py 클릭한 다음 Databricks Databricks>Connect에서 실행: 현재 파일 디버그를 클릭할 수도 있습니다.

    상황에 맞는 메뉴에서 현재 파일 디버그