快速入門：使用 Azure CLI 建立適用於 MariaDB 的 Azure 資料庫伺服器

文章
08/15/2024

重要

適用於 MariaDB 的 Azure 資料庫位於淘汰路徑上。強烈建議您移轉至適用於 MySQL 的 Azure 資料庫。如需移轉至適用於 MySQL 的 Azure 資料庫的詳細資訊，請參閱適用於 MariaDB 的 Azure 資料庫會發生什麼事？(部份機器翻譯)。

您可以使用 Azure CLI 從命令列或在指令碼中建立和管理 Azure 資源。本快速入門說明如何在大約五分鐘內，使用 Azure CLI 在 Azure 資源群組中建立適用於 MariaDB 的 Azure 資料庫伺服器。

如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。

必要條件

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

本文需要 2.0 版或更新版本的 Azure CLI。如果您是使用 Azure Cloud Shell，就已安裝最新版本。

如果您有多個訂用帳戶，請選擇包含資源或計費訂用帳戶的訂用帳戶。若要在您的帳戶中選取特定的訂用帳戶標識碼，請使用 az account set 命令：

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

建立資源群組

使用 az group create 命令建立 Azure 資源群組。 Azure 資源群組是在其中將 Azure 資源當作群組部署及管理的邏輯容器。

下列範例會在 westus 位置建立名為 myresourcegroup 的資源群組：

az group create --name myresourcegroup --location westus

建立適用於 MariaDB 的 Azure 資料庫伺服器

使用 az mariadb server create 命令建立適用於 MariaDB 的 Azure 資料庫伺服器。一部伺服器可以管理多個資料庫。一般而言，每個專案或每個使用者會使用個別的資料庫。

設定	範例值	描述
NAME	mydemoserver	輸入可識別適用於 MariaDB 的 Azure 資料庫伺服器的唯一名稱。伺服器名稱只能包含小寫字母、數字及連字號 (-) 字元。必須包含 3 到 63 個字元。
資源群組	myresourcegroup	輸入 Azure 資源群組的名稱。
sku-name	GP_Gen5_2	SKU 的名稱。遵循慣例定價層_compute generation_vCores 的速記。如需sku-name參數的詳細資訊，請參閱下表後面的區段。
backup-retention	7	備份應保留的時間長度。單位為天。範圍：7 到 35。
geo-redundant-backup	停用	是否應為此伺服器啟用異地備援備份。允許的值： Enabled、 Disabled。
location	westus	伺服器的 Azure 位置。
ssl-enforcement	已啟用	是否應為此伺服器啟用 SSL。允許的值： Enabled、 Disabled。
storage-size	51200	伺服器的儲存容量（單位為 MB）。有效的記憶體大小為 5,120 MB（最小值），增量為 1,024 MB。如需記憶體大小限制的詳細資訊，請參閱定價層。
version	10.2	MariaDB 主要引擎版本。
admin-user	myadmin	系統管理員登入的用戶名稱。系統管理員用戶參數不能azure_superuser、系統管理員、系統管理員、根、來賓或公用。
admin-password	您的密碼	系統管理員使用者的密碼。您的密碼必須包含 8 到 128 個字元。它必須包含下列三個類別的字元：英文大寫字母、英文小寫字母、數位和非英數位元。

sku-name 參數值會遵循慣例 {pricing tier}_{compute generation}_{vCores}，如下列範例所示：

--sku-name B_Gen5_1 對應於基本、第 5 代和 1 個虛擬核心。此選項是最小的可用 SKU。
--sku-name GP_Gen5_32 對應於一般用途、第 5 代和 32 個 vCore。
--sku-name MO_Gen5_2 對應到記憶體最佳化、第 5 代和 2 個 vCore。

如需依區域和各層之有效值的相關信息，請參閱定價層。

下列範例會在美國西部區域中建立名為 mydemoserver 的伺服器 。伺服器位於資源群組 myresourcegroup 中，並具有伺服器管理員登入 myadmin。伺服器是一般用途定價層中的 Gen 5 伺服器，其具有 2 個虛擬核心。伺服器名稱會對應至 DNS 名稱，而且在 Azure 中必須是全域唯一的。以您自己的伺服器管理員密碼取代 <server_admin_password> 。

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

注意

如果您的工作負載只需要輕量計算和 I/O，請考慮使用基本定價層。請注意，在基本定價層中建立的伺服器後續無法調整為「一般用途」或「記憶體最佳化」。如需詳細資訊，請參閱定價頁面。

設定防火牆規則

使用 az mariadb server firewall-rule create 命令，建立適用於 MariaDB 的 Azure 資料庫伺服器層級防火牆規則。伺服器層級防火牆規則可讓外部應用程式，例如 mysql 命令行工具或 MySQL Workbench，透過適用於 MariaDB 的 Azure 資料庫服務防火牆連線到您的伺服器。

下列範例會建立名為 AllowMyIP 的防火牆規則，以允許來自特定 IP 位址 192.168.0.1 的連線。以IP位址或IP位址範圍取代，該IP位址對應至您從中聯機的位置。

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

注意

