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.

Importer 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. Pour en savoir plus, consultez Migrer à l'aide de Database Migration Service.

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'un tableau par fichier, chargé à l'aide de psql.

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

  • SQL : reconstruction en 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 en tant que nouveau data store avec un temps d'arrêt minimal.

Paramètres régionaux acceptés pour les données importées

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

  • Ensemble complet de paramètres régionaux fournis par ICU.
  • Un 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 est définie par défaut sur un paramètre régional libc autre que ceux listés ici, vous pouvez toujours importer vos données, mais ce paramètre par défaut ne sera pas conservé. Pour vous assurer que les requêtes SQL utilisant ORDER BY trient correctement leurs résultats, vous devrez peut-être effectuer des étapes supplémentaires après l'importation de vos données.

Nous vous recommandons d'autoriser votre nouvelle base de données à utiliser le paramètre régional par défaut pour AlloyDB : C.UTF-8, fourni par libc. Associez ensuite des classements à toutes les colonnes que les requêtes de votre application peuvent impliquer dans les clauses ORDER BY, en nommant un classement approprié basé sur ICU 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 classements basés 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 classements basés sur ICU, AlloyDB est compatible avec le classement PostgreSQL intégré nommé ucs_basic. Cette collation utilise l'ordre standard des points de code Unicode pour permettre un tri particulièrement efficace. Nous vous recommandons de l'utiliser avec les colonnes dont l'ordre de tri approprié correspond à celui de la liste des points de code Unicode.

Exporter des 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 un tableau par fichier, à l'aide de psql.

  • DMP, en utilisant pg_dump pour créer une archive binaire portable de l'intégralité de votre base de données.

  • SQL, en utilisant pg_dump pour créer une liste d'instructions LDD et SQL permettant de reconstruire votre base de données.

Étapes suivantes