連接至執行 MariaDB 資料庫引擎的資料庫執行個體 - Amazon Relational Database Service
尋找連線資訊從 MySQL 命令列用戶端連線 (未加密)使用 JDBC 驅動程式連線至適用於 MariaDB 的 AWS RDS使用 Python 驅動程序連接到適用於 MariaDB 的 AWS RDS故障診斷

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

連接至執行 MariaDB 資料庫引擎的資料庫執行個體

當 Amazon RDS 佈建您的資料庫執行個體後，您就可以使用任何標準 MariaDB 用戶端應用程式或公用程式來連接至執行個體。在連線字串中，指定來自主要執行個體端點的網域名稱系統 (DNS) 位址做為主機參數。您也指定來自資料庫執行個體端點的連接埠號碼做為連接埠參數。

您能夠利用 MySQL 命令列用戶端等工具，藉此連接至 Amazon RDS for MariaDB 資料庫執行個體。如需有關使用 MySQL 命令列用戶端的詳細資訊，請參閱 MariaDB 文件中的 mysql 命令列用戶端。您可以用來連線的一個 GUI 應用程式是 Heidi。如需詳細資訊，請參閱下載 HeidiSQL 頁面。如需安裝 MySQL (包括 MySQL 命令列用戶端) 的資訊，請參閱安裝和升級 MySQL。

大多數的 Linux 發行版均包括 MariaDB 用戶端，而不是 Oracle MySQL 用戶端。若要在 Amazon Linux 2023 上安裝 MySQL 命令列用戶端，請執行下列命令：

sudo dnf install mariadb105

若要在 Amazon Linux 2 上安裝 MySQL 命令列用戶端，請執行下列命令：

sudo yum install mariadb

若要在大多數以 Debian 為基礎的 Linux 發行版上安裝 MySQL 命令列用戶端，請執行下列命令。

apt-get install mariadb-client

若要檢查 MySQL 命令列用戶端的版本，請執行下列命令。

mysql --version

若要讀取目前用戶端版本的 MySQL 文件，請執行下列命令。

man mysql

若要基於 Amazon VPC 從 Virtual Private Cloud (VPC) 外部連線至資料庫執行個體，資料庫執行個體必須可公開存取。此外，必須使用資料庫執行個體安全群組的入站規則授予存取權，且必須符合其他需求。如需更多詳細資訊，請參閱 無法連線至 Amazon RDS 資料庫執行個體。

您可以在 MariaDB 資料庫執行個體的連線上使用 SSL 加密。如需相關資訊，請參閱「將 SSL/TLS 與 MariaDB 資料庫執行個體搭配使用」。

尋找 MariaDB 資料庫執行個體的連線資訊

資料庫執行個體的連線資訊包括其端點、連接埠，以及有效的資料庫使用者，例如主要使用者。例如，假設端點值為 mydb.123456789012.us-east-1.rds.amazonaws.com。在此情況下，連接埠值為 3306，資料庫使用者為 admin。藉由此資訊，您可以在連線字串中指定下列值：

  • 對於主機或主機名稱或 DNS 名稱，請指定 mydb.123456789012.us-east-1.rds.amazonaws.com。

  • 對於連接埠，指定 3306。

  • 對於使用者，請指定 admin。

若要連線到資料庫執行個體，請針對 MariaDB 資料庫引擎使用任何用戶端。例如，您可以使用 MySQL 命令列用戶端或 MySQL 工作台。

若要尋找資料庫執行個體的連線資訊，您可以使用 AWS Management Console、 AWS Command Line Interface (AWS CLI) describe-db-instances命令或 Amazon RDS API Descri beDBInstances 操作列出其詳細資訊。

若要在中尋找資料庫執行個體的連線資訊 AWS Management Console

  1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

  2. 在導覽窗格中，選擇 Databases (資料庫) 以顯示資料庫執行個體的清單。

  3. 選擇 MariaDB 資料庫執行個體名稱以顯示其詳細資訊。

  4. 在 Connectivity & security (連線能力和安全性) 索引標籤上，複製該端點。另外，請記下連接埠號碼。您需要同時有端點和連接埠號碼，才能連線至資料庫執行個體。

    Amazon RDS 主控台中資料庫執行個體的端點和連接埠。

  5. 如果您需要尋找主要使用者名稱，請選擇 Configuration (組態) 索引標籤並檢視 Master username (主要使用者名稱) 值。

