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

Sebaiknya ekspor 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 impor data tersebut ke instance Looker (Google Cloud core) lainnya. Ada beberapa alasan mengapa Anda mungkin ingin mengekspor dan mengimpor data:

• Anda ingin melakukan upgrade atau downgrade ke edisi Looker lain (Google Cloud core).
• Anda ingin berpindah ke instance Looker (Google Cloud core) di project yang berbeda.
• Anda ingin berpindah ke instance Looker (Google Cloud core) di region yang berbeda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengimpor atau mengekspor data instance Looker (Google Cloud core), minta administrator untuk memberi Anda peran IAM Admin Looker (roles/looker.admin) pada project tempat instance dibuat. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Objek dan izin yang diperlukan untuk mengekspor ke bucket Cloud Storage

Catatan: Jika mengekspor data menggunakan konsol Google Cloud, Anda tidak perlu memberikan izin berikut secara manual. Izin tersebut akan diberikan secara otomatis.

• Akun layanan Looker. Jika Anda pernah menggunakan Google Cloud CLI CLI, Terraform, atau API untuk membuat instance Looker (Google Cloud core), dan belum membuat akun layanan Looker, Anda harus membuatnya.
• Bucket Cloud Storage dengan izin storage.objects.create yang ditetapkan ke akun layanan Looker. Peran 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. 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:

console

1. Buka halaman Looker di Konsol Google Cloud.

   Buka instance Looker

2. Pada menu drop-down Pilih organisasi di bagian atas halaman, pilih resource organisasi yang menyertakan instance Looker (Google Cloud core) yang datanya ingin Anda ekspor.

3. Klik nama instance yang datanya ingin Anda ekspor.

4. Klik Ekspor.

5. Di kolom Export Bucket, tentukan lokasi bucket tempat Anda ingin membuat artefak ekspor. Anda dapat memasukkan jalur di kolom input sebagai <bucket_name>/<folder_name> atau mencari untuk memilih lokasi yang sesuai dalam bucket.

6. Di kolom Select a customer-managed key, pilih CMEK yang akan digunakan untuk mengenkripsi artefak ekspor.

7. Klik EKSPOR.

gcloud

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

Ganti kode berikut:

• INSTANCE_NAME: nama untuk instance Looker (Google Cloud core) Anda; nama ini tidak terkait dengan URL instance
• BUCKET_NAME: lokasi bucket Cloud Storage tempat Anda ingin membuat artefak ekspor
• FOLDER_NAME: folder tempat Anda ingin menempatkan artefak ekspor dalam bucket Cloud Storage
• KMS_KEY_ID: jalur lengkap ke ID kunci CMEK khusus impor dan ekspor

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

Izin yang diperlukan untuk mengimpor dari bucket Cloud Storage

Catatan: Jika Anda mengimpor data menggunakan konsol Google Cloud, Anda tidak perlu memberikan izin berikut secara manual karena izin tersebut akan diberikan secara otomatis.

• Akun layanan Looker. Jika menggunakan Google Cloud CLI, Terraform, atau API untuk membuat instance Looker (Google Cloud core), dan belum membuat akun layanan Looker, Anda harus membuatnya.
• Berikan izin storage.objects.get ke akun layanan Looker. Peran Storage Object Viewer (roles/storage.objectViewer) menyertakan 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.

Catatan: Jika Anda membuat instance Looker (Google Cloud core) menggunakan CMEK, operasi impor harus memiliki akses ke CMEK tersebut beserta versi kuncinya. Saat Anda bermigrasi di antara dua region Google Cloud yang berbeda, proses impor mungkin perlu mengakses CMEK di server KMS di region yang berbeda dengan region target.

Mengimpor dari bucket Cloud Storage

Untuk mengimpor data Anda, pilih salah satu opsi berikut:

console

1. Buka halaman Looker di Konsol Google Cloud.

   Buka instance Looker

2. Pada menu drop-down Pilih organisasi di bagian atas halaman, pilih resource organisasi yang menyertakan instance Looker (Google Cloud core) tempat Anda ingin mengimpor data.

3. Klik nama instance tempat Anda ingin mengimpor data.

4. Klik IMPOR.

5. Di kolom Import Bucket, masukkan jalur atau jelajahi ke lokasi Cloud Storage tempat Anda mengekspor data. Pilih folder yang berisi file metadata.json dan file lainnya.

6. Klik IMPOR.

gcloud

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

Ganti kode berikut:

• INSTANCE_NAME: nama untuk instance Looker (Google Cloud core) Anda; nama ini tidak terkait dengan URL instance
• BUCKET_NAME: lokasi bucket Cloud Storage tempat file metadata.json dan file lainnya berada
• FOLDER_NAME: folder tempat file metadata.json dan file lainnya berada

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 ke akun layanan Looker atau peran Storage Object Creator (roles/storage.objectCreator) ke bucket Cloud Storage.

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

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

• Anda tidak dapat menggunakan bucket Cloud Storage yang telah mengaktifkan Requester Pays.

Error impor

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

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

• Impor dapat gagal karena inkompatibilitas versi antara instance target dan instance ekspor, seperti berikut:

  • Instance target memiliki versi minor Looker yang lebih kecil dari versi Looker yang diekspor. Misalnya, instance target ada di Looker 23.5.X, tetapi ekspor dibuat dari instance di Looker versi 23.6.X.
  • Versi minor instance yang membuat data ekspor berada di belakang versi Looker dari instance target dengan lebih dari satu rilis. Misalnya, instance target ada di Looker 23.6.X, tetapi ekspor dibuat dari instance di Looker versi 23.4.X.

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