Uppdatera SQL-slutpunktsaktivitet

Med aktiviteten Uppdatera SQL-slutpunkt i Microsoft Fabric-pipelines kan du programmatiskt uppdatera en Lakehouse SQL-slutpunkt som en del av 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 om du vill att SQL-slutpunkter omedelbart ska återspegla de senaste uppdateringarna utan att behöva använda 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-slutpunkten återspeglar 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
• Det finns en SQL-slutpunkt för Lakehouse.
• Pipelineidentiteten (användaren eller tjänstens huvudnamn) har behörighet att uppdatera SQL-slutpunkten.

Lägg till en aktivitet för att uppdatera SQL-slutpunkt i pipelinen i användargränssnittet

1. Skapa en ny pipeline på din arbetsyta.  

2. Sök efter Uppdatera SQL-slutpunkt i fönstret Pipelineaktiviteter och välj den för att lägga till den i pipelinearbetsytan.  

   

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

   

   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 inställningar för SQL-slutpunktsaktivitet

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-slutpunkten för den Lakehouse som du vill uppdatera. Uppdateringen uppdaterar Lakehouse SQL-slutpunktsmetadata så att den återspeglar de senaste data- och schemaändringarna.

   

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 popup-fönstret Utdata innebär att uppdateringen av SQL-slutpunkten 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

• Uppdaterar SQL-slutpunkten efter att en notebook skriver transformerade data till en Lakehouse.
• Utlös en SQL-slutpunktsuppdatering när lakehouseunderhållsaktiviteten (OPTIMIZE eller VACUUM) har slutförts.
• Se till att rapporter och instrumentpaneler frågar efter det senaste Lakehouse-tillståndet vid väldefinierade punkter i en pipeline.

Varför misslyckas min SQL-slutpunktsuppdatering när underliggande data är låsta?

Aktiviteten Uppdatera SQL-slutpunkt kan misslyckas tillfälligt när andra processer aktivt uppdaterar underliggande Lakehouse-data. Dessa processer omfattar inmatningspipelines, notebook-filer eller samtidiga skrivåtgärder.

Det här felet inträffar eftersom SQL-slutpunkten måste hämta 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.

Det här beteendet förväntas baserat på hur SQL-slutpunkter hanterar metadatauppdateringsåtgärder.

Symptoms

• Aktiviteten misslyckas tillfälligt, inte konsekvent.
• Felmeddelanden anger uppdateringskonflikter eller låskonkurration.
• Pipelines med flera sekventiella SQL-slutpunktsaktiviteter för uppdatering visar högre felfrekvenser.

Grundorsak

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

Det här beteendet är inte en defekt i aktiviteten Uppdatera SQL-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 uppdatering av SQL-slutpunktsaktivitet i slutet av bearbetningen
• Implementera ett återkommande uppdateringsschema

Använd endast en uppdatering av SQL-slutpunktsaktivitet 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.
• Sedan körs bara en Uppdatera SQL-slutpunktsaktivitet 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 det räcker för att hålla SQL-slutpunkten 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 Uppdatera SQL-slutpunkt kan ibland misslyckas när andra processer aktivt uppdaterar underliggande Lakehouse-data. Lösningar finns i avsnittet Varför misslyckas min SQL-slutpunktsuppdatering när underliggande data är låsta?

Relaterat innehåll

• Underhållsaktivitet för Lakehouse
• Uppdatera SQL-slutpunktsmetadata med REST-API:et