將 CLPPlus 連接至 Db2 資料庫

指令行處理器 Plus (CLPPlus) 提供一個指令行介面，您可以用來連接至 BLUDB 資料庫，以及用來定義、編輯及執行陳述式、Script 和指令。CLPPlus 已包含在 Db2 驅動程式套件中。

開始之前

您必須先執行下列步驟，才能連接至資料庫：

驗證必要條件，包括安裝驅動程式套件、配置區域環境，以及下載 SSL 憑證（必要的話）
收集連接資訊，包括資料庫詳細資料（例如主機名稱及埠號）以及連接認證（例如使用者 ID 及密碼）

此外，請確保已在電腦上安裝 Java™ 1.5.0 版或更新版本的軟體開發套件 (SDK) 或 Java 執行時期環境 (JRE)，並且環境變數設定如下：

JAVA_HOME 環境變數設為電腦上的 Java 安裝目錄。
PATH 環境變數設定包括電腦上 Java 安裝目錄的 bin 子目錄。

程序

在 Linux 作業系統的指令 Shell 中，於 Windows 命令提示字元或 Windows 作業系統的 Db2 指令視窗中，輸入下列指令。
這些指令會在電腦的驅動程式配置檔 (db2dsdriver.cfg) 中建立新項目，並設定連線屬性。您只需執行此步驟一次。
- 若為不使用 SSL 的連線：
```
db2cli writecfg add -database BLUDB -host hostname -port 50000
db2cli writecfg add -dsn alias -database BLUDB -host hostname -port 50000
```
- 若為使用 SSL 的連線：
```
db2cli writecfg add -database BLUDB -host hostname -port 50001 -parameter "SecurityTransportMode=SSL"
db2cli writecfg add -dsn alias -database BLUDB -host hostname -port 50001
```
其中：
- hostname 是伺服器的主機名稱
- alias 是您選擇的別名
若要利用使用 db2dsdriver.cfg 檔案中項目的 Db2 資料庫連線來啟動 CLPPlus，請輸入下列指令：
- Windows 環境：
```
clpplus userid@alias
```
- Linux 環境：
```
clpplus -nw userid@alias
```
其中：
- userid 是來自您事先收集之連接認證中的使用者 ID
- alias 是您使用 db2cli writecfg 指令所建立的別名
發出此指令時會開啟 CLPPlus 視窗。

在 CLPPlus 視窗中，輸入您的密碼。

即會顯示資料庫資訊，後面接著 SQL 提示。範例輸出如下：


Hostname = 192.0.2.0
Database server = DB2/LINUXX8664  SQL10054
SQL authorization ID = smith
Local database alias = BLUDB
Port = 50001

SQL>

結果

您現在可以輸入 CLPPlus 指令或 SELECT 陳述式，然後執行 Script 來使用資料庫中的資料。

範例

下列範例使用簡短 Script，以從範例表格 GOSALES.BRANCH 中擷取列。Script 檔命名為 cities.sql，並且位於本端 Windows 電腦的 C:\temp 目錄中。cities.sql 檔案包含下列文字：

SET ECHO ON
SELECT branch_code, city from GOSALES.BRANCH;

範例 1：以互動方式執行 Script：

利用您的使用者 ID 以及您在 db2dsdriver.cfg 檔案中建立的別名，來啟動 CLPPlus：
```
clpplus user_id@alias
```
輸入您的密碼。
在 SQL 提示中，輸入下列文字：
```
start C:\temp\cities.sql
```

範例 2：利用您的使用者 ID 以及您在 db2dsdriver.cfg 檔案中建立的別名來啟動 CLPPlus，並透過一個步驟來執行 Script：


clpplus user_id/password@alias @C:\temp\cities.sql

cities.sql Script 的範例輸出如下：


BRANCH_CODE CITY
----------- --------------------------------------------------
          6 Paris
          7 Milano
          9 Amsterdam
         13 Hamburg
         14 München
         15 Kista
         17 Calgary
         18 Toronto
         19 Boston
         20 Seattle
         21 Los Angeles
         22 Miami
         23 Lyon
         24 Distrito Federal
         25 Tokyo
         26 Osaka City
         28 Melbourne
         29 Bilbao
         30 Sao Paulo
         31 Kuopio
         32 Seoul
         33 Singapore

BRANCH_CODE CITY
----------- --------------------------------------------------
         34 Shanghai
         35 London
         36 Birmingham
         37 Zürich
         38 Heverlee
         39 Wien
         40 Geneve

29 rows were retrieved.