Descripción general de la migración

En esta página, se proporciona una descripción general de las formas de migrar datos dentro y fuera de AlloyDB para PostgreSQL.

Importando datos

Puedes migrar datos a AlloyDB con dos métodos:

  • Importar manualmente archivos que contengan tus datos

  • Usar Google Cloud Database Migration Service para migrar el contenido de una instancia completa y activa de PostgreSQL a un nuevo clúster de AlloyDB

Cómo importar datos archivados desde archivos

AlloyDB te permite importar datos de archivos ubicados en un bucket de Cloud Storage. AlloyDB admite una variedad de formatos de archivo para la importación de datos, incluidos los siguientes:

  • CSV, con el contenido de una tabla por archivo, cargado con psql

  • DMP, un archivo binario de una base de datos de PostgreSQL completa, importado con pg_restore

  • SQL, una reconstrucción de texto sin formato de una base de datos de PostgreSQL, procesada con psql

Cómo migrar una instancia activa con Database Migration Service

Como alternativa a la importación manual de archivos de volcado de datos, puedes usar Database Migration Service para AlloyDB. Este servicio te permite migrar todo el contenido de una instancia activa de PostgreSQL, incluidas todas sus bases de datos y metadatos, a un nuevo clúster de AlloyDB. Database Migration Service puede ayudarte a migrar tus aplicaciones existentes para que usen AlloyDB como su nuevo almacén de datos con un tiempo de inactividad mínimo.

Configuración regional compatible para los datos importados

AlloyDB admite las siguientes configuraciones regionales:

  • Es el conjunto completo de configuraciones regionales proporcionadas por ICU.
  • Un conjunto limitado de configuraciones regionales que proporciona libc:
    • C.UTF-8
    • en_US.utf8

Si la base de datos que deseas importar a AlloyDB usa de forma predeterminada una configuración regional de libc distinta de las dos que se indican aquí, puedes importar tus datos, pero esa configuración predeterminada no se transferirá. Para garantizar que las consultas SQL que usan ORDER BY ordenen sus resultados correctamente, es posible que debas seguir pasos adicionales después de importar tus datos.

Te recomendamos que permitas que tu base de datos nueva use la configuración regional predeterminada para AlloyDB: C.UTF-8, que proporciona libc. Luego, asocia las comparaciones con cualquier columna que las consultas de tu aplicación puedan implicar en cláusulas ORDER BY y asigna un nombre a una comparación adecuada basada en ICU para cada una. Puedes hacerlo a través de consultas DDL ALTER TABLE, como las siguientes:

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

Un nuevo clúster de AlloyDB define cientos de comparaciones según las configuraciones regionales proporcionadas por ICU, y puedes agregar más con la función CREATE COLLATION de PostgreSQL. Para ver la lista completa de nombres de compaginación basados en ICU definidos en un clúster de AlloyDB, ejecuta la siguiente consulta en cualquiera de sus instancias:

SELECT collname FROM pg_collation WHERE collprovider = 'i';

Además de las comparaciones basadas en ICU, AlloyDB admite la comparación integrada de PostgreSQL llamada ucs_basic. Esta ordenación usa el orden estándar de los puntos de código Unicode para permitir una ordenación especialmente eficiente. Recomendamos su uso con columnas cuyo orden de clasificación coincida con el de la lista de puntos de código Unicode.

Exporta datos

Puedes usar utilidades de línea de comandos para exportar tus datos de AlloyDB a archivos almacenados en un bucket de Cloud Storage, en varios formatos:

  • CSV, que exporta una tabla por archivo con psql.

  • DMP, con pg_dump para crear un archivo binario portátil de toda tu base de datos.

  • SQL, con pg_dump para crear una lista de instrucciones DDL y SQL para reconstruir tu base de datos.