Utilisation d' Milvus avec IBM App Connect Enterprise

Milvus est une base de données vectorielle open-source à haute performance conçue pour stocker et rechercher efficacement de grands volumes de données non structurées.

Les étapes suivantes vous montrent comment vous connecter à un compte Milvus et configurer un nœud de requête Milvus à l'aide de la découverte de connecteurs.

1. Dans la boîte à outils d' IBM App Connect Enterprise, créez un flux contenant un nœud « Demande d' Milvus ».
2. Sélectionnez le nœud Milvus Request dans le flux pour afficher les propriétés du nœud dans l'éditeur.
3. Dans l'onglet Base, cliquez sur Lancer la découverte du connecteur.
   Un panneau s'affiche, dans lequel vous indiquez le nom du projet de stratégie et les détails du coffre-fort à utiliser lors de la découverte des connecteurs.
4. Spécifiez les détails du projet de politique et de l'espace de stockage à utiliser lors de la découverte des connecteurs :
   1. Dans le champ Projet de stratégie, indiquez le projet de stratégie utilisé pour stocker les stratégies créées lors de la découverte des connecteurs.
      Vous pouvez également créer un nouveau projet de politique en cliquant sur Nouveau, puis en spécifiant le nom du nouveau projet de politique. Cliquez ensuite sur Terminer.
   2. Spécifiez le coffre-fort à utiliser lors de la découverte des connecteurs. Par défaut, les informations d'identification utilisées lors de la découverte du connecteur sont stockées dans un coffre-fort de répertoire externe, qui est un coffre-fort App Connect Enterprise pouvant être utilisé par n'importe quel serveur d'intégration. Vous pouvez également stocker les informations d'identification dans un coffre-fort de serveur d'intégration, qui est créé dans le répertoire de travail du serveur d'intégration et ne peut être utilisé que par ce serveur d'intégration spécifique.
      Pour spécifier le coffre-fort à utiliser pour stocker les informations d'identification, suivez les étapes de la section Utilisation de l'assistant de découverte de connecteur de l 'une des rubriques suivantes :

      • Configuration d'un coffre-fort de répertoire externe
      • Configuration d'une chambre forte de serveur d'intégration
   3. Dans le champ Clé du coffre-fort, entrez la clé du coffre-fort utilisée pour accéder aux informations d'identification stockées dans le coffre-fort. La clé de voûte doit comporter au moins 8 caractères.
   4. Facultatif : Par défaut, l'emplacement et la clé du coffre-fort spécifiés sont enregistrés en tant que préférences dans la boîte à outils afin que les valeurs soient prédéfinies lorsque vous lancez Connector Discovery. Si vous ne souhaitez pas que les préférences soient enregistrées, désélectionnez l'option Enregistrer dans les préférences de l'espace de stockage.
