Présentation de la migration

Cette page présente les différentes manières de migrer des données vers et depuis AlloyDB pour PostgreSQL.

Importation des données…

Vous pouvez migrer des données vers AlloyDB de deux manières:

  • Importer manuellement des fichiers contenant vos données

  • Utiliser Google Cloud Database Migration Service pour migrer le contenu d'une instance PostgreSQL active complète vers un nouveau cluster AlloyDB.

Importer des données archivées à partir de fichiers

AlloyDB vous permet d'importer des données à partir de fichiers situés dans un bucket Cloud Storage. AlloyDB est compatible avec différents formats de fichiers pour l'importation de données, y compris les suivants:

  • CSV, avec le contenu d'une table par fichier, chargé à l'aide de psql.

  • DMP, une archive binaire de l'ensemble d'une base de données PostgreSQL, importée à l'aide de pg_restore.

  • SQL, reconstruction au format texte brut d'une base de données PostgreSQL, traitée avec psql.

Migrer une instance active avec Database Migration Service

Au lieu d'importer manuellement des fichiers de vidage de données, vous pouvez utiliser Database Migration Service pour AlloyDB. Ce service vous permet de migrer l'intégralité du contenu d'une instance PostgreSQL active, y compris toutes ses bases de données et métadonnées, vers un nouveau cluster AlloyDB. Database Migration Service peut vous aider à faire passer vos applications existantes à AlloyDB comme nouveau data store avec un temps d'arrêt minimal.

Locales compatibles pour les données importées

AlloyDB est compatible avec les paramètres régionaux suivants:

  • Ensemble complet des paramètres régionaux fournis par ICU.
  • Ensemble limité de paramètres régionaux fournis par libc :
    • C.UTF-8
    • en_US.utf8

Si la base de données que vous souhaitez importer dans AlloyDB utilise par défaut une locale libc autre que les deux indiquées ici, vous pouvez toujours importer vos données, mais cette valeur par défaut ne sera pas conservée. Pour vous assurer que les requêtes SQL utilisant ORDER BY trient correctement leurs résultats, vous devrez peut-être prendre des mesures supplémentaires après avoir importé vos données.

Nous vous recommandons d'autoriser votre nouvelle base de données à utiliser les paramètres régionaux par défaut pour AlloyDB: C.UTF-8, fourni par libc. Associez ensuite des collations à toutes les colonnes que les requêtes de votre application peuvent impliquer dans des clauses ORDER BY, en nommant une collation basée sur ICU appropriée pour chacune d'elles. Vous pouvez le faire à l'aide de requêtes LDD ALTER TABLE, comme suit:

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

Un nouveau cluster AlloyDB définit des centaines de collations basées sur les paramètres régionaux fournis par ICU. Vous pouvez en ajouter d'autres à l'aide de la fonctionnalité CREATE COLLATION de PostgreSQL. Pour afficher la liste complète des noms de tri basés sur ICU définis sur un cluster AlloyDB, exécutez la requête suivante sur l'une de ses instances:

SELECT collname FROM pg_collation WHERE collprovider = 'i';

En plus des mises en forme basées sur ICU, AlloyDB est compatible avec la mise en forme intégrée PostgreSQL appelée ucs_basic. Cette mise en forme utilise l'ordre standard des points de code Unicode pour permettre un tri particulièrement efficace. Nous vous recommandons de l'utiliser avec des colonnes dont l'ordre de tri approprié correspond à celui de la liste des points de code Unicode.

Exportation de données

Vous pouvez utiliser des utilitaires de ligne de commande pour exporter vos données AlloyDB dans des fichiers stockés dans un bucket Cloud Storage, dans différents formats:

  • CSV, en exportant une table par fichier à l'aide de psql.

  • DMP, à l'aide de pg_dump pour créer une archive binaire portable de l'ensemble de votre base de données.

  • SQL, à l'aide de pg_dump pour créer une liste d'instructions LDD et SQL afin de reconstruire votre base de données.