SQL analytics endpoint metadata-synkronisering

Denne artikkelen beskriver hva SQL-analyseendepunktet er, hvordan det holder seg synkronisert med innsjøhuset ditt, og hvilke kontroller du har for å håndtere denne synkroniseringen. SQL-analyseendepunktet oppdager automatisk endringen og oppdaterer SQL-metadata via en bakgrunnsprosess. Du kan også manuelt oppdatere SQL-analyse-endepunktmetadata via Fabric-portalen, REST API eller T-SQL-lagret prosedyre.

Metadata-synkroniseringsbakgrunnsprosessen leser Delta-loggene fra /Tables mappen i OneLake og holder SQL-skjemaet oppdatert.

Fabric holder automatisk SQL-analyseendepunktet synkronisert med det underliggende lakehouse. Det er ingen infrastruktur å sette opp, og i de fleste tilfeller kreves ingen brukerhandling. Plattformen er ansvarlig for:

  • Tabelloppdagelse – oppdage nylig opprettede eller droppede Delta-tabeller i lakehouse, og opprette eller fjerne tilsvarende SQL-tabeller i endepunktet.
  • Dataferskhet – å oppdage endringer (innsettinger, oppdateringer, slettinger) gjort i dataene i eksisterende tabeller og sikre at spørringer returnerer resultater up-to-dato.
  • Skjemaendringsdeteksjon – oppdager kolonnetillegg, fjerning eller typeendringer i eksisterende Delta-tabeller og oppdaterer den tilsvarende SQL-tabelldefinisjonen.

For detaljer om hvordan denne synkroniseringen fungerer og faktorer som påvirker synkroniseringslatens, se SQL Analytics endpoint performance considerations.

Deteksjon av skjemaendringer og synkronisering av metadata

Hvert lakehouse, lager, database og speilet database i Fabric er automatisk tilkoblet sitt eget SQL-analyseendepunkt, slik at du kan spørre i Delta-tabeller med T-SQL og TDS-protokollen, uten å flytte eller kopiere data.

  • Hver lakehouse, lager, database og speilet database har nøyaktig ett SQL-analyseendepunkt.
  • Hver Delta-tabell i det underliggende elementet vises automatisk som en SQL-tabell i endepunktet.
  • Endpunktet er skrivebeskyttet over de autogenererte tabellene. Du kan utvide modellen med dine egne SQL-skjemaer, visninger, lagrede prosedyrer og funksjoner.
  • Endepunktet drives av samme beregningsmotor som Fabric datalager, så det gir høyytelses, lav-latens SQL-spørringer mot åpne Delta-filer.

Ny metadata-synkronisering (forhåndsvisning)

Important

Denne funksjonen er i forhåndsvisning.

I mai 2026 ble den nye metadata-synkroniseringen for SQL-analyseendepunktet annonsert som en forhåndsvisningsfunksjon. Du kan aktivere den nye metadata-synkroniseringsprosessen, som kun gjelder for nye SQL-analyseendepunkter. Det nye synkroniseringsalternativet for metadata fungerer for å holde dataene tilgjengelige for spørring innen sekunder etter at de lander i innsjøhuset.

Den nye prosessen for metadatasynkronisering inkluderer følgende funksjoner:

  • En ny ekstern tabellbasert arkitektur for parsing av Delta-logger og opprettelse av katalogen.
  • En frakoblet arkitektur som oppdager endringer i skjema og data separat og oppdaterer katalogen deretter.
  • En bakgrunnsoppdatering som sjekker for dataoppdateringer med jevne mellomrom.
  • En oppdatering av dataene på forespørsel når en innkommende lesespørring skjer og systemet oppdager at dataene ikke er ferske.

Aktiver ny metadata-synkronisering

Du kan aktivere den nye metadata-synkroniseringen på arbeidsområder ved å gå til Lagerinnstillinger under Arbeidsområdeinnstillinger.

Skjermbilde fra Fabric-portalen, arbeidsområdets innstillingsside, som viser lagerets alternativ for ny metadata-synkronisering og panelet for ny metadata-synkronisering (forhåndsvisning).

Når du aktiverer den nye metadata-synkroniseringen, synkroniseres nye SQL-analyseendepunkter i arbeidsområdet raskere når du oppdaterer endringer fra underliggende tabeller. For øyeblikket forblir eksisterende SQL-analyseendepunkter i det arbeidsområdet på den eldre versjonen av metadata-synkronisering.

Finn når metadataene sist ble oppdatert

Hvis du bruker den nye versjonen av metadata-synkroniseringen, kan du bruke dynamiske administrasjonsvisninger (DMV-er) for å få detaljer om den nyeste oppdateringen til SQL-analyse-endepunktet. Bruk sys.dm_db_external_tables_log_status DMV for å få detaljer om den siste metadata-synkroniseringen:

  • last_update_time_utc: Tidsstempel for siste gang tabellen ble oppdatert med nye data.
  • latest_log_version: Den høyeste Delta-transaksjonsloggversjonen av tabellen som ble oppdatert.
  • latest_checkpoint_version: Den nyeste Delta-sjekkpunktversjonen som ble behandlet.
  • is_blocked: Indikerer om det siste forsøket på tabelloppdateringen ble blokkert (1) eller vellykket (0).

For mer informasjon, se sys.dm_db_external_tables_log_status.

Begrensninger ved den nye metadata-synkroniseringen

  • Den nye metadata-synkroniseringen støtter ikke flerdelt sjekkpunkt, en utdatert delta-funksjon. Hvis tabellene dine i innsjøhuset inneholder flerdelte sjekkpunkter, vil de ikke oppdateres i den nye metadata-synkroniseringen.
  • Hvis arbeidsområdet ditt bruker Workspace Private Link, kan den nye metadata-synkroniseringen for øyeblikket ikke aktiveres.

Manuell oppdatering

I tillegg til bakgrunnsprosessene som automatisk oppdaterer data, kan du manuelt oppdatere metadataene:

  • Refresh fra portalen: I Fabric portal SQL analytics endpoint editor, velg ikonet Refresh i verktøylinjen Explorer for å tvinge frem en metadata-synkronisering på forespørsel. Gå til Query din SQL-analyseendepunkt, og se etter oppdateringsknappen i verktøylinjen.

    Skjermbilde fra Fabric-portalen som viser sql analytics-endepunktet Oppdater skjema-knappen.

  • Oppdater med REST API: Bruk Refresh SQL endpoint metadata REST API for å programmatisk oppdatere metadataene til et SQL-analyseendepunkt.

  • Oppdater via lagret prosedyre: Bruk sys.sp_dw_refresh_ext_table systemlagringsprosedyre for å oppdatere dataene for en spesifikk tabell i et SQL-analyseendepunkt. Denne T-SQL-metoden er kun tilgjengelig hvis SQL-analyseendepunktet ble opprettet etter at ny metadata-synkronisering (forhåndsvisning) ble aktivert. Eksempel:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Bruk API-et kun hvis du har skjemaendringer, som å legge til eller slette tabeller eller kolonner, eller endre kolonnetyper, og trenger å oppdatere hele elementet. For data-only endringer i et SQL-analyseendepunkt, bruk sys.sp_dw_refresh_ext_table systemlagret prosedyre for å oppdatere en spesifikk tabell.

For å justere de underliggende Delta-tabellene for å få best mulig metadata-synkronisering og spørringsytelse, se SQL Analytics endpoint Performance considerations.

Relatert innhold

  • Last updated on