5. Cliquez sur Launch Discovery pour lancer l'assistant Connector Discovery pour le connecteur Milvus.
   La fenêtre de découverte du connecteur s'affiche. Si des connexions (comptes) Milvus (comptes) sont disponibles, une liste de ces connexions s'affiche. S'il n'y a pas de connexions existantes, l'état du connecteur est indiqué comme suit : Milvus est indiqué par Not connected.
   • Si une ou plusieurs Milvus connexions (comptes) sont disponibles, effectuez les étapes suivantes :
     1. Sélectionnez la connexion (compte) que vous souhaitez utiliser en cliquant dessus.
     2. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur l'objet. Par exemple, pour récupérer les collections de Milvus cliquez sur Collections, puis sur Récupérer les collections.
   • S'il n'y a pas de connexions existantes (comptes), effectuez les étapes suivantes :
     1. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur cet objet. Par exemple, pour récupérer les collections de Milvus cliquez sur Collections, puis sur Récupérer les collections.
     2. Cliquez sur Connexion.
        Une fenêtre s'affiche dans laquelle vous pouvez saisir les détails de connexion de votre Milvus compte. Saisissez les informations suivantes dans l'assistant de connexion :

        • Serveur URL : Indiquez l'adresse URL du serveur API qui effectue les appels d'exécution.
        • Token : Le jeton utilisé pour accéder aux points d'extrémité de l'API. Pour obtenir un jeton, utilisez les deux points ( :) pour concaténer le nom d'utilisateur et le mot de passe que vous utilisez pour accéder à votre instance Milvus. Par exemple, root:milvus.
        • Autoriser les certificats auto-signés : Régler sur true (vrai) ou false (faux). La valeur "true" permet d'accepter les certificats auto-signés qui sont fiables et utilisés uniquement dans un environnement de non-production. La valeur par défaut est false.
        • Remplacer le serveur URL : Requis si vous voulez vous connecter à un point d'extrémité dans un réseau privé en utilisant le client de réseau privé, ou si vous voulez remplacer le serveur URL. Spécifiez une valeur prioritaire pour l'hôte et le port du connecteur au format <http or https>://<host_name>:<port>. Si vous n'utilisez pas le client de réseau privé ou si vous n'avez pas besoin d'une dérogation, laissez ce champ vide.
        • Nom du proxy : sélectionnez ou indiquez le nom du proxy que vous souhaitez qu' App Connect utilise pour acheminer les appels du connecteur. Ce champ n'est obligatoire que si les appels doivent passer par un proxy. Lorsque vous utilisez la boîte à outils « IBM App Connect Enterprise », le nom du proxy doit être indiqué sous la forme suivante : {PolicyProjectName}:HTTPProxyPolicyName
     3. Cliquez sur Connexion.

     Pour plus d'informations sur l'identification de ces informations de connexion, consultez la section « Comment utiliser IBM App Connect avec Milvus » dans la documentation sur la livraison continue (CD) de IBM App Connect in containers.

6. Définissez les propriétés requises du connecteur dans l'assistant.
   Vous pouvez également définir des propriétés qui précisent le nombre maximal d'enregistrements à extraire et l'action à entreprendre si cette limite est dépassée.
7. Lorsque vous avez fini de spécifier les propriétés dans l'assistant de découverte de connecteur, cliquez sur Enregistrer.
   Les informations d'identification utilisées pour se connecter à Milvus sont stockées dans le coffre-fort, tandis que les autres détails de connexion sont enregistrés dans la stratégie d' Milvus. Les valeurs des propriétés que vous définissez dans l'assistant sont renvoyées au nœud « Milvus Request » dans l'outil « IBM App Connect Enterprise Toolkit ».
8. Lorsque vous avez terminé la découverte et enregistré les valeurs des propriétés, quittez l'assistant de découverte de connecteur en cliquant sur le X dans le coin supérieur droit de la fenêtre ou en appuyant sur Alt+F4.
9. Revenir à la modification du nœud « Milvus Request » dans la boîte à outils « IBM App Connect Enterprise ».
   Les propriétés du connecteur qui ont été définies dans l'assistant de découverte du connecteur (à l'étape 6) sont maintenant visibles sur le nœud Milvus Request dans l'éditeur de propriétés. L'onglet Basique affiche les valeurs des propriétés Action et Objet que vous avez définies dans l'assistant. Par exemple, si vous avez sélectionné Collections > Récupérer les collections dans l'assistant, les propriétés suivantes s'affichent dans l'onglet « Basic » du nœud :

   • Action - getV2VectordbByDbNameCollectionsList
   • Objet - Collections

   Les valeurs des propriétés Action et Objet sont affichées en lecture seule. Si vous souhaitez modifier ces valeurs, vous pouvez le faire en cliquant à nouveau sur Lancer la découverte du connecteur et en définissant de nouvelles valeurs dans l'assistant de découverte du connecteur.

   La propriété Schema base name spécifie le nom de base des fichiers de schéma qui décrivent le format des messages de demande et de réponse qui sont envoyés et reçus du Milvus connecteur. Le nom de base du schéma est défini automatiquement la première fois que vous exécutez la recherche pour le nœud, et il est basé sur le nom du flux et le nom du nœud actuels. Si vous définissez cette propriété manuellement avant de lancer la découverte pour la première fois, c'est la valeur que vous avez définie qui est utilisée. Si vous renommez les schémas après la découverte, vous devez modifier cette propriété afin qu'elle corresponde au nom de base du schéma utilisé par les schémas renommés dans le projet. Si vous modifiez cette propriété après la recherche, vous devez soit renommer les noms des schémas pour qu'ils correspondent, soit relancer la recherche.

   En fonction de l'action sélectionnée lors de la découverte, l'assistant de découverte de connecteur génère soit un schéma de demande et un schéma de réponse, soit un schéma de réponse uniquement. Un schéma de demande n'est généré que si l'action et l'objet sélectionnés nécessitent un message de demande. Le schéma de demande généré est utilisé pour la validation du message de demande. Si l'action était RETRIEVE ou DELETE, seul le schéma de réponse est renvoyé par le connecteur.

   Les fichiers de schéma générés sont ajoutés au projet et peuvent être utilisés par un nœud de mise en correspondance pour transformer les données d'entrée ou de sortie. Le nom de fichier complet du schéma est dérivé du nom de base du schéma (tel que gen/milvus.Milvus_Request), suffixé par response.schema.json ou request.schema.json. Vous pouvez ouvrir le schéma en cliquant sur Ouvrir le schéma de demande ou Ouvrir le schéma de réponse.

