Partilhar via

az sql instance-failover-group-arc

Note

Essa referência faz parte da extensão arcdata para a CLI do Azure (versão 2.3.1 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az sql instance-failover-group-arc. Saiba mais sobre extensões.

Gerencie Grupos de Failover de instâncias gerenciadas SQL habilitadas para Arc.

Comandos

Name Description Tipo Status
az sql instance-failover-group-arc create

Crie um recurso de grupo de failover.

 Extension disponibilidade geral
az sql instance-failover-group-arc delete

Exclua um grupo de failover de Instância Gerenciada SQL habilitado para Arc.

 Extension disponibilidade geral
az sql instance-failover-group-arc list

Liste todos os grupos de failover.

 Extension disponibilidade geral
az sql instance-failover-group-arc show

Mostrar os detalhes de um recurso de grupo de failover.

 Extension disponibilidade geral
az sql instance-failover-group-arc update

Atualize um recurso de grupo de failover.

 Extension disponibilidade geral

az sql instance-failover-group-arc create

Crie um recurso de grupo de failover.

Crie um recurso de grupo de failover de Instância Gerenciada SQL habilitado para Arc para configurar um grupo de disponibilidade distribuído.

az sql instance-failover-group-arc create --mi
                                          --name
                                          --partner-mi
                                          [--k8s-namespace]
                                          [--no-wait]
                                          [--partner-mirroring-cert-file]
                                          [--partner-mirroring-url]
                                          [--partner-resource-group]
                                          [--partner-sync-mode {async, sync}]
                                          [--primary-mirroring-url]
                                          [--resource-group]
                                          [--role {primary, secondary}]
                                          [--shared-name]
                                          [--use-k8s]

Exemplos

Use a API do Kubernetes para criar um recurso de grupo de failover entre a instância gerenciada SQL primária sqlmi1 e a instância gerenciada SQL do parceiro sqlmi2. O ponto de extremidade de espelhamento do parceiro e o arquivo cert são necessários.

az sql instance-failover-group-arc create --name fogcr --shared-name sharedname1 --mi sqlmi1 --role primary --partner-mi sqlmi2 --partner-mirroring-url 10.20.5.20:970 --partner-mirroring-cert-file ./sqlmi2.cer --use-k8s

Use o Azure Resource Manager (ARM) para criar um recurso de grupo de failover.

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async

Use o ARM para criar um grupo de failover com URLs de espelhamento personalizadas.

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async --primary-mirroring-url 21.10.6.30:6603 --partner-mirroring-url 10.20.5.20:970

Parâmetros Obrigatórios

--mi

O nome da instância gerenciada SQL primária.

--name -n

O nome do recurso do grupo de failover.

--partner-mi

O nome da instância gerenciada SQL do parceiro ou da instância remota do SQL. Ao usar argumentos direcionados a ARM, isso se refere ao nome da instância de recuperação de desastres (DR).

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.

--k8s-namespace -k

Namespace onde o grupo de failover deve ser implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--no-wait

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

Propriedade Valor
Default value: False
--partner-mirroring-cert-file -f

O nome do arquivo do certificado público de ponto de extremidade de espelhamento para a instância gerenciada SQL do parceiro ou grupo de disponibilidade na instância SQL remota. Apenas o formato PEM é suportado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--partner-mirroring-url -u

A URL do ponto de extremidade de espelhamento da instância gerenciada SQL do parceiro.

--partner-resource-group

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc do parceiro DR.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--partner-sync-mode -m

O modo de sincronização de parceiro da instância gerenciada SQL habilitada para Arc.

Propriedade Valor
Valores aceites: async, sync
--primary-mirroring-url

A URL do ponto de extremidade de espelhamento da instância gerenciada SQL primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--resource-group -g

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--role

A função solicitada do grupo de failover. O papel pode ser alterado.

Propriedade Valor
Valores aceites: primary, secondary
--shared-name

O nome compartilhado do grupo de failover para esta instância gerenciada pelo SQL. Tanto a instância gerenciada SQL primária quanto seu parceiro devem usar o mesmo nome compartilhado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--use-k8s

Crie o grupo de failover de instância gerenciada SQL habilitada para Arc usando APIs Kubernetes locais.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted 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.

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

az sql instance-failover-group-arc delete

Exclua um grupo de failover de Instância Gerenciada SQL habilitado para Arc.

az sql instance-failover-group-arc delete --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--resource-group]
                                          [--use-k8s]

