Tutorial: Mendesain Azure Database for MariaDB menggunakan Azure CLI

Artikel
01/10/2024

Penting

Azure Database for MariaDB berada di jalur penghentian. Kami sangat menyarankan Anda bermigrasi ke Azure Database for MySQL. Untuk informasi selengkapnya tentang migrasi ke Azure Database for MySQL, lihat Apa yang terjadi pada Azure Database for MariaDB?.

Azure Database for MariaDB adalah layanan database relasional di cloud Microsoft berdasarkan mesin database MariaDB Edisi Komunitas. Dalam tutorial ini, Anda menggunakan Azure CLI (antarmuka baris perintah) dan utilitas lain untuk mempelajari cara:

Membuat Azure Database for MariaDB
Mengonfigurasi firewall server
Menggunakan alat baris-perintah mysql untuk membuat database
Memuat sampel data
Mengkueri data
Memperbarui data
Memulihkan data

Jika tidak memiliki langganan Azure, buat akun Azure gratis sebelum Anda memulai.

Prasyarat

Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
- Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
- Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
- Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Artikel ini memerlukan Azure CLI versi 2.0 atau yang lebih baru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

Jika Anda memiliki beberapa langganan Azure, pilih langganan yang sesuai tempat sumber daya berada atau harus ditagihkan. Pilih ID langganan tertentu di bawah akun Anda menggunakan perintah set akun az.

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

Buat grup sumber daya

Buat grup sumber daya Azure dengan perintah pembuatan grup az. Grup sumber daya adalah kontainer logis tempat sumber daya Azure disebar dan dikelola sebagai grup.

Contoh berikut ini menampilkan cara membuat grup sumber daya bernama myresourcegroup di westus lokasi.

az group create --name myresourcegroup --location westus

Membuat server Azure Database for MariaDB

Buat server Azure Database for MariaDB dengan perintah az mariadb server create. Server bisa mengelola beberapa database. Biasanya, database terpisah digunakan untuk setiap proyek atau untuk setiap pengguna.

Contoh berikut membuat server Azure Database for MariaDB yang terletak di westus dalam grup sumber daya myresourcegroup dengan nama mydemoserver. Server memiliki log-masuk admin bernama myadmin. Ini adalah Tujuan Umum, server Gen 5 dengan 2 vCores. Ganti <server_admin_password> dengan nilai Anda sendiri.

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

Nilai parameter sku-name mengikuti konvensi {pricing tier}_{compute generation}_{vCores} seperti pada contoh di bawah ini:

--sku-name B_Gen5_4 peta ke Dasar, Gen 5, dan 4 vCores.
--sku-name GP_Gen5_32 peta ke Tujuan Umum, Gen 5, dan 32 vCores.
--sku-name MO_Gen5_2 peta ke Memori Dioptimalkan, Gen 5, dan 2 vCores.

Silakan lihat dokumentasi tingkat harga untuk memahami nilai yang valid per wilayah dan per tingkatan.

Penting

Login admin server dan kata sandi yang Anda tentukan di sini diperlukan untuk masuk ke server dan databasenya nanti dalam mulai cepat ini. Ingat atau rekam informasi ini untuk digunakan nanti.

Mengonfigurasi aturan firewall

Buat aturan firewall tingkat server Azure Database for MariaDB dengan perintah az mariadb server firewall-rule create. Aturan firewall tingkat server memungkinkan aplikasi eksternal, seperti alat baris perintah mysql atau MySQL Workbench untuk tersambung ke server Anda melalui firewall layanan Azure MariaDB.

Contoh berikut membuat aturan firewall yang disebut AllowMyIP yang memungkinkan koneksi dari alamat IP tertentu, 192.168.0.1. Ganti alamat IP atau rentang alamat IP yang sesuai dengan tempat Anda akan tersambung.

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

Mendapatkan informasi sambungan

Untuk terhubung ke server Anda, Anda perlu memberikan informasi host dan kredensial akses.

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

Hasilnya dalam format JSON. Catat fullyQualifiedDomainName dan 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"
}

