Compartir a través de

az sql elastic-pool

  • Referencia

Administrar grupos elásticos.

Comandos

Nombre Description Tipo Estado
az sql elastic-pool create

Cree un grupo elástico.

 Principal GA
az sql elastic-pool delete

Elimina un grupo elástico.

 Principal GA
az sql elastic-pool list

Obtiene todos los grupos elásticos de un servidor.

 Principal GA
az sql elastic-pool list-dbs

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

 Principal GA
az sql elastic-pool list-editions

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

 Principal GA
az sql elastic-pool op

Administrar operaciones en un grupo elástico.

 Principal GA
az sql elastic-pool op cancel

Cancela la operación asincrónica en el grupo elástico.

 Principal GA
az sql elastic-pool op list

Obtiene una lista de las operaciones realizadas en el grupo elástico.

 Principal GA
az sql elastic-pool show

Obtiene un grupo elástico.

 Principal GA
az sql elastic-pool update

Actualice un grupo elástico.

 Principal GA

az sql elastic-pool create

Editar

Cree un grupo elástico.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--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

--capacity --dtu -c

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

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

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

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

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 hasta que finalice la operación de ejecución prolongada.

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.

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.

Valores aceptados: false, true
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 elastic-pool delete

Editar

Elimina un grupo elástico.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre del grupo elástico.

--no-wait

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

Valor predeterminado: False
--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>.

--subscription

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

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

Editar

Obtiene todos los grupos elásticos de un servidor.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

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

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 elastic-pool list-dbs

Editar

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

--subscription

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

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 elastic-pool list-editions

Editar

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

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

Parámetros opcionales

--available -a

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

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.

--edition --tier -e

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

--show-details -d

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

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.

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

Editar

Obtiene un grupo elástico.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

--subscription

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

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

Editar

Actualice un grupo elástico.

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--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

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

Valor predeterminado: []
--capacity --dtu -c

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

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

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

--force-string

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

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 espacios). 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".

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

--no-wait

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

Valor predeterminado: False
--preferred-enclave-type

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

Valores aceptados: Default, VBS
--remove

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

Valor predeterminado: []
--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>.

--set

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

Valor predeterminado: []
--subscription

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

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

Valores aceptados: false, true
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.