Compartir a través de

az sql instance-failover-group-arc

Note

Esta referencia forma parte de la extensión arcdata para la CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az sql instance-failover-group-arc. Obtenga más información sobre las extensiones.

Administrar grupos de conmutación por error de instancia administrada de SQL habilitados para Arc.

Comandos

Nombre Description Tipo Estado
az sql instance-failover-group-arc create

Cree un recurso de grupo de conmutación por error.

 Extension GA
az sql instance-failover-group-arc delete

Elimine un grupo de conmutación por error de SQL habilitado para Arc Instancia administrada.

 Extension GA
az sql instance-failover-group-arc list

Enumera todos los grupos de conmutación por error.

 Extension GA
az sql instance-failover-group-arc show

Muestra los detalles de un recurso de grupo de conmutación por error.

 Extension GA
az sql instance-failover-group-arc update

Actualice un recurso de grupo de conmutación por error.

 Extension GA

az sql instance-failover-group-arc create

Cree un recurso de grupo de conmutación por error.

Cree un recurso de grupo de conmutación por error de SQL habilitado para Arc Instancia administrada para configurar un grupo de disponibilidad distribuido.

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]

Ejemplos

Use la API de Kubernetes para crear un recurso de grupo de conmutación por error entre la instancia administrada de SQL principal sqlmi1 y la instancia administrada de SQL asociada sqlmi2. Se requieren el punto de conexión de creación de reflejo del asociado y el archivo de certificado.

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 Azure Resource Manager (ARM) para crear un recurso de grupo de conmutación por error.

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 ARM para crear un grupo de conmutación por error con direcciones URL de creación de reflejo 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 requeridos

--mi

Nombre de la instancia administrada de SQL principal.

--name -n

Nombre del recurso del grupo de conmutación por error.

--partner-mi

Nombre de la instancia administrada de SQL asociada o instancia remota de SQL. Cuando se usan argumentos de destino de ARM, esto hace referencia al nombre de la instancia de recuperación ante desastres (DR).

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--k8s-namespace -k

Espacio de nombres donde se va a implementar el grupo de conmutación por error. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--partner-mirroring-cert-file -f

Nombre de archivo del certificado público del punto de conexión de creación de reflejo para la instancia administrada de SQL asociada o el grupo de disponibilidad en la instancia remota de SQL. Solo se admite el formato PEM.

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

Dirección URL del punto de conexión de creación de reflejo de la instancia administrada de SQL del asociado.

--partner-resource-group

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para el asociado de recuperación ante desastres de Arc.

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

Modo de sincronización de asociados de la instancia administrada de SQL habilitada para Arc.

Propiedad Valor
Valores aceptados: async, sync
--primary-mirroring-url

Dirección URL del punto de conexión de creación de reflejo de la instancia administrada de SQL principal.

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

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para Arc principal.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--role

Rol solicitado del grupo de conmutación por error. El rol se puede cambiar.

Propiedad Valor
Valores aceptados: primary, secondary
--shared-name

Nombre compartido del grupo de conmutación por error de esta instancia administrada de SQL. Tanto la instancia administrada de SQL principal como su asociado deben usar el mismo nombre compartido.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--use-k8s

Cree el grupo de conmutación por error de instancia administrada de SQL habilitada para Arc mediante las API de Kubernetes locales.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql instance-failover-group-arc delete

Elimine un grupo de conmutación por error de SQL habilitado para Arc Instancia administrada.

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

Ejemplos

Elimine un recurso de grupo de conmutación por error mediante la API de Kubernetes.

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

Elimine un recurso de grupo de conmutación por error mediante Azure Resource Manager.

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

Parámetros requeridos

--name -n

Nombre del recurso del grupo de conmutación por error que se va a eliminar.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--k8s-namespace -k

Espacio de nombres donde se implementa el grupo de conmutación por error. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--mi

Nombre de la instancia administrada de SQL habilitada para Arc principal.

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

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para Arc principal.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql instance-failover-group-arc list

Enumera todos los grupos de conmutación por error.

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

Ejemplos

Enumere todos los grupos de conmutación por error de un espacio de nombres mediante la API de Kubernetes.

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

Para enumerar todos los grupos de conmutación por error, consulte Azure Resource Manager (ARM).

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--k8s-namespace -k

Espacio de nombres donde se implementan los grupos de conmutación por error. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--mi

Nombre de la instancia administrada de SQL habilitada para Arc.

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

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para Arc.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql instance-failover-group-arc show

Muestra los detalles de un recurso de grupo de conmutación por error.

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

Ejemplos

Muestre los detalles de un grupo de conmutación por error mediante la API de Kubernetes.

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

Para mostrar los detalles de un grupo de conmutación por error, consulte Azure Resource Manager (ARM).

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

Parámetros requeridos

--name -n

Nombre del recurso del grupo de conmutación por error.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--k8s-namespace -k

Espacio de nombres donde se implementa el grupo de conmutación por error. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--mi

Nombre de la instancia administrada de SQL habilitada para Arc principal.

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

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para Arc principal.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql instance-failover-group-arc update

Actualice un recurso de grupo de conmutación por error.

Actualice un recurso de grupo de conmutación por error de SQL habilitado para Arc Instancia administrada para cambiar el rol del grupo de disponibilidad distribuido.

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]

Ejemplos

Actualice un recurso de grupo de conmutación por error al rol secundario del rol principal mediante la API de Kubernetes.

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

Actualice un recurso de grupo de conmutación por error mediante Azure Resource Manager.

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

Parámetros requeridos

--name -n

Nombre del recurso del grupo de conmutación por error.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--k8s-namespace -k

Espacio de nombres donde existe el grupo de conmutación por error. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--mi

Nombre de la instancia administrada de SQL habilitada para Arc que se va a actualizar.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--partner-sync-mode -m

Modo de sincronización de asociados de la instancia administrada de SQL.

Propiedad Valor
Valores aceptados: async, sync
--resource-group -g

El grupo de recursos de Azure de la instancia administrada de SQL habilitada para Arc principal.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--role

Rol solicitado del grupo de conmutación por error.

Propiedad Valor
Valores aceptados: force-primary-allow-data-loss, force-secondary, secondary
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False