Opdater SQL analytics endpoint-aktivitet

Aktiviteten refresh SQL analytics endpoint i Microsoft Fabric pipelines lader dig programmatisk opdatere et Lakehouse SQL analytics endpoint som en del af en orkestreret workflow. Det er en del af Lakehouse Utility Suite til rørledninger og bruges typisk efter Lakehouse Maintenance-aktiviteten (for eksempel efter OPTIMIZE eller VACUUM operationer). Nedstrøms forbrugere – såsom Power BI-rapporter, notebooks eller eksterne SQL-klienter – ser derefter de nyeste data efter dataforberedelse eller vedligeholdelsestrin er afsluttet.

Brug denne aktivitet til at få SQL-analyse-endpoints til straks at afspejle de seneste opdateringer uden at være afhængig af manuelle opdateringer eller ad hoc-processer. Brug denne aktivitet, når din pipeline:

  • Opdaterer eller vedligeholder Lakehouse-data (for eksempel efter kopieringsjobs, notebook-udførelse eller vedligeholdelsesaktiviteter i Lakehouse).
  • Kræver, at Lakehouse SQL-analyseendpoint afspejler de seneste metadata og dataændringer.
  • Kræver deterministisk opdateringstidspunkt før nedstrøms skridt som rapportering, analyse eller eksport.

Forudsætninger

Før du bruger denne aktivitet, skal du sikre dig, at:

Tilføj en opdatering af SQL analytics-endpointaktivitet til din pipeline i UI'en

  1. Opret en ny pipeline i dit arbejdsområde.

  2. Søg efter Refresh SQL analytics endpoint i pipeline-aktivitetspanelet og vælg det for at tilføje det til pipeline-lærredet.

    Skærmbillede af opdatering af SQL-analyse-endpointaktiviteten i Aktiviteter-panelet.

  3. Vælg den nye Refresh SQL analytics endpoint-aktivitet på lærredet, hvis den ikke allerede er valgt.

    Skærmbillede af aktiviteten ved at refreshe SQL analytics-endpointet på pipeline-canvasen.

    Tip

    Du kan orkestrere denne aktivitet sammen med andre aktiviteter i Lakehouse Utility Suite – såsom Lakehouse Maintenance-aktiviteten – i samme pipeline, så vedligeholdelse og opdatering kører i rækkefølge.

  4. Se vejledningen til generelle indstillinger for at konfigurere fanen Generelle indstillinger.

Opdater SQL analytics endpoint aktivitetsindstillinger

  1. Vælg fanen Indstillinger for at konfigurere aktiviteten.  

  2. Konfigurér forbindelse ved at vælge en eksisterende forbindelse fra Forbindelsesmenuen , eller oprette en ny forbindelse og specificere dens konfigurationsdetaljer.

  3. Angiv det arbejdsområde , der indeholder Lakehouse.

  4. Angiv SQL analytics-endpointet som SQL analytics endpoint ID for det Lakehouse, du vil opdatere. Opfriskningen opdaterer Lakehouse SQL-analyse-endpoint-metadata, så det afspejler nylige data- og skemaændringer.

    Skærmbillede af opdateringen af SQL analytics endpoint aktivitetsindstillingerne, hvor du angiver SQL analytics endpoint.

Aktivitetsadfærd

Når aktivitetsløbet slutter:

  • Hvis Output-pop-up'en viser Successtatus , synkroniserer anmodningen usynkroniserede data med succes.

    Skærmbillede af en successtatus i aktivitetens output-popup.

  • En NotRun-status i Output-popup'en betyder, at opdateringen af SQL-analyseendpointet ikke blev kørt. Den betingelse betyder som regel, at du ikke har tilføjet nye data siden sidste synkronisering, så du ikke behøvede at køre det.

    Skærmbillede af en NotRun-status i aktivitetsoutput-popup'en.

  • Hvis Output-popup'en viser fejlstatus , er der gået noget galt.

