Compartir a través de


az sql mi-arc

Note

Esta referencia forma parte de la extensión arcdata para el 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 mi-arc. Obtenga más información sobre las extensiones.

Administre instancias administradas de SQL habilitadas para Azure Arc.

Comandos

Nombre Description Tipo Estado
az sql mi-arc config

Comandos de configuración.

Extension GA
az sql mi-arc config add

Agregue un valor para una ruta de acceso json en un archivo de configuración.

Extension GA
az sql mi-arc config init

Inicialice el CRD y los archivos de especificación de una instancia administrada de SQL.

Extension GA
az sql mi-arc config patch

Aplique revisiones a un archivo de configuración basado en un archivo de revisión json.

Extension GA
az sql mi-arc config remove

Quite un valor de una ruta de acceso json en un archivo de configuración.

Extension GA
az sql mi-arc config replace

Reemplace un valor para una ruta de acceso json en un archivo de configuración.

Extension GA
az sql mi-arc create

Crea una instancia de SQL Managed Instance.

Extension GA
az sql mi-arc delete

Elimina una instancia de SQL Managed Instance.

Extension GA
az sql mi-arc endpoint

Permite ver y administrar puntos de conexión de SQL.

Extension GA
az sql mi-arc endpoint list

Enumera los puntos de conexión de SQL.

Extension GA
az sql mi-arc get-mirroring-cert

Recupere el certificado del punto de conexión de creación de reflejo del grupo de disponibilidad de sql mi y almacene en un archivo.

Extension GA
az sql mi-arc list

Enumera instancias de SQL Managed Instance.

Extension GA
az sql mi-arc reprovision-replica

Vuelva a aprovisionar una réplica en una instancia administrada de SQL.

Extension GA
az sql mi-arc show

Muestra los detalles de una instancia de SQL Managed Instance.

Extension GA
az sql mi-arc update

Actualice la configuración de una instancia administrada de SQL.

Extension GA
az sql mi-arc upgrade

Actualice la instancia administrada de SQL.

Extension GA

az sql mi-arc create

Crea una instancia de SQL Managed Instance.

Para establecer la contraseña de la instancia administrada de SQL, establezca la variable de entorno AZDATA_PASSWORD.

az sql mi-arc create --name
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--private-key-file]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

Ejemplos

Cree una instancia administrada de SQL a través de la API de Kubernetes.

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Cree una instancia administrada de SQL con 3 réplicas en el escenario de alta disponibilidad a través de la API de Kubernetes.

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

Cree una instancia administrada de SQL mediante Azure Resource Manager (ARM).

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Cree una instancia administrada de SQL con Active Directory autenticación mediante la API de Kubernetes.

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

Parámetros requeridos

--name -n

Nombre de la instancia administrada de SQL.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--ad-account-name

El nombre de la cuenta Active Directory para este SQL Managed Instance habilitado para Arc. Esta cuenta debe crearse antes de la implementación de esta instancia.

--ad-connector-name

Nombre del conector de Active Directory. Este parámetro indica una intención de implementar con compatibilidad con AD.

--ad-encryption-types

Una lista separada por comas de los tipos de cifrado admitidos Active Directory. Debe ser un subconjunto de los siguientes valores: RC4, AES128, AES256.

--admin-login-secret

Nombre del secreto de Kubernetes para generar los hosts o hospedará las credenciales de la cuenta de inicio de sesión de administrador de usuario.

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

Habilite SQL Server agente para la instancia. El valor predeterminado está deshabilitado. Los valores permitidos son "true" o "false".

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

Lista separada por comas de anotaciones de la instancia administrada de SQL.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--cert-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para SQL Server.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--cert-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para SQL Server.

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

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--collation

Intercalación SQL Server para la instancia.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--cores-limit -c

Límite de núcleos de la instancia administrada como un entero.

--cores-request

Solicitud de núcleos de la instancia administrada como un entero.

--custom-location

Ubicación personalizada de esta instancia.

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

Si se especifica esto, se considera una instancia de desarrollo y no se facturará.

