OpenSearch:Source de données API

Cette rubrique explique comment ajouter une table en utilisant une API comme source de données.

Ajouter une table

1. Sur la page Instance Details > Table Management, cliquez sur Add Table.

2. Saisissez les informations de base de la table, puis cliquez sur Next.

Description de la configuration :

• Table Name : Saisissez un nom personnalisé.

• Number of Shards : Saisissez un entier positif jusqu'à 256. Ce paramètre améliore la vitesse des constructions complètes et les performances des requêtes individuelles. Pour certaines instances existantes, toutes les tables d'index doivent avoir le même nombre de shards. Vous pouvez également définir un seul shard pour une table d'index, tandis que toutes les autres partagent le même nombre de shards.

• Data update resources : Nombre de ressources utilisées pour les mises à jour des données. Par défaut, chaque index inclut gratuitement deux ressources de mise à jour (4 cœurs, 8 Go). Les ressources dépassant ce quota gratuit sont facturées. Pour plus d'informations, consultez la section ou Vector Search Edition International Website Billing Document.

• Scenario Template : La version Vector Search propose trois modèles intégrés : General, Vector - Image Search et Vector - Text Semantics.

3. Configurez la source de données pour la synchronisation, puis cliquez sur Next.

Description des paramètres :

• Data Source Type : Sélectionnez API. Cela indique que les données sont poussées vers l'instance via une API.

4. Configurez les champs, puis cliquez sur Next.

   Remarque

   • Le champ de clé primaire et le champ de vecteur sont obligatoires. Le champ de clé primaire doit être de type int ou string ; sélectionnez l'option Primary Key. Le champ de vecteur doit être de type float ; sélectionnez l'option Vector Field.

   • Par défaut, le champ de vecteur est de type float multivaleur. Le séparateur multivaleur par défaut est le séparateur ha3 ^] (encodé en UTF-8 sous la forme \x1D), utilisé pour fractionner les valeurs. Vous pouvez également spécifier un séparateur personnalisé.

   • Si un champ est manquant ou vide dans les données, le système le remplit automatiquement avec une valeur par défaut : 0 pour les types numériques et une chaîne vide pour le type STRING. Vous pouvez également spécifier une valeur par défaut personnalisée.

5. Configurez le schéma d'index, puis cliquez sur Next.

Cette section permet de configurer l'index vectoriel :

• Les champs de clé primaire et de vecteur sont obligatoires. Le champ namespace est facultatif et peut rester vide.

• La sélection se limite à ces trois champs fixes. Il n'est pas possible d'ajouter de nouveaux champs.

• Vector Dimensions : Sélectionnez le nombre de dimensions en fonction des vecteurs générés par votre modèle.

• Distance Metric : Choisissez la métrique de distance adaptée aux vecteurs générés par votre modèle. Le système prend en charge deux types de métriques : SquareEuclidean et InnerProduct.

• Vector Index Algorithm : Sélectionnez l'algorithme correspondant aux vecteurs générés par votre modèle. Le système prend en charge les algorithmes d'index vectoriel suivants : Quantized Clustering, linear et HNSW (Hierarchical Navigable Small World).

• Real-time Index : Indique si un index vectoriel en temps réel doit être construit pour les données incrémentielles provenant de l'API. La valeur par défaut est true.

Pour les autres configurations avancées, développez la section. Pour la description des paramètres, consultez la rubrique General configurations for vector indexes.

6. Confirmez la configuration. Après avoir cliqué sur Confirm, le système crée automatiquement la table selon vos spécifications.

Consultez la progression de la création dans l'historique des modifications.

7. Lorsque l'état de la table passe à In Use, testez les requêtes sur la page Query Test.

Notes

• Lors d'une construction complète pour une source de données API, toutes les données précédemment poussées sont effacées. Le système commence alors à synchroniser les données en temps réel à partir de l'horodatage spécifié. Faites donc preuve de prudence lors d'une construction complète pour une source de données API.