Partager via

az postgres flexible-server migration

  • Référence

Gérer les flux de travail de migration pour les serveurs flexibles PostgreSQL.

Commandes

Nom Description Type État
az postgres flexible-server migration check-name-availability

Vérifie si le nom de migration fourni peut être utilisé.

 Core GA
az postgres flexible-server migration create

Créez un flux de travail de migration pour un serveur flexible.

 Core GA
az postgres flexible-server migration list

Répertoriez les migrations d’un serveur flexible.

 Core GA
az postgres flexible-server migration show

Obtenez les détails d’une migration spécifique.

 Core GA
az postgres flexible-server migration update

Mettez à jour une migration spécifique.

 Core GA

az postgres flexible-server migration check-name-availability

Vérifie si le nom de migration fourni peut être utilisé.

az postgres flexible-server migration check-name-availability --migration-name
                                                              [--ids]
                                                              [--name]
                                                              [--resource-group]
                                                              [--subscription]

Exemples

Vérifiez si le nom de migration fourni est disponible pour votre flux de travail de migration.

az postgres flexible-server migration check-name-availability --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Paramètres obligatoires

--migration-name

Nom de la migration.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du serveur cible de migration.

--resource-group -g

Nom du groupe de ressources du serveur cible de migration.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az postgres flexible-server migration create

Créez un flux de travail de migration pour un serveur flexible.

az postgres flexible-server migration create --name
                                             --properties
                                             --resource-group
                                             [--location]
                                             [--migration-mode {offline, online}]
                                             [--migration-name]
                                             [--migration-option {Migrate, Validate, ValidateAndMigrate}]
                                             [--tags]

Exemples

