Notebook 유틸리티(NotebookUtils)는 Fabric Notebook에서 일반적인 작업을 쉽게 수행할 수 있도록 도와주는 기본 제공 패키지입니다. NotebookUtils를 사용하여 파일 시스템 작업을 하고, 환경 변수를 가져오고, Notebook을 서로 연결하고, 비밀을 사용할 수 있습니다. NotebookUtils 패키지는 PySpark(Python) Scala, SparkR Notebook 및 Fabric 파이프라인에서 사용할 수 있습니다.
Note
- MsSparkUtils는 공식적으로 NotebookUtils로 이름이 바뀌었습니다. 기존 코드는 이전 버전과 호환 되며 호환성이 손상되는 변경이 발생하지 않습니다. 새로운 기능에 대한 지속적인 지원과 액세스를 보장하기 위해 Notebookutils로 업그레이드하는 것이 좋습니다 . Mssparkutils 네임스페이스는 나중에 사용 중지됩니다.
- NotebookUtils는 Spark 3.4(런타임 v1.2) 이상에서 작동하도록 설계되었습니다. 모든 새로운 기능 및 업데이트는 앞으로 Notebookutils 네임스페이스에서만 지원됩니다.
NotebookUtils 모듈
NotebookUtils는 다음 모듈을 제공합니다. 모듈을 선택하여 자세한 설명서, 코드 예제 및 모범 사례를 확인합니다.
| 모듈 | 네임스페이스 | 설명 |
|---|---|---|
| 파일 시스템 유틸리티 | notebookutils.fs |
ADLS Gen2, Azure Blob Storage 및 Lakehouse Storage에서 파일 및 디렉터리로 작업합니다. 복사, 이동, 읽기, 쓰기, 삭제 및 목록 작업이 포함됩니다. |
| 파일 탑재 및 분리 | notebookutils.fs |
간소화된 파일 액세스를 위해 Spark 노드에 원격 스토리지(ADLS Gen2)를 로컬 탑재 지점으로 연결합니다. |
| Notebook 실행 및 오케스트레이션 | notebookutils.notebook |
DAG 지원, 작업 영역 간 참조 및 종료 값을 사용하여 병렬 실행을 포함하여 Notebook을 함께 실행하고 연결합니다. |
| 노트북 관리 | notebookutils.notebook |
프로그래밍 방식으로 Notebook 아티팩트 만들기, 가져오기, 업데이트, 삭제 및 나열 |
| 자격 증명 유틸리티 | notebookutils.credentials |
Azure 서비스에 대한 액세스 토큰을 가져오고 Azure Key Vault에서 비밀을 검색합니다. |
| 레이크하우스 유틸리티 | notebookutils.lakehouse |
Lakehouse 항목 및 테이블을 프로그래밍 방식으로 만들고, 가져오고, 업데이트하고, 삭제하고, 관리합니다. |
| 런타임 컨텍스트 | notebookutils.runtime |
Notebook 이름, 작업 영역 세부 정보 및 실행 컨텍스트를 포함한 세션 컨텍스트 정보에 액세스합니다. |
| 세션 관리 | notebookutils.session |
대화형 세션을 중지하고 Python 인터프리터를 다시 시작합니다. |
| UDF(사용자 데이터 함수) 유틸리티 | notebookutils.udf |
Notebook에서 사용자 데이터 함수를 검색하고 호출합니다. |
| 변수 라이브러리 유틸리티 | notebookutils.variableLibrary |
변수 라이브러리 항목에서 중앙에서 관리되는 변수 및 구성에 액세스합니다. |
사용 가능한 모든 모듈 및 메서드에 대한 개요를 보려면 다음을 실행합니다.
notebookutils.help()
특정 모듈에 대한 도움말을 보려면 다음을 실행합니다.
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
알려진 문제
- 1.2 이상의 런타임 버전을 사용하고 실행하는
notebookutils.help()경우 나열된 fabricClient 및 PBIClient API는 아직 지원되지 않지만 향후 릴리스에서 사용할 수 있습니다.