Databricks 노트북과 파일 편집기를 탐색하기

이 문서에서는 바로 가기 키, 코드 제안 및 자동 완성, 변수 검사 및 코드 폴딩을 포함하여 Databricks Notebook 및 파일 편집기를 탐색하는 데 사용할 수 있는 함수에 대해 설명합니다. Notebook 또는 파일 편집기를 사용하는 경우 Databricks Assistant를 사용하여 코드를 생성, 설명 및 디버그할 수 있습니다. 자세한 내용은 Databricks Assistant에서 코딩 도움 받는 방법을 참조하세요.

편집기 테마 중에서 선택할 수 있습니다. 보기 > 편집기 테마 선택하고 메뉴에서 선택합니다.

키보드 단축키

바로 가기 키를 표시하려면 도움말 > 바로 가기 키선택합니다. 사용할 수 있는 바로 가기 키는 커서가 코드 셀(편집 모드)에 있는지 여부(명령 모드)에 따라 달라집니다.

명령 팔레트

명령 팔레트를 사용하여 Notebook에서 작업을 신속하게 수행할 수 있습니다. 전자 필기장 작업 패널을 열려면 을 클릭합니다. 작업 영역의 오른쪽 아래 모서리에서 또는 MacOS에서 Cmd + Shift + P 바로 가기를 사용하거나 Windows에서 Ctrl + Shift + P 를 사용합니다.

텍스트 찾기 및 바꾸기

전자 필기장 내에서 텍스트를 찾아 바꾸려면 편집 > 찾기 및 바꾸기선택합니다. 현재 일치 항목은 주황색으로 강조 표시되고 다른 모든 일치 항목은 노란색으로 강조 표시됩니다.

현재 일치 항목을 바꾸려면 바꾸기을 클릭합니다. 노트에서 일치하는 모든 항목을 바꾸려면 모두 바꾸기을 클릭하세요.

일치하는 항목 간에 이동하려면 이전 버튼과 다음 버튼을 클릭하세요. shift+enter 눌러서 이전 일치 항목으로 이동하고, enter 눌러서 다음 일치 항목으로 이동할 수 있습니다.

찾기 및 바꾸기 도구를 닫려면 을 클릭하거나 esc 키를 누릅니다.

변수 검사

SQL 또는 Python Notebook에 정의된 변수에 대한 정보를 표시하려면 변수 이름 위에 커서를 갖다 댑니다. Python 변수 검사를 수행하려면 Databricks Runtime 12.2 LTS 이상이 필요합니다.

변수 탐색기참조하세요.

정의로 이동

Python 노트북이 컴퓨팅 리소스에 연결된 경우, 변수나 함수의 정의 또는 %run 문 뒤의 코드 정의로 빠르게 이동할 수 있습니다. 이렇게 하려면 변수 또는 함수 이름을 마우스 오른쪽 단추로 클릭한 다음 정의로 이동 또는 정의 피킹을 클릭합니다.

macOS 또는 Windows의 Ctrl 키에서 Cmd 키를 누른 채 변수 또는 함수 이름을 마우스로 가리킵니다. 정의가 발견되면 이름이 하이퍼링크로 바뀝니다.

'정의로 이동' 기능은 Databricks Runtime 12.2 LTS 이상에서 사용할 수 있습니다.

코드 접기

코드 접기를 사용하면 코드 섹션을 일시적으로 숨길 수 있습니다. 이 기능은 작업 중인 코드의 특정 섹션에 집중할 수 있으므로 긴 코드 블록으로 작업할 때 유용할 수 있습니다.

코드를 숨기려면 커서를 셀의 맨 왼쪽에 놓습니다. 아래쪽 화살표는 코드 섹션을 숨길 수 있는 논리 지점에 나타납니다. 화살표를 클릭하면 코드 섹션이 숨겨집니다. (이제 오른쪽을 가리키고) 화살표를 다시 클릭하면 코드가 표시됩니다.

바로 가기 키를 비롯한 자세한 내용은 VS Code 설명서를 참조하세요.

멀티커서 지원

비디오에 표시된 것처럼 멀티커서를 만들어 동시 편집을 더 쉽게 만들 수 있습니다.

셀에 멀티커서를 만들려면 다음을 수행합니다.

