全部产品
Search
文档中心

ApsaraDB for HBase:Gunakan API Java ApsaraDB for HBase untuk mengakses instance ApsaraDB for HBase Performance-enhanced Edition

更新时间:Jun 29, 2025

Topik ini menjelaskan cara menggunakan API Java yang disediakan oleh ApsaraDB for HBase untuk mengakses instance ApsaraDB for HBase Performance-enhanced Edition.

Prasyarat

  • ApsaraDB for HBase SDK for Java telah diinstal. Untuk informasi lebih lanjut, lihat Unduh ApsaraDB for HBase SDK for Java.

  • Jika Anda terhubung ke instance ApsaraDB for HBase Performance-enhanced Edition melalui jaringan internal, pastikan bahwa sebuah Instance ECS (Elastic Compute Service) telah dibeli. Instance ECS tersebut harus berada dalam virtual private cloud (VPC) yang sama dengan instance ApsaraDB for HBase Performance-enhanced Edition. Pastikan alamat IP dari instance ECS termasuk dalam daftar putih alamat IP dari instance ApsaraDB for HBase Performance-enhanced Edition.

    • Untuk informasi lebih lanjut tentang cara membeli instance ECS, lihat Buat Instance ECS.

    • Untuk informasi lebih lanjut tentang cara mengonfigurasi daftar putih alamat IP untuk instance ApsaraDB for HBase Performance-enhanced Edition, lihat Konfigurasikan Daftar Putih.

  • Jika Anda terhubung ke instance ApsaraDB for HBase Performance-enhanced Edition melalui Internet, pastikan bahwa daftar putih alamat IP telah dikonfigurasi untuk instance tersebut. Untuk informasi lebih lanjut, lihat Konfigurasikan Daftar Putih.

  1. Salin konfigurasi koneksi klien.

    1. Masuk ke Konsol ApsaraDB for HBase.

    2. Di halaman Clusters, temukan instance yang ingin dikelola dan klik ID instance.

      Instances

    3. Di panel navigasi sisi kiri halaman instance details page, klik Database Connection.

    4. Di halaman Koneksi Database, klik Generate Configuration Items. Di kotak dialog Client Connection Configuration, klik tab Java Configuration, dan salin kode Java.

      Java Configuration

  2. Inisialisasi klien. Tempelkan kode Java configuration yang disalin ke file proyek Java Anda untuk membuat klien.

    // Buat objek Configuration sebagai klien.
    Configuration conf = HBaseConfiguration.create();
    // Tentukan titik akhir instance ApsaraDB for HBase Anda. Di konsol ApsaraDB for HBase, navigasikan ke halaman detail instance dan klik Koneksi Database. Di bagian Informasi Koneksi, Anda dapat memperoleh titik akhir publik atau titik akhir yang menghadap VPC. Jika Anda terhubung ke instance melalui Internet, gunakan titik akhir publik. Jika Anda terhubung ke instance melalui VPC, gunakan titik akhir yang menghadap VPC.
    conf.set("hbase.zookeeper.quorum", "ld-xxxx-proxy-hbaseue.hbaseue.xxx.rds.aliyuncs.com:30020");
    // Tentukan nama pengguna dan kata sandi yang digunakan untuk mengakses instance. Secara default, nama pengguna dan kata sandi adalah root. Anda dapat mengubahnya sesuai kebutuhan.
    conf.set("hbase.client.username", "root");
    conf.set("hbase.client.password", "root");
    
    // Jika Anda menambahkan dependensi alihbase-client dalam proyek pengembangan Anda, Anda tidak perlu mengonfigurasi parameter connection.impl. Jika Anda menambahkan dependensi alihbase-connector dalam proyek pengembangan Anda, Anda harus mengonfigurasi parameter connection.impl.
    //conf.set("hbase.client.connection.impl", AliHBaseUEClusterConnection.class.getName());
  3. Buat koneksi ke instance ApsaraDB for HBase.

    Buat objek Connection untuk menghubungkan objek Configuration ke instance ApsaraDB for HBase.

    // Buat koneksi ke instance ApsaraDB for HBase. Anda hanya perlu membuat satu koneksi selama siklus hidup klien. Koneksi ini aman secara thread dan dapat dibagikan oleh semua thread. 
    // Setelah klien menyelesaikan beban kerja, objek Connection harus ditutup untuk mencegah kebocoran koneksi. 
    // Anda juga dapat mengeksekusi pernyataan try finally untuk mencegah kebocoran koneksi.
    Connection connection = ConnectionFactory.createConnection(conf);
  4. Setelah koneksi dibuat, Anda dapat menggunakan API Java ApsaraDB for HBase untuk mengakses instance ApsaraDB for HBase Performance-enhanced Edition. Bagian berikut menyediakan contoh dalam format Java:

    • Pernyataan DDL

      try (Admin admin = connection.getAdmin()){
          // Buat tabel.
          HTableDescriptor htd = new HTableDescriptor(TableName.valueOf("tablename"));
          htd.addFamily(new HColumnDescriptor(Bytes.toBytes("family")));
          // Buat tabel yang hanya memiliki satu partisi.
          // Kami merekomendasikan agar Anda melakukan pre-split tabel berdasarkan data yang akan disimpan saat Anda membuat tabel di lingkungan produksi.
          admin.createTable(htd);
            
          // Nonaktifkan tabel.
          admin.disableTable(TableName.valueOf("tablename"));
            
          // Potong tabel.
          admin.truncateTable(TableName.valueOf("tablename"), true);
            
          // Hapus tabel.
          admin.deleteTable(TableName.valueOf("tablename"));
      }
    • Pernyataan DML

      // Tabel adalah objek yang tidak aman secara thread. Saat sebuah thread melakukan operasi pada tabel, thread tersebut harus mendapatkan objek tabel yang diperlukan dari koneksi.
      try (Table table = connection.getTable(TableName.valueOf("tablename"))) {
          // Masukkan data.
          Put put = new Put(Bytes.toBytes("row"));
          put.addColumn(Bytes.toBytes("family"), Bytes.toBytes("qualifier"), Bytes.toBytes("value"));
          table.put(put);
      
          // Baca satu baris data.
          Get get = new Get(Bytes.toBytes("row"));
          Result res = table.get(get);
      
          // Hapus satu baris data.
          Delete delete = new Delete(Bytes.toBytes("row"));
          table.delete(delete);
      
          // Pindai data dalam rentang tertentu.
          Scan scan = new Scan(Bytes.toBytes("startRow"), Bytes.toBytes("endRow"));
          ResultScanner scanner = table.getScanner(scan);
          for (Result result : scanner) {
              // Proses hasil.
              // ...
          }
          scanner.close();
      }