Gegevens transformeren door een notebook uit te voeren

Gebruik de notebookactiviteit om notebooks uit te voeren die u in Microsoft Fabric maakt als onderdeel van uw Data Factory-pijplijnen. Met notebooks kunt u Apache Spark-taken uitvoeren om uw gegevens in te voeren, op te schonen of te transformeren als onderdeel van uw gegevenswerkstromen. U kunt eenvoudig een Notebook-activiteit toevoegen aan uw pijplijnen in Fabric. Deze handleiding begeleidt u bij elke stap.

Vereisten

Om aan de slag te gaan, moet u aan de volgende vereisten voldoen:

• Een tenantaccount met een actief abonnement. Gratis een account maken
• Er wordt een werkruimte gemaakt.
• Er wordt een notebook gemaakt in uw werkruimte. Zie Hoe maak je Microsoft Fabric-notebooks om een nieuw notitieblok te maken.

Een notebookactiviteit maken

1. Maak een nieuwe pijplijn in uw werkruimte.

2. Zoek naar Notebook in het deelvenster Activiteiten van de pijplijn en selecteer het om het aan het pijplijncanvas toe te voegen.

   

3. Selecteer de nieuwe Notitieblok-activiteit op het canvas als die nog niet is geselecteerd.

   

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

Notebookinstellingen configureren

Selecteer het tabblad Instellingen.

Selecteer onder Verbinding de verificatiemethode voor het uitvoeren van het notebook en geef de vereiste referenties of identiteitsconfiguratie op op basis van uw selectie:

• Service Principal (SPN): aanbevolen voor productiescenario's om een veilige, geautomatiseerde uitvoering te garanderen zonder te vertrouwen op gebruikersreferenties.
• Werkruimte-identiteit (WI): ideaal voor beheerde omgevingen waar gecentraliseerd identiteitsbeheer is vereist.

Selecteer een bestaand notitieblok in de vervolgkeuzelijst Notebook en geef eventueel parameters op die u aan het notitieblok wilt doorgeven.

Wi (Fabric Workspace Identity) gebruiken in de notebookactiviteit

1. De werkruimte-id maken

   U moet WI inschakelen in uw werkruimte (dit kan even duren voordat deze is geladen). Maak een werkruimte-id in uw Fabric-werkruimte. Houd er rekening mee dat de WI moet worden gemaakt in dezelfde werkruimte als uw pijplijn.

   Bekijk de documenten over werkruimte-identiteit.

2. Instellingen op tenantniveau inschakelen

   Schakel de volgende tenantinstelling in (deze is standaard uitgeschakeld): Service-principals kunnen openbare Fabric-API's aanroepen.

   U kunt deze instelling inschakelen in de Fabric-beheerportal. Zie het artikel service-principalverificatie inschakelen voor beheerders-API's voor meer informatie over deze instelling.

3. Werkruimtemachtigingen verlenen aan de Workspace Identity

   Open de werkruimte, selecteer Toegang beheren en wijs machtigingen toe aan de werkruimte-id. Toegang tot inzenders is voldoende voor de meeste scenario's. Als uw Notebook zich niet in dezelfde werkruimte bevindt als uw Pipeline, moet u de WI die u hebt gemaakt in de werkruimte van uw Pipeline ten minste toegang als bijdrager toewijzen tot de werkruimte van uw Notebook.

   Bekijk de documenten over Gebruikers toegang geven tot werkruimten.

Sessietag instellen

Om de hoeveelheid tijd die nodig is om uw notebooktaak uit te voeren te minimaliseren, kunt u optioneel een sessietag instellen. Als u de sessietag instelt, wordt Spark geïnstrueerd om een bestaande Spark-sessie opnieuw te gebruiken, waardoor de opstarttijd wordt geminimaliseerd. Elke willekeurige tekenreekswaarde kan worden gebruikt voor de sessietag. Als er geen sessie bestaat, wordt er een nieuwe gemaakt met behulp van de tagwaarde.

De pijplijn opslaan en uitvoeren of plannen

Ga naar het tabblad Start boven aan de pijplijneditor en selecteer de knop Opslaan om uw pijplijn op te slaan. Selecteer Uitvoeren om het rechtstreeks uit te voeren of Plan om deze te plannen. U kunt hier ook de uitvoeringsgeschiedenis bekijken of andere instellingen configureren.

Bekende problemen

• De WI-optie in de instellingen voor verbindingen wordt in sommige gevallen niet weergegeven. Dit is een fout waaraan momenteel een oplossing wordt gewerkt.

Gerelateerde inhoud

• Hoe pijplijnuitvoeringen te monitoren