az sql mi-arc

Nota:

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 mi-arc . Obtenga más información sobre las extensiones.

Permite administrar instancias de SQL Managed Instance habilitadas para Azure Arc.

Comandos

Nombre Description Tipo Estado
az sql mi-arc config

Comandos de configuración.

Extensión GA
az sql mi-arc config add

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

Extensión GA
az sql mi-arc config init

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

Extensión GA
az sql mi-arc config patch

Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.

Extensión GA
az sql mi-arc config remove

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

Extensión GA
az sql mi-arc config replace

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

Extensión GA
az sql mi-arc create

Crea una instancia de SQL Managed Instance.

Extensión GA
az sql mi-arc delete

Elimina una instancia de SQL Managed Instance.

Extensión GA
az sql mi-arc edit

En desuso, use la actualización sobre la edición.

Extensión Obsoleto
az sql mi-arc endpoint

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

Extensión GA
az sql mi-arc endpoint list

Enumera los puntos de conexión de SQL.

Extensión GA
az sql mi-arc get-mirroring-cert

Recupera el certificado del punto de conexión de creación de reflejo del grupo de disponibilidad de SQL MI y lo almacena en un archivo.

Extensión GA
az sql mi-arc list

Enumera instancias de SQL Managed Instance.

Extensión GA
az sql mi-arc reprovision-replica

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

Extensión GA
az sql mi-arc show

Muestra los detalles de una instancia de SQL Managed Instance.

Extensión GA
az sql mi-arc update

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

Extensión GA
az sql mi-arc upgrade

Actualiza la instancia administrada de SQL.

Extensión 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
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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]
                     [--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 autenticación de Active Directory a través de 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 de SQL Managed Instance.

Parámetros opcionales

--ad-account-name

Nombre de la cuenta de Active Directory para este Instancia administrada de SQL habilitado para Arc. Esta cuenta debe crearse antes de la implementación de esta instancia.

--ad-connector-name

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

--ad-encryption-types

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

--admin-login-secret

Nombre del secreto de Kubernetes que se va a generar y que hospeda u hospedará la credencial de la cuenta de inicio de sesión del administrador de usuarios.

--agent-enabled

Habilitación del Agente SQL Server para la instancia. De forma predeterminada, está deshabilitada. Los valores predeterminados son "true" o "false".

--annotations

Lista separada por comas de anotaciones de la instancia de SQL Managed Instance.

--cert-private-key-file

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

--cert-public-key-file

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

--collation

La intercalación de SQL Server para la instancia.

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

--dev

Si se especifica, se considera una instancia de desarrollo y no se factura.

--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--keytab-secret

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

--labels

Lista separada por comas de etiquetas de la instancia de SQL Managed Instance.

--language

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

--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 la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--no-external-endpoint

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

--no-wait

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

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 del archivo JSON de la instancia de SQL Managed Instance.

--primary-dns-name

El nombre DNS del servicio principal expuesto a los usuarios finales para conectarse a este Instancia administrada SQL 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).

--readable-secondaries

Número de réplicas que se van a leer. Solo se aplica a Crítico para la empresa nivel. 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 Instancia administrada 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.

valores aceptados: 1, 2, 3
--resource-group -g

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

--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 Instancia administrada SQL 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 van a aplicar a todos los servicios externos.

--service-cert-secret

Nombre del secreto de Kubernetes que se va a generar y que hospeda u hospedará el certificado de servicio SQL.

--service-labels

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

--service-type

Tipo del servicio principal.

valores aceptados: LoadBalancer, NodePort
--storage-annotations

Lista separada por comas de anotaciones que se van a aplicar a todas las PCV.

--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 datos (.mdf, .ndf). Si no se especifica ningún valor, no se especifica ninguna clase de almacenamiento, lo que da lugar a que Kubernetes use la predeterminada.

--storage-class-datalogs

Clase de almacenamiento que se va a usar para los registros de datos (.ldf). Si no se especifica ningún valor, no se especifica ninguna clase de almacenamiento, lo que da lugar a que Kubernetes use la 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 especifica ninguna clase de almacenamiento, lo que da lugar a que Kubernetes use la 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 especifica ninguna clase de almacenamiento, lo que da lugar a que Kubernetes use la predeterminada.

