Mengimpor atau mengekspor data dari instance Looker (Google Cloud core)

Anda mungkin ingin mengekspor data instance Looker (Google Cloud core) — yang mencakup konten yang dibuat dan data internal tentang instance Looker (Google Cloud core) Anda — dari satu instance Looker (Google Cloud core), lalu mengimpor data tersebut ke instance Looker (Google Cloud core) lain. Ada beberapa alasan mengapa Anda mungkin ingin mengekspor dan mengimpor data:

• Anda ingin mengupgrade atau mendowngrade ke edisi Looker (Google Cloud core) yang berbeda.
• Anda ingin berpindah ke instance Looker (Google Cloud core) di project lain.
• Anda ingin berpindah ke instance Looker (Google Cloud core) di region lain.
• Anda ingin mengekspor data dari instance non-produksi ke instance produksi.

Ekspor mencakup semua data, konfigurasi, dan konten dari sebuah instance, dengan pengecualian berikut:

• Setelan konsol Google Cloud , yang harus dilakukan di konsol Google Cloud untuk setiap instance, tidak diekspor. Namun, setelan di panel Admin Looker dalam aplikasi Looker (Google Cloud core) diekspor.
• Token OAuth apa pun yang disimpan dalam instance tidak diekspor. Jika menggunakan OAuth untuk koneksi database individual, setelah mengimpor, setiap pengguna harus login lagi dan memperbarui tokennya untuk koneksi database apa pun yang menggunakan OAuth.
• Jika Anda mengekspor dan mengimpor ke instance Looker (inti Google Cloud) yang menggunakan penyiapan jaringan yang berbeda dengan instance yang membuat ekspor, Anda mungkin perlu mengonfigurasi koneksi ke layanan eksternal secara berbeda.
• Jika memindahkan ekspor dari instance di satu project Google Cloud ke instance di project lain, izin IAM untuk memberi pengguna akses ke instance harus ditetapkan di project baru.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna mengimpor atau mengekspor data instance Looker (inti Google Cloud), minta administrator Anda untuk memberi Anda peran IAM Looker Admin (roles/looker.admin) pada project tempat instance dibuat. Untuk mengetahui informasi selengkapnya tentang cara memberikan 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 data instance Looker (Google Cloud core) ke bucket Cloud Storage

Bagian berikut menjelaskan cara mengekspor data instance Anda.

Objek dan izin yang diperlukan untuk mengekspor ke bucket Cloud Storage

• Akun layanan Looker. Jika Anda menggunakan Google Cloud CLI, Terraform, atau API untuk membuat instance Looker (Google Cloud core), dan Anda belum membuat akun layanan Looker, Anda harus membuatnya.
• Bucket Cloud Storage dengan izin storage.objects.create yang ditetapkan ke akun layanan Looker. Peran IAM Storage Object Creator (roles/storage.objectCreator) menyertakan izin ini, sehingga Anda dapat menetapkan peran tersebut ke akun layanan Looker.
• Kunci enkripsi yang dikelola pelanggan (CMEK). CMEK ini khusus untuk proses ekspor dan impor, serta berbeda dengan CMEK yang digunakan untuk mengenkripsi data instance Anda. Izin cloudkms.cryptoKeyVersions.useToEncrypt CMEK harus ditetapkan ke akun layanan Looker. Peran Cloud KMS CryptoKey Encrypter (roles/cloudkms.cryptoKeyEncrypter) mencakup izin ini, sehingga Anda dapat menetapkan peran tersebut ke akun layanan Looker.

Mengekspor ke bucket Cloud Storage

Untuk mengekspor data Anda, pilih salah satu opsi berikut:

gcloud looker instances export INSTANCE_NAME \
--target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \
--kms-key=KMS_KEY_ID

Mengimpor data dari bucket Cloud Storage ke instance Looker (Google Cloud core)

Bagian berikut menjelaskan cara mengimpor data instance Anda.

Izin yang diperlukan untuk mengimpor dari bucket Cloud Storage

