다음을 통해 공유

Microsoft Fabric Notebook의 T-SQL 지원

  • 아티클

Microsoft Fabric의 T-SQL Notebook 기능을 사용하면 Notebook 내에서 T-SQL 코드를 작성하고 실행할 수 있습니다. T-SQL Notebook을 사용하여 복잡한 쿼리를 관리하고 더 나은 markdown 설명서를 작성할 수 있습니다. 또한 연결된 웨어하우스 또는 SQL 분석 엔드포인트에서 T-SQL을 직접 실행할 수 있습니다. T-SQL 개발자는 Notebook에 데이터 웨어하우스 또는 SQL 분석 엔드포인트를 추가하여 연결된 엔드포인트에서 직접 쿼리를 실행할 수 있습니다. BI 분석가는 데이터베이스 간 쿼리를 수행하여 여러 웨어하우스 및 SQL 분석 엔드포인트에서 인사이트를 수집할 수도 있습니다.

대부분의 기존 Notebook 기능은 T-SQL Notebook에 사용할 수 있습니다. 여기에는 쿼리 결과 차트 작성, Notebook 공동 작성, 일반 실행 예약 및 데이터 통합 파이프라인 내에서 실행 트리거가 포함됩니다.

Important

이 기능은 프리뷰로 제공됩니다.

이 문서에서는 다음 방법을 설명합니다.

  • T-SQL Notebook 만들기
  • Notebook에 데이터 웨어하우스 또는 SQL 분석 엔드포인트 추가
  • Notebook에서 T-SQL 코드 만들기 및 실행
  • 차트 기능을 사용하여 쿼리 결과를 그래픽으로 표시
  • 쿼리를 보기 또는 테이블로 저장
  • 웨어하우스 간 쿼리 실행
  • T-SQL이 아닌 코드의 실행 건너뛰기

T-SQL Notebook 만들기

이 환경을 시작하려면 다음 두 가지 방법으로 T-SQL Notebook을 만들 수 있습니다.

  1. Data Warehouse 홈페이지에서 T-SQL Notebook 만들기: 데이터 웨어하우스 환경으로 이동하고 Notebook을 선택합니다.

    DW 홈페이지에서 t-sql Notebook 항목을 만드는 스크린샷

  2. 기존 웨어하우스 편집기에서 T-SQL Notebook 만들기: 기존 웨어하우스로 이동하고, 위쪽 탐색 리본에서 새 SQL 쿼리를 선택한 다음, 새 T-SQL 쿼리 Notebook을 선택합니다.

DW SQL 편집기에서 열린 Notebook의 스크린샷

Notebook이 만들어지면 T-SQL이 기본 언어로 설정됩니다. 현재 작업 영역의 데이터 웨어하우스 또는 SQL 분석 엔드포인트를 Notebook에 추가할 수 있습니다.

Notebook에 데이터 웨어하우스 또는 SQL 분석 엔드포인트 추가

Notebook에 데이터 웨어하우스 또는 SQL 분석 엔드포인트를 추가하려면 Notebook 편집기에서 + 데이터 원본 단추를 선택하고 웨어하우스를 선택합니다. 데이터 허브 패널에서 연결하려는 데이터 웨어하우스 또는 SQL 분석 엔드포인트를 선택합니다.

Notebook에 데이터 웨어하우스 또는 sql-endpoint를 추가하는 스크린샷

기본 웨어하우스 설정

여러 웨어하우스 또는 SQL 분석 엔드포인트를 Notebook에 추가할 수 있으며, 그 중 하나가 기본으로 설정됩니다. 주 웨어하우스는 T-SQL 코드를 실행합니다. 설정하려면 개체 탐색기로 이동하여 웨어하우스 옆에 있는 ...를 선택하고 기본으로 설정을 선택합니다.

기본 웨어하우스를 설정하는 스크린샷

세 부분으로 구성된 명명을 지원하는 T-SQL 명령의 경우 웨어하우스가 지정되지 않은 경우 기본 웨어하우스가 기본 웨어하우스로 사용됩니다.

Notebook에서 T-SQL 코드 만들기 및 실행

Notebook에서 T-SQL 코드를 만들고 실행하려면 새 셀을 추가하고 T-SQL을 셀 언어로 설정합니다.

t-sql 코드 셀을 만드는 방법을 보여 주는 스크린샷

개체 탐색기의 상황에 맞는 메뉴에서 코드 템플릿을 사용하여 T-SQL 코드를 자동으로 생성할 수 있습니다. 다음 템플릿은 T-SQL Notebook에 사용할 수 있습니다.

  • 상위 100개 선택
  • 테이블 만들기
  • 선택으로 만들기
  • 드롭
  • 삭제 및 만들기

t-sql 코드 템플릿을 보여 주는 스크린샷.

