Menggunakan Apache Spark dengan HBase di Managed Service for Apache Spark

Tidak digunakan lagi: Mulai dari Managed Service untuk Apache Spark versi 2.1, Anda tidak dapat lagi menggunakan komponen HBase opsional. Managed Service untuk Apache Spark versi 1.5 dan Managed Service untuk Apache Spark versi 2.0 menawarkan HBase versi Beta tanpa dukungan. Namun, karena sifat cluster Managed Service untuk Apache Spark yang sementara, penggunaan HBase tidak direkomendasikan.

Tujuan

Tutorial ini menunjukkan kepada Anda cara untuk:

1. Membuat cluster Managed Service untuk Apache Spark dengan menginstal Apache HBase dan Apache ZooKeeper pada cluster
2. Membuat tabel HBase menggunakan HBase shell yang berjalan di node master cluster Managed Service untuk Apache Spark
3. Menggunakan Cloud Shell untuk mengirimkan tugas Spark berbasis Java atau PySpark ke Managed Service untuk Apache Spark, yang menulis data ke tabel HBase lalu membacanya dari tabel tersebut.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:

• Managed Service for Apache Spark
• Compute Engine

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Sebelum memulai

Jika Anda belum pernah membuat project, buat project Google Cloud Platform.

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Dataproc and Compute Engine APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Dataproc and Compute Engine APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Membuat cluster Managed Service untuk Apache Spark

1. Jalankan perintah berikut di terminal sesi Cloud Shell untuk:

   • Instal komponen HBase dan ZooKeeper
   • Sediakan tiga node pekerja (tiga hingga lima worker direkomendasikan untuk menjalankan kode dalam tutorial ini)
   • Aktifkan Gateway Komponen
   • Menggunakan versi image 2.0
   • Gunakan flag --properties untuk menambahkan konfigurasi HBase dan library HBase ke jalur class driver dan eksekutor Spark.

gcloud dataproc clusters create cluster-name \
    --region=region \
    --optional-components=HBASE,ZOOKEEPER \
    --num-workers=3 \
    --enable-component-gateway \
    --image-version=2.0 \
    --properties='spark:spark.driver.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*,spark:spark.executor.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*'

Memverifikasi penginstalan konektor

1. Dari konsol Google Cloud atau terminal sesi Cloud Shell, SSH ke node master cluster Managed Service untuk Apache Spark.

2. Verifikasi penginstalan konektor Apache HBase Spark di node master:

   ls -l /usr/lib/spark/jars | grep hbase-spark
   

   Contoh output:

   -rw-r--r-- 1 root root size date time hbase-spark-connector.version.jar
   

3. Biarkan terminal sesi SSH tetap terbuka untuk:

   1. Membuat tabel HBase
   2. (Pengguna Java): Menjalankan perintah di node master cluster untuk menentukan versi komponen yang diinstal di cluster
   3. Memindai tabel Hbase Anda setelah Anda menjalankan kode

Membuat tabel HBase

Jalankan perintah yang tercantum di bagian ini di terminal sesi SSH node master yang Anda buka pada langkah sebelumnya.

1. Buka shell HBase:

   hbase shell
   

2. Buat 'my-table' HBase dengan grup kolom 'cf':

   create 'my_table','cf'
   

   1. Untuk mengonfirmasi pembuatan tabel, di konsol Google Cloud , klik HBase di link Component Gateway konsolGoogle Cloud untuk membuka UI Apache HBase. my-table tercantum di bagian Tabel di halaman Beranda.

      

Melihat kode Spark

Java

package hbase;

import org.apache.hadoop.hbase.spark.datasources.HBaseTableCatalog;
import org.apache.spark.sql.Dataset;
import org.apache.spark.sql.Row;
import org.apache.spark.sql.SparkSession;

import java.io.Serializable;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

public class SparkHBaseMain {
    public static class SampleData implements Serializable {
        private String key;
        private String name;


        public SampleData(String key, String name) {
            this.key = key;
            this.name = name;
        }

        public SampleData() {
        }

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }

        public String getKey() {
            return key;
        }

