Databricks Notebook 인터페이스 및 컨트롤

  • 아티클

Notebook 도구 모음에는 Notebook을 관리하고 편집하는 데 사용할 수 있는 메뉴와 아이콘이 포함되어 있습니다.

Notebook 도구 모음

Notebook 이름 옆에는 Notebook의 기본 언어를 변경할 수 있는 단추가 있으며, Notebook 이 Databricks Git 폴더 에 포함된 경우 Git 대화 상자를 엽니다.

이전 버전의 Notebook을 보려면 메뉴 오른쪽에 있는 "마지막 편집..." 메시지를 클릭합니다.

업데이트된 셀 디자인

Important

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

업데이트된 셀 디자인을 사용할 수 있습니다. 이 페이지에는 두 버전의 셀 디자인을 모두 사용하는 방법에 대한 정보가 포함되어 있습니다. 새 UI에 대한 방향과 일반적인 질문에 대한 답변은 새 셀 UI에 대한 방향을 참조하세요.

새 셀 디자인을 사용하거나 사용하지 않도록 설정하려면 작업 영역에서 편집기 설정 페이지를 엽니다. 사이드바에서 개발자를 클릭합니다. 실험적 기능에서 새 셀 UI를 전환합니다.

Notebook 셀

Notebook에는 코드 셀과 Markdown 셀이라는 두 가지 유형의 셀 컬렉션이 포함되어 있습니다. 코드 셀에는 실행 가능한 코드가 포함되어 있습니다. Markdown 셀에는 셀이 실행될 때 텍스트 및 그래픽으로 렌더링되고 코드를 문서화하거나 설명하는 데 사용할 수 있는 Markdown 코드가 포함되어 있습니다. 전자 필기장에서 셀을 추가하거나 제거하여 작업을 구성할 수 있습니다.

단일 셀, 셀 그룹을 실행하거나 전체 Notebook을 한 번에 실행할 수 있습니다. Notebook 셀에는 최대 10MB가 포함될 수 있습니다. Notebook 셀 출력은 20MB로 제한됩니다.

Notebook 도구 모음 아이콘 및 단추

도구 모음 오른쪽의 아이콘과 단추가 다음 표에 설명되어 있습니다.

아이콘 설명
모든 단추 실행인터럽트 실행 단추 모든 셀을 실행하거나 실행을 중지합니다. 이 단추의 이름은 Notebook의 상태에 따라 변경됩니다.
Notebook 헤더 컴퓨팅 선택기 컴퓨팅 선택기를 엽니다. Notebook이 클러스터 또는 SQL 웨어하우스에 연결된 경우 이 단추는 컴퓨팅 리소스의 이름을 표시합니다.
Notebook 헤더 작업 스케줄러 작업 스케줄러를 엽니다.
Notebook 헤더 DLT 선택기 Delta Live Tables를 엽니다. 이 단추는 Notebook이 Delta Live Tables 파이프라인의 일부인 경우에만 나타납니다.
Notebook 헤더 공유 단추 권한 대화 상자를 엽니다.

오른쪽 사이드바 작업

다음 표에 설명된 대로 Notebook의 오른쪽 사이드바에서 몇 가지 작업을 사용할 수 있습니다.

아이콘 설명
Notebook 헤더 주석 아이콘 Notebook 주석을 엽니다.
Notebook 헤더 실험 아이콘 MLflow Notebook 실험을 엽니다.
Notebook 버전 기록 아이콘 Notebook 버전 기록을 엽니다.
Notebook 변수 탐색기 변수 탐색기를 엽니다. Databricks Runtime 12.2 LTS 이상을 사용하는 Python 변수에 사용할 수 있습니다.
Notebook 환경 Python 환경 패널을 엽니다. 이 패널에는 Notebook 범위 라이브러리, 클러스터 라이브러리 및 Databricks 런타임에 포함된 라이브러리를 포함하여 Notebook에서 사용할 수 있는 모든 Python 라이브러리가 표시됩니다. Notebook이 클러스터에 연결된 경우에만 사용할 수 있습니다.