若要使用尋找 MariaDB 資料庫執行個體的連線資訊 AWS CLI，請呼叫命令。describe-db-instances在呼叫中，查詢資料庫執行個體 ID、端點、連接埠和主要使用者名稱。

對於LinuxmacOS、或Unix：

aws rds describe-db-instances \
  --filters "Name=engine,Values=mariadb" \
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"

在 Windows 中：

aws rds describe-db-instances ^
  --filters "Name=engine,Values=mariadb" ^
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"

輸出內容應如下所示：

[
    [
        "mydb1",
        "mydb1.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ],
    [
        "mydb2",
        "mydb2.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ]
]

若要使用 Amazon RDS API 尋找資料庫執行個體的連線資訊，請呼叫 DescribeDBInstances 操作。在輸出中，尋找端點地址、端點連接埠和主要使用者名稱的值。

從 MySQL 命令列用戶端連線 (未加密)

重要

僅當用戶端和伺服器位於同一 VPC 且網路受信任時，才使用未加密的 MySQL 連線。如需使用加密連線的詳細資訊，請參閱 使用 SSL/TLS (加密) 從 MySQL 命令列用戶端連線。

若要使用 MySQL 命令列用戶端連線至資料庫執行個體，在用戶端電腦上的命令提示字元中輸入下列命令。如此，這就會將您連限制 MariaDB 資料庫執行個體上的資料庫。會取代您用於 <endpoint> 資料庫執行個體的 DNS 名稱 (端點)，以及取代您用於 <mymasteruser> 的主要使用者名稱。提示您輸入密碼時，請提供您使用的主要密碼。

mysql -h <endpoint> -P 3306 -u <mymasteruser> -p

輸入使用者的密碼之後，您會看到類似如下的輸出。

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 31
Server version: 10.6.10-MariaDB-log Source distribution
 
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
  
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
  
MariaDB [(none)]>

使用 Amazon Web Services（AWS）JDBC 驅動程序連接到適用於 MariaDB 的 RDS

Amazon Web Services（AWS）JDBC 驅動程序被設計為一個高級 JDBC 包裝。這個包裝是補充和擴展現有 JDBC 驅動程序的功能。該驅動程序與社區 MySQL 連接器/J 驅動程序和社區 MariaDB 連接器/J 驅動程序兼容。

若要安裝 AWS JDBC 驅動程式，請附加 AWS JDBC 驅動程式 .jar 檔案 (位於應用程式中CLASSPATH)，並保留對個別社群驅動程式的參考。更新相應的連接 URL 前綴，如下所示：

  • jdbc:mysql:// 設定為 jdbc:aws-wrapper:mysql://

  • jdbc:mariadb:// 設定為 jdbc:aws-wrapper:mariadb://

如需有關 AWS JDBC 驅動程式的詳細資訊以及使用它的完整說明，請參閱 Amazon Web Services (AWS) JDBC 驅動程式 GitHub 儲存庫。

使用 Amazon Web Services 連接到 RDS（AWS）Python 驅動程序

Amazon Web Services（AWS）Python 驅動程序被設計為一個先進的 Python 包裝。此包裝器與開源 Psycopg 驅動程序的功能互補並擴展。 AWS Python 驅動程式支援 3.8 及更高版本。您可以使用pip命令以及psycopg開放原始碼套件來安裝套件。aws-advanced-python-wrapper

有關 AWS Python 驅動程序的更多信息以及使用它的完整說明，請參閱 Amazon Web Services（AWS）Python 驅動程序 GitHub 存儲庫。

對 MariaDB 資料庫執行個體的連線進行故障診斷

無法連接至新的資料庫執行個體有下列兩個常見原因：

  • 建立資料庫執行個體所用的安全群組，未授權從執行 MariaDB 應用程式或公用程式的裝置或 Amazon EC2 執行個體進行連線。資料庫執行個體必須擁有能授權連線的 VPC 安全群組。如需詳細資訊，請參閱 Amazon VPC 和 Amazon RDS Amazon Aur。

    您可以新增或編輯安全群組中的傳入規則。針對 Source (來源)，選擇 My IP (我的 IP)。此舉允許透過您的瀏覽器中偵測到的 IP 地址存取資料庫執行個體。

  • 資料庫執行個體是使用預設連接埠 3306 來建立，而公司的防火牆規則禁止從公司網路中的裝置連接至該連接埠。若要避免此失敗情況，請以不同的連接埠重新建立執行個體。

如需連線問題的詳細資訊，請參閱 無法連線至 Amazon RDS 資料庫執行個體。