Compartilhar via


az postgres flexible-server replica

Gerenciar réplicas de leitura.

Comandos

Nome Description Tipo Status
az postgres flexible-server replica create

Crie uma réplica de leitura para um servidor.

Núcleo GA
az postgres flexible-server replica list

Liste todas as réplicas de leitura para um determinado servidor.

Núcleo GA
az postgres flexible-server replica promote

Interrompa a replicação de uma réplica de leitura e promova-a para um servidor independente ou como um servidor primário.

Núcleo GA

az postgres flexible-server replica create

Crie uma réplica de leitura para um servidor.

az postgres flexible-server replica create --replica-name
                                           --resource-group
                                           --source-server
                                           [--address-prefixes]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

Exemplos

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com acesso público ou privado na zona e local especificados, se disponível.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --zone 3 --location testLocation

Crie uma réplica de leitura 'testreplicaserver' com uma nova sub-rede para 'testserver' com acesso privado.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com \
  --tags "key=value"

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com acesso público ou privado no local especificado, se disponível. Como a zona não é passada, ela automaticamente pegará a zona no local da réplica, que é diferente do servidor de origem, se disponível, caso contrário, ele pegará a zona igual ao servidor de origem no local da réplica, se disponível, caso contrário, definirá a zona como Nenhuma, ou seja, nenhuma preferência

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --location testLocation

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com --storage-size e --sku personalizados.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

Crie uma réplica de leitura 'testreplicaserver' para 'testserver', em que 'testreplicaserver' está em um grupo de recursos diferente 'newTestGroup'. Aqui --resource-group é para o grupo de recursos da réplica de leitura e --source-server deve ser passado como ID do recurso.

az postgres flexible-server replica create --replica-name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName} --location testLocation

Parâmetros Exigidos

--replica-name

O nome do servidor para o qual restaurar.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--source-server

O nome ou a ID do recurso do servidor de origem do qual restaurar.

Parâmetros Opcionais

--address-prefixes

O prefixo de endereço IP a ser usado ao criar uma nova rede virtual no formato CIDR. O valor padrão é 10.0.0.0/16.

--identity

O nome ou a ID do recurso da identidade atribuída pelo usuário para criptografia de dados.

--key

A ID do recurso da chave de chave primária para criptografia de dados.

--location -l

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

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--performance-tier

Camada de desempenho do servidor.

--private-dns-zone

Esse parâmetro só se aplica a um servidor com acesso privado. O nome ou a ID da zona DNS privada nova ou existente. Você pode usar a zona dns privada do mesmo grupo de recursos, grupo de recursos diferente ou assinatura diferente. Se você quiser usar uma zona de um grupo de recursos ou assinatura diferente, forneça a ID do recurso. A CLI criará uma nova zona dns privada dentro do mesmo grupo de recursos que a rede virtual, se não for fornecida pelos usuários.

--sku-name

O nome da SKU de computação. Segue a convenção Standard_{nome da VM}. Exemplos: Standard_B1ms.

--storage-size

A capacidade de armazenamento do servidor. O mínimo é de 32 GiB e o máximo é de 16 TiB.

--subnet

Nome ou ID de recurso de uma sub-rede nova ou existente. Se você quiser usar uma sub-rede de um grupo de recursos ou assinatura diferente, forneça a ID do recurso em vez do nome. Observe que a sub-rede será delegada a flexibleServers. Após a delegação, essa sub-rede não pode ser usada para qualquer outro tipo de recursos do Azure.

--subnet-prefixes

O prefixo de endereço IP da sub-rede a ser usado ao criar uma nova sub-rede no formato CIDR. O valor padrão é 10.0.0.0/24.

--tags

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

--tier

Camada de computação do servidor. Valores aceitos: Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Nome ou ID de uma rede virtual nova ou existente. Se você quiser usar uma vnet de um grupo de recursos ou assinatura diferente, forneça uma ID de recurso. O nome deve ter entre 2 e 64 caracteres. O nome deve começar com uma letra ou número, terminar com uma letra, número ou sublinhado e pode conter apenas letras, números, sublinhados, períodos ou hifens.

--yes -y

Não solicite confirmação.

Valor padrão: False
--zone -z

Zona de disponibilidade na qual provisionar o recurso.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az postgres flexible-server replica list

Liste todas as réplicas de leitura para um determinado servidor.

az postgres flexible-server replica list --name
                                         --resource-group

Exemplos

Liste todas as réplicas de leitura para o servidor mestre 'testserver'.

az postgres flexible-server replica list -g testGroup -n testserver

Parâmetros Exigidos

--name -n

Nome do servidor de origem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az postgres flexible-server replica promote

Interrompa a replicação de uma réplica de leitura e promova-a para um servidor independente ou como um servidor primário.

az postgres flexible-server replica promote [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

Exemplos

Interrompa a replicação para "testreplicaserver" e promova-o em um servidor autônomo de leitura/gravação.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver

Interrompa a replicação para "testreplicaserver" e promova um servidor autônomo de leitura/gravação com sincronização de dados forçada.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode standalone --promote-option forced

Pare a replicação para "testreplicaserver" e promova-a para o servidor primário com a sincronização de dados planejada. A réplica que você está promovendo deve ter o ponto de extremidade virtual do leitor atribuído ou você receberá um erro na promoção.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode switchover --promote-option planned

Parâmetros Opcionais

--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'.

--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.

--promote-mode

Se deseja promover a réplica de leitura para um servidor independente ou promovê-la como um servidor primário.

Valores aceitos: standalone, switchover
Valor padrão: standalone
--promote-option

Se os dados devem ser sincronizados antes de promover a réplica de leitura ou promover o mais rápido possível.

Valores aceitos: forced, planned
Valor padrão: planned
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

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

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.