데이터 찾아보기

Important

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

Notebook에서 사용할 수 있는 테이블 및 볼륨을 탐색하려면 Notebook의 왼쪽을 클릭하여 Notebook 데이터 아이콘 스키마 브라우저를 엽니다. 자세한 내용은 데이터 찾아보기를 참조하세요.

셀 작업 메뉴

셀 작업 메뉴를 사용하면 셀을 잘라내고 복사하고, 전자 필기장에서 셀을 이동하고, 코드 또는 결과를 숨길 수 있습니다. 메뉴의 모양은 원래 UI와 새 UI에서 다릅니다. 이 섹션에는 두 버전에 대한 지침이 포함되어 있습니다.

작업 영역에서 Databricks Assistant를 사용하도록 설정한 경우 코드 셀에서 이를 사용하여 코드에 대한 도움말 또는 제안을 받을 수 있습니다. 셀에서 Databricks Assistant 텍스트 상자를 열려면 셀의 오른쪽 위 모서리에 있는 Databricks 길잡이 아이콘 Databricks 길잡이 아이콘 을 클릭합니다.

셀의 오른쪽 위 모서리 근처에 있는 셀 언어 단추를 사용하여 코드와 markdown 간에 셀을 쉽게 변경하거나 코드 셀의 언어를 변경할 수 있습니다.

셀 언어 단추

셀 작업 메뉴(원래 UI)

셀 작업 메뉴

이 메뉴에서 코드 셀을 실행할 수도 있습니다.

셀 작업 메뉴 - 실행

셀 동작 메뉴에는 셀을 숨기거나 셀 셀 최소화삭제 아이콘을 삭제할 수 있는 단추도 포함되어 있습니다.

Markdown 셀의 경우 대시보드에 셀을 추가하는 옵션도 있습니다. 자세한 내용은 Notebook의 대시보드를 참조 하세요.

대시보드

새 UI에서 셀 작업

다음 스크린샷에서는 Notebook 셀의 오른쪽 위에 표시되는 아이콘을 설명합니다.

오른쪽 위 셀 아이콘 - 새 UI

언어 선택기: 셀의 언어를 선택합니다.

Databricks 도우미: 셀의 코드 제안에 대해 Databricks Assistant를 사용하거나 사용하지 않도록 설정합니다.

셀 포커스: 쉽게 편집할 수 있도록 셀을 확대합니다.

셀 작업 표시 메뉴: 셀 작업 메뉴를 엽니다. 이 메뉴의 옵션은 코드 및 Markdown 셀에 대해 약간 다릅니다.

셀 작업 메뉴 - 새 UI

새 UI에서 코드 셀을 실행하려면 코드 셀의 왼쪽 위에 있는 아래쪽 화살표를 클릭합니다.

셀 실행 메뉴 - 새 UI

셀을 실행한 후 셀 실행 메뉴 오른쪽에 셀이 마지막으로 실행된 시간과 실행 기간을 보여 주는 알림이 표시됩니다. 자세한 내용은 알림 위에 커서를 놓습니다.

마지막 실행 이미지

대시보드에 테이블 형식 결과가 있는 Markdown 셀 또는 셀을 추가하려면 셀 작업 메뉴에서 대시보드에 추가를 선택합니다. 자세한 내용은 Notebook의 대시보드를 참조 하세요.

셀을 삭제하려면 셀 오른쪽에 있는 휴지통 아이콘을 클릭합니다. 이 아이콘은 셀 위에 커서를 놓을 때만 나타납니다.

셀 휴지통 아이콘

셀의 코드에 주석을 추가하려면 코드를 강조 표시합니다. 셀 오른쪽에 메모 아이콘이 나타납니다. 아이콘을 클릭하여 메모 상자를 엽니다.

커밋 아이콘

