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

# 連線至您的 MariaDB 資料庫執行個體
<a name="USER_ConnectToMariaDBInstance"></a>

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

您能夠利用 MySQL 命令列用戶端等工具，藉此連接至 Amazon RDS for MariaDB 資料庫執行個體。如需有關使用 MySQL 命令列用戶端的詳細資訊，請參閱 MariaDB 文件中的 [mysql 命令列用戶端](http://mariadb.com/kb/en/mariadb/mysql-command-line-client/)。您可以用來連線的一個 GUI 應用程式是 Heidi。如需詳細資訊，請參閱[下載 HeidiSQL](http://www.heidisql.com/download.php) 頁面。如需安裝 MySQL (包括 MySQL 命令列用戶端) 的資訊，請參閱[安裝和升級 MySQL](https://dev.mysql.com/doc/refman/8.0/en/installing.html)。

大多數的 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 資料庫執行個體](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting)。

您可以在 MariaDB 資料庫執行個體的連線上使用 SSL 加密。如需相關資訊，請參閱[Amazon RDS 支援在 MariaDB 資料庫執行個體上啟用 SSL/TLS 加密。](MariaDB.Concepts.SSLSupport.md)。

若要尋找並連線至 RDS for MariaDB 資料庫執行個體，請參閱下列主題。

**Topics**
+ [尋找 MariaDB 資料庫執行個體的連線資訊](USER_ConnectToMariaDBInstance.EndpointAndPort.md)
+ [從 MySQL 命令列用戶端 (未加密) 進行 RDS for MariaDB 的連線](USER_ConnectToMariaDBInstance.CLI.md)
+ [使用 AWS JDBC 驅動程式和 AWS Python 驅動程式連線至 RDS for MariaDB；](MariaDB.Connecting.Drivers.md)
+ [對 MariaDB 資料庫執行個體的連線進行故障診斷](USER_ConnectToMariaDBInstance.Troubleshooting.md)

# 尋找 MariaDB 資料庫執行個體的連線資訊
<a name="USER_ConnectToMariaDBInstance.EndpointAndPort"></a>

資料庫執行個體的連線資訊包括其端點、連接埠，以及有效的資料庫使用者，例如主要使用者。例如，假設端點值為 `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 管理主控台、AWS Command Line Interface (AWS CLI) [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) 命令或 Amazon RDS API [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) 操作來列出其詳細資訊。

## 主控台
<a name="USER_ConnectToMariaDBInstance.EndpointAndPort.Console"></a>

**在 AWS 管理主控台 中尋找資料庫執行個體的連線資訊**

1. 登入 AWS 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。

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

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

1. 在 **Connectivity & security (連線能力和安全性)** 索引標籤上，複製該端點。另外，請記下連接埠號碼。您需要同時有端點和連接埠號碼，才能連線至資料庫執行個體。  
![\[Amazon RDS 主控台中的資料庫執行個體的端點和連接埠。\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/endpoint-port.png)

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

## AWS CLI
<a name="USER_ConnectToMariaDBInstance.EndpointAndPort.CLI"></a>

若要使用 AWS CLI 尋找 MariaDB 資料庫執行個體的連線資訊，請執行 [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) 命令。在呼叫中，查詢資料庫執行個體 ID、端點、連接埠和主要使用者名稱。

針對 Linux、macOS 或 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"
    ]
]
```

## RDS API
<a name="USER_ConnectToMariaDBInstance.EndpointAndPort.API"></a>

若要使用 Amazon RDS API 尋找資料庫執行個體的連線資訊，請呼叫 [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) 操作。在輸出中，尋找端點地址、端點連接埠和主要使用者名稱的值。

# 從 MySQL 命令列用戶端 (未加密) 進行 RDS for MariaDB 的連線
<a name="USER_ConnectToMariaDBInstance.CLI"></a>

**重要**  
僅當用戶端和伺服器位於同一 VPC 且網路受信任時，才使用未加密的 MySQL 連線。如需使用加密連線的詳細資訊，請參閱 [使用 SSL/TLS 從 MySQL 命令列用戶端連線至 Amazon RDS 上的 MariaDB 資料庫執行個體 (加密)](USER_ConnectToMariaDBInstanceSSL.CLI.md)。

若要使用 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)]>
```

# 使用 AWS JDBC 驅動程式和 AWS Python 驅動程式連線至 RDS for MariaDB；
<a name="MariaDB.Connecting.Drivers"></a>

使用 AWS JDBC 驅動程式和 AWS Python 驅動程式連線至 RDS for MariaDB 資料庫執行個體。如需詳細資訊，請參閱下列主題。

**Topics**
+ [使用 Amazon Web Services (AWS) JDBC 驅動程式連線至 RDS for MariaDB](#MariaDB.Connecting.JDBCDriver)
+ [使用 Amazon Web Services (AWS) Python 驅動程式連線至 RDS for MariaDB](#MariaDB.Connecting.PythonDriver)

## 使用 Amazon Web Services (AWS) JDBC 驅動程式連線至 RDS for MariaDB
<a name="MariaDB.Connecting.JDBCDriver"></a>

Amazon Web Services (AWS) JDBC 驅動程式設計為進階 JDBC 包裝函式。此包裝函式是現有 JDBC 驅動程式的補充和延伸功能。驅動器與社群 MySQL Connector/J 驅動程式和社群 MariaDB Connector/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 儲存庫](https://github.com/awslabs/aws-advanced-jdbc-wrapper)。

## 使用 Amazon Web Services (AWS) Python 驅動程式連線至 RDS for MariaDB
<a name="MariaDB.Connecting.PythonDriver"></a>

Amazon Web Services (AWS) Python 驅動程式設計為進階 Python 包裝函式。此包裝函式是開放原始碼 Psycopg 驅動程式的補充和延伸功能。 AWS Python 驅動程式支援 Python 3.8 版和更高版本。您可以使用 `pip` 命令以及`psycopg`開放原始碼`aws-advanced-python-wrapper`套件來安裝套件。

如需 AWS Python 驅動程式的詳細資訊和完整的使用說明，請參閱 [Amazon Web Services (AWS) Python Driver GitHub 儲存庫](https://github.com/awslabs/aws-advanced-python-wrapper)。

# 對 MariaDB 資料庫執行個體的連線進行故障診斷
<a name="USER_ConnectToMariaDBInstance.Troubleshooting"></a>

無法連接至新的資料庫執行個體有下列兩個常見原因：
+ 建立資料庫執行個體所用的安全群組，未授權從執行 MariaDB 應用程式或公用程式的裝置或 Amazon EC2 執行個體進行連線。資料庫執行個體必須擁有能授權連線的 VPC 安全群組。如需詳細資訊，請參閱[Amazon VPC 和 Amazon RDS](USER_VPC.md)。

  您可以新增或編輯安全群組中的傳入規則。針對 **Source (來源)**，選擇 **My IP (我的 IP)**。此舉允許透過您的瀏覽器中偵測到的 IP 地址存取資料庫執行個體。
+ 資料庫執行個體是使用預設連接埠 3306 來建立，而公司的防火牆規則禁止從公司網路中的裝置連接至該連接埠。若要避免此失敗情況，請以不同的連接埠重新建立執行個體。

如需連線問題的詳細資訊，請參閱 [無法連線至 Amazon RDS 資料庫執行個體](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting)。