適用於 MariaDB 的 Azure 資料庫連線會透過連接埠 3306 進行通訊。如果您嘗試從公司網路內部連線，則不允許透過埠 3306 的輸出流量。在此情況下，只有當 IT 部門開啟埠 3306 時，您才能連線到您的伺服器。

進行 SSL 設定

預設會強制執行您的伺服器與用戶端應用程式之間的 SSL 連線。此預設設定可透過因特網加密數據流，以確保「移動中」數據的安全性。針對本快速入門，請停用您伺服器的 SSL 連線。不建議對生產伺服器停用 SSL。如需詳細資訊，請參閱在您的應用程式中設定 SSL 連線能力，以安全地連線至適用於 MariaDB 的 Azure 資料庫。

下列範例會停用在適用於 MariaDB 的 Azure 資料庫伺服器上強制執行 SSL：

az mariadb server update --resource-group myresourcegroup --name mydemoserver --ssl-enforcement Disabled

取得連線資訊

若要連線到您的伺服器，您必須提供主機資訊和存取認證。若要取得連線資訊，請執行下列命令：

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

結果會採用 JSON 格式。記下 fullyQualifiedDomainName 和 administratorLogin 的值。

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": 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"
}

使用 mysql 命令行工具連線到伺服器

使用 mysql 命令行工具連線到您的伺服器。您可以下載命令列工具，並將安裝在您的電腦上。您也可以選取本文程式代碼範例上的 [ 試用] 按鈕，來存取命令行工具。另一個存取命令行工具的方式是選取 >Azure 入口網站右上方工具列上的 _ 按鈕，以開啟 Azure Cloud Shell。

若要使用 mysql 命令列工具連線到伺服器：

線上伺服器：

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

在提示字元中 mysql> 檢視伺服器狀態：

status

您應該會看到類似下列文字的內容：

C:\Users\>mysql -h mydemoserver.mariadb.database.azure.com -u myadmin@mydemoserver -p
Enter password: ***********
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 65512
Server version: 5.6.39.0 MariaDB Server

Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> status
--------------
mysql  Ver 14.14 Distrib 5.7.23, for Linux (x86_64)

Connection id:          64681
Current database:
Current user:           myadmin@40.118.201.21
SSL:                    Cipher in use is AES256-SHA
Current pager:          stdout
Using outfile:          ''
Using delimiter:        ;
Server version:         5.6.39.0 MariaDB Server
Protocol version:       10
Connection:             mydemoserver.mariadb.database.azure.com via TCP/IP
Server characterset:    latin1
Db     characterset:    latin1
Client characterset:    utf8
Conn.  characterset:    utf8
TCP port:               3306
Uptime:                 1 day 3 hours 28 min 50 sec

Threads: 10  Questions: 29002  Slow queries: 0  Opens: 33  Flush tables: 3  Open tables: 1  Queries per second avg: 0.293
--------------

mysql>

提示

如需其他命令，請參閱 MySQL 5.7 參考手冊 - 第 4.5.1 章。

使用 MySQL Workbench 來連線到伺服器

在用戶端電腦上開啟 MySQL Workbench。如果尚未安裝，請下載並安裝應用程式。

在 [設定新連線] 對話方塊的 [參數] 索引標籤上，輸入下列資訊︰

設定新的連線

設定	建議的值	描述
連線名稱	示範連線	輸入此連線的標籤（連線名稱可以是任何專案）
連線方式	標準 (TCP/IP)	使用 TCP/IP 通訊協定連線到適用於 MariaDB 的 Azure 資料庫
主機名稱	mydemoserver.mariadb.database.azure.com	您稍早記下的伺服器名稱。
連接埠	3306	適用於 MariaDB 的 Azure 資料庫的預設埠。
使用者名稱	myadmin@mydemoserver	您稍早注意到的伺服器管理員登入。
密碼	您的密碼	使用您稍早設定的系統管理員帳戶密碼。

若要檢查是否已正確設定所有參數，請選取 [ 測試連線]。
選取連線以成功連線到伺服器。

清除資源

如果您不需要本快速入門中用於另一個快速入門或教學課程的資源，您可以執行下列命令來刪除它們：

az group delete --name myresourcegroup

如果您想要只刪除在本快速入門中建立的伺服器，請執行 az mariadb server delete 命令：

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

下一步

使用 Azure CLI 設計 MariaDB 資料庫

分享方式：

快速入門：使用 Azure CLI 建立適用於 MariaDB 的 Azure 資料庫伺服器

必要條件

建立資源群組

建立適用於 MariaDB 的 Azure 資料庫伺服器

設定防火牆規則

進行 SSL 設定

取得連線資訊

使用 mysql 命令行工具連線到伺服器

使用 MySQL Workbench 來連線到伺服器

清除資源

下一步

意見反映

意見反映

更多資源

分享方式：

快速入門：使用 Azure CLI 建立 適用於 MariaDB 的 Azure 資料庫 伺服器

必要條件

建立資源群組

建立適用於 MariaDB 的 Azure 資料庫伺服器

設定防火牆規則

進行 SSL 設定

取得連線資訊

使用 mysql 命令行工具連線到伺服器

使用 MySQL Workbench 來連線到伺服器

清除資源

下一步

意見反映

意見反映

更多資源

快速入門：使用 Azure CLI 建立適用於 MariaDB 的 Azure 資料庫伺服器