• macOS에서는 Option 키를 누른 채로 각 위치를 클릭하여 커서를 추가합니다.
• Windows에서는 Alt 키를 누른 채로 각 위치를 클릭하여 커서를 추가합니다.
• 바로 가기를 변경하는 옵션도 있습니다. 다중 커서 및 열 선택 단축키 변경을참조하십시오.

macOS에서는 바로 가기 키 Option+Command+ 위쪽 또는 아래쪽 화살표 키를 사용하여 여러 세로로 정렬된 커서를 만들 수 있습니다.

열(상자) 선택

열에서 여러 항목을 선택하려면 캡처할 영역의 왼쪽 상단을 클릭합니다. 다음 작업:

• macOS에서 Shift + Option 누르고 오른쪽 아래로 끌어서 하나 이상의 열을 캡처합니다.
• Windows에서 Shift + Alt 누르고 오른쪽 아래로 끌어서 하나 이상의 열을 캡처합니다.
• 바로 가기를 변경하는 옵션도 있습니다. 다중 커서 및 열 선택 단축키 변경을참조하십시오.

다중 커서 및 열 선택에 대한 바로 가기 변경

대체 바로 가기는 다중 커서 및 열(상자) 선택을 위한 옵션입니다. 대체 선택을 사용하면 바로 가기가 다음과 같이 변경됩니다.

• 셀에 멀티커서를 만들려면 다음을 수행합니다.
  • macOS에서는 Cmd 키를 누른 채로 각 위치를 클릭하여 커서를 추가합니다.
  • Windows에서는 Ctrl 키를 누른 채로 각 위치를 클릭하여 커서를 추가합니다.
• 열에서 여러 항목을 선택하려면 캡처할 영역의 왼쪽 상단을 클릭합니다. 그 후:
  • macOS에서 Option 누르고 오른쪽 아래로 끌어서 하나 이상의 열을 캡처합니다.
  • Windows에서 Alt 누르고 오른쪽 아래로 끌어서 하나 이상의 열을 캡처합니다.

대체 바로 가기를 사용하도록 설정하려면 다음을 수행합니다.

1. 작업 영역의 오른쪽 위에 있는 사용자 이름을 클릭한 다음 드롭다운 목록에서 설정 클릭합니다.
2. 설정 사이드바에서 개발자선택합니다.
3. 코드 편집기 섹션에서 다중 커서 클릭에 대한 키 수정자 설정을 macOS의 경우 Cmd 또는 Windows의 경우 Ctrl로 변경합니다.

대체 바로 가기를 사용하도록 설정하면 세로로 정렬된 여러 커서를 만들기 위한 바로 가기 키가 변경되지 않습니다.

데이터 찾아보기

스키마 브라우저를 사용하여 Notebook에 사용할 수 있는 Unity 카탈로그 개체를 탐색합니다. 을 클릭합니다. Notebook의 왼쪽에서 스키마 브라우저를 엽니다.

For you 단추는 현재 세션에서 사용했거나 이전에 즐겨찾기로 표시된 개체만 표시합니다.

필터 상자에 텍스트를 입력하면 입력한 텍스트가 포함된 개체만 표시되도록 표시가 변경됩니다. 현재 열려 있거나 현재 세션에서 열려 있는 개체만 나타납니다. 필터 상자는 Notebook에 사용할 수 있는 카탈로그, 스키마, 테이블 및 볼륨을 완전히 검색하지 않습니다.

을 열려면 다음과 같이 커서를 개체 이름 위로 마우스로 가리킵니다.

개체가 테이블인 경우 다음을 수행할 수 있습니다.

• 셀을 자동으로 만들고 실행하여 표에 있는 데이터의 미리 보기를 표시합니다. 테이블의 케밥 메뉴에서 새 셀 미리 보기를 선택합니다.
• 카탈로그 탐색기에서 카탈로그, 스키마 또는 테이블을 봅니다. 케밥 메뉴에서 카탈로그 탐색기 열기를 선택합니다. 선택한 개체를 보여 주는 새 탭이 열립니다.
• 카탈로그, 스키마 또는 테이블에 대한 경로를 가져옵니다. 개체의 케밥 메뉴에서 복사와 경로을 선택합니다.
• 즐겨찾기에서 테이블을 추가합니다. 테이블의 케밥 메뉴에서 즐겨찾기 추가를 선택합니다.

