Langganan Cloud Storage

Langganan Cloud Storage adalah jenis langganan ekspor yang menulis pesan ke bucket Cloud Storage yang sudah ada saat pesan diterima. Anda tidak perlu mengonfigurasi klien pelanggan terpisah. Gunakan konsol Google Cloud, Google Cloud CLI, library klien, atau Pub/Sub API untuk membuat, memperbarui, mencantumkan, melepaskan, atau menghapus langganan Cloud Storage.

Tanpa jenis langganan Cloud Storage, Anda memerlukan langganan pull atau push dan pelanggan (seperti Dataflow) yang membaca pesan dan menulisnya ke bucket Cloud Storage. Overhead menjalankan tugas Dataflow tidak diperlukan jika pesan tidak memerlukan pemrosesan tambahan sebelum menyimpannya di bucket Cloud Storage; Anda dapat menggunakan langganan Cloud Storage sebagai gantinya.

Namun, pipeline Dataflow masih direkomendasikan untuk sistem Pub/Sub yang memerlukan beberapa transformasi data sebelum data disimpan di bucket Cloud Storage.

Untuk mempelajari cara melakukan streaming data dari Pub/Sub ke Cloud Storage dengan transformasi menggunakan Dataflow, lihat Melakukan streaming pesan dari Pub/Sub menggunakan Dataflow.

Sebelum memulai

Sebelum membaca dokumen ini, pastikan Anda memahami hal-hal berikut:

Alur kerja langganan Cloud Storage

Gambar berikut menunjukkan alur kerja antara langganan Cloud Storage dan Cloud Storage.

Alur pesan untuk langganan Cloud Storage

Gambar 1. Alur kerja untuk langganan Cloud Storage

Berikut adalah deskripsi singkat alur kerja yang mereferensikan Gambar 1:

  1. Pub/Sub menggunakan Cloud Storage API untuk mengirim data ke bucket Cloud Storage. Setelah berhasil menyelesaikan operasi tulis, API akan menampilkan respons OK.

  2. Pesan dikirim secara massal ke bucket Cloud Storage. Satu batch sesuai dengan objek yang disimpan di bucket Cloud Storage. Anda dapat mengonfigurasi setelan batch berdasarkan ukuran objek dan waktu yang berlalu sejak objek dibuat.

  3. Alur kerja untuk menulis objek ke bucket Cloud Storage memerlukan dua respons OK. Respons OK pertama dikirim saat pesan berhasil ditulis ke objek. Respons OK kedua dikirim saat objek yang berisi pesan diselesaikan. Pesan hanya akan terlihat di bucket setelah objek Cloud Storage yang berisinya berhasil diselesaikan.

  4. Jika ada kegagalan selama operasi tulis, pesan Pub/Sub itu sendiri akan direspons secara negatif. Pesan kemudian akan dikirim ulang. Jika operasi penulisan pesan gagal beberapa kali dan Anda memiliki topik yang dihentikan pengirimannya yang dikonfigurasi di langganan, maka pesan akan dipindahkan ke topik yang dihentikan pengirimannya.

Properti langganan Cloud Storage

Saat membuat langganan Cloud Storage, Anda harus menentukan beberapa properti tambahan. Properti ini mencakup properti langganan umum, persyaratan nama file dan format, persyaratan penyimpanan, dan lainnya. Untuk mempelajari properti ini lebih lanjut, lihat Properti langganan Cloud Storage.

Izin akun layanan Pub/Sub

Untuk membuat langganan Cloud Storage, akun layanan Pub/Sub harus memiliki izin untuk menulis ke bucket Cloud Storage tertentu dan membaca metadata bucket.

Untuk mengetahui informasi selengkapnya, lihat Menetapkan peran Cloud Storage ke akun layanan Pub/Sub.

Menangani kegagalan pesan

Jika pesan Pub/Sub tidak dapat ditulis ke bucket Cloud Storage, pesan tersebut tidak dapat dikonfirmasi. Untuk meneruskan pesan yang tidak terkirim tersebut, konfigurasikan topik yang dihentikan pengirimannya di langganan Cloud Storage.

Jika Pub/Sub tidak dapat menulis pesan ke Cloud Storage, Pub/Sub akan membatalkan pengiriman pesan dengan cara yang mirip dengan perilaku penundaan push.

Kuota

Batasan kuota berlaku untuk throughput pelanggan Cloud Storage untuk setiap region. Untuk mengetahui informasi tentang kuota untuk langganan Cloud Storage, lihat batas kuota pelanggan ekspor di Kuota dan batas Pub/Sub.

Harga

Untuk mengetahui informasi tentang harga langganan Cloud Storage, lihat halaman harga Pub/Sub.

Langkah selanjutnya