Tous les produits
Search
Centre de documentation

ApsaraDB for HBase:Accès via le Shell

Dernière mise à jour :Aug 10, 2026

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.

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