개체가 카탈로그, 스키마 또는 볼륨인 경우 개체의 경로를 복사하거나 카탈로그 탐색기에서 열 수 있습니다.

셀에 직접 테이블 또는 열 이름을 삽입하려면 다음을 수행합니다.

1. 이름을 입력할 위치에 있는 셀에서 커서를 클릭합니다.
2. 스키마 브라우저에서 테이블 이름 또는 열 이름 위로 커서를 이동합니다.
3. 개체 이름 오른쪽에 나타나는 을 클릭합니다.

웹 터미널 및 Databricks CLI 사용

전자 필기장에서 웹 터미널을 열려면 터미널 아이콘 을 클릭합니다. 오른쪽 사이드바 아래쪽에 있습니다.

Databricks Runtime 15.0 이상에서는 Notebook의 웹 터미널에서 Databricks CLI를 사용할 수 있습니다. 요구 사항 및 사용 정보는 Azure Databricks 웹 터미널에서 셸 실행 명령을 참조하세요.

Notebook 셀에서 CLI를 사용할 수 없습니다. 노트북에서 %sh databricks ...와 같은 명령은 Databricks Runtime 15.0 이상 버전에서 작동하지 않습니다.

개인 설정된 자동 완성

자동 완성은 코드 세그먼트를 입력할 때 자동으로 완료됩니다. 완성 가능한 개체에는 형식, 클래스 및 개체뿐만 아니라 SQL 데이터베이스, 테이블 이름 및 쿼리 코드 조각도 포함됩니다. Databricks는 Unity 카탈로그 메타데이터 및 사용량을 사용하여 제안을 개인 설정합니다.

• Python 셀의 경우 자동 완성이 작동 하려면 Notebook을 컴퓨팅 리소스에 연결 해야 하며, 완성 가능한 개체를 정의하는 모든 셀을 실행 해야 합니다.
• SQL 셀의 경우 Notebook이 컴퓨팅 리소스에 연결되지 않은 경우에도 자동 완성은 키워드 및 기본 구문을 제안합니다.
  • Unity 카탈로그에 작업 영역을 사용하는 경우 자동 완성은 Unity 카탈로그의 테이블에 대한 카탈로그, 스키마, 테이블 및 열 이름도 제안합니다.
  • Unity 카탈로그에 작업 영역을 사용하도록 설정하지 않은 경우 테이블 또는 열 이름을 제안하려면 전자 필기장을 다목적 컴퓨팅 리소스 또는 SQL 웨어하우스 에 연결해야 합니다.

셀을 입력하면 자동 완성 제안이 자동으로 표시됩니다. 위쪽 및 아래쪽 화살표 키 또는 마우스를 사용하여 제안을 선택하고 Tab 누르거나 Enter 눌러 셀에 선택 항목을 삽입합니다.

알아야 할 두 가지 사용자 설정 이 있습니다.

• 자동 완성 제안을 끄려면 입력할 때 자동 완성을 토글하세요. 자동 완성이 해제된 경우 Ctrl+스페이스바를 눌러 자동 완성 제안을 표시할 수 있습니다.
• Enter에서 자동 완성 제안을 삽입하지 못하도록 하려면 Enter 키를 토글하면 자동 완성 제안이 허용됩니다.

대괄호 일치

괄호, 대괄호 또는 중괄호 근처를 클릭하면 편집기가 해당 문자 및 일치하는 대괄호를 강조 표시합니다.

Python 오류 강조 표시

Databricks Assistant가 활성화된 작업 영역은 AI 지원 제안에 대해 Fix with Assistant를 선택할 수도 있습니다.

Databricks Notebook은 다음 오류 강조 표시를 지원합니다.