        public void setKey(String key) {
            this.key = key;
        }
    }
    public static void main(String[] args) {
        // Init SparkSession
        SparkSession spark = SparkSession
                .builder()
                .master("yarn")
                .appName("spark-hbase-tutorial")
                .getOrCreate();

        // Data Schema
        String catalog = "{"+"\"table\":{\"namespace\":\"default\", \"name\":\"my_table\"}," +
                "\"rowkey\":\"key\"," +
                "\"columns\":{" +
                "\"key\":{\"cf\":\"rowkey\", \"col\":\"key\", \"type\":\"string\"}," +
                "\"name\":{\"cf\":\"cf\", \"col\":\"name\", \"type\":\"string\"}" +
                "}" +
                "}";

        Map<String, String> optionsMap = new HashMap<String, String>();
        optionsMap.put(HBaseTableCatalog.tableCatalog(), catalog);

        Dataset<Row> ds= spark.createDataFrame(Arrays.asList(
                new SampleData("key1", "foo"),
                new SampleData("key2", "bar")), SampleData.class);

        // Write to HBase
        ds.write()
                .format("org.apache.hadoop.hbase.spark")
                .options(optionsMap)
                .option("hbase.spark.use.hbasecontext", "false")
                .mode("overwrite")
                .save();

        // Read from HBase
        Dataset dataset = spark.read()
                .format("org.apache.hadoop.hbase.spark")
                .options(optionsMap)
                .option("hbase.spark.use.hbasecontext", "false")
                .load();
        dataset.show();
    }
}

Python

from pyspark.sql import SparkSession

# Initialize Spark Session
spark = SparkSession \
  .builder \
  .master('yarn') \
  .appName('spark-hbase-tutorial') \
  .getOrCreate()

data_source_format = ''

# Create some test data
df = spark.createDataFrame(
    [
        ("key1", "foo"),
        ("key2", "bar"),
    ],
    ["key", "name"]
)

# Define the schema for catalog
catalog = ''.join("""{
    "table":{"namespace":"default", "name":"my_table"},
    "rowkey":"key",
    "columns":{
        "key":{"cf":"rowkey", "col":"key", "type":"string"},
        "name":{"cf":"cf", "col":"name", "type":"string"}
    }
}""".split())

# Write to HBase
df.write.format('org.apache.hadoop.hbase.spark').options(catalog=catalog).option("hbase.spark.use.hbasecontext", "false").mode("overwrite").save()

# Read from HBase
result = spark.read.format('org.apache.hadoop.hbase.spark').options(catalog=catalog).option("hbase.spark.use.hbasecontext", "false").load()
result.show()

Menjalankan kode

1. Buka terminal sesi Cloud Shell.

   Catatan: Jalankan perintah yang tercantum di bagian ini di terminal sesi Cloud Shell. Sebelumnya, Cloud Shell telah menginstal semua alat yang diperlukan untuk tutorial ini, termasuk gcloud CLI, git, Apache Maven, Java, dan Python, serta alat lainnya.

2. Buat clone repositori GitHub GoogleCloudDataproc/cloud-dataproc ke terminal sesi Cloud Shell Anda:

   git clone https://github.com/GoogleCloudDataproc/cloud-dataproc.git
   

3. Ubah ke direktori cloud-managed-spark/spark-hbase:

   cd cloud-managed-spark/spark-hbase
   

   Contoh output:

   user-name@cloudshell:~/cloud-managed-spark/spark-hbase (project-id)$
   

4. Kirimkan tugas Managed Service untuk Apache Spark.

Java

