How to update the configuration set for an HBase Search full-text index - ApsaraDB for HBase

Un jeu de configuration définit le schéma et les paramètres Solr d'une collection dans le service Search. Cette rubrique explique comment télécharger le jeu de configuration par défaut, personnaliser le schéma et importer votre propre jeu de configuration.

Prérequis

Avant de commencer, assurez-vous d'avoir :

HBase Shell installé et la liste d'autorisation configurée pour votre cluster HBase. Pour plus d'informations, consultez Utiliser HBase Shell pour accéder au service Search

Télécharger le jeu de configuration par défaut

Le service Search fournit un jeu de configuration intégré nommé _indexer_default. Téléchargez-le comme point de départ avant toute personnalisation.

Exécutez les commandes suivantes dans HBase Shell :

cd alisolr-7.3.8-bin/bin
./solr zk ls /configs                              # List existing configuration sets
./solr zk downconfig -d . -n _indexer_default      # Download _indexer_default to the current directory

Paramètres de la commande ./solr zk downconfig :

Paramètre	Obligatoire	Description	Exemple
`-d`	Oui	Répertoire local où écrire le jeu de configuration téléchargé	`.` (répertoire actuel)
`-n`	Oui	Nom du jeu de configuration à télécharger depuis ZooKeeper	`_indexer_default`

Une fois le téléchargement terminé, un répertoire conf est créé dans le répertoire actuel. Il contient deux fichiers :

managed-schema : définit les champs et les types de champ pour votre index
solrconfig.xml : configure les gestionnaires de requêtes Solr et d'autres paramètres

Définir les champs dans le schéma

Ouvrez le fichier managed-schema pour ajouter les définitions de champ de votre index.

Définir des champs explicites

Ajoutez un élément <field> pour chaque colonne à indexer :

<field name="name" type="string" indexed="true" stored="true" required="false" multiValued="false" />
<field name="age" type="pint" indexed="true" stored="true" docValues="true"  multiValued="false" />

Attributs clés :

Attribut	Description	Valeurs d'exemple
`type`	Type de champ. `pint` correspond à INT, `plong` correspond à LONG.	`string`, `pint`, `plong`
`indexed`	Si la valeur est `true`, le champ est consultable (searchable).	`true`, `false`
`stored`	Si la valeur est `true`, la valeur d'origine est stockée et renvoyée dans les résultats de requête.	`true`, `false`
`docValues`	Si la valeur est `true`, active le tri et les facettes sur le champ.	`true`, `false`
`multiValued`	Si la valeur est `true`, le champ accepte plusieurs valeurs par document.	`true`, `false`

Utiliser dynamicField pour des schémas flexibles (recommandé)

Si vos données comportent de nombreuses colonnes ou si les noms de colonne ne sont pas fixés à l'avance, utilisez dynamicField au lieu de définir explicitement chaque champ. dynamicField fait correspondre les champs par suffixe de nom : tout champ dont le nom se termine par le suffixe défini hérite automatiquement du type et des attributs correspondants.

Le fichier managed-schema inclut déjà des définitions dynamicField par défaut. Lors de l'écriture des données, utilisez un nom de champ correspondant à un suffixe :

name_s correspond automatiquement à *_s et est traité comme un champ de type string
age_i correspond automatiquement à *_i et est traité comme un champ de type pint (INT)

Cette approche évite les modifications fréquentes du fichier managed-schema à mesure que votre schéma évolue.

Importer le jeu de configuration

Après avoir modifié le fichier managed-schema, importez le jeu de configuration dans ZooKeeper sous un nouveau nom. Utilisez un jeu de configuration par collection.

./solr zk upconfig -d conf/ -n myconf

Paramètre	Obligatoire	Description	Exemple
`-d`	Oui	Chemin d'accès au répertoire local du jeu de configuration	`conf/`
`-n`	Oui	Nom à attribuer au jeu de configuration dans ZooKeeper	`myconf`

Pour vérifier l'importation, ouvrez la console web Solr et confirmez que myconf apparaît dans la liste des jeux de configuration.

myconf

Bonnes pratiques

Utilisez dynamicField lorsque c'est possible. La définition des champs avec des suffixes dynamicField évite les modifications fréquentes du fichier managed-schema et simplifie la gestion du schéma.
Un jeu de configuration par collection. Ne partagez pas un seul jeu de configuration entre plusieurs index, car les modifications apportées au schéma affectent toutes les collections qui l'utilisent.
**Partez de _indexer_default.** Téléchargez et modifiez toujours le jeu de configuration par défaut plutôt que d'en créer un à partir de zéro.