10. Vérifiez que les paramètres de propriété du nœud Milvus Request sont corrects, puis enregistrez le flux de messages.
11. Dans l'onglet Connexion du nœud Milvus Request, la propriété Policy indique le nom de la politique qui contient les détails de l'identité de sécurité à utiliser pour la connexion. La police a un type de Milvus.
    Pour plus d'informations, consultez la Politique relative à Milvus.
12. Facultatif : Définissez la propriété Timeout dans l'onglet Connection pour spécifier le temps (en secondes) pendant lequel le nœud attend que Milvus traite l'opération.
13. L'onglet Filter du nœud Milvus Request contient des propriétés qui contrôlent la manière dont le flux de messages sélectionne les données. Les valeurs initiales de ces propriétés sont tirées des valeurs de propriété qui ont été définies pour le connecteur dans l'assistant de découverte de connecteur Milvus dans l'assistant de découverte de connecteur, y compris les propriétés des options de filtrage et toutes les conditions spécifiées (comme décrit à l'étape 6 ). Ensuite, si vous revenez à l'assistant de découverte de connecteur et que vous modifiez les valeurs des propriétés (en ajoutant de nouvelles conditions, par exemple), ces mises à jour se reflètent dans les propriétés définies pour le nœud.

    Les propriétés des options de filtrage déterminent les objets à utiliser lors de l'exécution du nœud de requête Milvus. Les propriétés Limite du filtre contrôlent le nombre maximum d'éléments à extraire et l'action à entreprendre si la limite est dépassée.

    Vous pouvez modifier les valeurs en cliquant sur Modifier à côté de la valeur que vous souhaitez modifier dans la section Options du filtre, et en changeant les valeurs des propriétés qui ont été définies dans la section Limite du filtre.

    Les valeurs des propriétés peuvent être des valeurs textuelles ou des expressions ESQL ou XPATH qui sont résolues à partir du contenu du message transmis au nœud de requête Milvus lors de son exécution.

14. Dans l'onglet Demande, définissez la propriété Emplacement des données pour spécifier l'emplacement dans l'arborescence du message entrant qui contient les données de l'objet à créer dans l'arborescence Milvus. Ces données constituent la demande envoyée par le nœud de demande Milvus au système Milvus système.
15. Dans l'onglet Résultat, définissez la propriété Emplacement des données de sortie pour spécifier l'emplacement dans l'arbre des messages de sortie qui doit contenir les données de l'enregistrement créé à l'adresse Milvus.
16. Par défaut, les messages de demande sont validés par rapport au schéma de demande généré lors de la découverte du connecteur. Vous pouvez désactiver la validation des demandes ou modifier les paramètres de validation en utilisant les propriétés de validation du nœud Milvus Request.
17. Sauvegarder le flux de messages.