• Akun layanan Looker. Jika Anda menggunakan Google Cloud CLI, Terraform, atau API untuk membuat instance Looker (Google Cloud core), dan Anda belum membuat akun layanan Looker, Anda harus membuatnya.
• Berikan izin storage.objects.get ke akun layanan Looker. Peran IAM Storage Object Viewer (roles/storage.objectViewer) mencakup izin ini, sehingga Anda dapat menetapkan peran tersebut ke akun layanan Looker.
• Izin cloudkms.cryptoKeyVersions.useToDecrypt harus ditetapkan ke akun layanan Looker. Peran Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter) mencakup izin ini, sehingga Anda dapat menetapkan peran tersebut ke akun layanan Looker.

Mengimpor dari bucket Cloud Storage

Untuk mengimpor data Anda, pilih salah satu opsi berikut:

gcloud looker instances import INSTANCE_NAME \
--source-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME'

Setelah impor, pengguna Looker (inti Google Cloud) akan diminta untuk melakukan autentikasi ulang ke koneksi database BigQuery atau Snowflake yang menggunakan OAuth untuk autentikasi pengguna perorangan. Hal ini karena ekspor Looker (Google Cloud core) tidak mempertahankan akses OAuth atau token refresh untuk koneksi database pengguna individual.

Pengguna dapat melakukan autentikasi ulang ke database mereka dengan salah satu metode berikut:

• Ikuti perintah Login yang muncul saat mereka melihat Eksplorasi atau dasbor yang menggunakan koneksi database OAuth individual.
• Buka halaman Akun mereka dan pilih Login untuk setiap database di bagian heading Kredensial Koneksi OAuth.

Jadwal atau pemberitahuan otomatis apa pun yang dimiliki oleh satu pengguna dan yang mereferensikan koneksi OAuth akan rusak hingga pengguna tersebut login dengan kredensial OAuth-nya.

Memecahkan masalah ekspor atau impor data Looker (Google Cloud core)

Bagian ini menjelaskan cara memperbaiki kondisi error yang dapat menyebabkan proses ekspor atau impor gagal.

Error selama ekspor

• Pastikan Anda telah memberikan izin storage.objects.create atau peran IAM Storage Object Creator (roles/storage.objectCreator) kepada akun layanan Looker ke bucket Cloud Storage.

• Pastikan Anda telah memberikan izin cloudkms.cryptoKeyVersions.useToEncrypt atau peran Pengenkripsi CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) kepada akun layanan Looker untuk Kunci enkripsi yang dikelola pelanggan (CMEK) yang Anda buat.

• Pastikan lokasi Cloud Storage yang diberikan tidak memiliki file apa pun dari operasi ekspor sebelumnya sebelum Anda mengekspor data. Jika ada file yang sudah ada sebelumnya, hapus terlebih dahulu.

• Anda tidak dapat menggunakan bucket Cloud Storage yang telah mengaktifkan Pemohon Membayar.

Error impor

• Pastikan Anda telah memberikan izin storage.objects.get atau peran IAM Storage Object Viewer (roles/storage.objectViewer) ke akun layanan Looker untuk bucket Cloud Storage.

• Pastikan Anda telah memberikan izin cloudkms.cryptoKeyVersions.useToDecrypt atau peran Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter) kepada akun layanan Looker untuk Kunci enkripsi yang dikelola pelanggan (CMEK) yang Anda buat.

• Pengimporan dapat gagal karena ketidakcocokan versi antara instance target dan instance ekspor, sebagai berikut:

  • Instance target memiliki versi minor Looker yang lebih rendah dari versi Looker data yang diekspor. Misalnya, instance target menggunakan Looker 23.5.X, tetapi ekspor dibuat dari instance di Looker versi 23.6.X.
  • Versi minor instance yang membuat data ekspor lebih lama dari versi Looker instance target lebih dari satu rilis. Misalnya, instance target menggunakan Looker 23.6.X, tetapi ekspor dibuat dari instance di Looker versi 23.4.X.

  Dalam hal ini, upgrade instance ekspor atau instance target sehingga kedua instance menjalankan versi Looker yang sama.