Delen via


De opzoekactiviteit gebruiken om gegevens uit een gegevensbron op te zoeken

De activiteit Fabric Lookup kan een gegevensset ophalen uit een van de gegevensbronnen die worden ondersteund door Microsoft Fabric. U kunt het gebruiken om dynamisch te bepalen op welke objecten u in een volgende activiteit wilt werken, in plaats van de objectnaam hard te coderen. Enkele objectvoorbeelden zijn bestanden en tabellen.

Opzoekactiviteit leest en retourneert de inhoud van een configuratiebestand of -tabel. Het retourneert ook het resultaat van het uitvoeren van een query of opgeslagen procedure. De uitvoer kan een singleton-waarde of een reeks van kenmerken zijn, die kunnen worden gebruikt in een volgende kopieer-, transformatie- of controleflowactiviteiten zoals een ForEach-activiteit.

Vereisten

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

Voeg een opzoekactiviteit toe aan een pijplijn via de gebruikersinterface.

Voer de volgende stappen uit om een opzoekactiviteit in een pijplijn te gebruiken:

De activiteit maken

  1. Maak een nieuwe pijplijn in uw werkruimte.

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

    Schermafbeelding van de Fabric UI met het deelvenster Activiteiten en de zoekactiviteit gemarkeerd.

  3. Selecteer de nieuwe opzoekactiviteit op het canvas als deze nog niet is geselecteerd.

    Schermopname van het tabblad Algemene instellingen van de opzoekactiviteit.

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

Opzoekinstellingen

Selecteer het tabblad Instellingen , selecteer een bestaande verbinding in de vervolgkeuzelijst Verbinding of maak een nieuwe verbinding en geef de configuratiegegevens op.

Schermopname van het tabblad Activiteitsinstellingen opzoeken waarin het tabblad wordt gemarkeerd en waar u een nieuwe verbinding kunt kiezen.

In het voorbeeld in de vorige afbeelding ziet u een blobopslagverbinding, maar elk verbindingstype heeft een eigen configuratiedetails die specifiek zijn voor de geselecteerde gegevensbron.

Ondersteunde mogelijkheden

  • De opzoekactiviteit kan maximaal 5000 rijen retourneren; als de resultatenset meer records bevat, worden de eerste 5000 rijen geretourneerd.
  • De uitvoer van de lookup-activiteit ondersteunt maximaal 4 MB in grootte; activiteit mislukt als de grootte de limiet overschrijdt.
  • De langste duur voor lookup-activiteit voordat time-out plaatsvindt, is 24 uur.

Notitie

Wanneer u een query of opgeslagen procedure gebruikt om gegevens op te zoeken, moet u precies één resultaatset retourneren. Anders mislukt de lookup-activiteit.

Fabric ondersteunt de datastores die worden genoemd in het artikel Connector overzicht. Gegevens uit elke bron kunnen worden gebruikt.

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.

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