Usare l'attività Lookup per cercare i dati da un'origine dati

L'attività Fabric Lookup può recuperare un set di dati da qualsiasi origine dati supportata da Microsoft Fabric. È possibile usarlo per determinare in modo dinamico gli oggetti da utilizzare in un'attività successiva, anziché impostare come hardcoded il nome dell'oggetto. Alcuni esempi di oggetti sono file e tabelle.

L'attività Lookup legge e restituisce il contenuto di un file di configurazione o una tabella. Restituisce anche il risultato dell'esecuzione di una query o di una stored procedure. L'output può essere un valore singleton o una matrice di attributi, che possono essere utilizzati in una copia, trasformazione o attività del flusso di controllo successive, ad esempio l'attività ForEach.

Prerequisiti

Per iniziare, è necessario completare i prerequisiti seguenti:

Aggiungere un'attività di ricerca a una pipeline con l'interfaccia utente

Per usare un'attività Lookup in una pipeline, completare la procedura seguente:

Creazione dell'attività

  1. Creare una nuova pipeline nell'area di lavoro.

  2. Cercare Ricerca nel riquadro Attività pipeline e selezionarlo per aggiungerlo all'area di disegno della pipeline.

    Screenshot of the Fabric UI with the Activities pane and Lookup activity highlighted.

  3. Selezionare la nuova attività Lookup nell'area di disegno, se non è già selezionata.

    Screenshot showing the General settings tab of the Lookup activity.

Fare riferimento alle indicazioni generali sulle impostazioni per configurare la scheda Impostazioni generali .

Impostazioni di ricerca

Selezionare la scheda Impostazioni, selezionare una connessione esistente dall'elenco a discesa Connessione ion oppure usare il pulsante + Nuovo per creare una nuova connessione e specificarne i dettagli di configurazione.

Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

L'esempio nell'immagine precedente mostra una connessione di archiviazione BLOB, ma ogni tipo di connessione ha dettagli di configurazione specifici per l'origine dati selezionata.

Funzionalità supportate

  • L'attività Lookup può restituire fino a 5000 righe; se il set di risultati contiene più record, vengono restituite le prime 5000 righe.
  • L'output dell'attività di ricerca supporta fino a 4 MB di dimensioni; l'attività ha esito negativo se la dimensione supera il limite.
  • La durata più lunga per l'attività di ricerca prima del timeout è di 24 ore.

Nota

Quando si usa una query o una stored procedure per cercare i dati, assicurarsi di restituire uno e un set di risultati esatto. In caso contrario, l'attività di ricerca ha esito negativo.

Fabric supporta gli archivi dati elencati nell'articolo panoramica di Connessione or. È possibile usare i dati di qualsiasi origine.

Salvare ed eseguire o pianificare la pipeline

Passare alla scheda Home nella parte superiore dell'editor della pipeline e selezionare il pulsante Salva per salvare la pipeline. Selezionare Esegui per eseguirla direttamente o Pianificare la pianificazione. È anche possibile visualizzare la cronologia di esecuzione qui o configurare altre impostazioni.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.