Partilhar via


az sql db replica

Gerencie a replicação entre bancos de dados.

Comandos

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

Principal GA
az sql db replica delete-link

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

Principal GA
az sql db replica list-links

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

Principal GA
az sql db replica set-primary

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

Principal 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]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

Exemplos

Crie um banco de dados com 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

Crie um banco de dados com a 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 redundante 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 Obrigatórios

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

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

Parâmetros Opcionais

--assign-identity -i

Atribua identidade para o banco de dados.

Valores aceites: 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á desativada.

--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 em número inteiro de DTUs ou vcores.

--compute-model

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

Valores aceites: Provisioned, Serverless
--elastic-pool

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

--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 do banco de dados. Pode ser verdadeiro, falso ou nulo.

Valores aceites: false, true
--family -f

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

--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. Apenas 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 para este banco de dados.LicenseIncluded se precisar de uma licença ou BasePricese tiver uma licença e estiver elegível para o Azure HybridBenefit.

Valores aceites: BasePrice, LicenseIncluded
--min-capacity

Capacidade mínima que o banco de dados sempre terá alocado, se não pausado.

--no-wait

Não espere que a operação de longa duração termine.

Default value: 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.

--preferred-enclave-type

Especifica o tipo de enclave para este recurso.

Valores aceites: Default, VBS
--read-scale

Se habilitada, as conexões que têm a intenção do aplicativo definida como somente leitura em sua cadeia de conexão podem ser roteadas para uma réplica secundária somente leitura. Esta propriedade só é configurável para bancos de dados Premium e Business Critical.

Valores aceites: Disabled, Enabled
--secondary-type

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

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

O objetivo de 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.

--tags

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

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

A lista de identidade atribuída ao usuário para o Banco de dados SQL.

--zone-redundant -z

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

Valores aceites: false, true
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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 em que a outra réplica está.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do Banco de Dados SQL do Azure.

--partner-resource-group

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

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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. (gerado automaticamente)

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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do Banco de Dados SQL do Azure.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az sql db replica set-primary

Defina o banco de dados de réplica primária fazendo failover do banco de dados de 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 de réplica primária atual. (gerado automaticamente)

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

Parâmetros Opcionais

--allow-data-loss

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

Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do banco de dados a ser submetido a failover.

--resource-group -g

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

--server -s

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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