Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
Utilisation de Google Cloud Database Migration Service pour migrer le contenu d'une instance PostgreSQL active et 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 datastore avec un temps d'arrêt minimal.
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 effectuer des étapes 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, fournis 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 DDL ALTER TABLE, comme suit:
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 mise en forme basés sur ICU définis sur un cluster AlloyDB, exécutez la requête suivante sur l'une de ses instances:
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 DDL et SQL afin de reconstruire votre base de données.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eAlloyDB for PostgreSQL supports two primary methods for data migration: manually importing data from files or using Google Cloud Database Migration Service to migrate from an active PostgreSQL instance.\u003c/p\u003e\n"],["\u003cp\u003eData can be imported into AlloyDB from files in CSV, DMP, or SQL formats, located in a Cloud Storage bucket, using \u003ccode\u003epsql\u003c/code\u003e or \u003ccode\u003epg_restore\u003c/code\u003e utilities.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud Database Migration Service allows migrating an entire active PostgreSQL instance, including all databases and metadata, to a new AlloyDB cluster with minimal downtime.\u003c/p\u003e\n"],["\u003cp\u003eAlloyDB supports a range of locales, with a recommendation to use the default \u003ccode\u003eC.UTF-8\u003c/code\u003e locale and to define ICU-based collations for specific columns that require particular sort orders.\u003c/p\u003e\n"],["\u003cp\u003eData can be exported from AlloyDB to files in CSV, DMP, or SQL formats, stored in a Cloud Storage bucket, using \u003ccode\u003epsql\u003c/code\u003e or \u003ccode\u003epg_dump\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Migration overview\n\nThis page provides an overview of ways to migrate data into and out of\nAlloyDB for PostgreSQL.\n\nImporting data\n--------------\n\nYou can migrate data into AlloyDB through two methods:\n\n- Manually importing files containing your data.\n\n- Using Google Cloud Database Migration Service to migrate the contents of a whole,\n active PostgreSQL instance into a new AlloyDB cluster.\n\n| **Caution:** If your source database uses a default collation based on a locale provided by `libc`, you might need to add ICU-based collations to your tables after importing their data into AlloyDB. For more information, see [Supported locales for imported data](#locales).\n\n### Import archived data from files\n\nAlloyDB lets you import\ndata from files located in a Cloud Storage bucket.\nAlloyDB supports a variety of file formats for data\nimport, including the following:\n\n- [CSV](/alloydb/docs/import-csv-file), with the contents of one table\n per file, loaded using `psql`.\n\n- [DMP](/alloydb/docs/import-dmp-file), a binary archive of a whole\n PostgreSQL database, imported using `pg_restore`.\n\n- [SQL](/alloydb/docs/import-sql-file), a plain-text reconstruction of a\n PostgreSQL database, processed with `psql`.\n\n### Migrate an active instance with Database Migration Service\n\nAs an alternative to manually importing data-dump files, you can use\n[Database Migration Service for AlloyDB](/database-migration/docs/postgresql-to-alloydb).\nThis service lets you migrate the entire contents of an\nactive PostgreSQL instance---including all of its databases and\nmetadata---into a new AlloyDB cluster. Database Migration Service can\nhelp you transition your existing applications to using\nAlloyDB as their new datastore with minimal downtime.\n\n### Supported locales for imported data\n\nAlloyDB supports the following\n[locales](https://www.postgresql.org/docs/16//locale.html):\n\n- The full set of ICU-provided locales.\n- A limited set of locales provided by `libc`:\n - `C.UTF-8`\n - `en_US.utf8`\n\nIf the database you want to import into AlloyDB defaults\nto a `libc` locale other than the two listed here, you can still import\nyour data, but that default won't carry over. To ensure that SQL queries\nusing `ORDER BY` sort their results properly, you might need to take\nadditional steps after importing your data.\n\nWe recommend allowing your new database to use the default locale for\nAlloyDB: `C.UTF-8`, provided by `libc`. Then, associate\n[collations](https://www.postgresql.org/docs/16//collation.html) with any\ncolumns that your application's queries might involve in `ORDER BY`\nclauses, naming an appropriate ICU-based collation for each one. You can\ndo this through [`ALTER TABLE` DDL\nqueries](https://www.postgresql.org/docs/16//sql-altertable.html), such as the following: \n\n ALTER TABLE \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-k\"\u003eTABLE_NAME\u003c/span\u003e\u003c/var\u003e\n ALTER COLUMN \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-k\"\u003eCOLUMN_NAME\u003c/span\u003e\u003c/var\u003e\n SET DATA TYPE \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eCOLUMN_DATA_TYPE\u003c/span\u003e\u003c/var\u003e\n COLLATE \"\u003cvar translate=\"no\"\u003eCOLLATION_NAME\u003c/var\u003e\";\n\nA new AlloyDB cluster defines hundreds of collations\nbased on ICU-provided locales, and you can add more using [the PostgreSQL\n`CREATE COLLATION` facility](https://www.postgresql.org/docs/16//sql-createcollation.html). To\nsee the full list of ICU-based collation names defined on an\nAlloyDB cluster,\nrun the following query on any of its instances: \n\n SELECT collname FROM pg_collation WHERE collprovider = 'i';\n\nIn addition to ICU-based collations, AlloyDB supports the\nPostgreSQL built-in collation named `ucs_basic`. This collation uses\nthe standard order of Unicode code points to enable especially efficient\nsorting. We recommend its use with columns whose appropriate sort order\nmatches that of the Unicode code-point list.\n\nExporting data\n--------------\n\nYou can use command-line utilities to export your AlloyDB\ndata into files stored on a Cloud Storage bucket, in a variety of formats:\n\n- [CSV](/alloydb/docs/export-csv-file), exporting one table per file,\n using `psql`.\n\n- [DMP](/alloydb/docs/export-dmp-file), using `pg_dump` to create a\n portable, binary archive of your whole database.\n\n- [SQL](/alloydb/docs/export-sql-file), using `pg_dump` to create a list\n of DDL and SQL statements to reconstruct your database.\n\nWhat's next\n-----------\n\n- [Migrate data from a vector database to AlloyDB using LangChain](/alloydb/docs/ai/migrate-data-from-langchain-vector-stores-to-alloydb)."]]