az sql elastic-pool

Administrar grupos elásticos.

Comandos

Nombre	Description	Tipo	Estado
az sql elastic-pool create	Cree un grupo elástico.	Core	GA
az sql elastic-pool delete	Elimina un grupo elástico.	Core	GA
az sql elastic-pool list	Obtiene todos los grupos elásticos de un servidor.	Core	GA
az sql elastic-pool list-dbs	Obtiene una lista de bases de datos de un grupo elástico.	Core	GA
az sql elastic-pool list-editions	Enumera las ediciones del grupo elástico disponibles para la suscripción activa.	Core	GA
az sql elastic-pool op	Administrar operaciones en un grupo elástico.	Core	GA
az sql elastic-pool op cancel	Cancela la operación asincrónica en el grupo elástico.	Core	GA
az sql elastic-pool op list	Obtiene una lista de las operaciones realizadas en el grupo elástico.	Core	GA
az sql elastic-pool show	Obtiene un grupo elástico.	Core	GA
az sql elastic-pool update	Actualice un grupo elástico.	Core	GA

az sql elastic-pool create

Cree un grupo elástico.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--ha-replicas --read-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

Ejemplos

Creación de un grupo elástico con redundancia de zona habilitada

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

Creación de un grupo elástico con redundancia de zona deshabilitada explícitamente

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

Cree un grupo elástico estándar de 100 DTU.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

Cree un grupo elástico con la edición GeneralPurpose, hardware Gen4 y 1 núcleo virtual.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

Cree un grupo elástico con hyperscale edition, hardware Gen5, 4 núcleos virtuales y 2 réplicas de alta disponibilidad.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

Cree un grupo elástico con el enclave de VBS.

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

Parámetros requeridos

--name -n

Nombre del grupo elástico.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Parámetros opcionales

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

--capacity --dtu -c

Componente de capacidad de la SKU en número entero de DTU o vcores.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--db-dtu-max --db-max-capacity --db-max-dtu

Capacidad máxima (en DTU o vcores) que pueda consumir una base de datos.

--db-dtu-min --db-min-capacity --db-min-dtu

Se garantiza la capacidad minumum (en DTU o vcores) de cada base de datos.

--edition --tier -e

Componente de edición de la SKU. Entre los valores permitidos se incluyen: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--family -f

Componente de generación de proceso de la SKU (solo para SKU de núcleo virtual). Entre los valores permitidos se incluyen: Gen4, Gen5.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--ha-replicas --read-replicas

Número de réplicas de alta disponibilidad que se van a aprovisionar para la base de datos. Solo se puede establecer para la edición hiperescala.

--license-type

Tipo de licencia que se va a solicitar para este grupo elástico.

Propiedad	Valor
Valores aceptados:	BasePrice, LicenseIncluded

--maint-config-id -m

Identificador o nombre de configuración de mantenimiento especificado para este recurso.

--max-size --storage

Tamaño máximo de almacenamiento. Si no se especifica ninguna unidad, el valor predeterminado es bytes (B).

--no-wait

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

Propiedad	Valor
Valor predeterminado:	False

--preferred-enclave-type

Tipo de enclave preferido para el grupo elástico de Azure SQL. Entre los valores permitidos se incluyen: Default, VBS.

Propiedad	Valor
Valores aceptados:	Default, VBS

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Propiedad	Valor
Valores aceptados:	false, true

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 elastic-pool delete

Elimina un grupo elástico.

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre del grupo elástico.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

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

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id 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.

--verbose

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

Propiedad	Valor
Valor predeterminado:	False

az sql elastic-pool list

Obtiene todos los grupos elásticos de un servidor.

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--skip

Número de elementos de la colección que se van a omitir. El valor predeterminado es None.

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id 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.

--verbose

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

Propiedad	Valor
Valor predeterminado:	False

az sql elastic-pool list-dbs

Obtiene una lista de bases de datos de un grupo elástico.

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre del grupo elástico.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id 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.

--verbose

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

Propiedad	Valor
Valor predeterminado:	False