--k8s-namespace -k

Espacio de nombres donde se va a implementar la instancia administrada de SQL. 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
--keytab-secret

Nombre del secreto de Kubernetes que contiene el archivo keytab para este SQL Managed Instance habilitado para Arc.

--labels

Lista separada por comas de etiquetas de la instancia administrada de SQL.

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

La configuración regional SQL Server a cualquier identificador de idioma (LCID) admitido para la instancia.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--license-type -l

El tipo de licencia que se va a aplicar para esta instancia administrada Los valores permitidos son: BasePrice, LicenseIncluded, DisasterRecovery.Default es LicenseIncluded. El tipo de licencia se puede cambiar.

--memory-limit -m

Límite de la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--memory-request

Solicitud de capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--no-external-endpoint

Si se especifica, no se creará ningún servicio externo. De lo contrario, se creará un servicio externo con el mismo tipo de servicio que el controlador de datos.

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

Número de réplicas de orquestador de alta disponibilidad. El valor debe estar comprendido entre 1 y 3.

--path

Ruta de acceso al archivo azext_arcdata para el archivo JSON de instancia administrada de SQL.

--primary-dns-name

El nombre DNS del servicio principal expuesto a los usuarios finales para conectarse a este SQL Managed Instance habilitado para Arc (por ejemplo, sqlinstancename.contoso.com).

--primary-port-number

Número de puerto en el que se expone el servicio principal a los usuarios finales (por ejemplo, 31433).

--private-key-file

Archivo de clave privada generado por openSSL para usarlo como identificador de instancia.

--readable-secondaries

Número de réplicas que se van a leer. Solo se aplica al nivel Crítico para la empresa. El valor debe estar comprendido entre 0 y el número de réplicas menos 1.

--replicas

Esta opción especifica el número de réplicas de SQL Managed Instance que se implementarán en el clúster de Kubernetes con fines de alta disponibilidad. El valor predeterminado es 1 réplica para uso general, 3 réplicas para crítico para la empresa.

Propiedad Valor
Valores aceptados: 1, 2, 3
--resource-group -g

El Azure grupo de recursos al que se debe agregar el SQL Managed Instance habilitado para Arc.

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

Período de retención de copia de seguridad, especificado en días. Los valores permitidos son de 0 a 35. El valor predeterminado es 7. Al establecer el período de retención en 0, se desactivarán las copias de seguridad automáticas de todas las bases de datos de la instancia administrada de SQL y se eliminarán las copias de seguridad anteriores.

--secondary-dns-name

Nombre DNS del servicio secundario expuesto a los usuarios finales para conectarse a este SQL Managed Instance habilitado para Arc (por ejemplo, sqlinstancename2.contoso.com).

--secondary-port-number

Número de puerto en el que se expone el servicio secundario a los usuarios finales (por ejemplo, 31434).

--service-annotations

Lista separada por comas de anotaciones que se aplicarán a todos los servicios externos.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--service-cert-secret

Nombre del secreto de Kubernetes para generar los hosts o hospedará el certificado del servicio SQL.

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

Lista separada por comas de etiquetas que se aplicarán a todos los servicios externos.

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

Tipo del servicio principal.

Propiedad Valor
Valores aceptados: LoadBalancer, NodePort
--storage-annotations

Lista separada por comas de anotaciones que se aplicarán a todos los PVC.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--storage-class-backups

Clase de almacenamiento compatible con ReadWriteMany (RWX) que se usará para copias de seguridad (/var/opt/mssql/backups). Si no se especifica ningún valor, se usará la clase de almacenamiento predeterminada.

--storage-class-data -d

Clase de almacenamiento que se va a usar para los archivos de datos (.mdf, .ndf). Si no se especifica ningún valor, no se especificará ninguna clase de almacenamiento, lo que dará lugar a Kubernetes mediante la clase de almacenamiento predeterminada.

--storage-class-datalogs

Clase de almacenamiento que se va a usar para los registros de base de datos (.ldf). Si no se especifica ningún valor, no se especificará ninguna clase de almacenamiento, lo que dará lugar a Kubernetes mediante la clase de almacenamiento predeterminada.

