Tutoriel : Concevoir une base de données Azure Database for MariaDB à l’aide d’Azure CLI

Article
06/01/2023

Important

Azure Database for MariaDB est en voie de mise hors service. Nous vous recommandons vivement de migrer vers Azure Database pour MySQL. Pour plus d’informations sur la migration vers Azure Database pour MySQL, consultez Qu’est-ce qui se passe dans Azure Database for MariaDB ?.

Azure Database for MariaDB est un service de base de données relationnelle dans le cloud Microsoft qui repose sur le moteur de base de données MariaDB Community Edition. Dans ce didacticiel, vous allez utiliser l’interface Azure CLI (interface de ligne de commande) et d’autres utilitaires pour apprendre à :

Créer une base de données Azure Database for MariaDB
Configurer le pare-feu du serveur
Utiliser l’outil de ligne de commande mysql pour créer une base de données
Charger un exemple de données
Interroger des données
Mettre à jour des données
Restaurer des données

Si vous n’avez pas d’abonnement Azure, créez un compte Azure gratuit avant de commencer.

Prérequis

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Cet article nécessite la version 2.0 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.

Si vous possédez plusieurs abonnements, sélectionnez l’abonnement approprié dans lequel la ressource existe ou est facturée. Sélectionnez un ID d’abonnement spécifique sous votre compte à l’aide de la commande az account set.

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

Créer un groupe de ressources

Créez un groupe de ressources Azure avec la commande az group create. Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées en tant que groupe.

L’exemple suivant crée un groupe de ressources nommé myresourcegroup à l’emplacement westus.

az group create --name myresourcegroup --location westus

Créer un serveur Azure Database for MariaDB

Créez un serveur Azure Database for MariaDB au moyen de la commande az mariadb server create. Un serveur peut gérer plusieurs bases de données. En règle générale, une base de données distincte est utilisée pour chaque projet ou pour chaque utilisateur.

L’exemple suivant crée un serveur Azure Database for MariaDB, situé dans westus du groupe de ressources myresourcegroup avec le nom mydemoserver. Le serveur dispose d’une connexion administrateur avec le nom myadmin. Il s’agit d’un serveur à usage général, de 5e génération avec 2 vCores. Remplacez <server_admin_password> par votre propre valeur.

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

La valeur du paramètre sku-name suit la convention {tarification}_{génération de calcul}_{vCores} comme dans les exemples ci-dessous :

--sku-name B_Gen5_4 correspond à De base, Gén 5 et 4 vCores.
--sku-name GP_Gen5_32 correspond à Usage général, Gen 5 et 32 vCores.
--sku-name MO_Gen5_2 correspond à Mémoire optimisée, Gen 5 et 2 vCores.

Consultez la documentation des niveaux tarifaires pour comprendre les valeurs valides par région et par niveau.

Important

La connexion d’administrateur serveur et le mot de passe que vous spécifiez ici seront requis plus loin dans ce guide de démarrage rapide pour la connexion au serveur et à ses bases de données. Retenez ou enregistrez ces informations pour une utilisation ultérieure.

Configurer une règle de pare-feu

Créez une règle de pare-feu au niveau du serveur Azure Database for MariaDB avec la commande az mariadb server firewall-rule create. Une règle de pare-feu au niveau du serveur permet à une application externe, comme l’outil en ligne de commande mysql ou MySQL Workbench, de se connecter à votre serveur via le pare-feu du service Azure MariaDB.

L’exemple suivant crée une règle de pare-feu appelée AllowMyIP qui autorise les connexions d’une adresse IP spécifique, 192.168.0.1. Remplacez l’adresse ou la plage d’adresses IP qui correspondent à l’emplacement de votre connexion.

az mariadb 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

Obtenir les informations de connexion

Pour vous connecter à votre serveur, vous devez fournir des informations sur l’hôte et des informations d’identification pour l’accès.

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

Le résultat est au format JSON. Notez les valeurs fullyQualifiedDomainName et administratorLogin.

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "fullyQualifiedDomainName": "mydemoserver.mariadb.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMariaDB/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.DBforMariaDB/servers",
  "userVisibleState": "Ready",
  "version": "10.2"
}

Se connecter au serveur à l’aide de mysql

