SQL analytics endpoint metadata sync sync

Tento článok popisuje, čo je SQL analytics endpoint, ako zostáva synchronizovaný s vaším lakehouse a aké ovládacie prvky máte na správu tejto synchronizácie. SQL analytický endpoint automaticky detekuje zmenu a aktualizuje svoje SQL metadáta prostredníctvom procesu na pozadí. Môžete tiež manuálne obnovovať metadáta SQL analytics endpointov cez Fabric portál, REST API alebo uloženú procedúru T-SQL.

Proces synchronizácie metadát na pozadí číta Delta logy z priečinka /Tables v OneLake a udržiava SQL schému aktuálnu.

Microsoft Fabric automaticky udržiava SQL analytický endpoint synchronizovaný so základným lakehouse. Nie je potrebné nastaviť žiadnu infraštruktúru a vo väčšine prípadov nie je potrebná žiadna akcia používateľa. Platforma je zodpovedná za:

  • Objavovanie tabuliek – detekcia novo vytvorených alebo zrušených Delta tabuliek v lakehouse a vytváranie alebo odstraňovanie príslušných SQL tabuliek v koncovom bode.
  • Čerstvosť dát – detekcia zmien (vkladania, aktualizácie, mazania) vykonaných v existujúcich tabuľkách a zabezpečenie, že dotazy vracajú výsledky up-todátume.
  • Detekcia zmien schémy – detekcia pridaní, odstránení alebo zmien typov v existujúcich tabuľkách Delta a obnovenie zodpovedajúcej definície SQL tabuľky.

Podrobnosti o tom, ako táto synchronizácia funguje a faktory ovplyvňujúce latenciu synchronizácie, nájdete v SQL analytics Performance Endpoint Considerations.

Detekcia zmien schémy a synchronizácia metadát

Každý Lakehouse, sklad, databáza a zrkadlená databáza vo Fabric je automaticky vybavená vlastným SQL analytickým endpointom, takže môžete dotazovať Delta tabuľky pomocou T-SQL a TDS protokolu bez presúvania alebo kopírovania dát.

  • Každý Lakehouse, sklad, databáza a zrkadlová databáza má presne jeden SQL analytický endpoint.
  • Každá Delta tabuľka v základnej položke sa automaticky zobrazí ako SQL tabuľka v koncovom bode.
  • Koncový bod je iba na čítanie nad automaticky generovanými tabuľkami. Model môžete rozšíriť o vlastné SQL schémy, pohľady, uložené procedúry a funkcie.
  • Endpoint je poháňaný rovnakým výpočtovým motorom ako Fabric Data Warehouse, takže poskytuje vysoko výkonné, nízkolatenčné SQL dotazy proti otvoreným Delta súborom.

Synchronizácia nových metadát (náhľad)

Dôležité

Táto funkcia je ukážky.

V máji 2026 bola oznámená nová synchronizácia metadát pre SQL analytics endpoint ako ukážková funkcia. Môžete povoliť nový proces synchronizácie metadát, ktorý platí iba pre nové SQL analytické endpointy. Nová možnosť synchronizácie metadát funguje tak, aby boli dáta dostupné na dotazovanie do niekoľkých sekúnd po ich pristátí v jazernom dome.

Nový proces synchronizácie metadát zahŕňa nasledujúce funkcie:

  • Nová architektúra založená na externých tabuľkách na parsovanie Delta logov a tvorbu katalógu.
  • Odpojená architektúra, ktorá detekuje schému a dáta, sa mení samostatne a podľa toho obnovuje katalóg.
  • Obnova na pozadí, ktorá pravidelne kontroluje aktualizácie dát.
  • Obnovenie dát na požiadanie, keď nastane prichádzajúci čítací dotaz a systém zistí, že dáta nie sú čerstvé.

Povoliť synchronizáciu nových metadát

Novú synchronizáciu metadát na pracovných priestoroch môžete povoliť v nastaveniach skladu v nastaveniach pracovného priestoru.

Snímka obrazovky z portálu Fabric, stránka nastavení pracovného priestoru, zobrazujúca možnosť synchronizácie nových metadát v sklade a panel synchronizácie nových metadát (náhľad)

Keď povolíte synchronizáciu nových metadát, nové SQL analytické endpointy v pracovnom priestore sa synchronizujú rýchlejšie pri obnove zmien z podkladových tabuliek. V súčasnosti existujúce SQL analytické endpointy v tomto pracovnom priestore zostávajú na staršej verzii synchronizácie metadát.

Zistite, kedy boli metadáta naposledy aktualizované

Ak používate novú verziu synchronizácie metadát, môžete použiť dynamické manažérske pohľady (DMV) na získanie detailov o najnovšej aktualizácii SQL analytics endpointu. Použite DMV sys.dm_db_external_tables_log_status na získanie informácií o najnovšej synchronizácii metadát:

  • last_update_time_utc: Časová pečiatka pre poslednú aktualizáciu tabuľky o nové údaje.
  • latest_log_version: Najvyššia verzia Delta transakčného logu tabuľky, ktorá bola aktualizovaná.
  • latest_checkpoint_version: Najnovšia verzia Delta checkpointu, ktorá bola spracovaná.
  • is_blocked: Označuje, či bol posledný pokus o aktualizáciu tabuľky zablokovaný (1) alebo úspešný (0).

Pre viac informácií pozri sys.dm_db_external_tables_log_status.

Obmedzenia novej synchronizácie metadát

  • Nová synchronizácia metadát nepodporuje viacdielny checkpoint, čo je zastaraná delta funkcia. Ak vaše tabuľky Lakehouse obsahujú viacdielne kontrolné body, nebudú sa aktualizovať v novej synchronizácii metadát.
  • Ak váš pracovný priestor používa súkromný odkaz na pracovný priestor, momentálne nie je možné zapnúť synchronizáciu nových metadát.

Manuálne obnovovanie

Okrem procesov na pozadí, ktoré automaticky aktualizujú dáta, môžete manuálne obnoviť metadáta:

  • Obnoviť z portálu: V editore endpointov SQL analytics portálu Fabric vyberte ikonu Refresh v paneli nástrojov Explorer na vynútenie synchronizácie metadát na požiadanie. Choďte na Query váš SQL analytics endpoint a hľadajte tlačidlo obnovenia v paneli nástrojov.

    Snímka obrazovky z portálu služby Fabric zobrazujúca tlačidlo na obnovenie schémy analýzy SQL.

  • Obnovte pomocou REST API: Použite REST API metadát SQL endpointu Refresh na programové obnovenie metadát SQL analytics endpointu.

  • Obnovenie pomocou uloženej procedúry: Použite sys.sp_dw_refresh_ext_table systémovú uloženú procedúru na obnovenie dát pre konkrétnu tabuľku v SQL analytickom endpointe. Táto metóda T-SQL je dostupná len v prípade, že SQL analytics endpoint bol vytvorený po povolení synchronizácie nových metadát (náhľadu). Príklad:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

API používajte len vtedy, ak máte zmeny v schéme, napríklad pridávanie alebo mazanie tabuliek či stĺpcov, alebo zmenu typov stĺpcov, a potrebujete obnoviť celú položku. Pri zmenách len na základe dát v SQL analytickom endpointe použite systémovú uloženú sys.sp_dw_refresh_ext_table procedúru na aktualizáciu konkrétnej tabuľky.

Pre doladenie základných Delta tabuliek na dosiahnutie najlepšej synchronizácie metadát a výkonu dotazov pozri SQL analytics Endpoint Performance Considerations.

Súvisiaci obsah

  • Last updated on