셀을 위나 아래로 이동하려면 셀의 왼쪽 위 모서리 바깥쪽을 클릭하고 누른 채로 셀 이동 아이콘 셀을 새 위치로 끕니다. 셀 작업 메뉴에서 위로 이동 또는 아래로 이동을 선택할 수도 있습니다.

셀 만들기

Notebook에는 코드와 Markdown이라는 두 가지 유형의 셀이 있습니다. Markdown 셀의 내용은 HTML로 렌더링됩니다. 예를 들어, 다음 코드 조각에는 수준 1 제목에 대한 태그가 포함되어 있습니다.

%md ### Libraries
Import the necessary libraries.

다음과 같이 렌더링합니다.

렌더링된 Markdown 예제

셀 만들기(원래 UI)

원래 UI에서 새 셀을 만들려면 위쪽 또는 아래쪽의 셀을 마우스로 가리키고 아이콘을 셀 추가 클릭합니다. 전자 필기장 셀 메뉴를 사용할 수도 있습니다. 위의 셀 추가 또는 아래 셀 추가를 클릭하고 다운 케어 선택합니다.

코드 셀의 경우 셀에 코드를 입력하기만 하면 됩니다. Markdown 셀을 만들려면 셀의 언어 단추에서 Markdown을 선택하거나 셀 맨 위에 입력 %md 합니다.

셀 만들기(새 UI)

새 UI에 새 셀을 만들려면 위쪽 또는 아래쪽의 셀을 마우스로 가리킵니다. 코드 또는 텍스트를 클릭하여 각각 코드 또는 Markdown 셀을 만듭니다.

단추로 새 셀 만들기

셀 잘라내기, 복사 및 붙여넣기

셀을 잘라내고 복사하는 몇 가지 옵션이 있습니다. Safari 브라우저를 사용하는 경우 바로 가기 키만 사용할 수 있습니다.

  • 원래 UI 또는 새 UI의 셀 작업 메뉴에서 셀 잘라내기 또는 셀 복사를 선택합니다.
  • 바로 가기 키 사용: Command-X 및 Ctrl-X를 사용하여 잘라내고 Command-C 또는 Ctrl-C를 사용하여 복사합니다.
  • Notebook 맨 위에 있는 편집 메뉴를 사용합니다. 잘라내기 또는 복사를 선택합니다.

셀을 잘라내거나 복사한 후에는 Notebook의 다른 위치, 다른 Notebook 또는 다른 브라우저 탭 또는 창의 Notebook에 해당 셀을 붙여넣을 수 있습니다. 셀을 붙여넣으려면 바로 가기 키 Command-V 또는 Ctrl-V를 사용합니다. 셀은 현재 셀 아래에 붙여넣기됩니다.

잘라내기 또는 붙여넣기 작업을 실행 취소하려면 바로 가기 키 또는 메뉴 옵션을 사용하여 잘라내기 셀 편집 > 또는 셀 붙여넣기 취소 편집 > 을 사용할 수 있습니다.Ctrl-ZCommand-Z

인접한 셀을 선택하려면 Markdown 셀을 클릭한 다음, Shift + 위쪽 또는 아래쪽을 사용하여 위쪽 또는 아래쪽 셀을 선택합니다. 편집 메뉴를 사용하여 선택한 셀을 그룹으로 복사하거나, 잘라내거나, 붙여넣거나, 삭제할 수 있습니다. 모든 셀을 선택하려면 모든 셀 편집을 선택하거나 명령 모드 바로 가기 Cmd+A를 > 사용합니다.

Notebook 목차

자동으로 생성된 목차를 표시하려면 Notebook 왼쪽 위의 아이콘(왼쪽 사이드바와 맨 위 셀 사이)을 클릭합니다. Notebook에 사용된 Markdown 제목에서 목차가 생성됩니다. 새 UI를 사용하는 경우 제목이 있는 셀도 목차에 표시됩니다.

TOC 열기

셀 표시 옵션

Notebook에는 세 가지 표시 옵션이 있습니다. 보기 메뉴를 사용하여 표시 옵션을 변경합니다.

  • 표준 보기: 코드 셀 바로 뒤에 결과가 표시됩니다.
  • 결과만: 결과만 표시됩니다.
  • 나란히: 코드 셀과 결과 셀이 나란히 표시됩니다.

