Sql-eindpuntactiviteit vernieuwen

Met de activiteit SQL-eindpunt vernieuwen in Microsoft Fabric-pijplijnen kunt u programmatisch een Lakehouse SQL-eindpunt vernieuwen als onderdeel van een ingedeelde werkstroom. 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-eindpunten onmiddellijk recente updates weer te geven zonder te vertrouwen op handmatige vernieuwingen 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-eindpunt de meest recente metagegevens en gegevenswijzigingen 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 activiteit toe om een SQL-eindpunt te vernieuwen aan uw pijplijn in de gebruikersinterface.

  1. Maak een nieuwe pijplijn in uw werkruimte.  

  2. Zoek naar Vernieuw SQL-eindpunt in het deelvenster Pijplijnactiviteiten en selecteer het om het toe te voegen aan het pijplijncanvas.  

    Schermopname van de activiteit SQL-eindpunt vernieuwen in het deelvenster Activiteiten.

  3. Selecteer de nieuwe activiteit SQL-eindpunt vernieuwen op het canvas als deze nog niet is geselecteerd.  

    Schermopname van de activiteit SQL-eindpunt vernieuwen 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.

Instellingen voor SQL-eindpuntactiviteit vernieuwen

  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. Geef het SQL-eindpunt op voor het Lakehouse dat u wilt vernieuwen. Tijdens het vernieuwen worden de metagegevens van het Lakehouse SQL-eindpunt bijgewerkt, zodat deze recente wijzigingen in gegevens en schema's weerspiegelt.

    Schermopname van de activiteitsinstellingen voor SQL-eindpunt vernieuwen.

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 het pop-upvenster Uitvoer betekent dat het vernieuwen van het SQL-eindpunt 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 SQL-eindpunt vernieuwen nadat een notebook getransformeerde gegevens naar een Lakehouse heeft geschreven.
  • Activeer een SQL-eindpuntvernieuwing nadat de Lakehouse-onderhoudsactiviteit (OPTIMIZE of VACUUM) is voltooid.
  • Zorg ervoor dat rapporten en dashboards de meest recente Lakehouse-status op goed gedefinieerde punten in een pijplijn opvragen.

Waarom mislukt het vernieuwen van mijn SQL-eindpunt wanneer onderliggende gegevens zijn vergrendeld?

De activiteit SQL-eindpunt vernieuwen kan af en toe mislukken wanneer andere processen de onderliggende Lakehouse-gegevens actief bijwerken. Deze processen omvatten invoerpijplijnen, notebooks of gelijktijdige schrijfbewerkingen.

Deze fout treedt op omdat het SQL-eindpunt interne vergrendelingen moet verkrijgen om het vernieuwen 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 de wijze waarop SQL-eindpunten bewerkingen voor het vernieuwen van metagegevens beheren.

Symptomen

  • De activiteit mislukt af en toe, niet consistent.
  • Foutberichten geven aan dat er verversingsconflicten of vergrendelingscontentie is.
  • Pijplijnen met meerdere opeenvolgende vernieuwingsactiviteiten voor SQL-eindpunten tonen hogere foutenpercentages.

Hoofdoorzaak

SQL-eindpunten vereisen exclusieve toegang tot bepaalde metagegevensstructuren tijdens het vernieuwen. Als er tegelijkertijd een ander rekenproces naar Lakehouse wordt geschreven, treedt er een vergrendelingsconflict op.

Dit gedrag is geen defect in de activiteit SQL-eindpunt vernieuwen. 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 SQL-eindpunten 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,
  • Vervolgens wordt aan het einde slechts één vernieuwingsactiviteit voor SQL-eindpunten uitgevoerd.
  • Deze aanpak elimineert niet volledig fouten, maar vermindert aanzienlijk hoe vaak ze optreden.

Een terugkerend vernieuwingsschema implementeren

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 vernieuwingspogingen kunnen mislukken vanwege vergrendeling, maar voldoende geslaagd om uw SQL-eindpunt relatief up-to-date te houden.

Schermopname van een schemaconfiguratie voor een terugkerend vernieuwings-SQL-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

  • Last updated on