在 Kingbase 中使用 ksql 連接數據庫時，如果希望避免每次手動輸入密碼，可以通過以下方法實現免密登錄

1. 使用 .pgpass 文件（推薦）

Kingbase 兼容 PostgreSQL 協議，因此可以使用 PostgreSQL 的 .pgpass 文件來存儲密碼，實現免密登錄。步驟：

• 創建 .pgpass 文件：
  • 在用戶的主目錄下創建 .pgpass 文件：

  touch ~/.pgpass
  

  • 設置文件權限（確保只有當前用戶可讀寫）

  chmod 600 ~/.pgpass
  

• 編輯 .pgpass 文件：
  • 在 .pgpass 文件中添加以下內容：

  主機名:端口號:數據庫名:用戶名:密碼
  localhost:54321:testdb:system:mypassword
  

• 使用 ksql 連接數據庫：
  • 直接運行 ksql 命令，無需輸入密碼：

  ksql -U system -d testdb -h localhost -p 54321
  

2. 使用環境變量

可以通過設置環境變量 PGPASSWORD 來傳遞密碼，避免手動輸入。
步驟：

• 設置環境變量：
  • 在 Linux 或 macOS 中：

  export PGPASSWORD='mypassword'
  

  • 在 Windows 中：

  set PGPASSWORD=mypassword
  

• 使用 ksql 連接數據庫：
  • 直接運行 ksql 命令：

  ksql -U system -d testdb -h localhost -p 54321
  

3. 使用連接字符串

可以在 ksql 命令中直接指定連接字符串，包含用戶名和密碼。
步驟：

• 使用連接字符串：
  • 運行以下命令：

  ksql "host=localhost port=54321 dbname=testdb user=system password=mypassword"
  

4. 修改 ksql 的別名（簡化命令）

可以將 ksql 命令和連接參數封裝為一個別名，方便快速連接。
步驟：

• 編輯 Shell 配置文件：
  • 在 Linux 或 macOS 中，編輯 ~/.bashrc 或 ~/.zshrc 文件：

  alias myksql='ksql -U system -d testdb -h localhost -p 54321'
  

  • 在 Windows 中，可以創建一個批處理文件（如 myksql.bat）：

  @echo off
  ksql -U system -d testdb -h localhost -p 54321
  

• 使配置生效：
  • 在 Linux 或 macOS 中，運行以下命令：

  source ~/.bashrc
  

  • 在 Windows 中，直接運行批處理文件即可。
• 使用別名連接：
  • 在 Linux 或 macOS 中：

  myksql
  

  • 在 Windows 中：

  myksql.bat
  

5. 注意事項

• 安全性：
  • 使用 .pgpass 文件或環境變量時，確保密碼文件或環境變量不會被未授權用戶訪問。
  • 避免在腳本中直接硬編碼密碼。
• 權限問題
  • 確保 .pgpass 文件的權限為 600，否則 Kingbase 會忽略該文件。

6. 密碼含特殊字符轉義

如果 Kingbase 數據庫的密碼中包含 特殊字符（如 $, !, *, , " 等），在配置 .pgpass 文件或使用環境變量時，需要對特殊字符進行轉義，以避免解析錯誤。
以下是處理密碼中特殊字符的方法：

1. 在 .pgpass 文件中轉義特殊字符

• .pgpass 文件中的密碼部分需要根據以下規則轉義：
  • 冒號 (😃：必須轉義為 :
  • 反斜杠 ()：必須轉義為 \。
• 示例：
  • 假設密碼為 my$pass:word，則 .pgpass 文件中的內容應為：

  localhost:54321:testdb:system:my$pass\:word
  

2. 在環境變量中轉義特殊字符
   在設置環境變量 PGPASSWORD 時，需要根據 Shell 的規則對特殊字符進行轉義。
   (1) Linux/macOS（Bash/Zsh）
   • 使用單引號 (') 包裹密碼，避免 Shell 解析特殊字符。
   • 如果密碼中包含單引號，需要使用 ‘’’ 進行轉義。
   • 示例：

   export PGPASSWORD='my$pass:word'
   # 如果密碼為 my'pass$word，則：
   export PGPASSWORD='my'\''pass$word'
   

   (2) Windows（CMD/PowerShell）
   • 在 CMD 中，使用雙引號 (") 包裹密碼。
   • 如果密碼中包含雙引號，需要使用 " 進行轉義。
   • 示例：

   set PGPASSWORD="my$pass:word"
   # 如果密碼為 my"pass$word，則：
   set PGPASSWORD="my\"pass$word"
   

3. 在連接字符串中轉義特殊字符
   在 ksql 的連接字符串中，密碼部分需要用雙引號 (") 包裹，并對雙引號和反斜杠進行轉義。

• 示例：

# 假設密碼為 my$pass:word，則連接字符串為：
ksql "host=localhost port=54321 dbname=testdb user=system password='my$pass:word'"
# 如果密碼為 my"pass$word，則：
ksql "host=localhost port=54321 dbname=testdb user=system password='my\"pass$word'"

4. 在別名中轉義特殊字符
   如果使用別名簡化 ksql 命令，需要在別名定義中對特殊字符進行轉義。

• 示例：

# 假設密碼為 my$pass:word，則在 ~/.bashrc 或 ~/.zshrc 中定義別名：
alias myksql='ksql -U system -d testdb -h localhost -p 54321 -W my$pass:word'
# 如果密碼中包含單引號，需要使用 ''' 轉義：
alias myksql='ksql -U system -d testdb -h localhost -p 54321 -W my'\''pass$word'

5. 總結

• .pgpass 文件：轉義冒號 (😃 和反斜杠 ()。
• 環境變量：
  • Linux/macOS：使用單引號包裹密碼，轉義單引號。
  • Windows：使用雙引號包裹密碼，轉義雙引號。
• 連接字符串：用雙引號包裹密碼，轉義雙引號和反斜杠。
• 別名：根據 Shell 規則轉義特殊字符。