새 UI에서는 셀 여백의 아이콘(셀의 오른쪽 및 왼쪽 영역)에서 작업을 사용할 수 있습니다. 예를 들어 셀을 위아래로 이동하려면 왼쪽 여백의 그립 점을 셀 이동 아이콘 사용합니다. 셀을 삭제하려면 오른쪽 여백에 휴지통 아이콘을 사용합니다.

더 쉽게 편집하려면 포커스 모드 아이콘 셀 포커스 아이콘 을 클릭하여 셀을 전체 너비로 표시합니다. 포커스 모드를 종료하려면 을 클릭합니다 셀 포커스 종료 아이콘. 보기 > 가운데 레이아웃을 해제하여 셀의 표시된 너비를 확대할 수도 있습니다.

Notebook의 모든 셀을 업계 표준 줄 길이 및 간격에 자동으로 서식을 지정하려면 전자 필기장 서식 편집 > 을 선택합니다.

줄 및 명령 번호

줄 번호 또는 명령 번호를 표시하거나 숨기려면 보기 메뉴에서 줄 번호 또는 명령 번호를 선택합니다. 줄 번호의 경우 바로 가기 키 Control+L을 사용할 수도 있습니다.

줄 또는 명령 번호를 사용하도록 설정하면 Databricks는 기본 설정을 저장하고 해당 브라우저의 다른 모든 Notebook에 이 기본 설정을 표시합니다.

줄 및 명령 번호(원래 UI)

셀 위의 명령 번호는 해당 명령으로 연결됩니다. 셀의 명령 번호를 클릭하면 해당 명령에 고정되도록 URL이 업데이트됩니다. 전자 필기장에서 특정 명령에 대한 URL 링크를 얻으려면 명령 번호를 마우스 오른쪽 단추로 클릭하고 링크 주소 복사를 선택합니다.

줄 및 명령 번호(새 UI)

줄 번호는 새 UI에서 기본적으로 꺼져 있습니다. 이를 켜려면 줄 번호 보기를 > 선택합니다. 셀이 오류 상태이면 선택 영역에 관계없이 줄 번호가 표시됩니다.

명령 번호를 토글하려면 명령 번호 보기를 > 선택합니다.

새 UI에는 셀 명령 번호 링크가 포함되지 않습니다. Notebook의 특정 명령에 대한 URL 링크를 얻으려면 클릭하여 셀 포커스 아이콘 포커스 모드를 열고 브라우저 주소 표시줄에서 URL을 복사합니다. 포커스 모드를 종료하려면 을 클릭합니다 셀 포커스 종료 아이콘.

셀 제목 추가

원래 UI를 사용하여 셀에 제목을 추가하려면 셀 작업 메뉴에서 제목 표시를 선택합니다.

새 UI를 사용하여 셀에 제목을 추가하려면 다음 중 하나를 수행합니다.

  • 셀 위쪽의 가운데에 표시된 셀 번호를 클릭하고 제목을 입력합니다.
  • 셀 작업 메뉴에서 제목 추가를 선택합니다.

새 UI를 사용하면 제목이 있는 셀이 Notebook의 목차에 표시됩니다.

셀 제목 추가

어두운 모드에서 Notebook 보기

Notebook을 어두운 모드로 표시할 수 있습니다. 어두운 모드를 켜거나 끄려면 보기 > 테마를 선택하고 밝은 테마 또는 어두운 테마를 선택합니다.

셀 콘텐츠 숨기기 및 표시

셀 콘텐츠는 셀 코드와 셀을 실행하여 생성된 결과로 구성됩니다. 셀의 오른쪽 위에 있는 셀 작업 메뉴를 사용하여 셀 코드와 결과를 숨기고 표시할 수 있습니다.

관련 기능은 축소 가능한 제목을 참조 하세요.

