Ringkasan migrasi

Halaman ini memberikan ringkasan cara memigrasikan data ke dalam dan ke luar AlloyDB untuk PostgreSQL.

Mengimpor data

Anda dapat memigrasikan data ke AlloyDB melalui dua metode:

  • Mengimpor file yang berisi data Anda secara manual.

  • Menggunakan Google Cloud Database Migration Service untuk memigrasikan konten seluruh instance PostgreSQL aktif ke cluster AlloyDB baru. Untuk mengetahui informasi selengkapnya, lihat Memigrasikan menggunakan Database Migration Service.

Mengimpor data yang diarsipkan dari file

AlloyDB memungkinkan Anda mengimpor data dari file yang berada di bucket Cloud Storage. AlloyDB mendukung berbagai format file untuk impor data, termasuk:

  • CSV, dengan konten satu tabel per file, dimuat menggunakan psql.

  • DMP, arsip biner dari seluruh database PostgreSQL, diimpor menggunakan pg_restore.

  • SQL, rekonstruksi teks biasa dari database PostgreSQL, yang diproses dengan psql.

Memigrasikan instance aktif dengan Database Migration Service

Sebagai alternatif untuk mengimpor file dump data secara manual, Anda dapat menggunakan Database Migration Service untuk AlloyDB. Layanan ini memungkinkan Anda memigrasikan seluruh konten instance PostgreSQL aktif, termasuk semua database dan metadatanya, ke cluster AlloyDB baru. Database Migration Service dapat membantu Anda mentransisikan aplikasi yang ada untuk menggunakan AlloyDB sebagai penyimpanan data baru dengan waktu non-operasional minimal.

Lokalitas yang didukung untuk data yang diimpor

AlloyDB mendukung lokalitas berikut:

  • Set lengkap lokalitas yang disediakan ICU.
  • Kumpulan lokalitas terbatas yang disediakan oleh libc:
    • C.UTF-8
    • en_US.utf8

Jika database yang ingin Anda impor ke AlloyDB secara default menggunakan lokalitas libc selain dua yang tercantum di sini, Anda tetap dapat mengimpor data, tetapi default tersebut tidak akan dipertahankan. Untuk memastikan kueri SQL yang menggunakan ORDER BY mengurutkan hasilnya dengan benar, Anda mungkin perlu melakukan langkah tambahan setelah mengimpor data.

Sebaiknya izinkan database baru Anda menggunakan lokalitas default untuk AlloyDB: C.UTF-8, yang disediakan oleh libc. Kemudian, kaitkan penggabungan dengan kolom yang mungkin disertakan dalam kueri aplikasi Anda di klausa ORDER BY, dengan memberi nama penggabungan berbasis ICU yang sesuai untuk setiap kolom. Anda dapat melakukannya melalui kueri DDL ALTER TABLE, seperti berikut:

ALTER TABLE TABLE_NAME
    ALTER COLUMN COLUMN_NAME
    SET DATA TYPE COLUMN_DATA_TYPE
    COLLATE "COLLATION_NAME";

Cluster AlloyDB baru menentukan ratusan kolasi berdasarkan lokalitas yang disediakan ICU, dan Anda dapat menambahkan lebih banyak menggunakan fasilitas PostgreSQL CREATE COLLATION. Untuk melihat daftar lengkap nama kolasi berbasis ICU yang ditentukan pada cluster AlloyDB, jalankan kueri berikut pada salah satu instance-nya:

SELECT collname FROM pg_collation WHERE collprovider = 'i';

Selain kolasi berbasis ICU, AlloyDB mendukung kolasi bawaan PostgreSQL yang bernama ucs_basic. Kolasi ini menggunakan urutan standar titik kode Unicode untuk memungkinkan pengurutan yang sangat efisien. Sebaiknya gunakan dengan kolom yang urutan pengurutan yang sesuai cocok dengan urutan daftar titik kode Unicode.

Mengekspor data

Anda dapat menggunakan utilitas command line untuk mengekspor data AlloyDB ke dalam file yang disimpan di bucket Cloud Storage, dalam berbagai format:

  • CSV, mengekspor satu tabel per file, menggunakan psql.

  • DMP, menggunakan pg_dump untuk membuat arsip biner portabel dari seluruh database Anda.

  • SQL, menggunakan pg_dump untuk membuat daftar pernyataan DDL dan SQL untuk merekonstruksi database Anda.

Langkah berikutnya