Utilisez l’outil en ligne de commande mysql pour établir une connexion à votre serveur Azure Database for MariaDB. Dans cet exemple, la commande est :

mysql -h mydemoserver.database.windows.net -u myadmin@mydemoserver -p

Créer une base de données vide

Une fois que vous êtes connecté au serveur, créez une base de données vide.

mysql> CREATE DATABASE mysampledb;

À l’invite, exécutez la commande suivante pour basculer la connexion sur la base de données nouvellement créée :

mysql> USE mysampledb;

Créer des tables dans la base de données

Maintenant que vous savez vous connecter à la base de données Azure Database for MariaDB, effectuez certaines tâches de base.

Tout d’abord, créez une table et chargez-y des données. Nous allons créer une table qui stocke des données d’inventaire.

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

Charger des données dans les tables

Maintenant que vous disposez d’une table, insérez-y des données. Dans la fenêtre d’invite de commandes ouverte, exécutez la requête suivante pour insérer des lignes de données.

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

Vous avez maintenant chargé deux lignes de données dans la table que vous avez créée précédemment.

Interroger et mettre à jour les données des tables

Exécutez la requête suivante pour récupérer des informations à partir de la table de base de données.

SELECT * FROM inventory;

Vous pouvez également mettre à jour les données des tables.

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

La ligne est mise à jour en conséquence lorsque vous récupérez les données.

SELECT * FROM inventory;

Restaurer une version antérieure d’une base de données

Imaginez que vous avez supprimé cette table par erreur. Il s’agit de quelque chose que vous ne pouvez pas récupérer facilement. Azure Database for MariaDB vous permet de revenir à n’importe quel moment dans le temps, au cours de ces 35 derniers jours, et de procéder à une restauration à ce point dans le temps sur un nouveau serveur. Vous pouvez alors utiliser ce nouveau serveur pour récupérer les données supprimées. Les étapes suivantes restaurent le serveur à l’état dans lequel il était avant l’ajout de la table.

Pour effectuer la restauration, vous avez besoin des informations suivantes :

Point de restauration : sélectionnez un point dans le temps avant la modification du serveur. Doit être supérieure ou égale à la plus ancienne valeur de sauvegarde de la base de données source.
Serveur cible : spécifiez un nouveau nom de serveur sur lequel vous souhaitez effectuer la restauration
Serveur source : indiquez le nom du serveur à partir duquel vous voulez effectuer la restauration
Emplacement : vous ne pouvez pas sélectionner la région. Par défaut, elle est identique à celle du serveur source

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

La commande az mariadb server restore a besoin des paramètres suivants :

Paramètre	Valeur suggérée	Description
resource-group	myResourceGroup	Groupe de ressources dans lequel se trouve le serveur source.
name	mydemoserver-restored	Nom du serveur créé par la commande de restauration.
restore-point-in-time	2017-04-13T13:59:00Z	Choisissez la date et l’heure à utiliser pour la restauration. Elles doivent être comprises dans la période de rétention de la sauvegarde du serveur source. Utilisez le format de date et d’heure ISO8601. Par exemple, vous pouvez utiliser votre fuseau horaire local, comme `2017-04-13T05:59:00-08:00`, ou le format UTC Zulu `2017-04-13T13:59:00Z`.
source-server	mydemoserver	Nom ou identifiant du serveur source à partir duquel la restauration s’effectuera.

La restauration d’un serveur à un point antérieur dans le temps entraîne la création d’un nouveau serveur, qui est la copie du serveur d’origine tel qu’il était à l’instant spécifié. Les valeurs d’emplacement et de niveau tarifaire du serveur restauré sont les mêmes que celles du serveur source.

La commande est synchrone ; elle est renvoyée après la restauration du serveur. Une fois la restauration terminée, recherchez le serveur créé. Vérifiez que les données ont été restaurées comme prévu.

Étapes suivantes

Dans ce didacticiel, vous avez appris à effectuer les opérations suivantes :

Créer un serveur Azure Database for MariaDB
Configurer le pare-feu du serveur
Utiliser l’outil de ligne de commande mysql pour créer une base de données
Charger un exemple de données
Interroger des données
Mettre à jour des données
Restaurer des données