Tutorial: Diseño de Azure Database for MySQL mediante la CLI de Azure

Artículo
06/01/2023

SE APLICA A: Azure Database for MySQL: Servidor único

Importante

El servidor único de Azure Database for MySQL está en la ruta de retirada. Se recomienda encarecidamente actualizar al servidor flexible de Azure Database for MySQL. Para más información sobre la migración al servidor flexible de Azure Database for MySQL, consulte ¿Qué ocurre con Azure Database for MySQL con servidor único?

Azure Database for MySQL es un servicio de base de datos relacional de Microsoft Cloud basado en el motor de base de datos de MySQL Community Edition. En este tutorial, usa la CLI (interfaz de la línea de comandos) de Azure y otras utilidades para aprender a hacer lo siguiente:

Creación de una instancia de Azure Database for MySQL
Configuración del firewall del servidor
Uso de la herramienta de línea de comandos mysql para crear una base de datos
Carga de datos de muestra
Consultar datos
Actualización de datos
Restauración de datos

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Requisitos previos

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
- Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
- Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

En este artículo se necesita la versión 2.0 o posterior de la CLI de Azure. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

Si tiene varias suscripciones, elija la adecuada donde se encuentre el recurso o para la cual se facture. Seleccione un identificador de suscripción específico en su cuenta mediante el comando az account set.

az account set --subscription 00000000-0000-0000-0000-000000000000

Crear un grupo de recursos

Cree un grupo de recursos con el comando az group create. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran recursos de Azure como un grupo.

En el ejemplo siguiente, se crea un grupo de recursos denominado myresourcegroup en la ubicación westus.

az group create --name myresourcegroup --location westus

Creación de un servidor de Azure Database for MySQL

Cree un servidor de Azure Database for MySQL con el comando az mysql server create. Un servidor puede administrar varias bases de datos. Normalmente se usa una base de datos independiente para cada proyecto o para cada usuario.

En el ejemplo siguiente se crea una Base de datos de Azure para el servidor MySQL situado en westus en el grupo de recursos myresourcegroup con el nombre mydemoserver. El servidor tiene un usuario administrador llamado myadmin. Se trata de un servidor Gen 5 de uso general con 2 núcleos virtuales. Sustituya <server_admin_password> por su propio valor.

az mysql server create --resource-group myresourcegroup --name mydemoserver --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 --version 5.7

El valor del parámetro sku-name sigue la convención {tarifa} _ {compute generation} _ {vCores} como en los ejemplos siguientes:

--sku-name B_Gen5_2 se asigna a Básico, Gen 5 y 2 núcleos virtuales.
--sku-name GP_Gen5_32 se asigna a De uso general, Gen 5 y 32 núcleos virtuales.
--sku-name MO_Gen5_2 se asigna a Optimizado para memoria, Gen 5 y 2 núcleos virtuales.

Para comprender cuáles son los valores válidos por región y nivel consulte la documentación sobre planes de tarifa.

Importante

El inicio de sesión y la contraseña de administrador del servidor que especifique aquí serán necesarios para iniciar sesión más adelante en ese servidor y en las bases de datos que se especificarán en esta guía de inicio rápido. Recuerde o grabe esta información para su uso posterior.

Configurar de la regla de firewall

Cree una regla de firewall de nivel de servidor de Azure Database for MySQL con el comando az mysql server firewall-rule create. Una regla de firewall de nivel de servidor permite que una aplicación externa, como una herramienta de línea de comandos de mysql o MySQL Workbench para conectarse al servidor a través del firewall del servicio Azure MySQL.

En el ejemplo siguiente se crea una regla de firewall denominada AllowMyIP que permite las conexiones desde una dirección IP específica, 192.168.0.1. Sustituya la dirección IP o rango de direcciones IP que se correspondan con aquella desde la que se está conectando.

az mysql server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

Obtención de la información de conexión

Para conectarse al servidor, debe proporcionar las credenciales de acceso y la información del host.

az mysql server show --resource-group myresourcegroup --name mydemoserver

El resultado está en formato JSON. Tome nota de los valores de fullyQualifiedDomainName y administratorLogin.

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "fullyQualifiedDomainName": "mydemoserver.mysql.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMySQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
 "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforMySQL/servers",
  "userVisibleState": "Ready",
  "version": "5.7"
}

Conexión al servidor con MySQL

Use la herramienta de línea de comandos mysql para establecer una conexión con el servidor de Azure Database for MySQL. En este ejemplo, el comando es:

mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p

Crear una base de datos en blanco

