Configuración de parámetros del servidor en Azure Database for MySQL con PowerShell
SE APLICA A:
Azure Database for MySQL: Servidor único
Importante
El servidor único de Azure Database for MySQL está en proceso de retirada. Es muy recomendable actualizar al servidor flexible de Azure Database for MySQL. Para obtener más información sobre la migración al servidor flexible de Azure Database for MySQL, consulte ¿Qué sucede con el servidor único de Azure Database for MySQL?
Puede enumerar, mostrar y actualizar los parámetros de configuración de un servidor de Azure Database for MySQL mediante PowerShell. En el nivel del servidor, se expone y se puede modificar un subconjunto de las opciones de configuración del motor.
Nota
Los parámetros del servidor se pueden actualizar globalmente en el servidor; use la CLI de Azure, PowerShell o Azure Portal.
Requisitos previos
Para completar esta guía, necesita:
- El módulo Az PowerShell instalado localmente o Azure Cloud Shell en el explorador
- Un servidor de Azure Database for MySQL
Importante
Mientras el módulo Az.MySql PowerShell se encuentra en versión preliminar, debe instalarlo por separado desde el módulo Az PowerShell con el siguiente comando: Install-Module -Name Az.MySql -AllowPrerelease.
Una vez que el módulo Az.MySql PowerShell esté disponible con carácter general, formará parte de las futuras versiones del módulo Az PowerShell y estará disponible de forma nativa en Azure Cloud Shell.
Si decide usar PowerShell de forma local, conéctese a su cuenta de Azure con el cmdlet Connect-AzAccount.
Azure Cloud Shell
En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.
Para iniciar Azure Cloud Shell:
| Opción | Ejemplo o vínculo |
|---|---|
| Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Solo con seleccionar Pruébelo no se copia automáticamente el código o comando en Cloud Shell. |  |
| Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. |  |
| Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. |  |
Para usar Azure Cloud Shell:
Inicie Cloud Shell.
Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.
Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.
Seleccione Enter para ejecutar el código o comando.
Lista de los parámetros de configuración del servidor de Azure Database for MySQL
Para obtener una lista de todos los parámetros modificables en un servidor y sus valores, ejecute el cmdlet Get-AzMySqlConfiguration.
En el ejemplo siguiente se enumeran los parámetros de configuración del servidor mydemoserver incluido en el grupo de recursos myresourcegroup.
Get-AzMySqlConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver
Para ver la definición de cada uno de los parámetros enumerados, consulte la sección de referencia de MySQL en Server System Variables (Variables del sistema del servidor).
Presentación de los detalles de los parámetros de configuración del servidor
Para mostrar los detalles de un parámetro de configuración determinado de un servidor, ejecute el cmdlet Get-AzMySqlConfiguration y especifique el parámetro Name.
En este ejemplo se muestran detalles del parámetro de configuración slow_query_log del servidor mydemoserver incluido en el grupo de recursos myresourcegroup.
Get-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver
Modificación de un valor de los parámetros de configuración del servidor
También puede modificar el valor de un determinado parámetro de configuración del servidor; esta acción actualizará el valor de configuración subyacente del motor del servidor de MySQL. Para actualizar la configuración, use el cmdlet Update-AzMySqlConfiguration.
Para actualizar el parámetro de configuración slow_query_log del servidor mydemoserver incluido en el grupo de recursos myresourcegroup.
Update-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On