--storage-class-logs

Clase de almacenamiento que se va a usar para los registros (/var/log). Si no se especifica ningún valor, no se especificará ninguna clase de almacenamiento, lo que dará lugar a Kubernetes mediante la clase de almacenamiento predeterminada.

--storage-class-orchestrator-logs

Clase de almacenamiento que se va a usar para los registros de orquestador (/var/log). Si no se especifica ningún valor, no se especificará ninguna clase de almacenamiento, lo que dará lugar a Kubernetes mediante la clase de almacenamiento predeterminada.

--storage-labels

Lista separada por comas de etiquetas que se aplicarán a todos los PVC.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--sync-secondary-to-commit

Número de réplicas secundarias que se deben sincronizar para confirmar. Al establecer este valor en -1 se establecerá el número de secundarias sincronizadas necesarias en "(# de réplicas - 1) / 2", redondeado hacia abajo.

Propiedad Valor
Valor predeterminado: -1
Valores aceptados: -1, 0, 1, 2
--tde-mode

Modo de Cifrado de datos transparente (TDE) para este SQL Managed Instance habilitado para Arc. Valores permitidos: ServiceManaged, CustomerManaged o Disabled. El valor predeterminado es Deshabilitado.

--tde-protector-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para TDE.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para TDE.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--tde-protector-secret

Nombre del secreto de Kubernetes que contiene el certificado del protector de TDE y la clave privada de esta SQL Managed Instance habilitada para Arc. Solo se puede especificar para el modo TDE administrado por CustomerManaged.

--tier -t

Plan de tarifa de la instancia. Valores permitidos: BusinessCritical (bc for short) o GeneralPurpose (gp para short). El valor predeterminado es GeneralPurpose.

--time-zone

La SQL Server zona horaria de la instancia.

--trace-flags

Lista separada por comas de traceflags. No hay marcas de forma predeterminada.

--use-k8s

Cree una instancia administrada de SQL mediante las API locales de Kubernetes.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--volume-size-backups

Tamaño del volumen de almacenamiento que se va a usar para las copias de seguridad como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-data

Tamaño del volumen de almacenamiento que se va a usar para los datos como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-datalogs

Tamaño del volumen de almacenamiento que se va a usar para los registros de datos como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-logs

Tamaño del volumen de almacenamiento que se va a usar para los registros como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-orchestrator-logs

Tamaño del volumen de almacenamiento que se va a usar para los registros de orquestador como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

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 mi-arc delete

Elimina una instancia de SQL Managed Instance.

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Ejemplos

Elimine una instancia administrada de SQL a través de la API de Kubernetes.

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

Elimine una instancia administrada de SQL mediante Azure Resource Manager (ARM).

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

Parámetros requeridos

--name -n

Nombre de la instancia administrada de SQL 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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--k8s-namespace -k

Espacio de nombres donde se va a implementar la instancia administrada de SQL. 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
--resource-group -g

El grupo de recursos Azure en el que existe el SQL Managed Instance habilitado para Arc.

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

Use las API locales de Kubernetes 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 mi-arc get-mirroring-cert

Recupere el certificado del punto de conexión de creación de reflejo del grupo de disponibilidad de sql mi y almacene en un archivo.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--k8s-namespace]
                                 [--use-k8s]

Ejemplos

Recuperación del certificado del punto de conexión de creación de reflejo del grupo de disponibilidad de sqlmi1 y almacén en file fileName1

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

Parámetros requeridos

--cert-file

Nombre de archivo local para almacenar el certificado recuperado en formato PEM.

--name -n

Nombre de la instancia administrada de SQL.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--k8s-namespace -k

Espacio de nombres donde se va a implementar la instancia administrada de SQL. 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
--use-k8s

Use las API locales de Kubernetes 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 mi-arc list

Enumera instancias de SQL Managed Instance.

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

Ejemplos

Enumera instancias de SQL Managed Instance.

az sql mi-arc list --use-k8s

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.