1. Setel versi komponen dalam file pom.xml.
   1. Halaman versi rilis 2.0.x Managed Service untuk Apache Spark mencantumkan versi komponen Scala, Spark, dan HBase yang diinstal bersama dengan versi subminor image 2.0 terbaru dan empat versi subminor sebelumnya.
      1. Untuk menemukan versi subminor dari versi image 2.0 cluster Anda, klik nama cluster di halaman Clusters pada konsolGoogle Cloud untuk membuka halaman Cluster details, tempat Image version cluster dicantumkan.

         

   2. Atau, Anda dapat menjalankan perintah berikut di terminal sesi SSH dari node master cluster Anda untuk menentukan versi komponen:
      1. Periksa versi scala:

         scala -version
         

      2. Periksa versi Spark (tekan Control + D untuk keluar):

         spark-shell
         

      3. Periksa versi HBase:

         hbase version
         

      4. Identifikasi dependensi versi Spark, Scala, dan HBase di pom.xml Maven:

         <properties>
           <scala.version>scala full version (for example, 2.12.14)</scala.version>
           <scala.main.version>scala main version (for example, 2.12)</scala.main.version>
           <spark.version>spark version (for example, 3.1.2)</spark.version>
           <hbase.client.version>hbase version (for example, 2.2.7)</hbase.client.version>
           <hbase-spark.version>1.0.0(the current Apache HBase Spark Connector version)>
         </properties>
         

         Catatan: hbase-spark.version adalah versi konektor Spark HBase saat ini. Jangan mengubah nomor versi ini.
   3. Edit file pom.xml di editor Cloud Shell untuk memasukkan nomor versi Scala, Spark, dan HBase yang benar. Klik Open Terminal setelah Anda selesai mengedit untuk kembali ke command line terminal Cloud Shell.

      cloudshell edit .
      

   4. Beralih ke Java 8 di Cloud Shell. Versi JDK ini diperlukan untuk membangun kode (Anda dapat mengabaikan pesan peringatan plugin):

      sudo update-java-alternatives -s java-1.8.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
      

   5. Verifikasi penginstalan Java 8:

      java -version
      

      Contoh output:

      openjdk version "1.8..."
       

2. Buat file jar:

   mvn clean package
   

   File .jar ditempatkan di subdirektori /target (misalnya, target/spark-hbase-1.0-SNAPSHOT.jar.

3. Kirim tugas:

   gcloud dataproc jobs submit spark \
       --class=hbase.SparkHBaseMain  \
       --jars=target/filename.jar \
       --region=cluster-region \
       --cluster=cluster-name
   

   • --jars: Sisipkan nama file .jar Anda setelah "target/" dan sebelum ".jar".
   • Jika Anda tidak menetapkan classpath HBase driver dan executor Spark saat membuat cluster, Anda harus menetapkannya tiap kali pengiriman tugas dengan menyertakan flag ‑‑properties berikut dalam perintah pengiriman tugas:

     --properties='spark.driver.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*,spark.executor.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*'
            

4. Lihat output tabel HBase di output terminal sesi Cloud Shell:

   Waiting for job output...
   ...
   +----+----+
   | key|name|
   +----+----+
   |key1| foo|
   |key2| bar|
   +----+----+
   

Python

1. Kirim tugas:

   gcloud dataproc jobs submit pyspark scripts/pyspark-hbase.py \
       --region=cluster-region \
       --cluster=cluster-name
   

   • Jika Anda tidak menetapkan classpath HBase driver dan executor Spark saat membuat cluster, Anda harus menetapkannya tiap kali pengiriman tugas dengan menyertakan flag ‑‑properties berikut dalam perintah pengiriman tugas:

     --properties='spark.driver.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*,spark.executor.extraClassPath=/etc/hbase/conf:/usr/lib/hbase/*'
            

2. Lihat output tabel HBase di output terminal sesi Cloud Shell:

   Waiting for job output...
   ...
   +----+----+
   | key|name|
   +----+----+
   |key1| foo|
   |key2| bar|
   +----+----+
   

Memindai tabel HBase

Anda dapat memindai konten tabel HBase dengan menjalankan perintah berikut di terminal sesi SSH node master yang Anda buka pada Verifikasi penginstalan konektor:

1. Buka shell HBase:

   hbase shell
   

2. Pindai 'my-table':

   scan 'my_table'
   

   Contoh output:

   ROW               COLUMN+CELL
    key1             column=cf:name, timestamp=1647364013561, value=foo
    key2             column=cf:name, timestamp=1647364012817, value=bar
   2 row(s)
   Took 0.5009 seconds
   

Pembersihan

Setelah menyelesaikan tutorial, Anda dapat membersihkan resource yang dibuat agar tidak lagi menggunakan kuota dan menimbulkan tagihan. Bagian berikut menjelaskan cara menghapus atau menonaktifkan resource ini.

Menghapus project

Cara termudah untuk menghilangkan penagihan adalah dengan menghapus project yang Anda buat untuk tutorial.

Untuk menghapus project:

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Menghapus cluster

• Untuk menghapus cluster Anda:

  gcloud dataproc clusters delete cluster-name \
      --region=${REGION}