Démarrez un flux de travail de migration sur le serveur cible identifié par les paramètres. Les configurations de la migration doivent être spécifiées dans le fichier de propriétés. Les différentes propriétés sont définies comme suit : sourceDbServerResourceId : détails du serveur source. adminCredentials : ce paramètre répertorie les mots de passe des utilisateurs administrateurs pour le serveur source et le serveur flexible PostgreSQL cible. targetServerUserName : la valeur par défaut est l’utilisateur administrateur créé lors de la création du serveur flexible cible PostgreSQL, et le mot de passe fourni est utilisé pour l’authentification auprès de cet utilisateur. dbsToMigrate : spécifiez la liste des bases de données que vous souhaitez migrer vers un serveur flexible. overwriteDBsInTarget : lorsqu’il est défini sur true (valeur par défaut), si le serveur cible a une base de données existante portant le même nom que celui que vous essayez de migrer, le service de migration remplace automatiquement la base de données. Exemple de migrationConfig.json pour PostgreSQLSingleServer illustré ci-dessous. { « properties » : { « sourceDBServerResourceId » : « /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1 », « secretParameters » : { « adminCredentials » : { « sourceServerPassword » : « password », « targetServerPassword » : « password » }, « sourceServerUserName » : « testuser@pg-single-1 », « targetServerUserName » : « fspguser » }, « dBsToMigrate » : [ « postgres » ], « overwriteDbsInTarget » : « true » }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json"

Démarrez un flux de travail de migration sur le serveur cible identifié par les paramètres. Les configurations de la migration doivent être spécifiées dans le fichier migrationConfig.json. Utilisez le mode migration hors connexion pour la migration hors connexion.

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode offline

Démarrez un flux de travail de migration sur le serveur cible identifié par les paramètres. Les configurations de la migration doivent être spécifiées dans le fichier migrationConfig.json. Utilisez --migration-mode online for Online(with CDC). Utilisez l’option Migration-Option Validate pour valider uniquement la requête.

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-mode online --migration-option Validate

Démarrez un flux de travail de migration sur le serveur cible identifié par les paramètres. Les configurations de la migration doivent être spécifiées dans le fichier migrationConfig.json. Utilisez --migration-option Migrate for Migrate only request.

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver       --migration-name testmigration --properties "migrationConfig.json" --migration-option Migrate

Pour démarrer une migration pour d’autres que PostgreSQLSingleServer, soureType et sslMode doivent être spécifiés dans le fichier de propriétés. Ces propriétés sont définies comme suit : sourceType : Les valeurs peuvent être : localement, AWS_RDS, AzureVM, PostgreSQLSingleServer sslMode : modes SSL pour la migration. Le mode SSL pour PostgreSQLSingleServer est VerifyFull et Prefer/Require pour d’autres types de source. Exemple de migrationConfig.json indiqué ci-dessous. { « properties » : { « sourceDBServerResourceId » : « <<hostname or IP address>> :<port><username><>@<> », « secretParameters » : { « adminCredentials » : { « sourceServerPassword » : « password », « targetServerPassword » : « password » }, « sourceServerUserName » : « postgres », « targetServerUserName » : « fspguser » }, « dBsToMigrate » : [ « ticketdb »,"timedb »,"inventorydb » ], « overwriteDbsInTarget » : « true », « sourceType » : « OnPremises », « sslMode » : « Prefer » } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver         --migration-name testmigration --properties "migrationConfig.json"

Démarrez un workflow de migration avec point de terminaison privé sur le serveur cible en spécifiant migrationRuntimeResourceId dans le fichier de propriétés. Cette propriété est définie comme suit : migrationRuntimeResourceId : ID de ressource du serveur runtime de migration chargé de la migration des données entre le serveur source et le serveur cible. Exemple de migrationConfig.json indiqué ci-dessous. { « properties » : { « sourceDBServerResourceId » : « /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1 », « migrationRuntimeResourceId » : « /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/testsourcemigration », « secretParameters » : { « adminCredentials » : { « sourceServerPassword » : « password », » targetServerPassword » : « password » }, « sourceServerUserName » : « testuser@pg-single-1 », « targetServerUserName » : « fspguser » }, « dBsToMigrate » : [ « postgres » ], « overwriteDbsInTarget » : « true » } }

az postgres flexible-server migration create --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --properties "migrationConfig.json"

Paramètres obligatoires

--name -n

Nom du serveur cible de migration.

--properties -b

Propriétés de la requête. Utilisez des guillemets doubles ou inexistants pour passer un chemin de fichier json en tant qu’argument.

--resource-group -g

Nom du groupe de ressources du serveur cible de migration.

Paramètres facultatifs

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--migration-mode

Migration hors connexion ou en ligne(avec capture de données modifiées).

Valeurs acceptées: offline, online
Valeur par défaut: offline
--migration-name

Nom de la migration.

--migration-option

Option de migration prise en charge. La valeur par défaut est ValidateAndMigrate.

Valeurs acceptées: Migrate, Validate, ValidateAndMigrate
Valeur par défaut: ValidateAndMigrate
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az postgres flexible-server migration list

Répertoriez les migrations d’un serveur flexible.

az postgres flexible-server migration list --name
                                           --resource-group
                                           [--filter {Active, All}]

Exemples

Répertoriez les migrations actives d’un serveur flexible cible.

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter Active

Répertorier toutes les migrations (actives/terminées) d’un serveur flexible cible.

az postgres flexible-server migration list --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --filter All

Paramètres obligatoires

--name -n

Nom du serveur. Le nom ne peut contenir que des lettres minuscules, des chiffres et le caractère de trait d’union (-). 3 caractères minimum et 63 caractères maximum.

--resource-group -g

Nom du groupe de ressources du serveur cible de migration.

Paramètres facultatifs

--filter

Indiquez si toutes les migrations ou uniquement les migrations actives sont retournées. Les valeurs valides sont : Active et All.

Valeurs acceptées: Active, All
Valeur par défaut: Active
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az postgres flexible-server migration show

Obtenez les détails d’une migration spécifique.

az postgres flexible-server migration show --migration-name
                                           [--ids]
                                           [--name]
                                           [--resource-group]
                                           [--subscription]

Exemples

Obtenez les détails d’une migration spécifique d’un serveur flexible cible.

az postgres flexible-server migration show --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration

Paramètres obligatoires

--migration-name

Nom de la migration.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du serveur cible de migration.

--resource-group -g

Nom du groupe de ressources du serveur cible de migration.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az postgres flexible-server migration update

Mettez à jour une migration spécifique.

az postgres flexible-server migration update --migration-name
                                             [--cancel]
                                             [--cutover]
                                             [--ids]
                                             [--name]
                                             [--resource-group]
                                             [--setup-replication]
                                             [--subscription]

Exemples

Autoriser le flux de travail de migration à configurer la réplication logique sur la source. Notez que cette commande redémarre le serveur source.

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --setup-replication

Basculement de la migration des données pour toutes les bases de données impliquées dans la migration. Une fois cette opération terminée, les mises à jour suivantes de toutes les bases de données de la migration ne seront pas migrées vers la cible. La migration de basculement ne peut être déclenchée que pour migration_mode=Online.

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cutover

Annule la migration des données pour toutes les bases de données impliquées dans la migration. Seule la migration « InProgress » peut être annulée

az postgres flexible-server migration update --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group testGroup --name testserver --migration-name testmigration --cancel

Paramètres obligatoires

--migration-name

Nom de la migration.

Paramètres facultatifs

--cancel

Annulez la migration des données pour toutes les bases de données.

--cutover

Découpez la migration des données pour toutes les bases de données de la migration. Une fois cette opération terminée, les mises à jour suivantes de toutes les bases de données ne seront pas migrées vers la cible.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du serveur cible de migration.

--resource-group -g

Nom du groupe de ressources du serveur cible de migration.

--setup-replication

Autoriser le flux de travail de migration à configurer la réplication logique sur la source. Notez que cette commande redémarre le serveur source.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.