Oppdater SQL Analytics endpoint-aktivitet

Aktiviteten for oppdatering av SQL-analyse-endepunktet i Microsoft Fabric-pipelines lar deg programmatisk oppdatere et Lakehouse SQL-analyse-endepunkt som en del av en orkestrert arbeidsflyt. Det er en del av Lakehouse Utility Suite for rørledninger, og brukes vanligvis etter Lakehouse Maintenance-aktiviteten (for eksempel etter OPTIMIZE eller VACUUM operasjoner). Nedstrøms brukere – som Power BI-rapporter, notatbøker eller eksterne SQL-klienter – ser deretter de nyeste dataene etter at dataforberedelse eller vedlikeholdssteg er fullført.

Bruk denne aktiviteten til å få SQL-analyseendepunkter til umiddelbart å reflektere nylige oppdateringer uten å måtte stole på manuelle oppdateringer eller ad hoc-prosesser. Bruk denne aktiviteten når rørledningen din:

• Oppdaterer eller vedlikeholder Lakehouse-data (for eksempel etter kopieringsjobber, utskrift av notatbøker eller vedlikeholdsaktiviteter i Lakehouse).
• Krever at Lakehouse SQL-analyseendepunkt gjenspeiler de nyeste metadata- og dataendringene.
• Trenger deterministisk oppdateringstidspunkt før nedstrømssteg som rapportering, analyse eller eksport.

Forutsetninger

Før du bruker denne aktiviteten, sørg for at:

• En leierkonto med et aktivt abonnement. Opprett en konto gratis.
• Et arbeidsområde med et innsjøhus
• Det finnes et SQL-analyseendepunkt for Lakehouse.
• Pipeline-identiteten (bruker- eller tjenesteprinsipp) har tillatelse til å oppdatere SQL-analyseendepunktet.

Legg til en oppdatering av SQL-analyse-endepunktaktivitet i pipelinen din i brukergrensesnittet

1. Opprett en ny pipeline i arbeidsområdet ditt.

2. Søk etter Refresh SQL analytics endpoint i pipeline Activities-panelet og velg det for å legge det til i pipeline-lerretet.

   

3. Velg den nye Refresh SQL analytics-endepunktaktiviteten på lerretet hvis den ikke allerede er valgt.

   

   Tips

   Du kan organisere denne aktiviteten sammen med andre aktiviteter i Lakehouse Utility Suite – som vedlikeholdsaktiviteten i Lakehouse – i samme pipeline, slik at vedlikehold og oppfriskning kjører i rekkefølge.

4. Se veiledningen for generelle innstillinger for å konfigurere fanen Generelle innstillinger.

Oppdater SQL Analytics endpoint aktivitetsinnstillinger

1. Velg fanen Innstillinger for å konfigurere aktiviteten.  

2. Konfigurer tilkobling ved å velge en eksisterende tilkobling fra nedtrekksmenyen Forbindelse , eller opprette en ny tilkobling, og spesifisere konfigurasjonsdetaljene.

3. Spesifiser arbeidsområdet som inneholder Lakehouse.

4. Spesifiser SQL-analyseendepunktet som SQL analytics-endepunkt-ID for Lakehouse du vil oppdatere. Oppdateringen oppdaterer Lakehouse SQL-analyse-endepunktmetadata slik at den reflekterer nylige data- og skjemaendringer.

   

Aktivitetsatferd

Når aktivitetsrunden er ferdig:

• Hvis Output-popupen viser Suksessstatus , synkroniserer forespørselen usynkroniserte data med suksess.

  

• En NotRun-status i Output-popupen betyr at oppdateringen av SQL-analyseendepunktet ikke ble kjørt. Den betingelsen betyr vanligvis at du ikke har lagt til nye data siden forrige synkronisering, så du trengte ikke å kjøre det.

  

• Hvis Output-popupen viser feilstatus , gikk noe galt.

Vanlige scenarier

