Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Fabric Nachschlageaktivität kann ein Dataset aus einer der von Microsoft Fabric unterstützten Datenquellen abrufen. Sie können damit dynamisch ermitteln, welche Objekte in einer nachfolgenden Aktivität verarbeitet werden sollen, statt den Objektnamen hart zu codieren. Beispiele für Objekte sind Dateien und Tabellen.
Die Lookup-Aktivität liest die Daten und gibt den Inhalt einer Konfigurationsdatei oder Tabelle zurück. Zudem gibt sie auch das Ergebnis einer ausgeführten Abfrage oder gespeicherten Prozedur zurück. Die Ausgabe kann ein Singleton-Wert oder ein Array von Attributen sein, das in einer nachfolgenden Kopier-, Transformations-oder Ablaufsteuerungsaktivität wie einer ForEach-Aktivität verwendet werden kann.
Voraussetzungen
Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:
- Sie benötigen Zugriff auf einen Microsoft Fabric Mandanten mit einer bereitgestellten Kapazität. Sie können try Fabric mit einer kostenlosen Testversion testen.
- Ein Fabric workspace der spezifischen Kapazität zugeordnet.
Hinzufügen einer Lookup-Aktivität zu einer Pipeline über die Benutzeroberfläche
Führen Sie die folgenden Schritte aus, um eine Lookup-Aktivität in einer Pipeline zu verwenden:
Erstellen der Aktivität
Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.
Suchen Sie im Bereich Pipelineaktivitäten nach „Lookup“ und wählen Sie es aus, um es zum Pipeline-Arbeitsbereich hinzuzufügen.
Wählen Sie die neue Lookup-Aktivität in der Canvas aus, wenn sie noch nicht ausgewählt ist.
Um die Registerkarte Allgemein zu konfigurieren, finden Sie Informationen im Leitfaden für die Allgemeine Einstellungen.
Sucheinstellungen
Wählen Sie die Registerkarte Einstellungen oder eine vorhandene Verbindung in der Dropdownliste Verbindung aus, oder erstellen Sie eine neue Verbindung und geben Sie ihre Konfigurationsdetails an.
Das Beispiel in der vorherigen Abbildung zeigt eine Lakehouse-Verbindung, aber jeder Verbindungstyp verfügt über eigene Konfigurationsdetails, die für die ausgewählte Datenquelle spezifisch sind.
Die Schaltfläche "Datenvorschau " in den Nachschlageaktivitätseinstellungen, um ein Beispiel der von Ihrer Abfrage zurückgegebenen Daten anzuzeigen.
Vorschaudaten helfen Ihnen bei:
- Überprüfen, ob ihre Lakehouse-Tabelle oder -Abfrage die erwarteten Spalten und Werte zurückgibt
- Bestätigen, ob das Ergebnis eine einzelne Zeile oder mehrere Zeilen ist
- Verstehen Sie das Ausgabeformat (
firstRowvsvalue), bevor Sie darauf in Ausdrücken verweisen.
Verwendung der Ausgabe der Lookup-Aktivität
Nachdem die Nachschlageaktivität ausgeführt wurde, werden die Ergebnisse der Abfrage auf der Registerkarte "Ausgabe" zurückgegeben (es sollten dieselben Daten wie in der Vorschaudatenansicht sein). Sie können auf diese Ausgabe in downstream-Aktivitäten verweisen, um dynamische, metadatengesteuerte Pipelines zu fördern.
Sie können die Ausgabe der Nachschlageaktivität über den Ausdrucksgenerator in nachfolgenden Aktivitäten verwenden.
Die Nachschlageausgabe wird häufig für Folgendes verwendet:
- Kontrollverzweigungslogik (z. B. If-Bedingung oder Schalter)
- Durchlaufen von Zeilen mithilfe einer ForEach-Aktivität
In diesem Beispiel wird eine If Condition-Aktivität mithilfe der Ausgabe der Nachschlageaktivität dargestellt.
Unterstützte Funktionen
- Die Lookup-Aktivität kann bis zu 5,000 Zeilen zurückgeben. Wenn das Resultset mehr Datensätze enthält, werden die ersten 5,000 Zeilen zurückgegeben.
- Die Ausgabe der Lookup-Aktivität unterstützt eine Größe bis zu 4 MB. Wenn die Größe diesen Grenzwert überschreitet, schlägt die Aktivität fehl.
- Die Höchstdauer für die Lookup-Aktivität vor dem Timeout beträgt 24 Stunden.
Hinweis
Wenn Sie zum Suchen nach Daten eine Abfrage oder gespeicherte Prozedur verwenden, stellen Sie sicher, dass genau ein und nur ein Resultset zurückgegeben wird. Andernfalls schlägt die Lookup-Aktivität fehl.
Die folgenden Datenquellen werden für Nachschlageaktivitäten unterstützt.
Speichern und ausführen oder die Pipeline planen
Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.
Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.