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 subscriber 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 menuliskannya ke bucket Cloud Storage. Overhead menjalankan tugas Dataflow tidak diperlukan jika pesan tidak memerlukan pemrosesan tambahan sebelum disimpan di bucket Cloud Storage; Anda dapat menggunakan langganan Cloud Storage sebagai gantinya.

Untuk modifikasi ringan pada pesan atau atribut, Anda dapat melampirkan Transformasi Pesan Tunggal ke langganan Cloud Storage Anda. Namun, pipeline Dataflow direkomendasikan untuk sistem Pub/Sub yang memerlukan transformasi data yang lebih kompleks sebelum data disimpan di bucket Cloud Storage, terutama jika Anda ingin membuat jendela atau menggabungkan pesan.

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 deskripsi singkat alur kerja yang merujuk pada Gambar 1:

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

  2. Pesan dikirim dalam batch 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 berisi pesan tersebut berhasil diselesaikan.

  4. Jika ada kegagalan selama operasi tulis, pesan Pub/Sub itu sendiri akan dikonfirmasi negatif. Kemudian, pesan dikirim ulang. Jika operasi penulisan pesan gagal beberapa kali dan Anda telah mengonfigurasi topik pesan yang dihentikan pengirimannya pada langganan, maka pesan akan dipindahkan ke topik pesan 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 lebih lanjut properti ini, lihat Properti langganan Cloud Storage.

Menangani kegagalan pesan

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

Jika Pub/Sub tidak dapat menulis pesan ke Cloud Storage, Pub/Sub akan menghentikan pengiriman pesan dengan cara yang serupa dengan perilaku penghentian push.

Kuota

Batasan kuota berlaku untuk throughput pelanggan Cloud Storage untuk setiap region. Untuk mengetahui informasi tentang kuota 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 berikutnya