--storage-labels

Lista separada por comas de etiquetas que se van a aplicar a todas las PCV.

--sync-secondary-to-commit

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

valores aceptados: -1, 0, 1, 2
valor predeterminado: -1
--tde-mode

Modo Cifrado de datos transparente (TDE) para este Instancia administrada de SQL 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.

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

--tde-protector-secret

Nombre del secreto de Kubernetes que contiene el certificado del protector de TDE y la clave privada de este Instancia administrada sql habilitado 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 para abreviar) o GeneralPurpose (gp para abreviar). El valor predeterminado es GeneralPurpose.

--time-zone

Zona horaria de SQL Server para la instancia.

--trace-flags

Lista separada por comas de marcas de seguimiento. De manera predeterminada, no hay marcas.

--use-k8s

Creación de una instancia de SQL Managed Instance mediante las API locales de Kubernetes.

--volume-size-backups

Tamaño del volumen de almacenamiento que se va a usar en 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 en 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 K (kilobytes), MB (megabytes) o GB (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 K (kilobytes), MB (megabytes) o GB (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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc delete

Elimina una instancia de SQL Managed Instance.

az sql mi-arc delete --name
                     [--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 de SQL Managed Instance que se va a eliminar.

Parámetros opcionales

--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--no-wait

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

valor predeterminado: False
--resource-group -g

El grupo de recursos de Azure en el que existe el Instancia administrada sql habilitado para Arc.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc edit

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use 'update' en su lugar.

En desuso, use la actualización sobre la edición.

az sql mi-arc edit --name
                   [--agent-enabled]
                   [--annotations]
                   [--cores-limit]
                   [--cores-request]
                   [--custom-location]
                   [--dev]
                   [--k8s-namespace]
                   [--labels]
                   [--license-type]
                   [--location]
                   [--memory-limit]
                   [--memory-request]
                   [--no-wait]
                   [--path]
                   [--resource-group]
                   [--retention-days]
                   [--service-annotations]
                   [--service-labels]
                   [--tag-name]
                   [--tag-value]
                   [--tier]
                   [--time-zone]
                   [--trace-flags]
                   [--use-k8s]

Parámetros requeridos

--name -n

Nombre de la instancia de SQL Managed Instance que se va a editar. El nombre con el que se implementa la instancia no se puede cambiar.

Parámetros opcionales

--agent-enabled

Habilitación del Agente SQL Server para la instancia. De forma predeterminada, está deshabilitada.

--annotations

Lista separada por comas de anotaciones de la instancia de SQL Managed Instance.

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

--dev

Si se especifica, se considera una instancia de desarrollo y no se factura.

--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--labels

Lista separada por comas de etiquetas de la instancia de SQL Managed Instance.

--license-type

El tipo de licencia que se va a actualizar para esta instancia administrada Los valores permitidos son: BasePrice, LicenseIncluded, DisasterRecovery. El valor predeterminado es LicenseIncluded.

--location

Ubicación de Azure en la que se almacenarán los metadatos de sqlmi (por ejemplo, eastus).

--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 la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--no-wait

Si se especifica, el comando no espera a que la instancia esté lista para devolver un valor.

valor predeterminado: False
--path

Ruta de acceso al archivo azext_arcdata del archivo JSON de la instancia de SQL Managed Instance.

--resource-group -g

El grupo de recursos de Azure en el que existe el Instancia administrada sql habilitado para Arc.

--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 van a aplicar a todos los servicios externos.

--service-labels

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

--tag-name

Nombre de etiqueta de la instancia administrada de SQL.

--tag-value

Valor de etiqueta de la instancia administrada de SQL.

--tier -t

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

--time-zone

Zona horaria de SQL Server para la instancia.

--trace-flags

Lista separada por comas de marcas de seguimiento. De manera predeterminada, no hay marcas.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc get-mirroring-cert

Recupera el certificado del punto de conexión de creación de reflejo del grupo de disponibilidad de SQL MI y lo almacena en un archivo.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--k8s-namespace]
                                 [--use-k8s]

Ejemplos

Recupera el certificado del punto de conexión de creación de reflejo de sqlmi1 y lo almacena en el archivo fileName1.

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

Parámetros requeridos

--cert-file

Nombre de archivo local en el que se va a almacenar el certificado recuperado en formato PEM.

--name -n

Nombre de la instancia de SQL Managed Instance.

Parámetros opcionales

--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--custom-location

Ubicación personalizada en la que se implementan los Instancia administrada sql habilitados para Arc. Si no se especifica, se mostrarán todas las instancias del grupo de recursos.

--k8s-namespace -k

Espacio de nombres de Kubernetes que contiene los Instancia administrada sql habilitados para Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--resource-group -g

El grupo de recursos de Azure que contiene los Instancia administrada sql habilitados para Arc.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

--no-wait

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

valor predeterminado: False
--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 una Instancia administrada de SQL mediante la API de Kubernetes.

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

Para mostrar los detalles de una Instancia administrada de SQL, consulte Azure Resource Manager (ARM).

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

Parámetros requeridos

--name -n

Nombre de la instancia de SQL Managed Instance que se va a mostrar.

Parámetros opcionales

--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--path -p

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

--resource-group -g

El grupo de recursos de Azure en el que existe el Instancia administrada sql habilitado para Arc.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc update

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

az sql mi-arc update --name
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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

Actualiza 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 de SQL Managed Instance que se va a editar. El nombre con el que se implementa la instancia no se puede cambiar.

Parámetros opcionales

--ad-encryption-types

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

--agent-enabled

Habilitación del Agente SQL Server para la instancia. De forma predeterminada, está deshabilitada.

--annotations

Lista separada por comas de anotaciones de la instancia de SQL Managed Instance.

--cert-private-key-file

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

--cert-public-key-file

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

--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 en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--keytab-secret

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

--labels

Lista separada por comas de etiquetas de la instancia de SQL Managed Instance.

--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 la capacidad de la instancia administrada como un número entero seguido de Gi (gigabytes). Ejemplo: 4Gi.

--no-wait

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

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 del archivo JSON de la instancia de SQL Managed Instance.

--preferred-primary-replica

Réplica principal preferida que se va a actualizar.

--readable-secondaries

Número de réplicas que se van a leer. Solo se aplica a Crítico para la empresa nivel. 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 Instancia administrada que se implementarán en el clúster de Kubernetes con fines de alta disponibilidad.

valores aceptados: 1, 2, 3
--resource-group -g

El grupo de recursos de Azure en el que existe el Instancia administrada sql habilitado para Arc.

--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 van a aplicar a todos los servicios externos.

--service-cert-secret

Nombre del secreto de Kubernetes que se va a generar y que hospeda u hospedará el certificado de servicio SQL.

--service-labels

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

--sync-secondary-to-commit

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

valores aceptados: -1, 0, 1, 2
--tde-mode

Modo Cifrado de datos transparente (TDE) para este Instancia administrada de SQL 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.

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

--tde-protector-secret

Nombre del secreto de Kubernetes que contiene el certificado del protector de TDE y la clave privada de este Instancia administrada sql habilitado 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 para abreviar) o GeneralPurpose (gp para abreviar). El valor predeterminado es GeneralPurpose.

--time-zone

Zona horaria de SQL Server para la instancia.

--trace-flags

Lista separada por comas de marcas de seguimiento. De manera predeterminada, no hay marcas.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc upgrade

Actualiza la instancia administrada de SQL.

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

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

Ejemplos

Actualiza la instancia administrada de SQL.

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

Parámetros opcionales

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

valor predeterminado: False
--k8s-namespace -k

Espacio de nombres en el que se implementará la instancia de SQL Managed Instance. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--label-filter -l

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

--name -n

Nombre de la instancia de SQL Managed Instance.

--no-wait

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

valor predeterminado: False
--resource-group -g

El grupo de recursos de Azure en el que existe el Instancia administrada SQL habilitado para Arc de destino.

--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 de Kubernetes locales para realizar esta acción.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.