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
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
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.
Nombre del conector de Active Directory. Este parámetro indica una intención de implementar con compatibilidad con AD.
Una lista separada por comas de los tipos de cifrado admitidos Active Directory. Debe ser un subconjunto de los siguientes valores: RC4, AES128, AES256.
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 |
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 |
Lista separada por comas de anotaciones de la instancia administrada de SQL.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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 |
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 |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Intercalación SQL Server para la instancia.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Límite de núcleos de la instancia administrada como un entero.
Solicitud de núcleos de la instancia administrada como un entero.
Ubicación personalizada de esta instancia.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Azure Resource Manager – targeted Arguments |
Si se especifica esto, se considera una instancia de desarrollo y no se facturará.
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 |
Nombre del secreto de Kubernetes que contiene el archivo keytab para este SQL Managed Instance habilitado para Arc.
Lista separada por comas de etiquetas de la instancia administrada de SQL.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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 |
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.
Límite de la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.
Solicitud de capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.
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 espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Número de réplicas de orquestador de alta disponibilidad. El valor debe estar comprendido entre 1 y 3.
Ruta de acceso al archivo azext_arcdata para el archivo JSON de instancia administrada de SQL.
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).
Número de puerto en el que se expone el servicio principal a los usuarios finales (por ejemplo, 31433).
Archivo de clave privada generado por openSSL para usarlo como identificador de instancia.
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.
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 |
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 |
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.
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).
Número de puerto en el que se expone el servicio secundario a los usuarios finales (por ejemplo, 31434).
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 |
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 |
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 |
Tipo del servicio principal.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | LoadBalancer, NodePort |
Lista separada por comas de anotaciones que se aplicarán a todos los PVC.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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.
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.
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.
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.
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.
Lista separada por comas de etiquetas que se aplicarán a todos los PVC.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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 |
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.
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 |
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 |
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.
Plan de tarifa de la instancia. Valores permitidos: BusinessCritical (bc for short) o GeneralPurpose (gp para short). El valor predeterminado es GeneralPurpose.
La SQL Server zona horaria de la instancia.
Lista separada por comas de traceflags. No hay marcas de forma predeterminada.
Cree una instancia administrada de SQL mediante las API locales de Kubernetes.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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).
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).
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).
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).
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
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 espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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 las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
Nombre de archivo local para almacenar el certificado recuperado en formato PEM.
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
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 las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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.
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 |
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 |
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 las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
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 espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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 |
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.
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 las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Una lista separada por comas de los tipos de cifrado admitidos Active Directory. Debe ser un subconjunto de los siguientes valores: RC4, AES128, AES256.
Habilite SQL Server agente para la instancia. El valor predeterminado está deshabilitado.
Lista separada por comas de anotaciones de la instancia administrada de SQL.
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 |
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 |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Límite de núcleos de la instancia administrada como un entero.
Solicitud de núcleos de la instancia administrada como un entero.
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 |
Nombre del secreto de Kubernetes que contiene el archivo keytab para este SQL Managed Instance habilitado para Arc.
Lista separada por comas de etiquetas de la instancia administrada de SQL.
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.
Límite de la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.
Solicitud de capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.
No espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Número de réplicas de orquestador de alta disponibilidad. El valor debe estar comprendido entre 1 y 3.
Ruta de acceso al archivo azext_arcdata para el archivo JSON de instancia administrada de SQL.
Réplica principal preferida que se va a actualizar.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
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.
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 |
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 |
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.
Lista separada por comas de anotaciones que se aplicarán a todos los servicios externos.
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 |
Lista separada por comas de etiquetas que se aplicarán a todos los servicios externos.
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 |
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.
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 |
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 |
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.
Plan de tarifa de la instancia. Valores permitidos: BusinessCritical (bc for short) o GeneralPurpose (gp para short). El valor predeterminado es GeneralPurpose.
La SQL Server zona horaria de la instancia.
Lista separada por comas de traceflags. No hay marcas de forma predeterminada.
Use las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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.
Adquirir un token de Azure Policy automáticamente para esta operación de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
Identificador de referencia de cambio relacionado para esta operación de recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Global Policy Arguments |
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.
Indica qué instancia se actualizaría, pero no actualiza realmente las instancias.
Filtre para seleccionar las instancias que se van a actualizar en función de las propiedades de los recursos.
Invalida todas las directivas que se pueden aplicar a la instancia e intenta la actualización.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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 |
Filtre para seleccionar la instancia para actualizar en función de las etiquetas.
Nombre de la instancia administrada de SQL.
No espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
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 |
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 las API locales de Kubernetes para realizar esta acción.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Kubernetes API – targeted Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |