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

L'attività Ricerca infrastruttura può recuperare un set di dati da una qualsiasi delle origini dati supportate da Microsoft Fabric. È possibile usarlo per determinare in modo dinamico gli oggetti da usare in un'attività successiva, anziché codificare il nome dell'oggetto. Alcuni esempi di oggetti sono file e tabelle.

Importante

Microsoft Fabric è attualmente in ANTEPRIMA. Queste informazioni si riferiscono a un prodotto di versione preliminare che può essere modificato sostanzialmente prima che venga rilasciato. Microsoft non garantisce alcuna garanzia, espressa o implicita, rispetto alle informazioni fornite qui. Vedere Azure Data Factory documentazione per il servizio in Azure.

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 usati 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à Di ricerca 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à della pipeline e selezionarlo per aggiungerlo all'area di disegno della pipeline.

    Screenshot dell'interfaccia utente di Fabric con il riquadro Attività e l'attività Ricerca evidenziata.

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

    Screenshot che mostra la scheda Impostazioni generali dell'attività Ricerca.

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

Lookup settings

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

Screenshot che mostra la scheda Impostazioni attività ricerca evidenziando la scheda e dove scegliere una nuova connessione.

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

Funzionalità supportate

  • L'attività Ricerca può restituire fino a 5000 righe; se il set di risultati contiene più record, vengono restituite le prime 5000 righe.
  • L'output dell'attività 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à Ricerca prima del timeout è di 24 ore.

Nota

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

Fabric supporta gli archivi dati elencati nell'articolo Panoramica del connettore . I dati provenienti da qualsiasi origine possono essere usati.

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 eseguirlo direttamente o Pianificare per pianificarlo. È anche possibile visualizzare la cronologia di esecuzione qui o configurare altre impostazioni.

Screenshot che mostra la scheda Home nell'editor della pipeline con il nome della scheda, Salva, Esegui e Pianifica pulsanti evidenziati.

Passaggi successivi

Come monitorare le esecuzioni della pipeline