All Products
Search
Document Center

ApsaraDB for HBase:Activate the Search service

Last Updated:Mar 28, 2026

The Search service adds full-text index capability to ApsaraDB for HBase Enhanced Edition by linking it to a Big Data Service (BDS) cluster. This topic describes how to activate the service and verify that all instances are running.

Prerequisites

Before you begin, ensure that you have:

  • An ApsaraDB for HBase Enhanced Edition cluster

  • A Big Data Service (BDS) cluster in the same virtual private cloud (VPC) as the HBase cluster

If you don't have these clusters, purchase them from the ApsaraDB for HBase product page or create them directly in the HBase console using Create HBase Cluster and Create BDS Cluster.

Cluster

Activate the Search service

Warning

After you associate a BDS cluster with an HBase cluster, the BDS cluster cannot be linked to any other cluster or used for other purposes. Proceed with caution.

Warning

During activation, both the HBase cluster and BDS cluster are automatically upgraded to the latest version. The system may become unstable during the upgrade. Activate the service during off-peak hours to minimize impact on your workloads.

  1. Log in to the ApsaraDB for HBase Enhanced Edition console and click Full-text Index in the left-side navigation pane.

    Open Full-text Index

  2. Select the BDS cluster to associate.

    Note

    Only BDS clusters in the same VPC as your HBase Enhanced Edition cluster are available. A BDS cluster already linked to another HBase cluster in a full-text index configuration cannot be selected.

  3. Select the cluster type. The Search service requires large memory capacity and high disk I/O performance. Use a high-capacity standard solid-state drive (SSD) and local SSD for the cluster. If you have questions about cluster specifications, contact customer service through the ApsaraDB for HBase Q&A DingTalk group or submit a ticket.

Verify the activation

After activation, three instances appear in the console:

Instance typeExample ID
ApsaraDB for HBase Enhanced Editionld-t4n33q6tj8hexxxx
BDSbds-t4n579vl2f74xxxx
Searchld-t4n33q8he022kxxxx-m1-se

In the Service/Version/Primary Instance column, both the BDS instance and the Search instance show the associated HBase instance ID (ld-t4n33q8he022kxxxx).

The Search service is ready when all three instances show a status of Running.

Status

What's next

  • Use the Search service to run full-text queries on your HBase data.

  • Monitor the Search instance status in the HBase console.