--custom-location

Ubicación personalizada en la que se implementan las instancias administradas de SQL habilitadas para Arc. Si no se especifica, se mostrarán todas las instancias del grupo de recursos.

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

Espacio de nombres de Kubernetes que contiene las instancias administradas de SQL habilitadas para Arc. 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
--resource-group -g

El Azure grupo de recursos que contiene las instancias administradas de SQL habilitadas para Arc.

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

Use las API locales de Kubernetes 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 mi-arc reprovision-replica

Vuelva a aprovisionar una réplica en una instancia administrada de SQL.

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

Ejemplos

Ejemplo 1: Volver a aprovisionar la réplica 1 de SQL Managed Instance sqlmi1.

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

Parámetros requeridos

--name -n

Nombre de la réplica de instancia administrada de SQL que se va a volver a aprovisionar.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--k8s-namespace -k

Espacio de nombres donde se implementa la réplica de instancia administrada de SQL. 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
--use-k8s

Vuelva a aprovisionar la réplica de instancia administrada de SQL mediante las API locales de Kubernetes.

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 mi-arc show

Muestra los detalles de una instancia de SQL Managed Instance.

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

Ejemplos

Muestre los detalles de un SQL Managed Instance mediante la API de Kubernetes.

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

Muestre los detalles de un SQL Managed Instance consultando Azure Resource Manager (ARM).

az sql mi-arc show --name sqlmi1 --resource-group rg-name

Parámetros requeridos

--name -n

Nombre de la instancia administrada de SQL que se va a mostrar.

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 la instancia administrada de SQL. 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
--path -p

Ruta de acceso donde se debe escribir la especificación completa de la instancia administrada de SQL. Si se omite, la especificación se escribirá en la salida estándar.

--resource-group -g

El grupo de recursos Azure en el que existe el SQL Managed Instance habilitado para Arc.

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

Use las API locales de Kubernetes 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 mi-arc update

Actualice la configuración de una instancia administrada de SQL.

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

Ejemplos

Actualice la configuración de una instancia administrada de SQL.

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

Parámetros requeridos

--name -n

Nombre de la instancia administrada de SQL que se está editando. No se puede cambiar el nombre con el que se implementa la instancia.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--ad-encryption-types

Una lista separada por comas de los tipos de cifrado admitidos Active Directory. Debe ser un subconjunto de los siguientes valores: RC4, AES128, AES256.

--agent-enabled

Habilite SQL Server agente para la instancia. El valor predeterminado está deshabilitado.

--annotations

Lista separada por comas de anotaciones de la instancia administrada de SQL.

--cert-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para SQL Server.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--cert-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para SQL Server.

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

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--cores-limit -c

Límite de núcleos de la instancia administrada como un entero.

--cores-request

Solicitud de núcleos de la instancia administrada como un entero.

--k8s-namespace -k

Espacio de nombres donde se va a implementar la instancia administrada de SQL. 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
--keytab-secret

Nombre del secreto de Kubernetes que contiene el archivo keytab para este SQL Managed Instance habilitado para Arc.

--labels

Lista separada por comas de etiquetas de la instancia administrada de SQL.

--license-type -l

El tipo de licencia que se va a aplicar para esta instancia administrada Los valores permitidos son: BasePrice, LicenseIncluded, DisasterRecovery.Default es LicenseIncluded. El tipo de licencia se puede cambiar.

--memory-limit -m

Límite de la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--memory-request

Solicitud de capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--orchestrator-replicas

Número de réplicas de orquestador de alta disponibilidad. El valor debe estar comprendido entre 1 y 3.

--path

Ruta de acceso al archivo azext_arcdata para el archivo JSON de instancia administrada de SQL.

--preferred-primary-replica

Réplica principal preferida que se va a actualizar.

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

Número de réplicas que se van a leer. Solo se aplica al nivel Crítico para la empresa. El valor debe estar comprendido entre 0 y el número de réplicas menos 1.

--replicas

Esta opción especifica el número de réplicas de SQL Managed Instance que se implementarán en el clúster de Kubernetes con fines de alta disponibilidad.

