準備工作
云數據庫GaussDB 提供gsql工具幫助您在命令行下連接數據庫，您需要提前創建一臺彈性云主機用于安裝gsql工具。具體請參見《彈性云主機用戶指南》。
須知
操作系統需要選擇Euler操作系統。gsql支持的操作系統版本如下：
X86：EulerOS V2.0SP5。
設置安全組規則
在訪問數據庫前，您需要將訪問數據庫的IP地址，或者IP段加入安全組入方向的訪問規則，操作請參見設置安全組規則。
遠程連接數據庫
步驟 1 登錄申請的彈性云主機。
步驟 2 在申請的彈性云主機上，上傳客戶端工具包并配置gsql的執行環境變量。
- 以root用戶登錄客戶端機器。
- 創建“/tmp/tools”目錄。
mkdir /tmp/tools
- 獲取云數據庫GaussDB 軟件包并解壓。
unzip GaussDB_opengauss_client_tools.zip
- 根據申請的彈性云主機的操作系統架構進入不同目錄，獲取“GaussDB-Kernel-xxx-EULER-64bit-gsql.tar.gz”，并上傳到申請的彈性云主機“/tmp/tools”路徑下。
說明軟件包相對位置為安裝時所放位置，根據實際情況填寫。
- 解壓文件。
cd /tmp/tools
tar -zxvf GaussDB-Kernel-xxx-EULER-64bit-gsql.tar.gz
xxx為版本號，請根據實際情況替換。
- 設置環境變量。
打開“~/.bashrc”文件。
vi ~/.bashrc
按下i鍵進入INSERT模式，在其中輸入如下內容后，單擊“ESC”退出編輯模式，使用“:wq!”命令保存并退出。
export PATH=/tmp/tools/bin:$PATH
export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH
使環境變量配置生效。
source ~/.bashrc
步驟 3 執行如下指令，根據提示輸入密碼，連接數據庫。
數據庫創建成功后，會默認生成名稱為postgres的數據庫，此處以postgres庫為例。
gsql -d postgres -h 10.0.0.0 -U root -p 8000
Password for user root:
postgres為需要連接的數據庫名稱，10.0.0.0分布式為CN的IP地址，主備版為主DN的IP地址，root為登錄數據庫的用戶名，8000為CN的端口號。
SSL連接
步驟 1 登錄管理控制臺。
步驟 2 在“實例管理”頁面，單擊實例名稱進入“基本信息”頁面，單擊“數據庫信息”模塊“SSL”處的，下載根證書或捆綁包。
步驟 3 將根證書上傳至需連接云數據庫GaussDB 實例的彈性云主機，或保存到可訪問數據庫實例的設備。
將根證書導入彈性云主機Linux操作系統，您可以使用任何終端連接工具（如WinSCP、PuTTY等工具）將證書上傳至Linux系統任一目錄下以實現該目標。
步驟 4 連接云數據庫GaussDB 實例。
以Linux系統為例，在彈性云主機設置環境變量，執行如下命令。
export PGSSLMODE=<sslmode>
export PGSSLROOTCERT=<ca-file-directory>
gsql -h <host> -p <port> -d <database> -U <user>
參數說明
| 參數 | 說明 |
|---|---|
<host> |
主機IP，在“實例管理”頁面單擊實例名稱，進入“基本信息”頁面。“連接信息”模塊的“內網地址”（通過彈性云主機訪問）。 |
<port> |
端口，默認8000，當前端口，即在“實例管理”頁面單擊實例名稱，進入“基本信息”頁面，“連接信息”模塊的“數據庫端口”。 |
<database> |
需要連接的數據庫名，默認管理數據庫是postgres。 |
<user> |
用戶名，即云數據庫GaussDB 數據庫帳號，默認管理員帳號為root。 |
<ca-file-directory> |
ssl連接CA證書路徑。 |
<sslmode> |
ssl連接模式，設置為“verify-ca”，通過檢查證書鏈（Certificate Chain，以下簡稱CA）來驗證服務是否可信任。 |
在彈性云主機設置環境變量，使用root用戶SSL連接postgres數據庫實例，具體示例如下：
export PGSSLMODE="verify-ca"
export PGSSLROOTCERT="/home/Ruby/ca.pem"
gsql -d postgres -h 10.0.0.0 -U root -p 8000
Password for user root:
步驟 5 登錄數據庫后，出現如下信息，表示通過SSL連接成功。
SSL connection (cipher: DHE-RSA-AES256-GCM-SHA384, bits: 256)