• Oppdatering av SQL-analyseendepunktet etter at en notatbok skriver transformerte data til et Lakehouse.
• Utløs en oppdatering av SQL-analyse-endepunktet etter at Lakehouse Maintenance-aktiviteten (OPTIMIZE eller VACUUM) er fullført.
• Sikrer at rapporter og dashbord spør den nyeste Lakehouse-tilstanden på veldefinerte punkter i en pipeline.

Hvorfor feiler oppdateringen av endepunktet i SQL-analysen min når underliggende data er låst?

Oppdateringsaktiviteten for SQL-analyseendepunktet kan feile sporadisk når andre prosesser aktivt oppdaterer de underliggende Lakehouse-dataene. Disse prosessene inkluderer inntastingspipelines, notatbøker eller samtidige skriveoperasjoner.

Denne feilen skjer fordi SQL-analyseendepunktet må få interne låser for å fullføre oppdateringen. Hvis en annen operasjon låser dataene, går forespørselen ut eller gir en feilmelding.

Denne oppførselen forventes basert på hvordan SQL-analyseendepunkter håndterer oppdateringsoperasjoner for metadata.

Symptomer

• Aktiviteten mislykkes av og til, ikke konsekvent.
• Feilmeldinger indikerer oppdateringskonflikter eller låsstrid.
• Pipelines med flere sekvensielle oppdateringer av SQL-analyse-endepunkter viser høyere feilrater.

Rotårsak

SQL-analyseendepunkter krever eksklusiv tilgang til visse metadatastrukturer under oppdatering. Hvis en annen beregningsprosess skriver til Lakehouse samtidig, oppstår låskonflikt.

Denne oppførselen er ikke en feil i oppdatering av SQL-analyse-endepunktaktiviteten. Det er det naturlige resultatet av samtidige lese- og skriveoperasjoner på de underliggende dataene.

Midlertidige løsninger

To praktiske tilnærminger kan dempe dette problemet:

• Bruk kun én oppdateringsaktivitet for SQL-analyse-endepunktet på slutten av behandlingen
• Implementer en gjentakende oppdateringsplan

Bruk kun én Refresh SQL analytics-endepunktaktivitet på slutten av behandlingen

For å redusere sannsynligheten for låskonflikter, konsolider pipelinen din slik at:

• Alle inntastings-, transformasjons- og oppdateringsaktiviteter kjøres først,
• Deretter kjøres bare én oppdatering av SQL-analyse-endepunktaktivitet til slutt.
• Denne tilnærmingen eliminerer ikke feil helt, men reduserer betydelig hvor ofte de oppstår.

Implementer en gjentakende oppdateringsplan

Hvis scenarioet ditt ikke krever streng transaksjonskonsistens på et bestemt tidspunkt, bruk et mønster for gjentakende oppdateringer:

• Bestill en oppdatering hvert 15. minutt – kontinuerlig. Noen oppfriskningsforsøk kan mislykkes på grunn av låsing, men nok lykkes til å holde SQL-analyse-endepunktet ditt relativt oppdatert.

Denne tilnærmingen er praktisk og robust for mange analysearbeidsbelastninger.

Lagre og kjøre eller planlegge datasamlebåndet

Bytt til Hjem-fanen øverst i pipeline-editoren og velg lagre-knappen for å lagre pipelinen din. Velg Kjør for å kjøre det direkte eller Planlegg for å planlegge løp til bestemte tider eller intervaller. For mer informasjon om rørledningskjøringer, se: planlegg rørledningskjøringer.

Etter kjøring kan du overvåke pipeline-kjøringen og se kjørehistorikk fra Output-fanen under lerretet.

Kjente problemer

• Aktiviteten for oppdatering av SQL-analyseendepunktet kan av og til feile når andre prosesser aktivt oppdaterer de underliggende Lakehouse-dataene. For løsninger, se Hvorfor feiler oppdateringen av mitt SQL-analyseendepunkt når underliggende data er låst?

Relatert innhold

• Vedlikehold av innsjøhus
• Oppdater SQL-analyse-endepunktmetadata med REST API-et