Mengelola versi konektor kustom

Pratinjau — Konektor BigQuery

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Membuat versi konektor kustom

Untuk membuat versi konektor kustom, ikuti langkah-langkah berikut:

1. Di Konsol, buka halaman Application Integration > Custom connectors, lalu pilih atau buat Google Cloud project.

   Buka halaman Konektor kustom

   Tindakan ini akan menampilkan daftar konektor kustom.

2. Klik konektor kustom yang ingin Anda tambahkan versinya.

   Tindakan ini akan menampilkan halaman detail koneksi.

3. Klik Versions.

   Halaman ini menampilkan semua versi konektor.

4. Klik Create. Tindakan ini akan menampilkan halaman Create new version dengan nomor versi baru. Langkah-langkah untuk membuat versi baru mirip dengan langkah-langkah untuk membuat konektor kustom baru. Artinya, Anda dapat membuat versi dengan konektivitas langsung atau tidak langsung.
   • Untuk membuat versi dengan konektivitas langsung, lakukan langkah-langkah (mulai langkah 3 dan seterusnya) seperti yang didokumentasikan di Membuat konektor kustom dengan konektivitas langsung.
   • Untuk membuat versi dengan konektivitas tidak langsung, lakukan langkah-langkah (mulai langkah 3 dan seterusnya) seperti yang didokumentasikan di Membuat konektor kustom dengan konektivitas tidak langsung.

Mengelola versi konektor kustom

Untuk mengedit konektor kustom, lakukan langkah-langkah berikut:

1. Di Konsol, buka halaman Application Integration > Custom connectors, lalu pilih atau buat Google Cloud project.

   Buka halaman Konektor kustom

   Tindakan ini akan menampilkan daftar konektor kustom.

2. Klik konektor kustom yang memiliki versi.

   Tindakan ini akan menampilkan halaman detail koneksi.

3. Klik Versions.

   Versi untuk konektor yang dipilih akan muncul.

4. Klik Actions untuk memilih salah satu opsi berikut:
   • View Details: Untuk melihat detail versi konektor kustom.
   • Deprecate Version: Untuk menghentikan versi.
   • Delete: Untuk menghapus versi.
   • Ekspor: Untuk mendownload versi konektor sebagai file spesifikasi JSON. Untuk mengetahui informasi selengkapnya, lihat Mengekspor dan mengimpor.

Mengekspor dan mengimpor

Anda dapat membagikan konektor antar- Google Cloud project dengan mengekspor dan mengimpor spesifikasi konektor. Anda dapat mengekspor versi koneksi apa pun, lalu mengimpor spesifikasi ke project yang sama atau project yang berbeda Google Cloud . Mengekspor versi konektor yang tidak digunakan tidak didukung.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengekspor dan mengimpor konektor kustom, minta administrator untuk memberi Anda peran IAM berikut:

• Storage Object Admin (roles/storage.objectAdmin) di bucket Cloud Storage
• Security Admin (roles/iam.securityAdmin) di project tempat rahasia berada. Atau, Anda juga dapat meminta administrator untuk memberi Anda atau akun layanan, izin secretmanager.secrets.getIamPolicy dan secretmanager.secrets.setIamPolicy di project tempat rahasia berada.

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

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengekspor konektor kustom

Untuk mengekspor versi konektor, ikuti langkah-langkah berikut:

1. Di Konsol, buka halaman Application Integration > Custom connectors, lalu pilih atau buat Google Cloud project.

   Buka halaman Konektor kustom

2. Klik konektor kustom yang ingin Anda ekspor. Halaman ringkasan konektor kustom akan terbuka.
3. Klik Versions. Daftar versi konektor kustom akan ditampilkan.
4. Klik More Actions , lalu klik Export. File spesifikasi JSON untuk konektor kustom akan didownload.

Mengimpor konektor kustom

Untuk mengimpor versi konektor, ikuti langkah-langkah berikut:

1. Di Konsol, buka halaman Application Integration > Custom connectors, lalu pilih atau buat Google Cloud project.

   Buka halaman Konektor kustom

Halaman Custom connectors akan muncul.
2. Klik Import.
3. Telusuri dan pilih file spesifikasi JSON untuk konektor kustom. Jika Anda mengimpor konektor ke project lain, kolom Service account tidak akan diisi otomatis.
   Catatan: Pastikan konektor yang ingin Anda impor tidak dihentikan.

   Berdasarkan apakah konektor sudah ada atau belum, skenario berikut dapat terjadi:

   • Konektor dengan nama yang sama tidak ada: Halaman Create custom connector akan muncul. Versi konektor dalam JSON yang diimpor akan diisi otomatis. Versi ini tidak dapat diubah.
   • Konektor dengan nama yang sama ada, tetapi versi yang sama tidak ada: Halaman Create version untuk konektor tersebut akan muncul. Properti konektor seperti jenis konektor, nama, deskripsi akan diisi otomatis dari konektor yang ada dan tidak akan ditimpa dari JSON yang diimpor. Namun, detail dan nama versi konektor akan dibaca dari JSON yang diimpor. Hanya nama versi yang dapat diedit.
   • Konektor dengan nama dan versi yang sama ada: Pesan peringatan akan muncul yang menyatakan bahwa versi sudah ada dan versi baru akan digunakan saat Anda mengimpor spesifikasi JSON. Jika Anda mengklik Import, halaman Create version untuk konektor tersebut akan muncul. Properti konektor seperti jenis konektor, nama, deskripsi akan diisi otomatis dari konektor yang ada dan tidak akan ditimpa oleh JSON yang diimpor. Namun, detail versi akan dibaca dari JSON yang diimpor dan dapat diedit. Nomor versi terbaru yang tersedia akan digunakan untuk nama versi.
4. Isi detail yang tersisa, lalu klik Create. Konektor akan dibuat dengan spesifikasi JSON yang diimpor.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya

• Pelajari tentang semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari tentang log eksekusi integrasi.