Notebook 디버깅

아티클
11/23/2024

Important

이 기능은 공개 미리 보기 상태입니다.

이 페이지에서는 Databricks Notebook에서 기본 제공 대화형 디버거를 사용하는 방법을 설명합니다. 디버거는 Python에만 사용할 수 있습니다.

대화형 디버거는 중단점, 단계별 실행, 변수 검사 및 Notebook에서 코드를 보다 효율적으로 개발하는 데 도움이 되는 더 많은 도구를 제공합니다.

요구 사항

디버거에 액세스하려면 Notebook을 다음 컴퓨팅 리소스 중 하나에 연결해야 합니다.

서버리스 컴퓨팅
Databricks Runtime 13.3 LTS 이상에서 액세스 모드가 단일 사용자로 설정된 클러스터
Databricks Runtime 13.3 LTS 이상에서 액세스 모드가 격리 공유되지 않음으로 설정된 클러스터
액세스 모드가 Databricks Runtime 14.3 LTS 이상에서 공유로 설정된 클러스터

디버거 사용

다음 단계를 사용하여 디버거를 사용하도록 설정합니다.

작업 영역의 오른쪽 위에 있는 사용자 이름을 클릭하고 드롭다운 목록에서 설정을 선택합니다.
설정 사이드바에서 개발자를 선택합니다.
실험적 기능 섹션에서 Python Notebook 대화형 디버거를 전환합니다.

디버그 시작

디버거를 시작하려면 다음 단계를 수행합니다.

셀의 여백을 클릭하여 하나 이상의 중단점을 추가합니다. 중단점을 제거하려면 중단점을 다시 클릭합니다.
다음 옵션 중 하나를 사용하여 디버깅 세션을 시작합니다.
- 디버그 셀 실행을 > 클릭합니다.
- 바로 가기 키 옵션 + Shift + D를 사용합니다.
- 셀 실행 메뉴에서 디버그 셀을 선택합니다.

디버그 세션이 자동으로 시작되고 선택한 셀을 실행합니다.

셀에서 오류를 트리거하는 경우 디버거를 시작할 수도 있습니다. 셀 출력의 아래쪽에서 을 클릭합니다 .

디버그 세션이 활성화되면 디버그 도구 모음 이 셀 맨 위에 나타납니다.

디버깅 작업

주석이 추가된 디버거 도구 모음

디버그 세션에서 다음을 수행할 수 있습니다.

중단점을 설정하거나 제거합니다.
중단점에서 변수 값을 봅니다.
코드를 단계별로 실행합니다.
함수를 한 단계씩 실행하거나 내보낼 수 있습니다.

코드가 중단점에 도달하면 다음이 아니라 줄이 실행되기 전에 중지됩니다.

디버거 도구 모음의 단추를 사용하여 코드를 단계별로 실행합니다. 코드를 단계별로 실행하면 셀에 현재 줄이 강조 표시됩니다. 오른쪽 사이드바의 변수 탐색기 창에서 변수 값을 볼 수 있습니다.

함수를 단계별로 실행하면 로컬 함수 변수가 변수 창에 표시되어 표시됩니다 [local].

디버그 콘솔

디버깅 세션을 시작하면 디버그 콘솔이 자동으로 아래쪽 패널에 나타납니다. 이 콘솔을 사용하면 중단점에서 일시 중지될 때 Python 코드를 실행하여 변수를 검사하거나 조작할 수 있습니다. 주 Notebook에서 실행되는 코드는 디버깅 세션 중에 실행되지 않습니다. 콘솔에서 코드를 실행하려면 Enter 키를 누릅니 다. 여러 줄 식의 경우 Shift + Enter를 사용하여 새 줄로 이동합니다.

debug_console

참고 항목

디버그 콘솔은 빠른 평가를 위해 설계되었으며 코드 실행이 15초를 초과하는 경우 시간이 초과됩니다.
이 display 명령은 디버그 콘솔에서 지원되지 않습니다. DataFrame에서 샘플 데이터를 보려면 PySpark DataFrames 또는 df.head() Pandas DataFrames에 사용합니다df.show().