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, mengupdate, 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 untuk menjalankan tugas Dataflow tidak diperlukan jika pesan tidak memerlukan pemrosesan tambahan sebelum menyimpannya di bucket Cloud Storage. Anda dapat menggunakan langganan Cloud Storage.
Namun, pipeline Dataflow masih direkomendasikan untuk sistem Pub/Sub yang memerlukan 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 Menstreaming pesan dari Pub/Sub menggunakan Dataflow.
Sebelum memulai
Sebelum membaca dokumen ini, pastikan Anda sudah memahami hal-hal berikut:
Cara kerja Pub/Sub dan persyaratan Pub/Sub yang berbeda.
Berbagai jenis langganan dan alasan Anda perlu menggunakan langganan Cloud Storage.
Cara kerja Cloud Storage.
Alur kerja langganan Cloud Storage
Gambar berikut menunjukkan alur kerja antara langganan Cloud Storage dan Cloud Storage.
Gambar 1. Alur kerja untuk langganan Cloud Storage
Berikut adalah deskripsi singkat tentang alur kerja yang merujuk pada Gambar 1:
Pub/Sub menggunakan Cloud Storage API untuk mengirim data ke bucket Cloud Storage. Setelah operasi tulis berhasil diselesaikan, API akan menampilkan respons
OK
.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 telah berlalu sejak objek dibuat.
Alur kerja untuk menulis objek ke bucket Cloud Storage memerlukan dua respons
OK
. ResponsOK
pertama dikirim saat pesan berhasil ditulis ke objek. ResponsOK
kedua dikirim saat objek yang berisi pesan telah diselesaikan. Pesan hanya terlihat di bucket setelah objek Cloud Storage yang memuatnya berhasil diselesaikan.Jika terjadi kegagalan selama operasi tulis, pesan Pub/Sub itu sendiri akan dikonfirmasi secara negatif. Pesan tersebut kemudian dikirim ulang. Jika operasi tulis pesan gagal beberapa kali dan Anda memiliki topik yang dihentikan pengirimannya pada langganan, pesan akan dipindahkan ke topik yang dihentikan pengirimannya.
Properti langganan Cloud Storage
Saat membuat langganan Cloud Storage, Anda harus menentukan beberapa properti tambahan. Properti tersebut 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 pada langganan Cloud Storage.
Kuota
Batasan kuota berlaku pada throughput pelanggan Cloud Storage untuk setiap region. Untuk mengetahui informasi tentang kuota langganan Cloud Storage, lihat batas kuota pelanggan ekspor dalam kuota dan batas Pub/Sub.
Harga
Untuk mengetahui informasi tentang harga langganan Cloud Storage, lihat halaman harga Pub/Sub.
Langkah selanjutnya
Membuat langganan Cloud Storage.
Pelajari alat konfigurasi Pub/Sub: