OpenSearch:Démarrage rapide

Prérequis

1. Vous devez disposer d'un compte Alibaba Cloud et avoir effectué la vérification d'identité réelle.

2. Lors de votre première connexion à la console Alibaba Cloud, vous êtes invité à créer une AccessKey.

   • Une AccessKey associée à votre compte principal est requise pour créer et utiliser des applications.

   • Après avoir créé une AccessKey pour votre compte principal, vous pouvez également en générer une pour un utilisateur RAM. Accordez les permissions nécessaires à l'utilisateur RAM. Pour plus d'informations, consultez les règles de contrôle d'accès.

Étape 1 : Acheter une application

Connectez-vous à la console OpenSearch. Dans le coin supérieur gauche, sélectionnez OpenSearch-High-performance Search Edition. Sur la page instance management, cliquez sur Create Instance.

Vous pouvez acheter une application selon deux modes de facturation : par abonnement ou paiement à l'utilisation.

Sur la page d'achat, sélectionnez une région et une zone de disponibilité, telles que Chine (Shenzhen) ou Chine (Pékin), saisissez un nom d'application (qui ne pourra pas être modifié après la création) et choisissez une préférence de cluster (dedicated cluster - general-purpose, dedicated cluster - compute-optimized, dedicated cluster - storage-optimized ou shared cluster - general-purpose).

Toujours sur la page d'achat, configurez la capacité de stockage (par exemple, 100 Go), les ressources de calcul (par exemple, 800 LCU), le cycle de facturation (sélectionnez une durée comprise entre 1 et 6 mois et cochez éventuellement l'option Auto-renewal) ainsi que le resource group (le default resource group est sélectionné par défaut). Cliquez ensuite sur Buy Now pour passer commande.

Étape 2 : Configurer l'application

Une fois l'application initialisée, son statut passe à Pending. Cliquez sur Configure pour définir le schéma de l'application.

L'assistant de configuration vous guide à travers quatre étapes : Application schema → Index schema → Data source → Finish. Lors de la première étape, choisissez une méthode pour créer le schéma de l'application. Les options disponibles sont Create from data source, Create manually, Create from template et Create by uploading documents. Après avoir fait votre choix, cliquez sur Next.

Définir le schéma de l'application

Quatre méthodes permettent de créer un schéma d'application.

Méthodes de définition d'un schéma d'application :

1. Créer un schéma d'application à partir d'un modèle. Vous pouvez enregistrer un schéma d'application configuré sous forme de modèle afin de créer rapidement de nouvelles applications.

2. Créer un schéma d'application en téléchargeant des documents. Téléchargez un fichier de données existant (au format JSON uniquement). Le système analyse automatiquement le fichier pour générer un schéma d'application initial. Vous devrez ensuite redéfinir les types de champs et d'autres paramètres.

3. Créer un schéma d'application à partir d'une source de données. Cette approche est idéale pour synchroniser des données provenant de sources telles que RDS et MaxCompute. Elle permet de générer rapidement un schéma d'application initial basé sur le schéma de la table source, ce qui réduit les efforts manuels et limite les risques d'erreur. Cette section utilise RDS à titre d'exemple. La procédure est similaire pour les autres sources de données. Pour plus de détails, consultez la rubrique Configurer une source de données.

   Sélectionnez l'onglet Create from data source. Dans le panneau Select Data Source qui s'affiche à droite, choisissez RDS puis cliquez sur + New Database Connection.

   Dans la boîte de dialogue Connect to Database, saisissez l'ID de l'instance RDS, le nom de la base de données, le nom d'utilisateur et le mot de passe, puis cliquez sur Connect.

4. Créer manuellement un schéma d'application. Utilisez cette méthode si les autres options ne correspondent pas à votre scénario.

   Sur la page Create manually, saisissez un nom de table (par exemple, main) et sélectionnez Primary table. Dans la zone de définition des champs, définissez les noms des champs (par exemple, id et name), cochez le bouton radio primary key pour l'un des champs et choisissez un type pour chaque champ (tel que INT ou LITERAL). Les types de champs sélectionnés influencent la configuration ultérieure des champs d'index et d'attributs. Cliquez sur + pour ajouter d'autres champs.

Définir le schéma d'index

• Créez un index pour tout champ utilisé dans une clause query. Les champs de type flottant ne peuvent pas être configurés comme index. Pour plus d'informations, consultez le schéma de table OpenSearch.

• Créez des champs d'attribut pour les champs utilisés dans les clauses filter, sort ou dans les fonctions.