Propiedad Valor
Valores aceptados: 1, 2, 3
--resource-group -g

El grupo de recursos Azure en el que existe el SQL Managed Instance habilitado para Arc.

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

Período de retención de copia de seguridad, especificado en días. Los valores permitidos son de 0 a 35. El valor predeterminado es 7. Al establecer el período de retención en 0, se desactivarán las copias de seguridad automáticas de todas las bases de datos de la instancia administrada de SQL y se eliminarán las copias de seguridad anteriores.

--service-annotations

Lista separada por comas de anotaciones que se aplicarán a todos los servicios externos.

--service-cert-secret

Nombre del secreto de Kubernetes para generar los hosts o hospedará el certificado del servicio SQL.

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

Lista separada por comas de etiquetas que se aplicarán a todos los servicios externos.

--sync-secondary-to-commit

Número de réplicas secundarias que se deben sincronizar para confirmar. Al establecer este valor en -1 se establecerá el número de secundarias sincronizadas necesarias en "(# de réplicas - 1) / 2", redondeado hacia abajo.

Propiedad Valor
Valores aceptados: -1, 0, 1, 2
--tde-mode

Modo de Cifrado de datos transparente (TDE) para este SQL Managed Instance habilitado para Arc. Valores permitidos: ServiceManaged, CustomerManaged o Disabled. El valor predeterminado es Deshabilitado.

--tde-protector-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para TDE.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para TDE.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--tde-protector-secret

Nombre del secreto de Kubernetes que contiene el certificado del protector de TDE y la clave privada de esta SQL Managed Instance habilitada para Arc. Solo se puede especificar para el modo TDE administrado por CustomerManaged.

--tier -t

Plan de tarifa de la instancia. Valores permitidos: BusinessCritical (bc for short) o GeneralPurpose (gp para short). El valor predeterminado es GeneralPurpose.

--time-zone

La SQL Server zona horaria de la instancia.

--trace-flags

Lista separada por comas de traceflags. No hay marcas de forma predeterminada.

--use-k8s

Use las API locales de Kubernetes 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 mi-arc upgrade

Actualice la instancia administrada de SQL.

Actualice la instancia administrada de SQL a la versión deseada especificada. Si no se especifica desired-version, se usará la versión del controlador de datos.

az sql mi-arc upgrade [--acquire-policy-token]
                      [--change-reference]
                      [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Ejemplos

Actualice la instancia administrada de SQL.

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--desired-version -v

La versión válida más reciente a la que actualizar. Opcional, si no se especifica ninguna versión, se usará la versión del controlador de datos. Especifique "auto" para actualizar automáticamente a la versión válida más reciente. Obtenga más información sobre las actualizaciones automáticas en: https://aka.ms/arc-sqlmi-auto-upgrade.

--dry-run -d

Indica qué instancia se actualizaría, pero no actualiza realmente las instancias.

--field-filter -f

Filtre para seleccionar las instancias que se van a actualizar en función de las propiedades de los recursos.

--force

Invalida todas las directivas que se pueden aplicar a la instancia e intenta la actualización.

Propiedad Valor
Valor predeterminado: False
--k8s-namespace -k

Espacio de nombres donde se va a implementar la instancia administrada de SQL. 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
--label-filter -l

Filtre para seleccionar la instancia para actualizar en función de las etiquetas.

--name -n

Nombre de la instancia administrada de SQL.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--resource-group -g

El grupo de recursos Azure en el que existe el SQL Managed Instance habilitado para Arc de destino.

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

La opción "--target" está en desuso y se quitará en una versión futura. Use "--desired-version" en su lugar.

La versión válida más reciente a la que actualizar. Opcional, si no se especifica ninguna versión, se usará la versión del controlador de datos. Especifique "auto" para actualizar automáticamente a la versión válida más reciente. Obtenga más información sobre las actualizaciones automáticas en: https://aka.ms/arc-sqlmi-auto-upgrade.

--use-k8s

Use las API locales de Kubernetes 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