Présentation de la migration

Pour déplacer des bases de données vers ou depuis AlloyDB pour PostgreSQL, vous pouvez migrer des instances PostgreSQL actives avec un temps d'arrêt minimal à l'aide de Database Migration Service, ou importer et exporter des fichiers CSV, DMP et SQL stockés dans Cloud Storage.

Importer des données

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

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 d'une base de données PostgreSQL entière, importée à l'aide de pg_restore.

  • SQL, une 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 dump 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 datastore, avec un temps d'arrêt minimal.

Paramètres régionaux compatibles 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 utilise par défaut des paramètres régionaux libc autres que les deux listés ici, vous pouvez toujours importer vos données, mais ces paramètres par défaut ne seront pas conservés. 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.

Google vous recommande d'autoriser votre nouvelle base de données à utiliser les paramètres régionaux par défaut pour AlloyDB : C.UTF-8, fournis par libc. Ensuite, associez 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. Pour ce faire, vous pouvez utiliser des requêtes LDD ALTER TABLE, comme suit :

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

Remplacez les éléments suivants :

  • TABLE_NAME : nom de la table contenant la colonne.
  • COLUMN_NAME : nom de la colonne à mettre à jour.
  • COLUMN_DATA_TYPE : type de données de la colonne
  • COLLATION_NAME : nom du classement basé sur ICU à appliquer.

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 classement 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 intégré PostgreSQL nommé ucs_basic. Ce classement utilise l'ordre standard des points de code Unicode pour permettre un tri particulièrement efficace. Google recommande de l'utiliser avec des 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 une table par fichier, à l'aide de psql.

  • DMP, en utilisant 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 d'instructions SQL afin de reconstruire votre base de données.

Étapes suivantes