Utiliser l’activité de recherche pour rechercher des données à partir d’une source de données

L’activité De recherche d’infrastructure peut récupérer un jeu de données à partir de n’importe quelle source de données prise en charge par Microsoft Fabric. Vous pouvez l’utiliser pour déterminer de manière dynamique sur quels objets intervenir dans une activité ultérieure, au lieu de coder en dur le nom d’objet. Les fichiers et les tables constituent quelques exemples d’objet.

Important

Microsoft Fabric est actuellement en préversion. Certaines informations portent sur un produit en préversion susceptible d’être substantiellement modifié avant sa publication. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici. Reportez-vous à la documentation Azure Data Factory pour le service dans Azure.

L’activité Lookup lit et retourne le contenu d’une table ou d’un fichier de configuration. Elle retourne également le résultat de l’exécution d’une requête ou d’une procédure stockée. La sortie peut être une valeur singleton ou un tableau d’attributs, qui peut être consommé dans des activités ultérieures de copie, de transformation ou de flux de contrôle comme l’activité ForEach.

Prérequis

Pour commencer, vous devez remplir les conditions préalables suivantes :

Ajouter une activité de recherche à un pipeline avec l’interface utilisateur

Pour utiliser une activité Lookup dans un pipeline, effectuez les étapes suivantes :

Création de l’activité

  1. Créez un pipeline dans votre espace de travail.

  2. Recherchez dans le volet Activités du pipeline, puis sélectionnez-le pour l’ajouter au canevas du pipeline.

    Capture d’écran de l’interface utilisateur d’infrastructure avec le volet Activités et l’activité de recherche mis en évidence.

  3. Sélectionnez la nouvelle activité de recherche sur le canevas si elle n’est pas déjà sélectionnée.

    Capture d’écran montrant l’onglet Paramètres généraux de l’activité De recherche.

Reportez-vous à l’aide relative aux paramètres généraux pour configurer l’onglet Paramètres généraux .

Paramètres de recherche

Sélectionnez l’onglet Paramètres , sélectionnez une connexion existante dans la liste déroulante Connexion , ou utilisez le bouton + Nouveau pour créer une connexion et spécifiez ses détails de configuration.

Capture d’écran montrant l’onglet Paramètres de l’activité de recherche mettant en évidence l’onglet et l’emplacement où choisir une nouvelle connexion.

L’exemple dans l’image précédente montre une connexion de stockage d’objets blob, mais chaque type de connexion a ses propres détails de configuration spécifiques à la source de données sélectionnée.

Fonctionnalités prises en charge

  • L’activité De recherche peut retourner jusqu’à 5 000 lignes ; si le jeu de résultats contient plus d’enregistrements, les 5 000 premières lignes sont retournées.
  • La sortie de l’activité de recherche prend en charge jusqu’à 4 Mo de taille ; l’activité échoue si la taille dépasse la limite.
  • La durée la plus longue pour l’activité de recherche avant l’expiration du délai d’attente est de 24 heures.

Notes

Lorsque vous utilisez une requête ou une procédure stockée pour rechercher des données, veillez à retourner un jeu de résultats et exactement un seul jeu de résultats. Dans le cas contraire, l’activité de recherche échoue.

Fabric prend en charge les magasins de données répertoriés dans l’article Vue d’ensemble du connecteur . Les données de n’importe quelle source peuvent être utilisées.

Enregistrer et exécuter ou planifier le pipeline

Basculez vers l’onglet Accueil en haut de l’éditeur de pipeline, puis sélectionnez le bouton Enregistrer pour enregistrer votre pipeline. Sélectionnez Exécuter pour l’exécuter directement ou Planifier pour le planifier. Vous pouvez également afficher l’historique des exécutions ici ou configurer d’autres paramètres.

Capture d’écran montrant l’onglet Accueil dans l’éditeur de pipeline avec le nom de l’onglet, les boutons Enregistrer, Exécuter et Planifier mis en évidence.

Étapes suivantes

Guide pratique pour surveiller les exécutions de pipelines