Uppdatera aktivitet för SQL-analysens slutpunkt

Aktiviteten för att uppdatera en SQL-analysslutpunkt i Microsoft Fabric-pipelines gör att du programmatiskt kan uppdatera en SQL-analysslutpunkt för ett Lakehouse i ett orkestrerat arbetsflöde. Det är en del av Lakehouse Utility Suite för pipelines och används vanligtvis efter Lakehouse Maintenance-aktiviteten (till exempel efter OPTIMIZE- eller VACUUM-åtgärder). Nedströmsanvändare – till exempel Power BI-rapporter, notebook-filer eller externa SQL-klienter – ser sedan de senaste data när dataförberedelser eller underhållssteg har slutförts.

Använd den här aktiviteten för att få analysändpunkter för SQL att omedelbart återspegla de senaste uppdateringarna utan att behöva förlita dig på manuella uppdateringar eller ad hoc-processer. Använd den här aktiviteten när din pipeline:

• Uppdaterar eller underhåller Lakehouse-data (till exempel efter kopieringsjobb, notebook-körning eller Lakehouse-underhållsaktiviteter).
• Kräver att Lakehouse SQL-analysendpointen speglar de senaste metadata- och dataändringarna.
• Behöver deterministisk uppdateringstidpunkt innan efterföljande steg, som rapportering, analys eller export.

Förutsättningar

Innan du använder den här aktiviteten kontrollerar du att:

• Ett klientkonto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• En arbetsyta med en Lakehouse
• En SQL-analysenhet finns för Lakehouse.
• Pipelinens identitet (användare eller tjänstens huvudnamn) har behörighet att uppdatera SQL-analys­slutpunkten.

Lägg till en uppdateringsaktivitet för SQL-analysändpunkt i din pipeline i användargränssnittet

1. Skapa en ny pipeline på din arbetsyta.

2. Sök efter Refresh SQL analytics endpoint i pipeline Activities-panelen och välj den för att lägga till den i pipeline-canvasen.

   

3. Välj den nya aktiviteten Uppdatera SQL-analysens slutpunkt på arbetsytan om den inte redan är vald.

   

   Tip

   Du kan samordna den här aktiviteten tillsammans med andra Aktiviteter i Lakehouse Utility Suite, till exempel underhållsaktiviteten Lakehouse, i samma pipeline så att underhåll och uppdatering körs i följd.

4. Se Allmänna-inställningar vägledning för att konfigurera inställningsfliken Allmänt.

Uppdatera aktivitetsinställningarna för SQL analytics-slutpunkten

1. Välj fliken Inställningar för att konfigurera aktiviteten.  

2. Konfigurera anslutningen genom att välja en befintlig anslutning från listrutan Anslutning eller skapa en ny anslutning och ange dess konfigurationsinformation.

3. Ange arbetsyta som innehåller Lakehouse.

4. Ange SQL-analysändpunkten som SQL analytics-endpoint-ID för Lakehouse du vill uppdatera. Uppdateringen uppdaterar Lakehouse SQL-analysanalysens endpoint-metadata så att den speglar senaste data- och schemaändringar.

   

Aktivitetsbeteende

När aktivitetskörningen är klar:

• Om pop-up-fönstret Utdata visar statusen Lyckades, synkroniserar begäran osynkroniserade data framgångsrikt.

  

• En NotRun-status i Output-popupen betyder att uppdateringen av SQL-analysendpointen inte kördes. Det här villkoret innebär vanligtvis att du inte har lagt till nya data sedan den senaste synkroniseringen, så du behövde inte köra dem.

  

• Om popup-fönstret Utdata visar statusen Fel gick något fel.

Vanliga scenarier

• Uppdatering av SQL-analysslutpunkten efter att en anteckningsbok har skrivit transformerade data till ett Lakehouse.
• Starta en uppdatering av SQL-analysens endpoint efter att Lakehouse Maintenance-aktiviteten (OPTIMIZE eller VACUUM) är klar.
• Att säkerställa att rapporter och instrumentpaneler hämtar data från det senaste tillståndet i Lakehouse vid väldefinierade punkter i en pipeline.

Varför misslyckas uppdateringen av min SQL-analysändpunkt när underliggande data är låsta?

Aktiviteten för att uppdatera SQL-analysens slutpunkt kan sporadiskt misslyckas när andra processer aktivt uppdaterar underliggande Lakehouse-data. Dessa processer omfattar inmatningspipelines, notebook-filer eller samtidiga skrivåtgärder.

Detta fel uppstår eftersom SQL-analysändpunkten måste få interna lås för att slutföra uppdateringen. Om en annan åtgärd låser data överskrids tidsgränsen för begäran eller returnerar ett fel.

Detta beteende förväntas baserat på hur SQL-analysendpoints hanterar uppdateringsoperationer för metadata.

Symptoms

• Aktiviteten misslyckas tillfälligt, inte konsekvent.
• Felmeddelanden anger uppdateringskonflikter eller låskonkurration.
• Pipelines med flera uppdateringsaktiviteter i följd för SQL-analysändpunkten har högre felfrekvens.

Grundorsak

SQL-analysenslutpunkter kräver exklusiv åtkomst till vissa metadatastrukturer under uppdateringen. Om en annan beräkningsprocess skriver till Lakehouse vid samma tidpunkt inträffar låsstrid.

Detta beteende är inte ett fel i aktiviteten för att uppdatera SQL-analysens slutpunkt. Det är det naturliga resultatet av samtidiga läs- och skrivåtgärder på underliggande data.

Lösningar

Två praktiska metoder kan åtgärda problemet:

• Använd endast en aktivitet för att uppdatera SQL-analysändpunkten i slutet av bearbetningen
• Implementera ett återkommande uppdateringsschema

Använd endast aktiviteten Uppdatera SQL-analysändpunkt i slutet av bearbetningen

Om du vill minska sannolikheten för låskonflikter konsoliderar du din pipeline så att:

• Alla inmatnings-, transformerings- och uppdateringsaktiviteter körs först.
• Därefter körs endast en uppdateringsaktivitet för SQL-analysslutpunkten i slutet.
• Den här metoden eliminerar inte fel helt, men minskar avsevärt hur ofta de inträffar.

Implementera ett återkommande uppdateringsschema

Om ditt scenario inte kräver strikt transaktionskonsekvens vid ett visst tillfälle använder du ett återkommande uppdateringsmönster:

• Schemalägg en uppdatering var 15:e minut – kontinuerligt. Vissa uppdateringsförsök kan misslyckas på grund av låsning, men tillräckligt många lyckas för att hålla din SQL-analysendpoint relativt uppdaterad.

Den här metoden är praktisk och robust för många analysarbetsbelastningar.

Spara och kör eller schemalägg pipelinan

Växla till fliken Start överst i pipelineredigeraren och välj knappen Spara för att spara din pipeline. Välj Kör för att köra den direkt eller Schemalägg för att schemalägga körningar vid specifika tidpunkter eller intervall. Mer information om pipelinekörningar finns i: schemalägga pipelinekörningar.

När du har kört kan du övervaka pipelinekörningen och visa körningshistoriken från fliken Utdata under arbetsytan.

Kända problemområden

• Aktiviteten för att uppdatera SQL-analysens slutpunkt kan ibland misslyckas när andra processer aktivt uppdaterar underliggande Lakehouse-data. För lösningar, se Varför misslyckas uppdateringen av min SQL-analysendpoint när underliggande data är låst?

Relaterat innehåll

• Underhållsaktivitet för Lakehouse
• Uppdatera SQL-analysens endpoint-metadata med REST API