Sambungkan ke server menggunakan mysql

Gunakan alat baris perintah mysql untuk membuat koneksi ke server Azure Database for MariaDB Anda. Dalam contoh ini, perintahnya adalah:

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

Membuat database kosong

Setelah Anda tersambung ke server, buat database kosong.

mysql> CREATE DATABASE mysampledb;

Jika diminta, jalankan perintah berikut ini untuk mengalihkan koneksi ke database yang baru dibuat ini:

mysql> USE mysampledb;

Membuat tabel dalam database

Setelah Anda tahu cara tersambung ke database Azure Database for MariaDB, selesaikan beberapa tugas dasar.

Pertama, buat tabel dan muat dengan beberapa data. Mari kita buat tabel yang menyimpan informasi inventaris.

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

Memuat data ke dalam tabel

Setelah Anda memiliki tabel, sisipkan beberapa data ke dalamnya. Pada jendela permintaan perintah yang terbuka, jalankan kueri berikut ini untuk menyisipkan beberapa baris data.

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

Sekarang Anda memiliki dua baris data sampel dalam tabel yang Anda buat sebelumnya.

Mengkueri dan memperbarui data dalam tabel

Jalankan kueri berikut untuk mengambil informasi dari tabel data.

SELECT * FROM inventory;

Anda juga dapat memperbarui data dalam tabel.

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

Baris akan diperbarui sesuai saat Anda mengambil data.

SELECT * FROM inventory;

Memulihkan database ke titik waktu tertentu

Bayangkan Anda tidak sengaja menghapus tabel ini. Ketidaksengajaan ini adalah sesuatu yang tidak dapat Anda pulihkan dengan mudah. Azure Database for MariaDB memungkinkan Anda untuk kembali ke titik waktu apa pun dalam waktu 35 hari terakhir dan memulihkan titik ini tepat waktu ke server baru. Anda dapat menggunakan server baru ini untuk memulihkan data Anda yang dihapus. Langkah-langkah berikut ini memulihkan server sampel ke titik sebelum tabel ditambahkan.

Untuk pemulihan, Anda memerlukan informasi berikut:

Titik pemulihan: Pilih titik-dalam-waktu yang terjadi sebelum server diubah. Harus lebih besar dari atau sama dengan nilai pencadangan terlama database sumber.
Server target: Sediakan nama server baru yang ingin Anda pulihkan
Server sumber: Berikan nama server yang ingin Anda pulihkan
Lokasi: Anda tidak dapat memilih wilayah, secara default ini sama dengan server sumber

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

Perintah az mariadb server restore membutuhkan parameter berikut:

Pengaturan	Nilai yang disarankan	Deskripsi
grup sumber daya	myresourcegroup	Grup sumber daya tempat server sumber berada.
nama	mydemoserver-restored	Nama server baru yang dibuat oleh perintah pemulihan.
restore-point-in-time	2017-04-13T13:59:00Z	Pilih titik waktu untuk dipulihkan. Tanggal dan waktu ini harus berada dalam periode retensi cadangan server sumber. Gunakan format tanggal dan waktu ISO8601. Misalnya, Anda dapat menggunakan zona waktu lokal Anda sendiri, seperti `2017-04-13T05:59:00-08:00`, atau menggunakan format UTC Zulu `2017-04-13T13:59:00Z`.
source-server	mydemoserver	Nama atau ID server sumber untuk dipulihkan.

Memulihkan server ke titik waktu membuat server baru, disalin sebagai server asli pada titik waktu yang Anda tentukan. Nilai tingkat lokasi dan harga untuk server yang dipulihkan sama dengan server sumber.

Perintah ini sinkron, dan akan kembali setelah server dipulihkan. Setelah pemulihan selesai, temukan server baru yang dibuat. Verifikasi bahwa data telah dipulihkan seperti yang diharapkan.

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari:

Membuat server Azure Database for MariaDB
Mengonfigurasi firewall server
Menggunakan alat baris-perintah mysql untuk membuat database
Memuat sampel data
Mengkueri data
Memperbarui data
Memulihkan data