az sql elastic-pool list-editions

Enumera las ediciones del grupo elástico disponibles para la suscripción activa.

Además incluye los parámetros disponibles de DTU de grupo, los límites de almacenamiento y la configuración por base de datos. Para reducir el nivel de detalle, los límites de almacenamiento y la configuración por base de datos adicionales están ocultos de forma predeterminada.

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition --tier]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

Ejemplos

Muestra todas las ediciones del grupo elástico y los límites de DTU del grupo en la región Oeste de EE. UU.

az sql elastic-pool list-editions -l westus -o table

Mostrar todos los límites de DTU del grupo para la edición Standard en la región Oeste de EE. UU.

az sql elastic-pool list-editions -l westus --edition Standard -o table

Mostrar tamaños máximos disponibles para grupos elásticos con al menos 100 DTU en la región Oeste de EE. UU.

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

Mostrar la configuración disponible por base de datos para grupos elásticos estándar de 100 DTU en la región Oeste de EE. UU.

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

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.

--available -a

Si se especifica, muestre solo los resultados disponibles en la región especificada.

Propiedad	Valor
Valor predeterminado:	False

--dtu

Número de DTU que se van a buscar. Si no se especifica, se muestran todos los tamaños de DTU.

Propiedad	Valor
Grupo de parámetros:	Search Arguments

--edition --tier -e

Edición que se va a buscar. Si no se especifica, se muestran todas las ediciones.

Propiedad	Valor
Grupo de parámetros:	Search Arguments

--show-details -d

Lista de detalles adicionales que se van a incluir en la salida.

Propiedad	Valor
Valores aceptados:	db-max-dtu, db-max-size, db-min-dtu, max-size

--vcores

Número de vcores que se van a buscar. Si no se especifica, se muestran todos los tamaños de núcleo virtual.

Propiedad	Valor
Grupo de parámetros:	Search 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 elastic-pool show

Obtiene un grupo elástico.

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre del grupo elástico.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id 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.

--verbose

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

Propiedad	Valor
Valor predeterminado:	False

az sql elastic-pool update

Actualice un grupo elástico.

az sql elastic-pool update [--add]
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--force-string]
                           [--ha-replicas --read-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

Ejemplos

Actualización del grupo elástico con redundancia de zona habilitada

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

Actualización del grupo elástico con redundancia de zona deshabilitada explícitamente

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

Actualización del grupo elástico con 2 réplicas de alta disponibilidad

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

Actualización del grupo elástico con el enclave de VBS

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

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.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--capacity --dtu -c

Componente de capacidad de la SKU en número entero de DTU o vcores.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--db-dtu-max --db-max-capacity --db-max-dtu

Capacidad máxima (en DTU o vcores) que pueda consumir una base de datos.

--db-dtu-min --db-min-capacity --db-min-dtu

Se garantiza la capacidad minumum (en DTU o vcores) de cada base de datos.

--edition --tier -e

Componente de edición de la SKU. Entre los valores permitidos se incluyen: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--family -f

Componente de generación de proceso de la SKU (solo para SKU de núcleo virtual). Entre los valores permitidos se incluyen: Gen4, Gen5.

Propiedad	Valor
Grupo de parámetros:	Performance Level (components) Arguments

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	False

--ha-replicas --read-replicas

Número de réplicas de alta disponibilidad que se van a aprovisionar para la base de datos. Solo se puede establecer para la edición hiperescala.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--maint-config-id -m

Identificador o nombre de configuración de mantenimiento especificado para este recurso.

--max-size --storage

Tamaño máximo de almacenamiento. Si no se especifica ninguna unidad, el valor predeterminado es bytes (B).

--name -n

Nombre del grupo elástico.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

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

Propiedad	Valor
Valor predeterminado:	False

--preferred-enclave-type

Tipo de enclave que se va a configurar para el grupo elástico.

Propiedad	Valor
Valores aceptados:	Default, VBS

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Propiedad	Valor
Valores aceptados:	false, true

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.

--verbose

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

Propiedad	Valor
Valor predeterminado:	False