SQL 분석 엔드포인트 메타데이터 동기화

이 문서에서는 SQL 분석 엔드포인트의 정의, 레이크하우스와 동기화 상태를 유지하는 방법 및 해당 동기화를 관리해야 하는 컨트롤에 대해 설명합니다. SQL 분석 엔드포인트는 변경 내용을 자동으로 검색하고 백그라운드 프로세스를 통해 SQL 메타데이터를 업데이트합니다. Fabric 포털, REST API 또는 T-SQL 저장 프로시저를 통해 관리적으로 SQL 분석 엔드포인트 메타데이터 새로 고칠 수도 있습니다.

메타데이터 동기화 백그라운드 프로세스는 OneLake의 폴더에서 델타 로그를 /Tables 읽고 SQL 스키마를 최신 상태로 유지합니다.

Microsoft Fabric 자동으로 SQL 분석 엔드포인트를 기본 lakehouse와 동기화 상태로 유지합니다. 설정할 인프라가 없으며 대부분의 경우 사용자 작업이 필요하지 않습니다. 플랫폼은 다음을 담당합니다:

  • 테이블 검색 - 레이크하우스에서 새로 만들거나 삭제한 델타 테이블을 검색하고 엔드포인트에서 해당 SQL 테이블을 만들거나 제거합니다.
  • 데이터 새로 고침 - 기존 테이블의 데이터에 대한 변경 내용(삽입, 업데이트, 삭제)을 검색하고 쿼리가 up-to-date 결과를 반환하도록 합니다.
  • 스키마 변경 검색 - 기존 델타 테이블에서 열 추가, 제거 또는 형식 변경 내용을 검색하고 해당 SQL 테이블 정의를 새로 고칩니다.

이 동기화의 작동 방식 및 동기화 대기 시간에 영향을 주는 요인에 대한 자세한 내용은 SQL 분석 엔드포인트 성능 고려 사항을 참조하세요.

스키마 변경 검색 및 메타데이터 동기화

Fabric 모든 Lakehouse, 웨어하우스, 데이터베이스 및 미러된 데이터베이스는 자체 SQL 분석 엔드포인트를 사용하여 자동으로 프로비전되므로 데이터를 이동하거나 복사하지 않고도 T-SQL 및 TDS 프로토콜을 사용하여 델타 테이블을 쿼리할 수 있습니다.

  • 모든 Lakehouse, 웨어하우스, 데이터베이스 및 미러된 데이터베이스에는 정확히 하나의 SQL 분석 엔드포인트가 있습니다.
  • 기본 항목의 각 델타 테이블은 자동으로 엔드포인트의 SQL 테이블로 표시됩니다.
  • 엔드포인트는 자동 생성된 테이블을 통해 읽기 전용입니다. 고유한 SQL 스키마, 뷰, 저장 프로시저 및 함수를 사용하여 모델을 확장할 수 있습니다.
  • 엔드포인트는 Fabric Data Warehouse 동일한 컴퓨팅 엔진에 의해 구동되므로 열려 있는 델타 파일에 대해 대기 시간이 짧은 고성능 SQL 쿼리를 제공합니다.

새 메타데이터 동기화(미리 보기)

Important

이 기능은 프리뷰 상태입니다.

2026년 5월에 SQL 분석 엔드포인트에 대한 새 메타데이터 동기화가 미리 보기 기능으로 발표되었습니다. 새 SQL 분석 엔드포인트에만 적용되는 새 메타데이터 동기화 프로세스를 사용하도록 설정할 수 있습니다. 새 메타데이터 동기화 옵션은 레이크하우스에 도착한 후 몇 초 내에 쿼리에 사용할 수 있는 데이터를 유지하기 위해 작동합니다.

새 메타데이터 동기화 프로세스에는 다음 기능이 포함됩니다.

  • 델타 로그를 구문 분석하고 카탈로그를 만들기 위한 새로운 외부 테이블 기반 아키텍처입니다.
  • 스키마 및 데이터 변경 내용을 별도로 검색하고 그에 따라 카탈로그를 새로 고치는 분리된 아키텍처입니다.
  • 주기적으로 데이터 업데이트를 확인하는 백그라운드 새로 고침입니다.
  • 들어오는 읽기 쿼리가 발생하고 시스템에서 데이터가 최신 상태가 아님을 감지할 때 데이터의 주문형 새로 고침입니다.