• Les types de champs tokenisés, tels que TEXT et SHORT_TEXT, ne peuvent pas être configurés en tant que champs d'attribut. Seuls les types de champs numériques et non tokenisés, tels que int, int_array, float, float_array, double, double_array, literal et literal_array, peuvent être configurés en tant que champs d'attribut.

  À l'étape Index schema, configurez trois sections : Index Fields, où vous définissez le nom de l'index, les champs inclus et la méthode d'analyse (comme chinese - general analysis ou keyword), par exemple query=default:"cloud search" ; Attribute fields, qui permet d'utiliser les champs dans les clauses filter, aggregate, sort et distinct, par exemple filter=id>100000 ; et Default Display Fields, qui garantit que les valeurs de ces champs sont renvoyées dans les résultats de recherche. Une fois la configuration terminée, cliquez sur Next pour configurer la source de données.

Synchroniser la source de données

1. Associez une source de données. Une fois l'association établie, sélectionnez les tables de données, cliquez sur >> pour les ajouter, puis confirmez votre sélection.

2. Après confirmation, la page de mappage des champs s'affiche. Sélectionnez Add Data. OpenSearch mappe automatiquement les champs source aux champs d'application portant le même nom. Mappez manuellement les champs dont les noms diffèrent.

3. Sur la page de mappage des champs, vous pouvez également configurer des plug-ins de source de données. Pour plus d'informations, consultez la documentation sur les plug-ins de source de données.

   Remarque

   Pour la synchronisation des données en temps réel, consultez la rubrique Synchronisation en temps réel DTS.

4. Finalisez la création.

Étape 3 : Tester la recherche

Une fois vos données chargées, vous pouvez tester la fonctionnalité de recherche. La console OpenSearch propose une page intégrée Search test. Vous pouvez configurer les clauses de requête et les paramètres pour exécuter des tests selon vos besoins (pour plus de détails, consultez l'aperçu de l'API et l'introduction au SDK). Cette section prend la page Search Test comme exemple. Pour tester votre configuration de recherche, cliquez sur l'icône + située à côté d'une clause ou d'un paramètre, sélectionnez un élément dans la liste déroulante, saisissez le contenu correspondant, puis cliquez sur Search.

Utilisation

1. Dans le volet de navigation de gauche, choisissez Feature Extensions > Search test. Saisissez une requête dans la clause de requête requise.

   Sélectionnez Online application. Dans la clause config, définissez start:0,hit:10,format:fulljson, puis cliquez sur Search pour afficher les résultats.

2. Vous pouvez également ajouter d'autres clauses et paramètres.

   Cliquez sur l'icône + pour ajouter une clause. Vous pouvez sélectionner une clause filter, une clause sort, une clause distinct, une clause aggregate, une clause kvpairs ou une clause config.

   Cliquez sur l'icône + à côté de Parameters pour ajouter un paramètre. Les paramètres disponibles incluent les champs d'affichage (fetch_fields), l'analyse de requête (qp), first_rank_name (expression de tri grossier), second_rank_name (expression de tri fin), le type de plug-in de tri fin (second_rank_type), la configuration du résumé (summary), la prédiction de catégorie (category_prediction), la requête brute (raw_query), la politique de re-recherche (re_search), les informations métier (biz), l'ID de la demande de recherche (from_request_id), l'ID utilisateur (user_id), le test A/B (abtest), la désactivation (disable) et les paramètres personnalisés (custom).

Informations complémentaires

Clauses

Clause de requête : Consultez la documentation relative à la clause de requête.

Clause de filtre : Consultez la documentation relative à la clause de filtre.

Clause de tri : Consultez la documentation relative à la clause de tri.

Clause distinct : Consultez la documentation relative à la clause distinct.

Clause aggregate : Consultez la documentation relative à la clause aggregate.

Clause kvpairs : Consultez la documentation relative à la clause kvpairs.

Clause config : Consultez la documentation relative à la clause config.

Paramètres

Champs d'affichage (fetch_fields) : Spécifie les champs à renvoyer dans les résultats. Séparez les noms de plusieurs champs par des points-virgules (;).

Analyse de requête (qp) : Spécifie le nom de la règle d'analyse de requête.

first_rank_name (expression de tri grossier) : Spécifie le nom de l'expression de tri grossier.

second_rank_name (expression de tri fin) : Spécifie le nom de l'expression de tri fin.

Configuration du résumé (summary) : Configure le résumé des résultats de recherche. Pour plus d'informations, consultez la rubrique Résumé des résultats de recherche.

Prédiction de catégorie et requête brute : Spécifiez le nom de la prédiction de catégorie et les termes de la requête.

Politique de re-recherche (re_search) : Définit la politique de re-recherche. Pour plus d'informations, consultez la rubrique Traitement de la recherche.

Pour les informations métier (biz) et l'ID utilisateur, consultez la rubrique Traitement de la recherche.

Test A/B : Spécifie le nom du test A/B.

Désactivation (disable) : Désactive une fonctionnalité spécifiée. Par exemple, disable=qp.

Pour plus de détails sur les fonctionnalités avancées, consultez la documentation produit correspondante.