Bemærkning

Aktivitetskørslen sætter disse statusser i Output-pop-up'en. Forveksl ikke disse statusser med selve aktivitetsstatussen.

Almindelige scenarier

  • Opdatering af SQL-analyse-endpointet efter en Notebook har skrevet transformerede data til et Lakehouse.
  • Udløs en opdatering af SQL-analyseendpointet efter Lakehouse Maintenance-aktiviteten (OPTIMIZE eller VACUUM) er afsluttet.
  • At sikre, at rapporter og dashboards forespørger den seneste Lakehouse-tilstand på veldefinerede punkter i en pipeline.

Hvorfor fejler opdateringen af mit SQL-analyseendpoint, når underliggende data er låst?

Aktiviteten ved refresh SQL-analyse-endpointet kan fejle indimellem, når andre processer aktivt opdaterer de underliggende Lakehouse-data. Disse processer inkluderer indlæsningspipelines, notesbøger eller samtidige skriveoperationer.

Denne fejl sker, fordi SQL-analyse-endpointet skal opnå interne låse for at fuldføre opdateringen. Hvis en anden operation låser dataene, går anmodningen ud eller giver en fejl.

Denne adfærd forventes baseret på, hvordan SQL-analyseendpoints håndterer metadata-opdateringsoperationer.

Symptomer

  • Aktiviteten fejler indimellem, ikke konsekvent.
  • Fejlmeddelelser indikerer opdateringskonflikter eller lås-konkurrence.
  • Pipelines med flere sekventielle opdateringer af SQL-analyse-endpointaktiviteter viser højere fejlrater.

Rodårsagen

SQL-analyseendepunkter kræver eksklusiv adgang til visse metadatastrukturer under opdatering. Hvis en anden beregningsproces skriver til Lakehouse samtidig, opstår der låsekonkurrence.

Denne adfærd er ikke en fejl i opdaterings-SQL-analyse-endpointaktiviteten. Det er det naturlige resultat af samtidige læse- og skriveoperationer på de underliggende data.

Løsninger

To praktiske tilgange kan afbøde dette problem:

Brug kun én Refresh SQL analytics endpoint-aktivitet ved slutningen af behandlingen

For at mindske risikoen for låsekonflikter, konsolider din pipeline, så at:

  • Alle indlæsnings-, transformations- og opdateringsaktiviteter kører først,
  • Derefter udføres kun én opdatering af SQL analytics-endpoint-aktivitet til sidst.
  • Denne tilgang eliminerer ikke fejl fuldstændigt, men reducerer betydeligt, hvor ofte de opstår.

Implementer en tilbagevendende opdateringsplan

Hvis dit scenarie ikke kræver streng transaktionsmæssig konsistens på et bestemt tidspunkt, så tag et mønster med tilbagevendende opdateringer:

  • Planlæg en opdatering hvert 15. minut – kontinuerligt. Nogle opdateringsforsøg kan fejle på grund af låsning, men nok lykkes til at holde dit SQL-analyse-endpoint relativt opdateret.

Skærmbillede af en tilbagevendende opdatering af SQL analytics endpoint planlægningskonfiguration.

Denne tilgang er praktisk og robust for mange analysearbejdsbyrder.

Gem og kør eller planlæg pipelinen

Skift til fanen Hjem øverst i pipeline-editoren og vælg gem-knappen for at gemme din pipeline. Vælg Kør for at køre direkte eller Skemalæg for at planlægge løb på bestemte tidspunkter eller intervaller. For mere information om rørledningskørsler, se: planlæg rørledningskørsler.

Skærmbillede, der viser fanen Hjem i pipelineeditoren med tabulatornavnet, knapperne Gem, Kør og Planlæg fremhævet.

Efter kørsel kan du overvåge pipeline-udførelsen og se kørselshistorik fra fanen Output under lærredet.

Kendte problemer

Relateret indhold

  • Last updated on