Compartilhar via

az postgres flexible-server migration

Gerenciar fluxos de trabalho de migração para servidores flexíveis do PostgreSQL.

Comandos

Nome Description Tipo Status
az postgres flexible-server migration check-name-availability

Verifica se o nome da migração fornecido pode ser usado.

 Core GA
az postgres flexible-server migration create

Crie um novo fluxo de trabalho de migração para um servidor flexível.

 Core GA
az postgres flexible-server migration list

Listar as migrações de um servidor flexível.

 Core GA
az postgres flexible-server migration show

Obtenha os detalhes de uma migração específica.

 Core GA
az postgres flexible-server migration update

Atualize uma migração específica.

 Core GA

az postgres flexible-server migration check-name-availability

Verifica se o nome da migração fornecido pode ser usado.

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

Exemplos

Verifique se o nome da migração fornecido está disponível para o fluxo de trabalho de migração.

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

Parâmetros Exigidos

--migration-name

Nome da migração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do Grupo de Recursos do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az postgres flexible-server migration create

Crie um novo fluxo de trabalho de migração para um servidor flexível.

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

Exemplos

Inicie um fluxo de trabalho de migração no servidor de destino identificado pelos parâmetros. As configurações da migração devem ser especificadas no arquivo de propriedades. As propriedades diferentes são definidas como: sourceDbServerResourceId: detalhes do servidor de origem. adminCredentials: esse parâmetro lista senhas para usuários administradores tanto para o servidor de origem quanto para o servidor flexível postgreSQL de destino. targetServerUserName: o valor padrão é o usuário administrador criado durante a criação do servidor flexível de destino postgreSQL e a senha fornecida é usada para autenticação nesse usuário. dbsToMigrate: especifique a lista de bancos de dados que você deseja migrar para o Servidor Flexível. overwriteDBsInTarget: quando definido como true (padrão), se o servidor de destino tiver um banco de dados existente com o mesmo nome que o que você está tentando migrar, o serviço de migração substituirá automaticamente o banco de dados. Exemplo de migrationConfig.json para PostgreSQLSingleServer mostrado abaixo. { "properties": { "sourceDBServerResourceId": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxx/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"

Inicie um fluxo de trabalho de migração no servidor de destino identificado pelos parâmetros. As configurações da migração devem ser especificadas no arquivo migrationConfig.json. Use --migration-mode offline para migração offline.

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

Inicie um fluxo de trabalho de migração no servidor de destino identificado pelos parâmetros. As configurações da migração devem ser especificadas no arquivo migrationConfig.json. Use o modo de migração online para migração online (com CDC). Use a opção de migração Validar para validar somente a solicitação.

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

Inicie um fluxo de trabalho de migração no servidor de destino identificado pelos parâmetros. As configurações da migração devem ser especificadas no arquivo migrationConfig.json. Use --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

Para iniciar uma migração diferente de PostgreSQLSingleServer, soureType e sslMode devem ser especificados no arquivo de propriedades. Essas propriedades são definidas como: sourceType: Os valores podem ser – OnPremises, AWS_AURORA, AWS_RDS, AzureVM, PostgreSQLSingleServer sslMode: modos SSL para migração. O modo SSL para PostgreSQLSingleServer é VerifyFull e Prefer/Require para outros tipos de origem. Exemplo migrationConfig.json mostrado abaixo. { "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"

Inicie um fluxo de trabalho de migração habilitado para ponto de extremidade privado no servidor de destino especificando migrationRuntimeResourceId no arquivo de propriedades. Essa propriedade é definida como: migrationRuntimeResourceId: a ID do recurso do servidor de runtime de migração responsável pela migração de dados entre o servidor de origem e de destino. Exemplo migrationConfig.json mostrado abaixo. { "properties": { "sourceDBServerResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/test-single-rg/providers/Microsoft.DBforPostgreSQL/servers/pg-single-1", "migrationRuntimeResourceId": "//subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxx/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"

Parâmetros Exigidos

--name -n

Nome do servidor de destino de migração.

--properties -b

Propriedades da solicitação. Use aspas duplas ou nenhuma para passar o caminho do arquivo json como argumento.

--resource-group -g

Nome do Grupo de Recursos do servidor de destino de migração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--migration-mode

Migração offline ou online (com CDC).

Propriedade Valor
Valor padrão: offline
Valores aceitos: offline, online
--migration-name

Nome da migração.

--migration-option

Opção de migração com suporte. O padrão é ValidateAndMigrate.

Propriedade Valor
Valor padrão: ValidateAndMigrate
Valores aceitos: Migrate, Validate, ValidateAndMigrate
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az postgres flexible-server migration list

Listar as migrações de um servidor flexível.

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

Exemplos

Liste as migrações ativas no momento de um servidor flexível de destino.

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

Liste todas as migrações (Ativas/Concluídas) de um servidor flexível de destino.

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

Parâmetros Exigidos

--name -n

O nome do servidor. O nome pode conter apenas letras minúsculas, números e o caractere hífen (-). Mínimo de 3 caracteres e máximo de 63 caracteres.

--resource-group -g

Nome do Grupo de Recursos do servidor de destino de migração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

Indique se todas as migrações ou apenas as migrações ativas são retornadas. Os valores válidos são: Ativo e Todos.

Propriedade Valor
Valor padrão: Active
Valores aceitos: Active, All
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az postgres flexible-server migration show

Obtenha os detalhes de uma migração específica.

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

Exemplos

Obtenha os detalhes de uma migração específica de um servidor flexível de destino.

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

Parâmetros Exigidos

--migration-name

Nome da migração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do Grupo de Recursos do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az postgres flexible-server migration update

Atualize uma migração específica.

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

Exemplos

Permitir que o fluxo de trabalho de migração configure a replicação lógica na origem. Observe que esse comando reiniciará o servidor de origem.

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

Recortar a migração de dados para todos os bancos de dados envolvidos na migração. Depois que isso for concluído, as atualizações subsequentes para todos os bancos de dados na migração não serão migradas para o destino. A migração de substituição só pode ser disparada para migration_mode=Online.

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

Cancela a migração de dados para todos os bancos de dados envolvidos na migração. Somente a migração 'InProgress' pode ser cancelada

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

Parâmetros Exigidos

--migration-name

Nome da migração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cancel

Cancele a migração de dados para todos os bancos de dados.

--cutover

Recortar a migração de dados para todos os bancos de dados na migração. Depois que isso for concluído, as atualizações subsequentes para todos os bancos de dados não serão migradas para o destino.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

Nome do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do Grupo de Recursos do servidor de destino de migração.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--setup-replication

Permitir que o fluxo de trabalho de migração configure a replicação lógica na origem. Observe que esse comando reiniciará o servidor de origem.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False