Vernieuw de activiteit van het SQL-analyse-eindpunt

De refresh SQL analytics endpointactiviteit in Microsoft Fabric pipelines stelt je in staat een Lakehouse SQL analytics endpoint programmatisch te verversen als onderdeel van een georkestreerde workflow. Het maakt deel uit van de Lakehouse Utility Suite voor pijplijnen en wordt meestal gebruikt na de onderhoudsactiviteit van Lakehouse (bijvoorbeeld na OPTIMIZE- of VACUUM-bewerkingen). Downstreamgebruikers, zoals Power BI-rapporten, notebooks of externe SQL-clients, zien vervolgens de meest recente gegevens nadat de stappen voor gegevensvoorbereiding of onderhoud zijn voltooid.

Gebruik deze activiteit om SQL-analytics-endpoints direct recente updates te laten weergeven zonder te vertrouwen op handmatige verversingen of ad-hocprocessen. Gebruik deze activiteit wanneer uw pijplijn:

  • Hiermee worden Lakehouse-gegevens bijgewerkt of onderhouden (bijvoorbeeld na kopieertaken, uitvoering van notebooks of onderhoudsactiviteiten van Lakehouse).
  • Vereist dat het Lakehouse SQL-analyse-endpoint de nieuwste metadata en datawijzigingen weergeeft.
  • Er is een deterministische vernieuwingstijd vereist vóór downstreamstappen, zoals rapportage, analyse of exports.

Vereiste voorwaarden

Voordat u deze activiteit gebruikt, moet u ervoor zorgen dat:

Voeg een vernieuwingsactiviteit voor een SQL-analyse-eindpunt toe aan je pipeline in de UI

  1. Maak een nieuwe pijplijn in uw werkruimte.

  2. Zoek naar Refresh SQL analytics endpoint in het pipeline Activities-paneel en selecteer het om het toe te voegen aan het pipeline canvas.

    Screenshot van de verversactiviteit van het SQL-analyse-endpoint in het Activiteiten-paneel.

  3. Selecteer de nieuwe Refresh SQL analytics endpoint-activiteit op het canvas als die nog niet is geselecteerd.

    Schermafbeelding van de vernieuwingsactiviteit van het SQL analytics-endpoint op het pijplijncanvas.

    Tip

    U kunt deze activiteit organiseren naast andere Lakehouse Utility Suite-activiteiten, zoals de Lakehouse-onderhoudsactiviteit, in dezelfde pijplijn, zodat onderhoud en vernieuwing op volgorde worden uitgevoerd.

  4. Raadpleeg de richtlijnen voor algemene instellingen voor het configureren van het tabblad Algemene instellingen.

Vernieuw de instellingen voor SQL analytics endpoint activiteit

  1. Selecteer het tabblad Instellingen om de activiteit te configureren.  

  2. Configureer de verbinding door een bestaande verbinding te selecteren in de vervolgkeuzelijst Verbinding of door een nieuwe verbinding te maken en de configuratiegegevens op te geven.

  3. Geef de werkruimte op die het Lakehouse bevat.

  4. Specificeer het SQL-analytics-endpoint als de SQL-analytics-endpoint-ID voor het Lakehouse dat je wilt verversen. De vernieuwing werkt de metadata van de Lakehouse SQL-analytics endpoint bij zodat deze recente data- en schemawijzigingen weerspiegelt.

    Maak een screenshot van de instellingen voor de verversen van SQL analytics endpoint activiteiten, waarbij je het SQL analytics endpoint specificeert.

Activiteitsgedrag

Wanneer de uitvoering van de activiteit is voltooid:

  • Als in het pop-upvenster Uitvoer de status Geslaagd wordt weergegeven, worden niet-gesynchroniseerde gegevens gesynchroniseerd.

    Schermopname van de status Geslaagd in het pop-upvenster Uitvoer van activiteit.

  • Een NotRun-status in de Output-pop-up betekent dat de verversing van het SQL-analytics-endpoint niet is uitgevoerd. Deze voorwaarde betekent meestal dat u geen nieuwe gegevens hebt toegevoegd sinds de laatste synchronisatie, dus u hoeft deze niet uit te voeren.

    Schermopname van een NotRun-status in het pop-upvenster Uitvoer van activiteit.

  • Als in het pop-upvenster Uitvoer de foutstatus wordt weergegeven, is er iets misgegaan.

Opmerking

