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.

Core disponibilidade geral
az sql db replica delete-link

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

Core disponibilidade geral
az sql db replica list-links

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

Core disponibilidade geral
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.

Core disponibilidade geral

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--assign-identity -i

Atribua identidade para o banco de dados.

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

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 em 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 aceites: Provisioned, Serverless
--elastic-pool

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

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

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. 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 qualificado para o Azure HybridBenefit.

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

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

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

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

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

--partner-sub-id

ID da assinatura para 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 este recurso.

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

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

Propriedade Valor
Grupo de parâmetros: Performance Level Arguments
--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.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 em que a outra réplica está.

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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

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

Nome ou ID da subscrição. 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
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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

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

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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. (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 tornar-se necessários para que o comando seja executado com êxito.

--allow-data-loss

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

Propriedade Valor
Default value: False
--ids

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

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

Nome do banco de dados a ser submetido a 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á a nova primária.

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á a nova réplica primária. Você pode configurar o padrão usando az configure --defaults sql-server=<name>.

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

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False