Zelfstudie: een Azure Database for MariaDB ontwerpen met Azure CLI
Belangrijk
Azure Database for MariaDB bevindt zich op het buitengebruikstellingspad. We raden u ten zeerste aan om te migreren naar Azure Database for MySQL. Zie Wat gebeurt er met Azure Database for MariaDB voor meer informatie over migreren naar Azure Database for MySQL.
Azure Database for MariaDB is een relationele databaseservice in de Microsoft Cloud die is gebaseerd op de MariaDB Community Edition-database-engine. In deze zelfstudie gebruikt u Azure CLI (Command Line Interface of opdrachtregelinterface in goed Nederlands) en andere hulpprogramma's om deze bewerkingen uit te voeren:
- Een Azure Database for MariaDB maken
- De serverfirewall configureren
- Het opdrachtregelprogramma mysql gebruiken om een database te maken
- Voorbeeldgegevens laden
- Querygegevens
- Gegevens bijwerken
- Gegevens terugzetten
Als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account voordat u begint.
Vereisten
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
- Voor dit artikel is versie 2.0 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
Als u meerdere abonnementen hebt, kiest u het abonnement waarin de resource is opgenomen of wordt gefactureerd. Selecteer een specifiek abonnements-ID in uw account met de opdracht az account set.
az account set --subscription 00000000-0000-0000-0000-000000000000
Een brongroep maken
Maak een Azure-resourcegroep met de opdracht az group create. Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en groepsgewijs worden beheerd.
In het volgende voorbeeld wordt een resourcegroep met de naam myresourcegroup
gemaakt op de locatie westus
.
az group create --name myresourcegroup --location westus
Een Azure Database for MariaDB-server maken
Maak een Azure Database for MariaDB-server met de opdracht az mariadb server create
. Een server kan meerdere databases beheren. Een aparte database wordt doorgaans gebruikt voor elk project of voor elke gebruiker.
In het volgende voorbeeld wordt een Azure Database for MariaDB-server gemaakt die zich in westus
bevindt in de resourcegroep myresourcegroup
met de naam mydemoserver
. De server heeft aanmeldgegevens voor de beheerder met de naam myadmin
. Dit is een Gen 5-server voor Algemeen gebruik met twee vCores. Vervang het <server_admin_password>
door uw eigen waarde.
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
De parameterwaarde voor de sku-naam volgt de conventie {prijscategorie}_{compute generation}_{vCores} zoals in de onderstaande voorbeelden:
--sku-name B_Gen5_4
komt overeen met Basic, Gen 5 en 4 vCores.--sku-name GP_Gen5_32
komt overeen met Algemeen gebruik, Gen 5 en 32 vCores.--sku-name MO_Gen5_2
komt overeen met Geoptimaliseerd voor geheugen, Gen 5 en 2 vCores.
Raadpleeg de documentatie over prijscategorieën om de geldige waarden per regio en categorie te begrijpen.
Belangrijk
De beheerdersaanmelding bij de server en het wachtwoord die u hier opgeeft, zijn vereist voor aanmelding bij de server en de bijbehorende databases verderop in deze quickstart. Onthoud of noteer deze informatie voor later gebruik.
Firewallregel configureren
Maak een firewallregel op MariaDB-serverniveau voor Azure Database met de opdracht az mariadb server firewall-rule create
. Met een firewallregel op serverniveau kan een externe toepassing, zoals het opdrachtregelprogramma mysql of MySQL Workbench, verbinding maken met uw server via de MariaDB-servicefirewall van Azure.
In het volgende voorbeeld wordt een firewallregel met de naam AllowMyIP
gemaakt, die verbindingen van een specifiek IP-adres, 192.168.0.1, toestaat. Vervang dit adres door het IP-adres of de reeks IP-adressen die overeenkomen met het IP-adres waarmee u verbinding gaat maken.
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
De verbindingsgegevens ophalen
Als u verbinding met uw server wilt maken, moet u hostgegevens en toegangsreferenties opgeven.
az mariadb server show --resource-group myresourcegroup --name mydemoserver
Het resultaat wordt in JSON-indeling weergegeven. Noteer de fullyQualifiedDomainName en de 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"
}
Verbinding maken met de server met behulp van mysql
Gebruik het opdrachtregelprogramma mysql om een verbinding tot stand te brengen met uw Azure Database for MariaDB-server. In dit voorbeeld is dit de opdracht:
mysql -h mydemoserver.database.windows.net -u myadmin@mydemoserver -p
Een lege database maken
Zodra u met de server bent verbonden, maakt u een lege database.
mysql> CREATE DATABASE mysampledb;
Voer bij de prompt de volgende opdracht uit om verbinding te maken met de zojuist gemaakte database:
mysql> USE mysampledb;
Tabellen maken in de database
U weet nu hoe u verbinding kunt maken met de Azure Database for MariaDB-database en dus is het tijd om enkele eenvoudige taken uit te voeren.
We gaan eerst een tabel maken en hierin enkele gegevens laden. Laten we een tabel maken waarin voorraadgegevens worden opgeslagen.
CREATE TABLE inventory (
id serial PRIMARY KEY,
name VARCHAR(50),
quantity INTEGER
);
Gegevens laden in de tabellen
De volgende stap bestaat uit het toevoegen van gegevens aan de tabel. Voer bij de opdrachtprompt de volgende query uit om enkele rijen met gegevens in te voegen.
INSERT INTO inventory (id, name, quantity) VALUES (1, 'banana', 150);
INSERT INTO inventory (id, name, quantity) VALUES (2, 'orange', 154);
We hebben nu twee rijen met voorbeeldgegevens in de tabel die u eerder hebt gemaakt.
De gegevens in de tabellen opvragen en bijwerken
Voer de volgende query uit om gegevens op te halen uit de databasetabel.
SELECT * FROM inventory;
U kunt ook de gegevens in de tabellen bijwerken.
UPDATE inventory SET quantity = 200 WHERE name = 'banana';
De rij wordt dan meteen bijgewerkt wanneer u gegevens ophaalt.
SELECT * FROM inventory;
Een database herstellen naar een eerder tijdstip
Stel dat u deze tabel per ongeluk hebt verwijderd. Dit is iets wat u niet eenvoudig kunt herstellen. In Azure Database for MariaDB kunt u echter gedurende een periode van maximaal 35 dagen teruggaan naar een bepaald tijdstip om vanaf dat moment de gegevens te herstellen op een nieuwe server. U kunt deze nieuwe server dan gebruiken om de verwijderde gegevens te herstellen. Met de volgende stappen wordt de voorbeeldserver hersteld naar een punt voordat de tabel is toegevoegd.
Voor deze herstelbewerking hebt u de volgende gegevens nodig:
- Herstelpunt: selecteer een tijdstip voorafgaand aan het moment waarop de server is gewijzigd. De tijd moet eerder zijn dan of gelijk zijn aan het tijdstip van de oudste back-up van de brondatabase.
- Doelserver: geef de naam op van de nieuwe server waarnaar u wilt herstellen
- Bronserver: geef de naam op van de server waarvan u gegevens wilt terugzetten.
- Locatie: u kunt de regio niet selecteren, standaard is deze hetzelfde als die van de bronserver
az mariadb server restore --resource-group myresourcegroup --name mydemoserver-restored --restore-point-in-time "2017-05-4 03:10" --source-server-name mydemoserver
De opdracht az mariadb server restore
vereist de volgende parameters:
Instelling | Voorgestelde waarde | Beschrijving |
---|---|---|
resource-group | myresourcegroup | De resourcegroep waarin de bronserver bestaat. |
name | mydemoserver-restored | De naam van de nieuwe server die door de opdracht restore is gemaakt. |
restore-point-in-time | 2017-04-13T13:59:00Z | Selecteer een bepaald tijdstip om naar te herstellen. Deze datum en tijd moet binnen de back-upretentieperiode van de bronserver vallen. Gebruik ISO8601-notatie voor datum en tijd. U kunt bijvoorbeeld uw eigen lokale tijdzone, zoals 2017-04-13T05:59:00-08:00 , gebruiken of de UTC Zulu-notatie 2017-04-13T13:59:00Z . |
source-server | mydemoserver | De naam of ID van de bronserver voor het herstellen. |
Wanneer u een server naar een bepaald tijdstip herstelt, wordt er een nieuwe server gemaakt, die een kopie is van de oorspronkelijke server vanaf het opgegeven tijdstip. De locatie en prijscategorie van de herstelde server zijn hetzelfde als die van de bronserver.
De opdracht is synchroon en keert terug nadat de server is hersteld. Nadat het herstel is voltooid, zoekt u de nieuwe server. Controleer of de gegevens zijn hersteld zoals verwacht.
Volgende stappen
In deze zelfstudie hebt u het volgende geleerd:
- Een Azure Database for MariaDB-server maken
- De serverfirewall configureren
- Het opdrachtregelprogramma mysql gebruiken om een database te maken
- Voorbeeldgegevens laden
- Querygegevens
- Gegevens bijwerken
- Gegevens terugzetten