Compartilhar via


az sql db replica

Gerenciar a replicação entre bancos de dados.

Comandos

Nome Description Tipo Status
az sql db replica create

Crie um banco de dados como uma réplica secundária legível de um banco de dados existente.

Core GA
az sql db replica delete-link

Pare permanentemente a replicação de dados entre duas réplicas de banco de dados.

Core GA
az sql db replica list-links

Liste as réplicas de um banco de dados e seu status de replicação.

Core GA
az sql db replica set-primary

Defina o banco de dados de réplica primária fazendo failover do banco de dados da réplica primária atual.

Core GA

az sql db replica create

Crie um banco de dados como uma réplica secundária legível de um banco de dados existente.

Uma lista completa de opções de nível de desempenho pode ser vista executando az sql db list-editions -a -o table -l LOCATION. O banco de dados secundário deve ter a mesma edição que o banco de dados primário.

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy --bsr]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation --epauto {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas --read-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--partner-sub-id]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective --service-objective]
                         [--tags]
                         [--umi --user-assigned-identity-id]
                         [--zone-redundant {false, true}]

Exemplos

Crie um banco de dados com o nível de desempenho S0 como uma réplica secundária de um banco de dados Standard existente.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

Criar um banco de dados com edição GeneralPurpose, hardware Gen4 e 1 vcore como uma réplica secundária de um banco de dados GeneralPurpose existente

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

Crie um banco de dados com armazenamento de backup com redundância de zona como uma réplica secundária de um banco de dados existente.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

Parâmetros Exigidos

--name -n

Nome do Banco de Dados SQL do Azure.

--partner-server

Nome do servidor no qual criar a nova réplica.

--resource-group -g

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

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>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.

--assign-identity -i

Atribuir identidade ao banco de dados.

Propriedade Valor
Valores aceitos: false, true
--auto-pause-delay

Tempo em minutos após o qual o banco de dados é pausado automaticamente. Um valor de -1 significa que a pausa automática está desabilitada.

Propriedade Valor
Grupo de parâmetros: Serverless offering Arguments
--availability-zone

Zona de disponibilidade.

--backup-storage-redundancy --bsr

Redundância de armazenamento de backup usada para armazenar backups. Os valores permitidos incluem: Local, Zone, Geo, GeoZone.

--capacity -c

O componente de capacidade do sku no número inteiro de DTUs ou vcores.

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--compute-model

O modelo de computação do banco de dados.

Propriedade Valor
Grupo de parâmetros: Serverless offering Arguments
Valores aceitos: Provisioned, Serverless
--elastic-pool

O nome ou a ID do recurso do pool elástico no qual criar o banco de dados.

Propriedade Valor
Grupo de parâmetros: Performance Level Arguments
--encryption-protector

Especifica a chave do cofre de chaves do Azure a ser usada como chave protetora de criptografia de banco de dados.

--encryption-protector-auto-rotation --epauto

Especifica o sinalizador de rotação automática da chave do protetor de criptografia de banco de dados. Pode ser verdadeiro, falso ou nulo.

Propriedade Valor
Valores aceitos: false, true
--family -f

O componente de geração de computação do sku (somente para vcore skus). Os valores permitidos incluem: Gen4, Gen5.

Propriedade Valor
Grupo de parâmetros: Performance Level (components) Arguments
--federated-client-id

A ID do cliente federado para o Banco de Dados SQL. Ele é usado para o cenário de CMK entre locatários.

--ha-replicas --read-replicas

O número de réplicas de alta disponibilidade a serem provisionadas para o banco de dados. Somente configurável para a edição Hyperscale.

--keys

A lista de chaves AKV para o Banco de Dados SQL.

--license-type

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncluded se você precisar de uma licença ou BasePricese tiver uma licença e estiver qualificado para o Azure HybridBenefit.

Propriedade Valor
Valores aceitos: BasePrice, LicenseIncluded
--min-capacity

Capacidade mínima que o banco de dados sempre alocará, se não estiver em pausa.

Propriedade Valor
Grupo de parâmetros: Serverless offering Arguments
--no-wait

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

Propriedade Valor
Valor padrão: False
--partner-database

Nome da nova réplica. Se não for especificado, o padrão será o nome do banco de dados de origem.

--partner-resource-group

Nome do grupo de recursos no qual criar a nova réplica. Se não for especificado, o padrão será o grupo de recursos de origem.

--partner-sub-id

ID da assinatura na qual criar a nova réplica. Se não for especificado, o padrão será a ID da assinatura de origem.

--preferred-enclave-type

Especifica o tipo de enclave para esse recurso.

Propriedade Valor
Valores aceitos: Default, VBS
--read-scale

Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica somente leitura secundária. Essa propriedade só é configurável para bancos de dados Premium e Comercialmente Críticos.

Propriedade Valor
Valores aceitos: Disabled, Enabled
--secondary-type

Tipo de secundário a ser criado. Os valores permitidos incluem: Geo, Named.

--service-level-objective --service-objective

O objetivo do serviço para o novo banco de dados. Por exemplo: Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

Propriedade Valor
Grupo de parâmetros: Performance Level Arguments
--tags

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

--umi --user-assigned-identity-id

A lista de identidade atribuída pelo usuário para o Banco de Dados SQL.

--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão será verdadeiro se nenhum valor for especificado.

Propriedade Valor
Valores aceitos: false, true
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

Pare permanentemente a replicação de dados entre duas réplicas de banco de dados.

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

Nome do servidor no qual a outra réplica está.

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 Banco de Dados SQL do Azure.

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

Nome do grupo de recursos no qual a outra réplica está. Se não for especificado, o padrão será o grupo de recursos do primeiro banco de dados.

--resource-group -g

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

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

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>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
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
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

Liste as réplicas de um banco de dados e seu status de replicação.

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Liste as réplicas de um banco de dados e seu status de replicação. (autogenerated)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

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 Banco de Dados SQL do Azure.

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

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

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

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>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 sql db replica set-primary

Defina o banco de dados de réplica primária fazendo failover do banco de dados da réplica primária atual.

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

Exemplos

Defina o banco de dados de réplica primária fazendo failover do banco de dados da réplica primária atual. (autogenerated)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

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.

--allow-data-loss

Se especificada, a operação de failover permitirá a perda de dados.

Propriedade Valor
Valor padrão: False
--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 banco de dados para failover.

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

Nome do grupo de recursos que contém a réplica secundária que se tornará o novo primário.

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

Nome do servidor que contém a réplica secundária que se tornará o novo primário. Você pode configurar o padrão usando az configure --defaults sql-server=<name>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