Mengimpor data dari penyedia cloud lain

Dengan Pusat Migrasi, Anda dapat mengimpor data performa dan penggunaan dari infrastruktur yang dihosting di penyedia cloud lain, seperti Amazon Web Services (AWS) dan Azure.

Untuk mengimpor data dari penyedia cloud lain, lakukan langkah-langkah berikut:

Download skrip pengumpulan.
Jalankan skrip di infrastruktur cloud dan buat tabel output.
Upload tabel output ke Pusat Migrasi.

Praktik terbaik untuk menjalankan skrip pengumpulan

Saat Anda menjalankan skrip pengumpulan, pertimbangkan hal berikut:

Jalankan skrip pengumpulan menggunakan instance AWS CloudShell (saat mengumpulkan data dari AWS) atau Azure Cloud Shell (saat mengumpulkan data dari Azure). Dengan menggunakan shell ini, Anda tidak perlu membuat, mendistribusikan, dan memelihara kunci autentikasi untuk menjalankan skrip pengumpulan di lingkungan runtime lainnya.
Jalankan skrip pengumpulan dengan meniru identitas akun yang memiliki izin hanya baca minimal. Menggunakan izin hanya baca akan menghindari modifikasi yang tidak disengaja pada resource AWS atau Azure Anda.
Skrip ini bersifat open source. Jadi, jika organisasi Anda memiliki persyaratan peraturan tertentu, tinjau kode tersebut untuk memahami dengan tepat jenis data yang dikumpulkan.

Batasan

Ukuran maksimum untuk upload file adalah 100 Mb.

Mendownload skrip

Untuk mendownload skrip, pilih salah satu link berikut, bergantung pada penyedia cloud Anda:

Jalankan skrip:

Untuk menjalankan skrip, ikuti petunjuk dalam file README di repositori. Skrip menghasilkan file ZIP dengan tabel data yang dikumpulkan. Ekstrak file dari file ZIP.

Upload hasil skrip pengumpulan

Untuk mengupload file, ikuti langkah-langkah berikut:

Konsol

Buka halaman Impor data.

Buka Impor data
Klik Tambahkan data. Halaman baru akan terbuka.
Pilih Upload files lalu, di bagian Set up file upload, masukkan nama upload file.
Dari daftar, pilih AWS Export atau Azure exports.
Klik Select files to upload, lalu pilih semua file yang ingin Anda upload.

Catatan: Untuk file AWS dan Azure, Anda tidak dapat mengupload file ZIP yang dihasilkan oleh skrip secara langsung, tetapi Anda harus mengekstrak file tersebut terlebih dahulu, lalu mengupload file CSV.
Untuk mengonfirmasi dan mulai mengupload file, klik Upload file.
Jika file divalidasi dengan benar, untuk membuat aset dari file, klik Import data, lalu klik Confirm.

API

Buat tugas impor.
```
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}
```
Ganti kode berikut:
- PROJECT_ID: ID project untuk membuat tugas impor.
- REGION: Region untuk membuat tugas impor.
- IMPORT_JOB_ID: ID tugas impor baru.
- SOURCE_ID: ID sumber yang sudah ada yang akan dikaitkan dengan tugas impor.

Opsional: Untuk mengonfirmasi bahwa tugas impor telah dibuat dengan benar, dapatkan tugas impor.

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

Buat file data impor yang dilampirkan ke tugas impor.

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

Ganti kode berikut:

DATA_FILE_ID: ID file data baru
IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_EXPORTED_AWS_CSV atau IMPORT_JOB_FORMAT_EXPORTED_AZURE_CSV

Dapatkan file data.

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

Salin URL dari kolom signedUrl dari respons.
Upload file ke URL yang disalin.
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
Ganti kode berikut:
- UPLOAD_FILE_PATH: Jalur lokal file yang diupload.
- COPIED_URL: URL bertanda tangan yang disalin dari langkah pratinjau.
Opsional: Ulangi langkah 3–6 untuk membuat lebih banyak file data dengan tugas impor yang sama.

Opsional: Dapatkan semua file data tugas impor.

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

Validasi tugas impor.

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

Dapatkan tugas impor dan lihat laporan validasi. Jika statusnya READY, Anda dapat melanjutkan ke langkah berikutnya. Jika tidak, Anda perlu memperbaiki tugas atau file tertentu, tindakan ini mungkin mengharuskan menghapus file atau mengupload file baru.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Jalankan tugas impor.

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

Dapatkan tugas impor dan lihat laporan eksekusi. Jika statusnya adalah COMPLETED, artinya tugas berhasil dieksekusi. Atau, jika tugas gagal dan dalam status terminal, laporan eksekusi akan menyertakan error. Buat tugas impor baru dan terapkan perubahan yang diperlukan.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Jika Anda mengalami masalah saat mengupload file, lihat cara memecahkan masalah pesan error umum.

Tinjau upload

Setelah Anda mengupload file, Pusat Migrasi akan memvalidasinya untuk memeriksa apakah file tersebut benar secara formal. Jika validasi berhasil, Pusat Migrasi akan memproses data untuk membuat aset baru, atau memperbarui aset yang sudah ada. Anda dapat memeriksa status tugas upload dari Konsol Google Cloud.

Untuk meninjau status tugas upload Anda, ikuti langkah-langkah berikut:

Buka halaman Impor data, lalu klik Upload file.
Dari daftar impor file, pilih upload yang ingin Anda tinjau.
Di halaman upload file, di bagian Progres impor data, tinjau Status file yang Anda upload.

Anda dapat melihat file dalam salah satu status berikut.

Daftar status

Selesai. Impor file Anda berhasil.
Siap. File Anda lulus validasi, dan siap diimpor.
Tertunda. File Anda menunggu file lain selesai diproses.
Berjalan. File Anda sedang diproses.
Memvalidasi. File Anda berada dalam tahap validasi.
Validasi gagal. File Anda berisi beberapa kesalahan. Perbaiki kesalahan tersebut, lalu coba upload file Anda lagi.
Gagal. File Anda tidak dapat diimpor.

Tinjau detail error

Jika menemukan error setelah mengimpor file, Anda dapat meninjau pesan error secara langsung di Konsol Google Cloud.

Untuk meninjau error pada tugas upload, ikuti langkah-langkah berikut:

Buka halaman Impor data, lalu klik Upload file.
Klik file impor yang menampilkan peringatan atau error. Halaman detail file impor menampilkan daftar lengkap error.

Di halaman detail file impor, Anda dapat meninjau aset dan kolom data yang menyebabkan error, serta melihat deskripsi error. Error dalam tugas impor file dapat mencegah Pusat Migrasi membuat aset baru atau memperbarui aset yang ada dengan perubahan baru. Untuk memperbaiki error ini, edit file Anda dan buat tugas impor file baru untuk menguploadnya lagi.

Untuk mengetahui informasi selengkapnya tentang kemungkinan pesan error, lihat Memecahkan masalah error impor file.

Langkah selanjutnya

Pelajari metode pengumpulan Pusat Migrasi lebih lanjut.
Pelajari cara mengelola upload file Anda.