새 메타데이터 동기화 사용

작업 영역 설정 아래의 웨어하우스 설정으로 이동하여 작업 영역에서 새 메타데이터 동기화를 사용하도록 설정할 수 있습니다.

웨어하우스 새 메타데이터 동기화 옵션과 새 메타데이터 동기화(미리 보기) 창을 보여 주는 Fabric 포털의 작업 영역 설정 페이지 스크린샷.

새 메타데이터 동기화를 사용하도록 설정하면 기본 테이블의 변경 내용을 새로 고치면 작업 영역의 새 SQL 분석 엔드포인트가 더 빠르게 동기화됩니다. 기존 SQL 분석 엔드포인트는 영향을 받지 않습니다.

메타데이터가 마지막으로 업데이트된 시기 찾기

새 버전의 메타데이터 동기화를 사용하는 경우 DMV(동적 관리 뷰)를 사용하여 SQL 분석 엔드포인트에 대한 최신 업데이트에 대한 세부 정보를 가져올 수 있습니다. DMV를 sys.dm_db_external_tables_log_status 사용하여 최신 메타데이터 동기화에 대한 세부 정보를 가져옵니다.

  • last_update_time_utc: 테이블이 새 데이터로 마지막으로 업데이트된 시간 타임스탬프입니다.
  • latest_log_version: 업데이트된 테이블의 가장 높은 델타 트랜잭션 로그 버전입니다.
  • latest_checkpoint_version: 처리된 최신 델타 검사점 버전입니다.
  • is_blocked: 테이블 업데이트의 마지막 시도가 차단되었는지() 또는 성공(10)했는지를 나타냅니다.

자세한 내용은 sys.dm_db_external_tables_log_status 참조하세요.

새 메타데이터 동기화의 제한 사항

  • 새 메타데이터 동기화는 사용되지 않는 델타 기능인 다중 파트 검사점을 지원하지 않습니다. 레이크하우스 테이블에 여러 부분으로 구성된 검사점이 포함된 경우 새 메타데이터 동기화에서 업데이트하지 못합니다.

수동 새로 고침

데이터를 자동으로 업데이트하는 백그라운드 프로세스 외에도 메타데이터를 수동으로 새로 고칠 수 있습니다.

  • 포털에서 새로 고침: Fabric 포털 SQL 분석 엔드포인트 편집기에서 Explorer> 도구 모음에서 Refresh 아이콘을 선택하여 주문형 메타데이터 동기화를 강제 적용합니다. SQL 분석 엔드포인트에 Query 이동하여 도구 모음에서 새로 고침 단추를 찾습니다.

    SQL 분석 엔드포인트 새로 고침 스키마 단추를 보여 주는 Fabric 포털의 스크린샷

  • REST API를 사용하여 새로 고침: SQL 엔드포인트 메타데이터 REST API 새로 고침 을 사용하여 SQL 분석 엔드포인트의 메타데이터를 프로그래밍 방식으로 새로 고칩니다.

  • 저장 프로시저를 통해 새로 고침: sys.sp_dw_refresh_ext_table 시스템 저장 프로시저 를 사용하여 SQL 분석 엔드포인트 내의 특정 테이블에 대한 데이터를 새로 고칩니다. 이 T-SQL 메서드는 새 메타데이터 동기화(미리 보기)를 사용하도록 설정한 후에 SQL 분석 엔드포인트를 만든 경우에만 사용할 수 있습니다. 다음은 그 예입니다.

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";
    

테이블 또는 열 추가 또는 삭제, 열 유형 변경 등 스키마 변경 내용이 있고 전체 항목을 새로 고쳐야 하는 경우에만 API를 사용합니다. SQL 분석 엔드포인트에서 데이터 전용 변경의 경우 시스템 저장 프로시저를 sys.sp_dw_refresh_ext_table 사용하여 특정 테이블을 업데이트합니다.

기본 델타 테이블을 튜닝하여 최상의 메타데이터 동기화 및 쿼리 성능을 얻으려면 SQL 분석 엔드포인트 성능 고려 사항을 참조하세요.