셀 내용 숨기기 및 표시(원래 UI)

셀 코드 또는 결과를 숨기려면 코드 숨기기 또는 결과 숨기기를 클릭하고 다운 케어 선택합니다. 셀의 첫 줄만 표시하도록 선택할 셀 최소화 수도 있습니다.

숨겨진 셀 코드 또는 결과를 표시하려면 표시 링크를 클릭합니다.

숨겨진 코드 및 결과 표시

셀 내용 숨기기 및 표시(새 UI)

셀 코드 또는 결과를 숨기려면 셀의 오른쪽 위에 있는 케밥 메뉴를 셀 케밥 아이콘 클릭하고 코드 숨기기 또는 결과 숨기기를 선택합니다. 셀 축소를 선택하여 셀 의 첫 줄만 표시할 수도 있습니다. 축소된 셀을 확장하려면 셀 확장을 선택합니다.

숨겨진 셀 코드 또는 결과를 표시하려면 표시 아이콘 아이콘 표시을 클릭합니다.

축소 가능한 제목

Markdown 제목을 포함하는 셀 뒤에 나타나는 셀은 제목 셀로 축소할 수 있습니다. Notebook 전체에서 Markdown 제목을 포함하는 셀 뒤에 오는 셀을 확장하거나 축소하려면 보기 메뉴에서 모든 제목 축소를 선택합니다. 이 섹션의 나머지 부분에서는 셀의 하위 집합을 확장하거나 축소하는 방법을 설명합니다.

관련 기능은 셀 내용 숨기기 및 표시를 참조 하세요.

제목 확장 및 축소(원래 UI)

이미지는 다음 두 개의 셀이 축소된 수준 2 머리글 MLflow 설정을 보여 줍니다.

원래 UI의 축소된 셀

제목을 확장하고 축소하려면 + 아이콘과 - 아이콘을 클릭합니다.

제목 확장 및 축소(새 UI)

이미지는 다음 두 개의 셀이 축소된 수준 2 머리글 MLflow 설정을 보여 줍니다.

새 UI의 축소된 셀

제목을 확장하고 축소하려면 Markdown 셀 위에 커서를 놓습니다. 셀 왼쪽에 표시되는 화살표를 클릭합니다.

Notebook에 대한 컴퓨팅 리소스

이 섹션에서는 Notebook 컴퓨팅 리소스에 대한 옵션을 설명합니다. Databricks 클러스터에서 Notebook을 실행하거나 SQL 명령의 경우 SQL 분석에 최적화된 컴퓨팅 유형인 SQL 웨어하우스를 사용할 수도 있습니다.

클러스터에 Notebook 연결

클러스터에 Notebook을 연결하려면 CAN ATTACH TO 클러스터 수준 권한이 필요합니다.

Important

Notebook이 클러스터에 연결되어 있는 한 Notebook에 대한 CAN RUN 권한이 있는 사용자는 클러스터에 액세스할 수 있는 암시적 권한을 가집니다.

Notebook을 클러스터에 연결하려면 Notebook 도구 모음에서 컴퓨팅 선택기를 클릭하고 드롭다운 메뉴에서 클러스터를 선택합니다.

최근에 사용했거나 현재 실행 중인 클러스터의 선택 항목이 메뉴에 표시됩니다.

Notebook 연결

사용 가능한 모든 클러스터에서 선택하려면 자세히...를 클릭합니다. 클러스터 이름을 클릭하여 드롭다운 메뉴를 표시하고 기존 클러스터를 선택합니다.

클러스터 더 보기 대화 상자

드롭다운 메뉴에서 새 리소스 만들기...를 선택하여 새 클러스터를 만들 수도 있습니다.

Important

연결된 Notebook에는 다음과 같은 Apache Spark 변수가 정의되어 있습니다.

클래스 변수 이름
SparkContext sc
SQLContext/HiveContext sqlContext
SparkSession(Spark 2.x) spark

SparkSession, SparkContext 또는 SQLContext를 만들지 마세요. 이렇게 하면 일관되지 않은 동작이 발생할 수 있습니다.

