Memilih protokol endpoint untuk Dataproc Metastore

Halaman ini menjelaskan cara memilih protokol endpoint untuk Dataproc Metastore.

Anda pertama-tama memilih protokol endpoint saat membuat layanan Dataproc Metastore. Pilihan ini memengaruhi fitur yang dapat Anda integrasikan dan gunakan dengan layanan Anda. Perhatikan bahwa setelah Anda memilih protokol endpoint, ada beberapa batasan jika Anda ingin mengubahnya. Pastikan Anda memilih protokol yang sesuai dengan kebutuhan Anda.

Untuk memahami perbedaan antara protokol endpoint, lihat Tentang protokol endpoint.

Sebelum memulai

Peran yang Diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat Dataproc Metastore, minta administrator untuk memberi Anda peran IAM berikut di project Anda, berdasarkan prinsip hak istimewa minimum:

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin metastore.services.create, yang diperlukan untuk membuat Metastore Dataproc.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya tentang peran dan izin Dataproc Metastore tertentu, lihat Mengelola akses Dataproc dengan IAM.

Memilih protokol endpoint

Contoh berikut menunjukkan versi singkat langkah-langkah yang Anda ikuti untuk memilih protokol endpoint. Untuk mengetahui petunjuk langkah demi langkah lengkap tentang seluruh proses yang harus Anda ikuti, lihat Membuat Dataproc Metastore.

Untuk layanan Dataproc Metastore baru

Untuk membuat layanan Dataproc Metastore dan memilih protokol endpoint untuk pertama kalinya, ikuti petunjuk berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Metastore Dataproc:

    Membuka Dataproc Metastore

  2. Di menu Navigasi Dataproc Metastore, klik Create.

    Halaman Buat layanan akan terbuka.

  3. Di bagian Endpoint protocol, pilih Thrift atau gRPC.

    Thrift adalah protokol endpoint default yang telah dipilih sebelumnya.

    Anda hanya dapat memperbarui protokol endpoint yang ada dari Thrift ke gRPC. Jika Anda ingin beralih dari gRPC ke Thrift, buat layanan Dataproc Metastore baru.

  4. Pilih konfigurasi lainnya untuk layanan Anda, sesuai kebutuhan.

  5. Untuk membuat dan memulai layanan, klik Kirim.

    Jika memilih endpoint gRPC, Anda harus memberikan izin IAM tambahan ke layanan Anda. Untuk informasi selengkapnya, lihat Mengakses endpoint gRPC.

gcloud CLI

  1. Untuk memilih protokol endpoint, jalankan perintah gcloud metastore services create berikut:

    gcloud metastore services create SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift"

    Ganti kode berikut:

    • SERVICE_ID: Nama atau ID untuk layanan Metastore Dataproc Anda.

    • ENDPOINT_PROTOCOL: Protokol endpoint yang ingin Anda gunakan untuk Dataproc Metastore. Anda dapat menentukan thrift atau grpc.

      Thrift adalah protokol endpoint default yang telah dipilih sebelumnya.

      Anda hanya dapat memperbarui protokol endpoint yang ada dari Thrift ke gRPC. Jika ingin beralih dari gRPC ke Thrift, Anda harus membuat layanan baru.

  2. Pastikan bahwa layanan Anda berhasil dibuat.

    Jika memilih protokol endpoint gRPC, Anda harus menambahkan izin IAM tambahan ke akun Anda. Untuk informasi selengkapnya, lihat Mengakses endpoint gRPC.

Untuk layanan Dataproc Metastore yang ada

Untuk memperbarui protokol endpoint layanan Metastore Dataproc yang ada, ikuti petunjuk berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Metastore Dataproc:

    Membuka Dataproc Metastore

  2. Di halaman Dataproc Metastore, klik layanan yang akan diupdate.

    Halaman Detail layanan akan terbuka.

  3. Di tab Configuration, klik Edit.

    Halaman Edit layanan akan terbuka.

  4. Di bagian Endpoint protocol, pilih gRPC.

  5. Untuk memperbarui layanan, klik Kirim.

    Setelah mengupdate ke protokol endpoint gRPC, Anda harus menambahkan izin IAM tambahan ke akun Anda. Untuk informasi selengkapnya, lihat Mengakses endpoint gRPC.

gcloud CLI

  1. Untuk mengupdate protokol endpoint, jalankan perintah gcloud metastore services update berikut:

    gcloud metastore services update SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL

    Ganti kode berikut:

    • SERVICE: Nama layanan Dataproc Metastore Anda.
    • ENDPOINT_PROTOCOL: Protokol endpoint yang ingin Anda update untuk layanan Dataproc Metastore. Anda hanya dapat menentukan grpc.

  2. Pastikan update Anda berhasil.

    Setelah mengupdate ke endpoint gRPC, Anda harus memberikan izin IAM tambahan ke layanan Anda. Untuk informasi selengkapnya, lihat Mengakses endpoint gRPC.

Menemukan nilai URI endpoint

Konsol

Anda dapat melihat URI endpoint di halaman Dataproc Metastore.

  • Untuk endpoint Thrift, nilai URL dimulai dengan thrift://
  • Untuk endpoint gRPC, nilai URL dimulai dengan https://

Gambar berikut menunjukkan contoh layanan Dataproc Metastore yang dikonfigurasi dengan protokol endpoint gRPC.

URL detail layanan dan nilai hive.metastore.warehouse.dir

gcloud CLI

Untuk melihat URI endpoint, jalankan perintah gcloud metastore services describe berikut:

gcloud metastore services describe SERVICE --format="get(endpointUri)"

Ganti kode berikut:

  • SERVICE: Nama layanan Dataproc Metastore Anda.

Langkah selanjutnya