Synchronizacja metadanych punktu końcowego analizy SQL

W tym artykule opisano, czym jest punkt końcowy analizy SQL, jak pozostaje zsynchronizowany z usługą Lakehouse, oraz kontrolkami, którymi trzeba zarządzać synchronizacją. Punkt końcowy analizy SQL automatycznie wykrywa zmianę i aktualizuje metadane SQL za pośrednictwem procesu w tle. Możesz również ręcznie odświeżyć metadane punktu końcowego analizy SQL w portalu Fabric, za pomocą interfejsu API REST lub procedury składowanej T-SQL.

Proces synchronizacji metadanych w tle odczytuje dzienniki delty z /Tables folderu w usłudze OneLake i utrzymuje aktualny schemat SQL.

Microsoft Fabric automatycznie utrzymuje punkt końcowy analityki SQL zsynchronizowany z źródłowym magazynem lakehouse. Nie ma infrastruktury do skonfigurowania i w większości przypadków nie jest wymagana żadna akcja użytkownika. Platforma jest odpowiedzialna za:

  • Odnajdywanie tabel — wykrywanie nowo utworzonych lub usuniętych tabel Delta w lakehouse oraz tworzenie lub usuwanie odpowiadających im tabel SQL w punkcie końcowym.
  • Świeżość danych — wykrywanie zmian (wstawień, aktualizacji, usunięć) w danych w istniejących tabelach oraz zapewnienie, że zapytania zwracają aktualne wyniki.
  • Wykrywanie zmian schematu — wykrywanie dodawania, usuwania lub zmiany typu w istniejących tabelach delty i odświeżanie odpowiedniej definicji tabeli SQL.

Aby uzyskać szczegółowe informacje na temat działania tej synchronizacji i czynników wpływających na opóźnienie synchronizacji, zobacz Zagadnienia dotyczące wydajności punktu końcowego analizy SQL.

Wykrywanie zmian schematu i synchronizacja metadanych

Każda usługa Lakehouse, hurtownia, baza danych i dublowana baza danych w usłudze Fabric jest automatycznie wyposażana we własny punkt końcowy analizy SQL, dzięki czemu można wykonywać zapytania do tabel Delta przy użyciu języka T-SQL i protokołu TDS bez przenoszenia ani kopiowania danych.

  • Każdy obiekt Lakehouse, hurtownia, baza danych i dublowana baza danych ma dokładnie jeden punkt końcowy analityki SQL.
  • Każda tabela delty w elemencie bazowym jest automatycznie wyświetlana jako tabela SQL w punkcie końcowym.
  • Punkt końcowy jest tylko do odczytu w przypadku automatycznie wygenerowanych tabel. Model można rozszerzyć przy użyciu własnych schematów SQL, widoków, procedur składowanych i funkcji.
  • Ten punkt końcowy bazuje na tym samym silniku obliczeniowym co Fabric Data Warehouse, dzięki czemu umożliwia wykonywanie wysokowydajnych zapytań SQL o niskich opóźnieniach na otwartych plikach Delta.

Nowa synchronizacja metadanych (wersja zapoznawcza)

Important

Ta funkcja jest dostępna w wersji zapoznawczej.

W maju 2026 r. nowa synchronizacja metadanych dla punktu końcowego analizy SQL została ogłoszona jako funkcja w wersji zapoznawczej. Możesz włączyć nowy proces synchronizacji metadanych, który ma zastosowanie tylko do nowych punktów końcowych analizy SQL. Nowa opcja synchronizacji metadanych działa tak, aby dane były dostępne do wykonywania zapytań w ciągu kilku sekund od jego lądowania w lakehouse.

Nowy proces synchronizacji metadanych obejmuje następujące funkcje:

  • Nowa architektura oparta na tabelach zewnętrznych do parsowania logów Delta i tworzenia katalogu.
  • Oddzielona architektura, która wykrywa zmiany schematu i danych oddzielnie i odpowiednio odświeża wykaz.
  • Odświeżanie w tle, które okresowo sprawdza dostępność aktualizacji danych.
  • Odświeżanie danych na żądanie, gdy nadejdzie zapytanie odczytu, a system wykryje, że dane są nieaktualne.

Włączanie nowej synchronizacji metadanych

Możesz włączyć nową synchronizację metadanych w obszarach roboczych, przechodząc do obszaru Ustawienia magazynu w obszarze Ustawienia obszaru roboczego.

Zrzut ekranu z portalu Fabric przedstawiający stronę Ustawienia obszaru roboczego, na której widoczne są opcja Synchronizacja nowych metadanych magazynu oraz panel Nowa synchronizacja metadanych (wersja zapoznawcza).

Po włączeniu nowej synchronizacji metadanych nowe punkty końcowe analizy SQL w obszarze roboczym będą synchronizowane szybciej podczas odświeżania zmian z bazowych tabel. Nie ma to wpływu na istniejące punkty końcowe analizy SQL.

Znajdowanie daty ostatniej aktualizacji metadanych

Jeśli używasz nowej wersji synchronizacji metadanych, możesz użyć dynamicznych widoków zarządzania (DMV), aby uzyskać szczegółowe informacje o najnowszej aktualizacji punktu końcowego analizy SQL. Aby uzyskać szczegółowe informacje o najnowszej synchronizacji metadanych, użyj sys.dm_db_external_tables_log_status DMV:

  • last_update_time_utc: znacznik czasu ostatniej aktualizacji tabeli przy użyciu nowych danych.
  • latest_log_version: Najwyższa wersja dziennika transakcji Delta zaktualizowanej tabeli.
  • latest_checkpoint_version: Najnowsza wersja punktu kontrolnego Delta, która została przetworzona.
  • is_blocked: wskazuje, czy ostatnia próba aktualizacji tabeli została zablokowana (1) czy pomyślna (0).

Aby uzyskać więcej informacji, zobacz sys.dm_db_external_tables_log_status.

Ograniczenia nowej synchronizacji metadanych

  • Nowa synchronizacja metadanych nie obsługuje wieloczęściowego punktu kontrolnego, czyli przestarzałej funkcji delta. Jeśli tabele lakehouse zawierają wieloczęściowe punkty kontrolne, nie będą one aktualizowane w nowej synchronizacji metadanych.

Odświeżanie ręczne

Oprócz procesów w tle, które automatycznie aktualizują dane, można ręcznie odświeżyć metadane:

Użyj interfejsu API tylko wtedy, gdy masz zmiany schematu, takie jak dodawanie lub usuwanie tabel lub kolumn lub zmienianie typów kolumn, i trzeba odświeżyć cały element. W przypadku zmian tylko danych w punkcie końcowym analizy SQL użyj sys.sp_dw_refresh_ext_table procedury składowanej systemu, aby zaktualizować określoną tabelę.

Aby dostrajać bazowe tabele delty w celu uzyskania najlepszej synchronizacji metadanych i wydajności zapytań, zobacz Zagadnienia dotyczące wydajności punktu końcowego analizy SQL.