셀 도구 모음에서 실행 단추를 선택하여 하나의 T-SQL 코드 셀을 실행하거나 도구 모음에서 모두 실행 단추를 선택하여 모든 셀을 실행할 수 있습니다.

참고 항목

각 코드 셀은 별도의 세션에서 실행되므로 한 셀에 정의된 변수는 다른 셀에서 사용할 수 없습니다.

동일한 코드 셀 내에 여러 줄의 코드가 포함될 수 있습니다. 사용자는 이러한 코드의 일부를 선택하고 선택한 코드만 실행할 수 있습니다. 각 실행은 새 세션도 생성합니다.

선택한 코드 셀을 실행하는 방법을 보여 주는 스크린샷

코드를 실행한 후 메시지 패널을 확장하여 실행 요약을 확인합니다.

실행 요약을 보여 주는 스크린샷.

테이블 탭에는 반환된 결과 집합의 레코드가 나열됩니다. 실행에 여러 결과 집합이 포함된 경우 드롭다운 메뉴를 통해 하나씩 전환할 수 있습니다.

결과 탭에서 전환하는 방법을 보여 주는 스크린샷

차트 기능을 사용하여 쿼리 결과를 그래픽으로 표시

검사를 클릭하면 각 열의 데이터 품질 및 분포를 나타내는 차트를 볼 수 있습니다.

차트 양식의 결과 검사를 보여 주는 스크린샷

쿼리를 보기 또는 테이블로 저장

테이블로 저장 메뉴를 사용하여 CTAS 명령을 사용하여 쿼리 결과를 테이블에 저장할 수 있습니다. 이 메뉴를 사용하려면 코드 셀에서 쿼리 텍스트를 선택하고 테이블로 저장 메뉴를 선택합니다.

쿼리를 테이블로 저장하는 방법을 보여 주는 스크린샷

테이블을 대화 상자로 저장하는 방법에 대한 스크린샷.

마찬가지로 셀 명령 모음의 보기로 저장 메뉴를 사용하여 선택한 쿼리 텍스트에서 보기를 만들 수 있습니다.

보기를 만드는 방법을 보여 주는 스크린샷

보기로 저장 대화 상자를 보여 주는 스크린샷

참고 항목

  • 테이블로 저장 및 보기로 저장 메뉴는 선택한 쿼리 텍스트에만 사용할 수 있으므로 이러한 메뉴를 사용하기 전에 쿼리 텍스트를 선택해야 합니다.

  • 보기 만들기는 세 부분으로 구성된 이름을 지원하지 않으므로 웨어하우스를 기본 웨어하우스로 설정하여 항상 기본 웨어하우스에 뷰를 만듭니다.

웨어하우스 간 쿼리

세 부분으로 구성된 이름을 사용하여 웨어하우스 간 쿼리를 실행할 수 있습니다. 세 부분으로 구성된 명명은 데이터베이스 이름, 스키마 이름 및 테이블 이름으로 구성됩니다. 데이터베이스 이름은 웨어하우스 또는 SQL 분석 엔드포인트의 이름, 스키마 이름은 스키마 이름, 테이블 이름은 테이블 이름입니다.

웨어하우스 간 쿼리를 실행하는 방법을 보여 주는 스크린샷

T-SQL이 아닌 코드의 실행 건너뛰기

동일한 Notebook 내에서 다른 언어를 사용하는 코드 셀을 만들 수 있습니다. 예를 들어 PySpark 코드 셀은 T-SQL 코드 셀 앞에 표시할 수 있습니다. 이 경우 사용자는 T-SQL Notebook에 대한 PySpark 코드 실행을 건너뛰도록 선택할 수 있습니다. 이 대화 상자는 도구 모음에서 모두 실행 단추를 클릭하여 모든 코드 셀을 실행할 때 나타납니다.

TSQL이 아닌 코드를 건너뛰는 방법을 보여 주는 스크린샷

공개 미리 보기 제한 사항

  • 매개 변수 셀은 T-SQL Notebook에서 아직 지원되지 않습니다. 파이프라인 또는 스케줄러에서 전달된 매개 변수는 T-SQL Notebook에서 사용할 수 없습니다.
  • 최근 실행 기능은 T-SQL Notebook에서 아직 지원되지 않습니다. 현재 데이터 웨어하우스 모니터링 기능을 사용하여 T-SQL Notebook의 실행 기록을 확인해야 합니다. 자세한 내용은 데이터 웨어하우스 모니터링 문서를 참조하세요.
  • 파이프라인 실행 내의 모니터 URL은 T-SQL Notebook에서 아직 지원되지 않습니다.
  • 스냅샷 기능은 T-SQL Notebook에서 아직 지원되지 않습니다.
  • Git 및 배포 pipline 지원은 T-SQL Notebook에서 아직 지원되지 않습니다.

관련 콘텐츠

Fabric Notebook에 대한 자세한 내용은 다음 문서를 참조하세요.