Met de uitvoering van de activiteit worden deze statussen ingesteld in het pop-upvenster Uitvoer. Verwar deze statussen niet met de activiteitsstatus zelf.

Algemene scenario's

  • Het vernieuwen van het SQL-analyse-eindpunt nadat een Notebook getransformeerde gegevens naar een Lakehouse heeft geschreven.
  • Activeer een verversing van het SQL-analytics-endpoint nadat de Lakehouse Maintenance-activiteit (OPTIMIZE of VACUUM) is voltooid.
  • Ervoor zorgen dat rapporten en dashboards op duidelijk gedefinieerde punten in een pijplijn de meest recente status van het Lakehouse raadplegen.

Waarom faalt de verversing van mijn SQL-analytics endpoint wanneer de onderliggende data vergrendeld is?

De refresh SQL analytics endpointactiviteit kan af en toe falen wanneer andere processen actief de onderliggende Lakehouse-data bijwerken. Deze processen omvatten invoerpijplijnen, notebooks of gelijktijdige schrijfbewerkingen.

Deze storing ontstaat omdat het SQL-analyse-endpoint interne locks moet krijgen om de verversing te voltooien. Als een andere bewerking de gegevens vergrendelt, treedt er een time-out op of retourneert de aanvraag een fout.

Dit gedrag wordt verwacht op basis van hoe SQL-analytics-endpoints metadata-verversingsoperaties beheren.

Symptomen

  • De activiteit mislukt af en toe, niet consistent.
  • Foutberichten geven aan dat er verversingsconflicten of vergrendelingscontentie is.
  • Pijplijnen met meerdere sequentiële verversingsactiviteiten voor SQL-analytics endpoints laten hogere faalpercentages zien.

Hoofdoorzaak

SQL-analytics-endpoints vereisen exclusieve toegang tot bepaalde metadatastructuren tijdens het verversen. Als er tegelijkertijd een ander rekenproces naar Lakehouse wordt geschreven, treedt er een vergrendelingsconflict op.

Dit gedrag is geen defect in de refresh SQL analytics endpointactiviteit. Dit is het natuurlijke resultaat van gelijktijdige lees- en schrijfbewerkingen op de onderliggende gegevens.

Tijdelijke oplossingen

Twee praktische benaderingen kunnen dit probleem verhelpen:

Gebruik slechts één vernieuwingsactiviteit voor het SQL Analytics-eindpunt aan het einde van de verwerking

Als u de kans op vergrendelingsconflicten wilt verminderen, voegt u uw pijplijn samen, zodat:

  • Alle opname-, transformatie- en updateactiviteiten worden eerst uitgevoerd,
  • Pas aan het einde wordt er maar één vernieuwingsactiviteit van het SQL analytics-endpoint uitgevoerd.
  • Deze aanpak elimineert niet volledig fouten, maar vermindert aanzienlijk hoe vaak ze optreden.

Voer een terugkerend verversingsschema uit

Als voor uw scenario op een bepaald moment geen strikte transactionele consistentie is vereist, moet u een terugkerend vernieuwingspatroon toepassen:

  • Plan elke 15 minuten een vernieuwing, continu. Sommige ververspogingen kunnen mislukken door vergrendeling, maar genoeg slagen om je SQL-analytics-endpoint relatief up-to-date te houden.

Schermafbeelding van de schemaconfiguratie voor een terugkerende vernieuwing van een SQL-analyse-eindpunt.

Deze aanpak is praktisch en robuust voor veel analyseworkloads.

Bewaar en voer de pijplijn uit, of plan deze

Schakel over naar het tabblad Home boven aan de pijplijneditor en selecteer de knop Opslaan om uw pijplijn op te slaan. Selecteer Uitvoeren om deze rechtstreeks uit te voeren of Planning om uitvoeringen op specifieke tijdstippen of intervallen te plannen. Zie voor meer informatie over pijplijnuitvoeringen: pijplijnuitvoeringen plannen.

Schermopname van het tabblad Start in de pijplijneditor met de tabnaam en de knoppen Opslaan, Uitvoeren en Inplannen gemarkeerd.

Nadat u de pijplijn heeft uitgevoerd, kunt u de pijplijnuitvoering bewaken en de uitvoeringsgeschiedenis bekijken op het Uitvoer tabblad onder het canvas.

Bekende problemen

Verwante inhoud

  • Laatst bijgewerkt om