Partager via


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

L’activité de Recherche Fabric 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.

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 :

Ajoutez une activité 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 nouveau pipeline dans votre espace de travail.

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

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

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

    Screenshot showing the General settings tab of the Lookup activity.

Reportez-vous aux instructions relatives aux paramètres Général pour configurer l’onglet Paramètres Général .

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 nouvelle connexion et spécifiez ses détails de configuration.

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

L’exemple de 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é 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é Recherche prend en charge une taille maximale fixée à 4 Mo. L’activité ne peut pas s’exécuter correctement si la taille limite est dépassée.
  • La durée la plus longue pour l’activité de recherche avant l’expiration du délai d’attente est de 24 heures.

Remarque

Lorsque vous utilisez une requête ou une procédure stockée pour rechercher des données, veillez à retourner un seul et unique 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 et 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 d'exécution ici ou configurer d'autres paramètres.

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