Tous les produits
Search
Centre de documentation

OpenSearch:Prise en main

Dernière mise à jour :Aug 25, 2026

Prérequis

  1. Vous avez créé un compte Alibaba Cloud en vous inscrivant et avez effectué la vérification d'identité réelle.

  2. Lors de l'activation de votre compte Alibaba Cloud et de la connexion à la console, créez une clé d'accès pour poursuivre.

  • Une clé d'accès est requise pour créer et utiliser des applications. La clé d'accès de votre compte principal ne peut pas être vide.

  • Après avoir créé une clé d'accès pour votre compte principal, vous pouvez également en créer une pour un utilisateur RAM afin d'accéder aux ressources. Accordez les autorisations nécessaires à l'utilisateur RAM. Pour plus d'informations, consultez la rubrique Authentification RAM.

  1. Vous devez disposer d'un environnement Virtual Private Cloud (VPC). Pour plus d'informations, consultez la rubrique Présentation de Virtual Private Cloud (VPC).

Remarque :

Si vous souhaitez utiliser un utilisateur RAM pour gérer une instance OpenSearch Retrieval Engine Edition, utilisez votre compte principal pour accorder les autorisations AliyunSearchEngineFullAccess et AliyunSearchEngineReadOnlyAccess à cet utilisateur RAM.

Achat d'une instance

Pour acheter une instance, consultez la rubrique Achat d'une instance OpenSearch Retrieval Engine Edition.

Configuration d'un cluster

Remarque :

Une instance nouvellement achetée affiche le statut « Pending Configuration » sur sa page de détails. Le système déploie automatiquement un cluster vide correspondant à la quantité et aux spécifications des nœuds de requête et des nœuds de données que vous avez achetés.

1. Sélectionnez l'instance à configurer et cliquez sur Configure.

2. Saisissez un nom de table, sélectionnez le nombre de shards et les ressources de mise à jour des données, puis cliquez sur Next.

Remarque

Name : Composé de lettres, de chiffres ou de traits de soulignement (_), avec une longueur maximale de 25 caractères.

Number of shards : Saisissez un entier positif jusqu'à 256. Les shards améliorent la vitesse de construction de l'index complet et les performances des requêtes uniques.

Data update resources : Nombre de ressources dédiées aux mises à jour de données en temps réel. L'augmentation de cette valeur accroît la concurrence pour la consommation des données en temps réel, ce qui améliore le débit (TPS).

3. Configurez une source de données. Les sources de données prises en charge incluent MaxCompute + API Data Source, OSS + API Data Source, API Data Source et Data Lake Formation (DLF). Après avoir configuré les paramètres, vous pouvez éventuellement activer la reconstruction automatique de l'index. Une fois la source de données validée, cliquez sur Next.

Lors de la configuration d'une source de données MaxCompute, spécifiez les paramètres suivants : AccessKey et AccessKey Secret, Project Name (Project) (3 à 28 caractères ; doit commencer par une lettre et contenir uniquement des lettres, des chiffres et des traits de soulignement), Table Name (Table) (1 à 128 caractères ; doit commencer par une lettre et contenir uniquement des lettres, des chiffres et des traits de soulignement) et Table Partition (Partition) (séparez les partitions multiniveaux par des virgules). Après avoir saisi les informations, cliquez sur Validate. Une fois la source de données validée, cliquez sur Next.

4. Sélectionnez la clé primaire, les champs d'attribut et les champs à afficher dans les résultats de recherche. Indiquez si les données doivent être compressées et sélectionnez l'analyseur pour chaque champ correspondant.

Compression du contenu des attributs et des champs :

  • Les champs d'attribut ne sont pas compressés par défaut. Pour activer la compression, sélectionnez file_compressor.

  • Le contenu des champs n'est pas compressé par défaut. Pour les champs STRING multivalues, la valeur par défaut est uniq. Pour les champs numériques à valeur unique, la valeur par défaut est equal.

Remarque
  • Si vous activez la compression des attributs, nous vous recommandons d'accéder à Cluster Management > Node Status > Table Loading Policy pour ajuster la méthode de chargement de l'index. Cela permet de réduire l'impact sur les performances.

  • Seuls les champs TEXT peuvent être configurés avec un analyseur.

  • La duplication de champ est prise en charge. Un champ dupliqué (champ DUP) possède le même contenu que le champ d'origine. Si vous poussez un contenu incohérent, le contenu du champ d'origine l'écrase. Pour utiliser un contenu différent dans le champ DUP, supprimez la copie de la configuration dans les paramètres avancés du champ DUP.

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

5. Configurez un index pour chaque champ interrogeable, puis cliquez sur Next.

6. Configurez les indexes : sur la page des paramètres d'index, définissez le Index name, le Index type (tel que TEXT ou STRING), les Included fields et la méthode de Data compression. Vous pouvez cliquer sur View/Modify pour ajuster les paramètres avancés. Cliquez sur + pour ajouter une nouvelle ligne d'index. Une fois terminé, cliquez sur Next.

7. Cliquez sur Confirm Creation et attendez la fin de la construction.

Après avoir confirmé que les informations sont correctes, cliquez sur Confirm Creation. Le système construit l'index en utilisant les ressources concurrentes sélectionnées. Une fois la construction terminée, l'index est automatiquement activé dans l'instance actuelle.

Vérification de la progression de la reconstruction de l'index

Dans le volet de navigation de gauche, cliquez sur Change History et sélectionnez une plage de temps au cours des trois derniers jours pour afficher la progression de la construction.

Test d'une requête

Effectuez un test de recherche sur la page Feature Extensions > Query Test. OpenSearch Retrieval Engine Edition prend en charge trois méthodes de requête : HA query, SQL query et REST API query.

Sélectionnez HA query comme méthode de requête. Dans la zone query, saisissez une instruction de requête, telle que id:'1'. Utilisez le format indiqué dans l'indice, par exemple daogou:part_ids=0|2. Définissez les paramètres cluster (par exemple, general) et config (par exemple, start:0,hit:10,format:json). Après soumission, la page affiche l'URL de la requête, le nombre d'enregistrements correspondants, la latence et les valeurs des champs renvoyées.

Notes d'utilisation

Important

  • Seule la méthode de facturation paiement à l'utilisation est prise en charge.

  • Le nom d'utilisateur et le mot de passe définis lors de l'achat de l'instance peuvent être modifiés sur la page de détails de l'instance.

  • Le nom du cluster est attribué par le système lors de l'achat de l'instance et ne peut pas être modifié.

  • Chaque reconstruction d'index est facturée en fonction des ressources consommées.