• Python 구문 오류 강조 표시: Python 코드 셀의 구문 오류가 빨간색으로 강조 표시됩니다. 가능하면 어시스턴트가 신속한 해결책을 제안합니다. Databricks Runtime 12.1 이상 또는 서버리스 컴퓨팅을 실행하는 컴퓨팅에 대해 지원됩니다. pyproject.toml 파일로 구문 오류 강조 표시를 설정할 수 있습니다. Python 구문 강조 표시 구성을 참조하세요.
• Python 형식 오류 강조 표시: 오류 및 경고를 서식 지정하는 Python 코드는 심각도에 따라 노란색 또는 빨간색으로 밑줄이 표시됩니다. 이렇게 하면 예기치 않은 들여쓰기, 긴 줄 길이 등과 같은 서식 문제를 식별할 수 있습니다. 구문 경고를 마우스로 가리키면 자세한 정보를 볼 수 있습니다. Databricks Runtime 12.1 이상 또는 서버리스 컴퓨팅을 실행하는 컴퓨팅에 대해 지원됩니다.
• Python 유형 오류 강조 표시: 형식 검사를 통해 Python 및 PySpark 프로젝트의 코드 품질, 가독성 및 유지 관리 효율성이 향상될 수 있습니다. 형식 검사기는 코드 실행 전에 함수 호출에서 존재하지 않는 특성, 누락된 인수 및 일치하지 않는 인수와 관련된 오류에 플래그를 지정할 수 있습니다. 강조 표시된 경고 위로 마우스를 가져가서 자세한 정보를 확인합니다. Databricks Runtime 16.0 이상 또는 서버리스 환경 2를 실행하는 컴퓨팅에 지원됩니다.

Python 오류 강조 표시를 활성화

오류 강조 표시를 사용하거나 사용하지 않도록 설정하려면 다음을 수행합니다.

1. 작업 영역의 오른쪽 위에 있는 사용자 이름을 클릭한 다음 드롭다운 목록에서 설정 클릭합니다.
2. 설정 사이드바에서 개발자선택합니다.
3. Python 구문 오류 강조 표시(코드 편집기 아래), Python 형식 오류 강조 표시(실험적 기능 아래) 및/또는 Python 유형 오류 강조 표시(실험적 기능 아래)에 대한 설정을 전환합니다.

Python 구문 강조 표시 구성

Notebook이 Databricks Runtime 16.4 이상 또는 서버리스 환경 버전 3 이상을 실행하는 컴퓨팅에 연결된 경우 파일을 만들어 pyproject.toml 구문 강조 표시 동작을 사용자 지정할 수 있습니다. 지정된 Notebook의 경우 작업 공간 파일 시스템에서 파일의 직접 상위 경로 중 가장 가까운 pyproject.toml 파일이 사용됩니다. 상위 경로에서 파일을 찾을 수 없는 경우 현재 사용자의 홈 폴더에 있는 pyproject.toml 파일이 사용됩니다.

예를 들어, 경로 a/b/c/d/notebook.py 에 있는 노트북이 있고, pyproject.toml에는 파일이 a/b/pyproject.toml와 a/b/c/pyproject.toml에 있을 경우 두 번째 파일이 더 가까워서 사용됩니다. pyproject.toml에 있는 /a/b/c/e/pyproject.toml 파일은 직접 상위 경로에 있지 않아서 고려되지 않습니다.

Azure Databricks는 pyproject.toml 파일에 표준 구문을 사용합니다. 예를 들어 Ruff 설명서를 참조하여 pyproject.toml 파일을 사용하여 Ruff linter를 구성하는 방법을 확인할 수 있습니다.

현재 Azure Databricks는 ruff, pylint, pyright 및 flake8를 linting을 위한 구성으로 설정하는 것만 지원합니다.pyproject.toml

Linter를 사용하도록 설정하려면 pyproject.toml 파일에 [tool.<name-of-linter>] 블록이 있어야 합니다.

Linter를 명시적으로 사용하지 않도록 설정하려면 다음 블록을 추가합니다.

[tool.<name-of-linter>]
disabled=true

다음과 같은 블록으로 Azure Databricks로 작성된 구문 강조 표시 규칙을 사용하지 않도록 설정할 수도 있습니다.

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

플레이크8에는 다른 형식의 구성이 필요한데, 플레이크8에 대한 구성을 문자열로 전달해야 합니다.

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

SQL 서식 사용자 지정

새 SQL 편집기 및 Notebook 편집기에서 SQL 서식 설정 사용자 지정할 수 있습니다. 개발자 설정 보기를 >클릭합니다. SQL 형식으로 아래로 스크롤하고 설정을 지정합니다.