All Products
Search
Document Center

Lindorm:Add an HBase data source

Last Updated:Mar 28, 2026

Add an HBase data source to a Lindorm Tunnel Service (LTS) instance to migrate or synchronize data from HBase to Lindorm.

Choose your method

Select the method based on your cluster type and network topology:

Cluster typeNetworkMethod
ApsaraDB for HBase Standard EditionSame VPC as LTSUse the Lindorm console
ApsaraDB for HBase Standard EditionDifferent VPC from LTSUse the LTS web UI
ApsaraDB for HBase Performance-enhanced EditionSame VPC as LTSUse the Lindorm console
ApsaraDB for HBase Performance-enhanced EditionDifferent VPC from LTSAdd a LindormTable data source
Self-managed HBase clusterAnyUse the LTS web UI
E-MapReduce (EMR) HBase clusterAnyUse the LTS web UI

Use the Lindorm console to add an HBase data source

Use this method when your ApsaraDB for HBase cluster and LTS instance are in the same virtual private cloud (VPC).

Prerequisites

Before you begin, ensure that you have:

  • An LTS instance

  • An ApsaraDB for HBase Standard Edition or Performance-enhanced Edition cluster in the same VPC as the LTS instance

Steps

  1. Log on to the Lindorm console.

  2. On the Instances page, click the ID of an LTS instance.

  3. In the left-side navigation pane, click Data Sources.

  4. On the HBase Data Source tab, click Add Data Source.

  5. In the Add Data Source dialog box, configure the following parameters.

    ParameterRequiredDescription
    Instance TypeYesSelect HBase Enhanced Edition or ApsaraDB for HBase Standard Edition.
    RegionYesSelect the region where the data source cluster is deployed.
    Instance IDYesSelect the ID of the data source cluster. The cluster must be in the same VPC as the LTS instance.
  6. Click OK.

The data source is added when its status changes to Associated.

Use the LTS web UI to add an HBase data source

Use this method for self-managed HBase clusters, EMR HBase clusters, or ApsaraDB for HBase clusters in a different VPC from your LTS instance.

Prerequisites

Before you begin, ensure that you have:

  • An activated LTS instance with access to the LTS web UI. For setup instructions, see Purchase the LTS service and log on to the LTS web UI.

  • The ZooKeeper node addresses, ZooKeeper port, and HDFS connection URL of the HBase cluster

  • For self-managed or EMR HBase clusters: the /etc/hosts file of the HBase cluster

Steps

  1. In the left-side navigation pane of the LTS web UI, choose Data Source Manage > Add Data Source.

  2. On the Add data source page, configure the following parameters.

    ParameterRequiredDescription
    NameYesA name for the HBase data source.
    Data Source TypeYesThe version of the HBase data source. Select one of the following values: HBase1x (ApsaraDB for HBase V1.0), HBase2x (ApsaraDB for HBase V2.0), HBase098 (self-managed HBase V0.98), HBase094 (self-managed HBase V0.94).
    ParametersYesThe JSON configuration for connecting to the HBase data source. See Configure the Parameters field.
    Cluster/etc/hostsOnly for EMR or self-managed clustersThe /etc/hosts file of the HBase cluster, which maps hostnames to IP addresses for each node.
  3. Click Add.

Configure the Parameters field

Paste the following JSON template into the Parameters field and replace the placeholder values.

{
  "clusterKey": "<zk-host-1>,<zk-host-2>,<zk-host-3>:2181:/hbase",
  "hbaseDir": "/hbase",
  "hdfsUri": "hdfs://<namenode-1>:8020,<namenode-2>:8020"
}
ParameterRequiredDescription
clusterKeyYesThe ZooKeeper connection string, in the format <zk-host-1>,<zk-host-2>,<zk-host-3>:<port>:<znode-parent-path>. The <znode-parent-path> is the value of zookeeper.znode.parent in the HBase cluster configuration. Append the port number 2181 only to the last ZooKeeper host.
hbaseDirYesThe HDFS path for the HBase data, which is the value of hbase.rootdir in the cluster configuration. Specify the lowest-level directory without the hdfs:// prefix. For example, if hbase.rootdir is hdfs://hbase/hbase, set hbaseDir to /hbase.
hdfsUriYesThe HDFS connection URL. For a high-availability cluster: hdfs://<namenode-1>:8020,<namenode-2>:8020. For a single-node cluster: hdfs://<namenode>:8020. Use the fully qualified domain name for each NameNode, and append port 8020 to each NameNode address.