Una vez conectado al servidor, cree una base de datos vacía.

mysql> CREATE DATABASE mysampledb;

En el símbolo del sistema, ejecute el comando siguiente para cambiar la conexión a esta base de datos recién creada:

mysql> USE mysampledb;

Creación de tablas en la base de datos

Ahora que sabe cómo conectarse a la base de datos de Azure Database for MySQL, complete algunas tareas básicas.

En primer lugar, cree una tabla y cárguela con algunos datos. Vamos a crear una tabla que almacena la información del inventario.

CREATE TABLE inventory (
	id serial PRIMARY KEY, 
	name VARCHAR(50), 
	quantity INTEGER
);

Carga de datos en las tablas

Ahora que tiene una tabla, inserte algunos datos en ella. En la ventana de símbolo del sistema abierta, ejecute la consulta siguiente para insertar algunas filas de datos.

INSERT INTO inventory (id, name, quantity) VALUES (1, 'banana', 150); 
INSERT INTO inventory (id, name, quantity) VALUES (2, 'orange', 154);

Ahora tiene dos filas de datos de ejemplo en la tabla que creó anteriormente.

Consulta y actualización de los datos en las tablas

Ejecute la consulta siguiente para recuperar información de la tabla de base de datos.

SELECT * FROM inventory;

También puede actualizar los datos en las tablas.

UPDATE inventory SET quantity = 200 WHERE name = 'banana';

La fila se actualiza en consecuencia cuando se recuperan los datos.

SELECT * FROM inventory;

Restauración de una base de datos a un momento anterior en el tiempo

Imagine que eliminó accidentalmente esta tabla. No se puede recuperar con facilidad. Azure Database for MySQL permite volver a cualquier momento dado en el período de los últimos 35 días y restaurar este momento en un servidor nuevo. Puede usar este servidor nuevo para recuperar los datos eliminados. Los pasos siguientes restauran el servidor de ejemplo a un punto antes de que se agregara la tabla.

Para realizar la restauración, necesita la información siguiente:

Punto de restauración: seleccione el momento antes de que se modificara la base de datos. Debe ser mayor o igual que el valor de la copia de seguridad más antigua de la base de datos de origen.
Servidor de destino: especifique el nombre del nuevo servidor donde desea restaurar
Servidor de origen: especifique el nombre del servidor desde donde desea restaurar
Ubicación: no se puede seleccionar la región; de forma predeterminada, es la misma que la del servidor de origen

az mysql server restore --resource-group myresourcegroup --name mydemoserver-restored --restore-point-in-time "2017-05-4 03:10" --source-server-name mydemoserver

El comando az mysql server restore necesita los parámetros siguientes:

Configuración	Valor sugerido	Descripción
resource-group	myresourcegroup	Grupo de recursos en el que existe el servidor de origen.
name	mydemoserver-restored	Nombre del nuevo servidor que se crea mediante el comando de restauración.
restore-point-in-time	2017-04-13T13:59:00Z	Seleccione un momento dado en el que quiere restaurar. Esta fecha y hora debe estar dentro del período de retención de copia de seguridad del servidor de origen. Use el formato de fecha y hora ISO8601. Por ejemplo, puede usar su propia zona horaria local, como `2017-04-13T05:59:00-08:00`, o usar el formato de hora Zulú UTC `2017-04-13T13:59:00Z`.
source-server	mydemoserver	Nombre o identificador del servidor de origen desde el que se va a restaurar.

Al restaurar un servidor a un momento dado, se crea un servidor que se copia como servidor original a un momento dado que especifique. Los valores de ubicación y plan de tarifa del servidor restaurado son los mismos que los del servidor de origen.

El comando es sincrónico y se devolverá después de que se haya restaurado el servidor. Una vez finalizada la restauración, busque el servidor que se ha creado. Compruebe que los datos se han restaurado del modo esperado.

Limpieza de recursos

Si no necesita estos recursos para otra guía de inicio rápido o tutorial, puede eliminarlos con el siguiente comando:

az group delete --name myresourcegroup

Si solo desea eliminar el servidor recién creado, puede ejecutar el comando az mysql server delete.

az mysql server delete --resource-group myresourcegroup --name mydemoserver

Pasos siguientes

En este tutorial aprendió lo siguiente:

Creación de un servidor de Azure Database for MySQL
Configuración del firewall del servidor
Uso de la herramienta de línea de comandos mysql para crear una base de datos
Carga de datos de muestra
Consultar datos
Actualización de datos
Restauración de datos

Ejemplos de la CLI de Azure para Azure Database for MySQL