bin/solr (alisolr) est un outil en ligne de commande pour gérer les index du service Search sur ApsaraDB for HBase. Créez et listez des collections, et gérez les ensembles de configuration dans ZooKeeper (ZK).
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Une instance ApsaraDB for HBase avec le service Search activé
Un accès réseau à l'instance (réseau interne ou Internet)
Téléchargement et configuration du Shell HBase
Téléchargement et décompression du package
curl -O https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/alisolr-7.3.8-bin.tar.gz
tar -zxvf alisolr-7.3.8-bin.tar.gz
Cette opération crée le répertoire alisolr-7.3.8-bin.
Configuration de la connexion ZooKeeper
Modifiez le fichier alisolr-7.3.8-bin/conf/solr.in.sh. Repérez la ligne SOLR_ZK_HOST, supprimez le caractère # en début de ligne et définissez l'adresse ZooKeeper de votre instance :
SOLR_ZK_HOST="ld-xxxx-proxy-zk.hbaseue.9b78df04-b.rds.aliyuncs.com:2181/solr"
Pour obtenir l'adresse ZooKeeper, accédez à la page des détails de votre instance Search et cliquez sur Database Connection afin d'afficher l'adresse Client Address.

L'adresse affichée sur la page des détails est une adresse de réseau interne. Pour accéder au service Search via Internet, cliquez sur Enable Internet Access sur la page des détails, puis définissez SOLR_ZK_HOST avec l'adresse IP publique fournie.
Gestion des collections et des ensembles de configuration
Exécutez toutes les commandes depuis le répertoire alisolr-7.3.8-bin/bin. Démarrez le shell :
./solr
Création d'une collection
./solr create_collection -c <collection-name> -n <config-set-name> -shards <shard-count>
| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
-c |
Oui | Nom de la collection à créer | testIndex |
-n |
Oui | Nom de l'ensemble de configuration à utiliser | _indexer_default |
-shards |
Oui | Nombre de shards | 2 |
Exemple : Créez une collection nommée testIndex avec 2 shards, en utilisant l'ensemble de configuration par défaut :
./solr create_collection -c testIndex -n _indexer_default -shards 2
Liste des collections
./solr list_collections
Gestion des ensembles de configuration
Avant de créer une collection avec une configuration personnalisée, téléchargez un ensemble de configuration dans ZooKeeper.
Le service Search fournit un ensemble de configuration par défaut (_indexer_default) que vous pouvez télécharger, modifier et uploader sous votre propre nom.
Téléchargement d'un ensemble de configuration
./solr zk downconfig -d . -n _indexer_default
| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
-d |
Oui | Répertoire local où sauvegarder l'ensemble de configuration | . (répertoire actuel) |
-n |
Oui | Nom de l'ensemble de configuration dans ZooKeeper | _indexer_default |
Après l'exécution de cette commande, un sous-dossier conf est créé dans le répertoire actuel. Il contient les fichiers de l'ensemble de configuration _indexer_default.
Upload d'un ensemble de configuration
Une fois les fichiers du dossier conf modifiés, uploadez-les en tant qu'ensemble de configuration personnalisé :
./solr zk upconfig -d conf -n myConf
| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
-d |
Oui | Répertoire local contenant l'ensemble de configuration | conf |
-n |
Oui | Nom à attribuer à l'ensemble de configuration dans ZooKeeper | myConf |
Liste des ensembles de configuration
./solr zk ls /configs
Création d'une collection avec un ensemble de configuration personnalisé
Après avoir uploadé un ensemble de configuration personnalisé, créez une collection qui l'utilise :
./solr create_collection -c myIndex -n myConf -shards 2