Exemplos

Exclua um recurso de grupo de failover usando a API do Kubernetes.

az sql instance-failover-group-arc delete --name fogcr --use-k8s

Exclua um recurso de grupo de failover usando o Gerenciador de Recursos do Azure.

az sql instance-failover-group-arc delete --name fogcr --mi sqlmi1 -g rg-name

Parâmetros Obrigatórios

--name -n

O nome do recurso do grupo de failover a ser excluído.

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.

--k8s-namespace -k

Namespace onde o grupo de failover é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--mi

O nome da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--resource-group -g

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted 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.

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

az sql instance-failover-group-arc list

Liste todos os grupos de failover.

az sql instance-failover-group-arc list [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

Exemplos

Liste todos os grupos de failover em um namespace usando a API do Kubernetes.

az sql instance-failover-group-arc list --k8s-namespace arcdata --use-k8s

Liste todos os grupos de failover consultando o Azure Resource Manager (ARM).

az sql instance-failover-group-arc list --mi sqlmi1 -g rg-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.

--k8s-namespace -k

Namespace onde os grupos de failover são implantados. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--mi

O nome da instância gerenciada SQL habilitada para Arc.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--resource-group -g

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted 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.

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

az sql instance-failover-group-arc show

Mostrar os detalhes de um recurso de grupo de failover.

az sql instance-failover-group-arc show --name
                                        [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

Exemplos

Mostrar os detalhes de um grupo de failover usando a API do Kubernetes.

az sql instance-failover-group-arc show --name fogcr --use-k8s

Mostrar os detalhes de um grupo de failover consultando o Azure Resource Manager (ARM).

az sql instance-failover-group-arc show --name fogcr1 --mi sqlmi1 -g rg-name

Parâmetros Obrigatórios

--name -n

O nome do recurso do grupo de failover.

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.

--k8s-namespace -k

Namespace onde o grupo de failover é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--mi

O nome da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--resource-group -g

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted 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.

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

az sql instance-failover-group-arc update

Atualize um recurso de grupo de failover.

Atualize um recurso de grupo de failover de Instância Gerenciada SQL habilitado para Arc para alterar a função do grupo de disponibilidade distribuída.

az sql instance-failover-group-arc update --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--no-wait]
                                          [--partner-sync-mode {async, sync}]
                                          [--resource-group]
                                          [--role {force-primary-allow-data-loss, force-secondary, secondary}]
                                          [--use-k8s]

Exemplos

Atualize um recurso de grupo de failover para a função secundária de primária usando a API do Kubernetes.

az sql instance-failover-group-arc update --name fogcr --role secondary --use-k8s

Atualize um recurso de grupo de failover usando o Gerenciador de Recursos do Azure.

az sql instance-failover-group-arc update --name fogcr  --role secondary --mi sqlmi1 --resource-group rg-name

Parâmetros Obrigatórios

--name -n

O nome do recurso do grupo de failover.

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.

--k8s-namespace -k

Namespace onde o grupo de failover existe. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--mi

O nome da instância gerenciada SQL habilitada para Arc a ser atualizada.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--no-wait

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

Propriedade Valor
Default value: False
--partner-sync-mode -m

O modo de sincronização de parceiro da instância gerenciada SQL.

Propriedade Valor
Valores aceites: async, sync
--resource-group -g

O grupo de recursos do Azure da instância gerenciada SQL habilitada para Arc primária.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--role

A função solicitada do grupo de failover.

Propriedade Valor
Valores aceites: force-primary-allow-data-loss, force-secondary, secondary
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted 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.

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