Usare l'attività Ricerca dati per ricercare i dati in un'origine dati

L'attività di ricerca Fabric può recuperare un set di dati da qualsiasi origine dati supportata da Microsoft Fabric. È possibile usarlo per determinare in modo dinamico gli oggetti su cui operare 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 singolo o un array di attributi, che possono essere utilizzati in attività successive di copia, trasformazione o controllo del flusso, come l'attività ForEach.

Prerequisiti

Per iniziare, è necessario soddisfare i prerequisiti seguenti:

• È necessario avere accesso a un tenant di Microsoft Fabric con una capacità fornita. È possibile try Fabric con una versione di valutazione gratuita.
• Un Fabric spazio di lavoro assegnato a tale capacità.

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

Per utilizzare un'attività di ricerca in una pipeline, completare i seguenti passaggi:

Creazione dell’attività

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

2. Cerca Lookup nel riquadro Attività della pipeline e selezionalo per aggiungerlo all'area di disegno della pipeline.

   

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

   

Fare riferimento alla guida alle impostazioni Generali per configurare la scheda impostazioni Generali.

Impostazioni di ricerca

Selezionare la scheda Impostazioni , selezionare una connessione esistente nell'elenco a discesa Connessione oppure creare una nuova connessione e specificarne i dettagli di configurazione.

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

Pulsante Anteprima dei dati nelle impostazioni dell'attività Ricerca per visualizzare un esempio dei dati restituiti dalla query.

I dati di anteprima consentono di:

• Verificare che la tabella o la query Lakehouse restituisca le colonne e i valori previsti
• Verificare se il risultato è una singola riga o più righe
• Comprendere la forma di output (firstRow vs value) prima di farvi riferimento nelle espressioni

Usare l'output dell'attività di Lookup

Dopo l'esecuzione dell'attività Lookup, restituisce i risultati della query nella scheda Output , che deve corrispondere agli stessi dati nella visualizzazione Dati di anteprima. È possibile fare riferimento a questo output nelle attività downstream per guidare pipeline dinamiche guidate dai metadati.

Sarà possibile usare l'output dell'attività Lookup tramite il generatore di espressioni nelle attività successive.

L'output di Lookup viene comunemente usato per:

• Logica di diramazione del controllo (ad esempio, If Condition o Switch)
• Eseguire il ciclo delle righe usando un'attività ForEach

In questo esempio viene mostrata un'attività If Condition usando l'output dell'attività Lookup.

Funzionalità supportate

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

Per l'attività Lookup sono supportate le origini dati seguenti.

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 Pianifica per pianificare le esecuzioni a intervalli o ore specifici. Per altre informazioni sulle esecuzioni della pipeline, vedere Pianificare le esecuzioni della pipeline.

Dopo l'esecuzione, è possibile monitorare l'esecuzione della pipeline e visualizzare la cronologia di esecuzione dalla scheda Output sotto l'area di disegno.

Contenuto correlato

• Come monitorare le esecuzioni delle pipeline