SQL 웨어하우스에서 Notebook 사용

Notebook이 SQL 웨어하우스에 연결된 경우 SQL 및 Markdown 셀을 실행할 수 있습니다. 다른 언어(예: Python 또는 R)로 셀을 실행하면 오류가 발생합니다. SQL 웨어하우스에서 실행되는 SQL 셀은 SQL 웨어하우스의 쿼리 기록에 표시됩니다. 쿼리를 실행한 사용자는 출력 맨 아래에 있는 경과된 시간을 클릭하여 Notebook에서 쿼리 프로필을 볼 수 있습니다.

Notebook을 실행하려면 Pro 또는 서버리스 SQL 웨어하우스가 필요합니다. 작업 영역 및 SQL 웨어하우스에 액세스할 수 있어야 합니다.

전자 필기장이 SQL 웨어하우스에 연결된 경우 위젯은 다르게 작동합니다. 자세한 내용은 SQL 웨어하우스에서 Databricks 위젯 사용을 참조하세요.

SQL 웨어하우스에 Notebook을 연결하려면 다음을 수행합니다.

  1. Notebook 도구 모음에서 컴퓨팅 선택기를 클릭합니다. 드롭다운 메뉴에는 현재 실행 중이거나 최근에 사용한 컴퓨팅 리소스가 표시됩니다. SQL 웨어하우스는 .로 SQL 웨어하우스 레이블표시됩니다.

  2. 메뉴에서 SQL 웨어하우스를 선택합니다.

    사용 가능한 모든 SQL 웨어하우스를 보려면 드롭다운 메뉴에서 자세히...를 선택합니다. Notebook에 사용할 수 있는 컴퓨팅 리소스를 보여 주는 대화 상자가 나타납니다. SQL Warehouse를 선택하고 사용하려는 웨어하우스를 선택한 다음 연결을 클릭합니다.

    SQL 웨어하우스가 선택된 더 많은 클러스터 대화 상자

워크플로 또는 예약된 작업을 만들 때 SQL Notebook의 컴퓨팅 리소스로 SQL 웨어하우스를 선택할 수도 있습니다.

SQL 웨어하우스의 제한 사항은 다음과 같습니다.

  • SQL 웨어하우스에 연결된 경우 실행 컨텍스트의 유휴 시간 제한은 8시간입니다.
  • 반환된 결과의 최대 크기는 10,000개 행과 2MB 중 더 작은 쪽입니다.

전자 필기장 분리

컴퓨팅 리소스에서 Notebook을 분리하려면 Notebook 도구 모음에서 컴퓨팅 선택기를 클릭하고 목록의 연결된 클러스터 또는 SQL 웨어하우스 위로 마우스를 가져가면 측면 메뉴를 표시합니다. 사이드 메뉴에서 분리를 선택합니다.

Notebook 분리

또한 클러스터 세부 정보 페이지의 Notebook 탭을 사용하여 클러스터에서 Notebook을 분리할 수 있습니다.

Notebook 을 분리하면 실행 컨텍스트 가 제거되고 계산된 모든 변수 값이 Notebook에서 지워집니다.

팁

Azure Databricks는 사용하지 않는 Notebook을 클러스터에서 분리하는 것이 좋습니다. 이렇게 하면 드라이버의 메모리 공간이 확보됩니다.

웹 터미널 및 Databricks CLI 사용

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

웹 터미널에서 Databricks CLI 사용

Databricks Runtime 15.0부터 Notebook의 웹 터미널에서 Databricks CLI를 사용할 수 있습니다.

요구 사항

  • 단일 사용자 또는 격리 공유 액세스 모드가 없는 클러스터에 Notebook을 연결해야 합니다.
  • PRIVATE Link에 사용하도록 설정된 작업 영역에서 CLI를 사용할 수 없습니다.

설치된 CLI는 항상 최신 버전입니다. 인증은 현재 사용자를 기반으로 합니다.

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