GBase-8s數(shù)據(jù)庫JDBC Driver程序員指南

1、8s 數(shù)據(jù)庫 JDBC Driver 程序員指南GBase目錄1 簡介.- 1 -1.1 內(nèi)容- 1 -1.2 符合行業(yè)標(biāo)準(zhǔn)- 1 -1.3 演示數(shù)據(jù)庫- 1 -1.4 如何閱讀語法圖- 2 -1.5 示例代碼約定- 3 -2 入門- 4 -2.1 什么是 JDBC？ - 4 -2.2 什么是 JDBC 驅(qū)動(dòng)程序？ - 4 -2.3 GBase 8s JDBC 驅(qū)動(dòng)程序概述- 5 -2.3.1 在 GBase 8s JDBC 驅(qū)動(dòng)程序中實(shí)現(xiàn)的類- 5 -2.3.2 GBase 8s JDBC 驅(qū)動(dòng)程序中的文件- 9 -2.3.3 客戶機(jī)和服務(wù)器 JDBC 驅(qū)動(dòng)程序- 10 -2.4 取得 JD

2、BC 驅(qū)動(dòng)程序- 11 -2.5 安裝 JDBC 驅(qū)動(dòng)程序- 11 -2.5.1 在圖形或控制臺(tái)模式下安裝 JDBC 驅(qū)動(dòng)程序- 11 -2.5.2 在靜默模式下，安裝 JDBC 驅(qū)動(dòng)程序- 12 -2.6 在應(yīng)用程序中使用驅(qū)動(dòng)程序- 12 -2.7 在 applet 中使用驅(qū)動(dòng)程序- 14 -2.8 卸載 JDBC 驅(qū)動(dòng)程序- 14 -2.8.1 在圖形或控制臺(tái)模式下卸載- 15 -2.8.2 在靜默模式下卸載- 15 -3 連接至數(shù)據(jù)庫- 16 -3.1 OnCperties 參數(shù)配置文件- 16 -3.1.1 STD_INTERVAL_TO_FLOAT 配置參數(shù)- 16 -3.2 加載

3、GBase 8s JDBC 驅(qū)動(dòng)程序- 17 -3.3 DataSource 對(duì)象 - 18 -3.4 DriverManager.getConnection() 方法 - 21 -3.4.1 數(shù)據(jù)庫 URL 的格式- 22 -3.4.2 數(shù)據(jù)庫與數(shù)據(jù)庫服務(wù)器連接- 26 -3.4.3 指定屬性- 28 -3.5 隨同 GBase 8s JDBC 驅(qū)動(dòng)程序的 GBase 8s 環(huán)境變量- 29 -3.6 動(dòng)態(tài)地讀取 GBase 8s sqlhosts 文件- 39 -3.6.1 連接屬性語法.- 40 -3.6.2 管理要求- 41 -3.6.3 以 sqlhosts 數(shù)據(jù)來更新 LDAP 服

4、務(wù)器的實(shí)用程序 - 41 -3.7 連接至高可用性集群的服務(wù)器- 42 -通過 GBase 8s Connection Manager 連接至高可用性集群服務(wù)器的屬性 - 43-通過 SQLHOST 文件組條目，來連接至高可用性集群服務(wù)器的屬性.- 46 - 3.7.3 直接連接至服務(wù)器的 HDR 對(duì)的屬性 - 47 - 3.7.4 檢查高可用性輔助服務(wù)器的只讀狀態(tài)- 48 - 3.7.5 對(duì) HDR 輔助服務(wù)器的連接重試嘗試 - 49 -3.8 HTTP 代理服務(wù)器- 50 -3.8.1 配置環(huán)境來使用代理服務(wù)器- 51 -3.8.2 帶有 LDAP 服務(wù)器的代理 - 53 -3.9 其他多

5、層解決方案- 55 -3.10 加密選項(xiàng)- 55 -3.10.1 JCE 安全軟件包 - 56 -3.10.2 符合 GBase FIPS 的安全軟件包 - 56 -3.10.3 口令加密- 57 -3.10.4 配置連接來使用 SSL 協(xié)議- 57 -3.10.5 網(wǎng)絡(luò)加密- 58 -3.11 隨同 GBase 8s JDBC 驅(qū)動(dòng)程序來使用單點(diǎn)登錄訪問控制- 60 -3.12 PAM 認(rèn)證方法 - 61 -3.12.1 JDBC 中的 PAM - 62 -3.13 關(guān)閉連接- 63 -4 執(zhí)行數(shù)據(jù)庫操作- 64 -4.1 查詢數(shù)據(jù)庫- 64 -4.1.1 將查詢發(fā)送至 GBase 8s 數(shù)

6、據(jù)庫的示例- 64 -4.1.2 結(jié)果集- 65 -4.1.3 釋放資源- 66 -4.1.4 跨線程執(zhí)行- 66 -4.1.5 滾動(dòng)游標(biāo)- 66 -4.1.6 保持游標(biāo)- 67 -4.2 更新數(shù)據(jù)庫- 68 -4.2.1 執(zhí)行批量更新- 68 -GBase 8s JDBC Driver 程序員指南V南大通用數(shù)據(jù)技術(shù)股份有限公司4.2.2 執(zhí)行批量插入.- 69 -4.3 參數(shù)、轉(zhuǎn)義語法和不受支持的方法- 69 -4.3.1 CallableStatement OUT 參數(shù) - 69 -4.3.2 CallableStatement 中命名了的參數(shù) - 76 -4.3.3 JDBC 支持 DE

7、SCRIBE INPUT - 81 -4.3.4 轉(zhuǎn)義語法- 83 -4.3.5 不支持的方法和行為不同的方法- 83 -4.4 處理事務(wù)- 86 -4.5 處理錯(cuò)誤- 88 -4.5.1 以 SQLException 類來處理錯(cuò)誤- 88 -4.5.2 檢索語法錯(cuò)誤偏移量- 89 -4.5.3 以 com.gbasedbt.jdbc.Message 類來處理錯(cuò)誤- 90 -4.6 訪問數(shù)據(jù)庫元數(shù)據(jù)- 90 -4.7 對(duì) JDBC API 的其他 GBase 8s 擴(kuò)展 - 91 -4.7.1 “自動(dòng)釋放”特性- 91 -4.7.2 獲取驅(qū)動(dòng)程序版本信息- 92 -4.8 存儲(chǔ)和檢索 XML

8、文檔- 93 -4.8.1 建立環(huán)境，來使用 XML 方法- 93 -4.8.2 插入數(shù)據(jù)- 95 -4.8.3 檢索數(shù)據(jù)- 96 -4.8.4 插入數(shù)據(jù)示例- 96 -4.8.5 檢索數(shù)據(jù)示例- 98 -5 操作 GBase 8s 類型- 100 -5.1 distinct 數(shù)據(jù)類型- 100 -5.1.1 插入數(shù)據(jù)示例- 100 -5.1.2 檢索數(shù)據(jù)示例- 102 -5.1.3 不支持的方法- 103 -5.2 BYTE 和 TEXT 數(shù)據(jù)類型 - 104 -5.2.1 高速緩存大對(duì)象- 104 -5.2.2 示例：插入或更新數(shù)據(jù)- 104 -5.2.3 示例：選擇數(shù)據(jù)- 106 -5.

9、3 SERIAL 和 SERIAL8 數(shù)據(jù)類型- 108 -5.4 BIGINT 和 BIGSERIAL 數(shù)據(jù)類型 - 109 -5.5 INTERVAL 數(shù)據(jù)類型- 109 -5.5.1 Interval 類.- 110 -5.5.2 IntervalYM 類- 112 -5.5.3 IntervalDF 類 - 114 -5.5.4 Interval 示例 - 116 -5.6 集合和數(shù)組- 116 -5.6.1 集合示例- 117 -5.6.2 數(shù)組示例- 120 -5.7 命名的和未命名的行- 121 -5.7.1 間隔和集合支持- 122 -5.7.2 不支持的方法- 122 -5.

10、7.3 SQLData 接口- 122 -5.7.4 Struct 接口 - 127 -5.7.5 ClassGenerator 實(shí)用程序 - 132 -5.8 類型高速緩存信息- 135 -5.9 智能大對(duì)象數(shù)據(jù)類型- 135 -5.9.1 數(shù)據(jù)庫服務(wù)器中的智能大對(duì)象- 136 -5.9.2 客戶機(jī)應(yīng)用程序中的智能大對(duì)象- 137 -5.9.3 在智能大對(duì)象上執(zhí)行操作- 143 -5.9.4 使用存儲(chǔ)特征- 149 -5.9.5 使用狀態(tài)特征- 158 -5.9.6 使用鎖- 159 -5.9.7 高速緩存大對(duì)象- 160 -5.9.8 避免轉(zhuǎn)移大對(duì)象的錯(cuò)誤- 161 -5.9.9 智能大對(duì)

11、象示例- 161 -6 與不透明數(shù)據(jù)類型一起使用- 164 -6.1 IfmxUDTSQLInput 接口- 165 -6.1.1 讀取數(shù)據(jù)- 165 -6.1.2 于數(shù)據(jù)流中定位- 166 -6.1.3 設(shè)置或獲取數(shù)據(jù)屬性- 166 -6.2 IfmxUDTSQLOutput 接口 - 166 -6.3 映射不透明數(shù)據(jù)類型- 167 -6.4 鍵入高速緩存信息- 167 -6.5 不支持的方法- 167 -6.6 創(chuàng)建不透明類型和 UDR - 168 -6.6.1 創(chuàng)建不透明類型和 UDR 概述.- 168 -6.6.2 準(zhǔn)備創(chuàng)建不透明類型和 UDR - 170 -6.6.3 創(chuàng)建不透明類型

12、- 170 -6.6.4 創(chuàng)建 UDR - 173 -6.6.5 Java 類的要求- 174 -6.6.6 SQL 名稱 - 175 -6.6.7 指定不透明類型的屬性- 175 -6.6.8 創(chuàng)建 JAR 和類文件- 178 -6.6.9 將類定義發(fā)送到數(shù)據(jù)庫服務(wù)器- 179 -6.6.10 從現(xiàn)有代碼創(chuàng)建不透明類型- 180 -6.6.11 移除不透明類型和 JAR 文件- 182 -6.6.12 創(chuàng)建 UDR - 182 -6.6.13 移除 UDR 和 JAR 文件 - 184 -6.6.14 獲取有關(guān)不透明類型和 UDR 的信息 - 184 -6.6.15 在事務(wù)中執(zhí)行- 186

13、-6.7 示例- 187 -6.7.1 類定義- 187 -6.7.2 插入數(shù)據(jù)- 189 -6.7.3 檢索數(shù)據(jù)- 190 -6.7.4 不透明類型中的智能大對(duì)象- 191 -6.7.5 使用 UDTManager 從現(xiàn)有的 Java 類創(chuàng)建不透明類型 - 194 - 6.7.6 不需現(xiàn)有的 Java 類創(chuàng)建不透明類型- 207 - 6.7.7 使用 UDRManager 創(chuàng)建 UDR- 212 -7 全球化和日期格式- 214 -7.1 支持 JDK 和全球化 - 214 -7.2 支持 GBase 8s GLS 變量- 215 -7.3 支持 DATE 最終用戶格式 - 216 -7.3

14、.1 GL_DATE 變量- 216 -7.3.2 DBDATE 變量 (deprecated)- 219 -7.3.3 DBCENTURY 變量 - 221 -7.4 最終用戶格式的優(yōu)先規(guī)則- 222 -7.5 支持代碼集轉(zhuǎn)換- 223 -7.5.1 數(shù)據(jù)庫代碼集的字符- 223 -7.5.2 客戶端代碼集 Unicode - 225 -7.5.3 連接具有非 ASCII 字符的數(shù)據(jù)庫.- 226 -7.5.4 TEXT 和 CLOB 數(shù)據(jù)類型的代碼集轉(zhuǎn)換- 226 -7.5.5 BLOB 和 BYTE 數(shù)據(jù)類型的代碼集轉(zhuǎn)換- 229 -7.6 用戶定義的語言環(huán)境- 229 -7.6.1 使

15、用 NEWLOCALE 和 NEWCODESET 環(huán)境變量連接- 229 -7.6.2 使用 NEWNLSMAP 環(huán)境變量連接 - 230 -7.7 支持全球化的錯(cuò)誤消息- 230 -8 調(diào)優(yōu)和故障排除- 231 -8.1 調(diào)試 JDBC API 程序- 231 -8.2 管理性能- 231 -8.2.1 管理訪存緩沖區(qū)大小- 232 -8.2.2 大對(duì)象的內(nèi)存管理- 232 -8.2.3 減少網(wǎng)絡(luò)流量- 233 -8.2.4 批量插入- 234 -8.2.5 連接池- 234 -8.2.6 避免應(yīng)用程序掛起問題（僅限于 HP-UX）- 239 -9 附錄- 239 -9.1 示例代碼文件-

16、239 -9.1.1 可用示例摘要- 239 -9.2 DataSource 擴(kuò)展 - 247 -9.2.1 讀和寫屬性- 248 -9.2.2 獲取和設(shè)置標(biāo)準(zhǔn)屬性- 249 -9.2.3 獲取和設(shè)置 GBase 8s 連接屬性- 249 -9.2.4 獲取和設(shè)置連接池 DataSource 屬性 - 253 -9.3 映射數(shù)據(jù)類型- 254 -9.3.1 在 GBase 8s 和 JDBC 數(shù)據(jù)類型之間映射的數(shù)據(jù)類型- 254 -9.3.2 PreparedStatement.setXXX() 擴(kuò)展的數(shù)據(jù)類型映射- 258 -9.3.3 ResultSet.getXXX() 方法的數(shù)據(jù)類型映

17、射 - 268 -9.3.4 UDT manager 和 UDR manager 的數(shù)據(jù)類型映射- 272 -9.4 轉(zhuǎn)換內(nèi)部 GBase 8s 數(shù)據(jù)類型- 276 -9.4.1 IfxToJavaType 類 - 276 -9.5 錯(cuò)誤消息- 286 -9.5.1 -79700 - 286 -9.5.2 -79702 - 286 -GBase 8s JDBC Driver 程序員指南I南大通用數(shù)據(jù)技術(shù)股份有限公司9.5.3 -79703 - 286 -9.5.4 -79704 - 286 -9.5.5 -79705 - 286 -9.5.6 -79706 - 286 -9.5.7 -7970

18、7 - 287 -9.5.8 -79708 - 287 -9.5.9 -79709 - 287 -9.5.10 -79710 - 287 -9.5.11 -79711 - 287 -9.5.12 -79712 - 288 -9.5.13 -79713 - 288 -9.5.14 -79714 - 288 -9.5.15 -79715 - 288 -9.5.16 -79716 - 288 -9.5.17 -79717 - 288 -9.5.18 -79718 - 289 -9.5.19 -79719 - 289 -9.5.20 -79720 - 289 -9.5.21 -79721 - 289

19、-9.5.22 -79722 - 289 -9.5.23 -79723 - 289 -9.5.24 -79724 - 290 -9.5.25 -79725 - 290 -9.5.26 -79726 - 290 -9.5.27 -79727 - 290 -9.5.28 -79728 - 290 -9.5.29 -79729 - 290 -9.5.30 -79730 - 291 -9.5.31 -79731 - 291 -9.5.32 -79732 - 291 -9.5.33 -79733 - 291 -9.5.34 -79734 - 291 -9.5.35 -79735 - 291 -9.5.3

20、6 -79736 - 292 -GBase 8s JDBC Driver 程序員指南9.5.37 -79737 - 292 -X南大通用數(shù)據(jù)技術(shù)股份有限公司9.5.38 -79738 - 292 -9.5.39 -79739 - 292 -9.5.40 -79740 - 292 -9.5.41 -79741 - 292 -9.5.42 -79742 - 293 -9.5.43 -79744 - 293 -9.5.44 -79745 - 293 -9.5.45 -79746 - 293 -9.5.46 -79747 - 293 -9.5.47 -79748 - 294 -9.5.48 -7974

21、9 - 294 -9.5.49 -79750 - 294 -9.5.50 -79755 - 294 -9.5.51 -79756 - 294 -9.5.52 -79757 - 295 -9.5.53 -79758 - 295 -9.5.54 -79759 - 295 -9.5.55 -79760 - 295 -9.5.56 -79761 - 295 -9.5.57 -79762 - 296 -9.5.58 -79764 - 296 -9.5.59 -79765 - 296 -9.5.60 -79766 - 296 -9.5.61 -79767 - 296 -9.5.62 -79768 - 29

22、7 -9.5.63 -79769 - 297 -9.5.64 -79770 - 297 -9.5.65 -79771 - 297 -9.5.66 -79772 - 297 -9.5.67 -79774 - 297 -9.5.68 -79775 - 298 -9.5.69 -79776 - 298 -9.5.70 -79777 - 298 -GBase 8s JDBC Driver 程序員指南9.5.71 -79778 - 298 -9.5.104 -79816 - 305 -X南大通用數(shù)據(jù)技術(shù)股份有限公司9.5.72 -79780 - 298 -9.5.73 -79781 - 298 -9.5

23、.74 -79782 - 299 -9.5.75 -79783 - 299 -9.5.76 -79784 - 299 -9.5.77 -79785 - 299 -9.5.78 -79786 - 299 -9.5.79 -79788 - 300 -9.5.80 -79789 - 300 -9.5.81 -79790 - 300 -9.5.82 -79792 - 300 -9.5.83 -79793 - 300 -9.5.84 -79794 - 300 -9.5.85 -79795 - 301 -9.5.86 -79796 - 301 -9.5.87 -79797 - 301 -9.5.88 -7

24、9798 - 301 -9.5.89 -79799 - 301 -9.5.90 -79800 - 302 -9.5.91 -79801 - 302 -9.5.92 -79802 - 302 -9.5.93 -79803 - 302 -9.5.94 -79804 - 302 -9.5.95 -79805 - 303 -9.5.96 -79806 - 303 -9.5.97 -79807 - 303 -9.5.98 -79808 - 304 -9.5.99 -79809 - 304 -9.5.100 -79811 - 304 -9.5.101 -79812 - 304 -9.5.102 -7981

25、4 - 304 -9.5.103 -79815 - 305 -GBase 8s JDBC Driver 程序員指南9.5.105 -79817 - 305 -X南大通用數(shù)據(jù)技術(shù)股份有限公司9.5.106 -79818 - 305 -9.5.107 -79819 - 305 -9.5.108 -79820 - 305 -9.5.109 -79821 - 306 -9.5.110 -79822 - 306 -9.5.111 -79823 - 306 -9.5.112 -79824 - 306 -9.5.113 -79825 - 307 -9.5.114 -79826 - 307 -9.5.115

26、-79827 - 307 -9.5.116 -79828 - 307 -9.5.117 -79829 - 307 -9.5.118 -79830 - 307 -9.5.119 -79831 - 308 -9.5.120 -79834 - 308 -9.5.121 -79836 - 308 -9.5.122 -79837 - 308 -9.5.123 -79838 - 308 -9.5.124 -79839 - 309 -9.5.125 -79840 - 309 -9.5.126 -79842 - 309 -9.5.127 -79843 - 309 -9.5.128 -79844 - 309 -

27、9.5.129 -79845 - 310 -9.5.130 -79846 - 310 -9.5.131 -79847 - 311 -9.5.132 -79848 - 311 -9.5.133 -79849 - 311 -9.5.134 -79850 - 311 -9.5.135 -79851 - 311 -9.5.136 -79852 - 311 -9.5.137 -79853 - 312 -9.5.138 -79854 - 312 -GBase 8s JDBC Driver 程序員指南X南大通用數(shù)據(jù)技術(shù)股份有限公司9.5.139 -79855 - 312 -9.5.140 -79856 -

28、312 -9.5.141 -79857 - 312 -9.5.142 -79858 - 313 -9.5.143 -79859 - 313 -9.5.144 -79860 - 313 -9.5.145 -79861 - 313 -9.5.146 -79862 - 313 -9.5.147 -79863 - 314 -9.5.148 -79864 - 314 -9.5.149 -79865 - 314 -9.5.150 79868 - 314 -9.5.151 -79877 - 314 -9.5.152 -79878 - 314 -9.5.153 -79879 - 315 -9.5.154 -7

29、9880 - 315 -9.5.155 -79881 - 315 -GBase 8s JDBC Driver 程序員指南 - PAGE 9 -南大通用數(shù)據(jù)技術(shù)股份有限公司簡介內(nèi)容本手冊(cè)描述了如何安裝、加載和使用 GBase 8s JDBC Driver 從 Java 應(yīng)用程序或應(yīng)用小程序連接 GBase 8s 數(shù)據(jù)庫。這些主題描述了面向任務(wù)格式的 GBase 8s JDBC 擴(kuò)展；它不包括接口中的每個(gè)方法和參數(shù)。有關(guān)完整的參考（包括所有方法和參數(shù)），請(qǐng)參閱聯(lián)機(jī) Javadoc，它在安裝了 GBase 8s JDBC Driver 的 doc/javadoc 目錄中。還可以使用 GBase 8s

30、 JDBC Driver 編寫在服務(wù)器中執(zhí)行的用戶定義例程。這些主題是為使用 JDBC API 通過 GBase 8s JDBC Driver 連接到 GBase 8s 數(shù)據(jù)庫的Java 程序員編寫的。要使用這些主題，您應(yīng)該知道如何使用 Java 進(jìn)行編程，特別是了解JDBC API 的類和方法。有關(guān)軟件兼容性的信息，請(qǐng)參閱GBase 8s JDBC Driver 發(fā)行說明。這些主題來自 GBase 8s JDBC Driver 程序員指南。符合行業(yè)標(biāo)準(zhǔn)GBase 8s 產(chǎn)品符合各種標(biāo)準(zhǔn)。基于 SQL 的 GBase 8s 產(chǎn)品完全兼容 SQL-92 入門級(jí)（發(fā)布為 ANSI X3.135-1

31、992），這與 ISO 9075:1992 完全相同。另外，GBase 8s 數(shù)據(jù)庫服務(wù)器的許多功能都遵守 SQL-92 中級(jí)和完全級(jí)別以及 X/Open SQL 公共應(yīng)用程序環(huán)境 (CAE) 標(biāo)準(zhǔn)。演示數(shù)據(jù)庫DB-Access 實(shí)用程序隨 GBase 8s 數(shù)據(jù)庫服務(wù)器產(chǎn)品一起提供，它包括一個(gè)或多個(gè)以下演示數(shù)據(jù)庫：stores_demo 數(shù)據(jù)庫以一家虛構(gòu)的體育用品批發(fā)商的有關(guān)信息舉例說明了關(guān)系模式。GBase 8s 出版物中的許多示例均基于 stores_demo 數(shù)據(jù)庫。superstores_demo 數(shù)據(jù)庫舉例說明了對(duì)象關(guān)系模式。superstores_demo 數(shù)據(jù)庫包含擴(kuò)展數(shù)據(jù)類型

32、、類型和表繼承以及用戶定義的例程的示例。有關(guān)如何創(chuàng)建和填充演示數(shù)據(jù)庫的信息，請(qǐng)參閱GBase 8s DB-Access 用戶指南。有關(guān)數(shù)據(jù)庫及其內(nèi)容的描述，請(qǐng)參閱GBase 8s SQL 指南：參考。用于安裝演示數(shù)據(jù)庫的腳本位于 UNIX 平臺(tái)上的 $GBS_HOME/bin 目錄和 Windows環(huán)境中的 %GBS_HOME%bin 目錄中。如何閱讀語法圖語法圖使用特殊組件描述語句和命令的語法。 從左到右，從上到下跟隨線的路徑閱讀語法圖。此右側(cè)雙箭頭加直線符號(hào) 表示語句開始。右側(cè)箭頭符號(hào) 表示語句延續(xù)到下一行。右箭頭加直線符號(hào) 表示語句繼續(xù)上一行的內(nèi)容。直線、右箭頭加左箭頭符號(hào) 表示語句結(jié)束

33、。必需項(xiàng)出現(xiàn)在水平線（主路徑）中?？蛇x項(xiàng)出現(xiàn)在主路徑下方。如果可以從兩個(gè)或多個(gè)項(xiàng)中選擇，那么它們以堆棧的方式表示。如果必須選擇其中一項(xiàng)，那么堆棧中的一項(xiàng)出現(xiàn)在主路徑上。如果從中選擇的項(xiàng)是可選的，那么整個(gè)堆棧出現(xiàn)在主路徑下方。如果缺省其中一項(xiàng)，則它會(huì)在主路徑上方顯示，剩余的選項(xiàng)將會(huì)顯示在下方。返回左側(cè)的箭頭，在主線之上，表示該項(xiàng)可重復(fù)。在此情況下，重復(fù)項(xiàng)必須用一個(gè)或多個(gè)空格隔開。如果重復(fù)的箭頭包含一個(gè)逗號(hào)，那么您必須使用逗號(hào)分隔重復(fù)的項(xiàng)。堆棧上方重復(fù)的箭頭表示可以從堆棧的項(xiàng)目中進(jìn)行多個(gè)選擇或者重復(fù)一個(gè)選擇。SQL 關(guān)鍵字以大寫字母出現(xiàn) （例如：FROM）。它們必須嚴(yán)格按照所顯示的拼寫。變量以小寫

34、字母出現(xiàn)（例如：column-name）。它們表示用戶在語句中提供的名稱或值。如果出現(xiàn)了標(biāo)點(diǎn)符號(hào)、括號(hào)、算術(shù)運(yùn)算符或其它這樣的符號(hào)，那么必須將它們作為語法的一部分輸入。某些時(shí)候，一個(gè)變量表示一個(gè)語句段。例如：在以下語法圖中，變量 parameter-block 表示已標(biāo)記為 parameter-block 的語句段：parameter-block：示例代碼約定SQL 代碼的示例在整個(gè)出版物中出現(xiàn)。除非另有說明，代碼不特定于任何單個(gè)的 GBase 8s應(yīng)用程序開發(fā)工具。CONNECT TO stores_demo.DELETE FROM customer WHERE customer_num =

35、 121.COMMIT WORK如果示例中僅列出 SQL 語句，那么它們將不用分號(hào)定界。例如：您可能看到以下示例中的代碼： DISCONNECT CURRENT要將此 SQL 代碼用于特定產(chǎn)品，必須應(yīng)用該產(chǎn)品的語法規(guī)則。例如，如果使用的是 SQL API，那么必須在每條語句的開頭使用 EXEC SQL，并在每條語句的結(jié)尾使用分號(hào)（或其他合適的定界符）。 如果使用的是 DBAccess，那么必須用分號(hào)將多條語句隔開。提示： 代碼示例中的省略點(diǎn)表示在整個(gè)應(yīng)用程序中將添加更多的代碼，但是不必顯示它以描述正在討論的概念。有關(guān)使用特定應(yīng)用程序開發(fā)工具或 SQL API 的 SQL 語句的詳細(xì)指導(dǎo)，請(qǐng)參閱

36、您的產(chǎn)品文檔。入門這些主題提供 GBase 8s JDBC Driver 和 JDBC API 的概述。什么是 JDBC？Java 數(shù)據(jù)庫連接（JDBC）是標(biāo)準(zhǔn)應(yīng)用系統(tǒng)編程接口（API）的 JavaSoft 規(guī)范，其允許 Java程序訪問數(shù)據(jù)庫管理系統(tǒng)。JDBC API 由一系列以 Java 編程語言編寫的接口和類組成。使用這些標(biāo)準(zhǔn)接口和類，編程人員可編寫連接至數(shù)據(jù)庫的應(yīng)用程序，發(fā)送以結(jié)構(gòu)化查詢語言（SQL）編寫的查詢，并處理結(jié)果。由于 JDBC 是標(biāo)準(zhǔn)規(guī)范，因此，使用 JDBC API 的一個(gè) Java 程序可連接至任何數(shù)據(jù)庫管理系統(tǒng)（DBMS），只要存在該特定 DBMS 的驅(qū)動(dòng)程序。什么是

37、 JDBC 驅(qū)動(dòng)程序？JDBC API 定義 Java 接口和類，編程人員使用其來連接至數(shù)據(jù)庫，并發(fā)送查詢。JDBC 驅(qū)動(dòng)程序?qū)崿F(xiàn)特定 DBMS 供應(yīng)商這些接口和類。在使用 JDBC API 的 Java 程序?qū)嶋H連接至數(shù)據(jù)庫之前，它為特定 DBMS 加載指定的驅(qū)動(dòng)程序。然后，JDBC DriverManager 類將所有 JDBC API 調(diào)用發(fā)送至加載了的驅(qū)動(dòng)程序。有四類 JDBC 驅(qū)動(dòng)程序：JDBC-ODBC 橋加 ODBC 驅(qū)動(dòng)程序，也稱為 Type 1 驅(qū)動(dòng)程序?qū)?JDBC API 調(diào)用翻譯為 Microsoft ODBC 調(diào)用，然后將其傳至 ODBC 驅(qū)動(dòng)程序必須在使用此類驅(qū)動(dòng)程序

38、的每個(gè)客戶機(jī)計(jì)算機(jī)上加載 ODBC 二進(jìn)制代碼。ODBC 是“開放式數(shù)據(jù)庫連接”的首字母縮略詞。本地 API，一定程度上的 Java 驅(qū)動(dòng)程序，也稱為 Type 2 驅(qū)動(dòng)程序?qū)?JDBC API 調(diào)用轉(zhuǎn)換為特定于 DBMS 的客戶機(jī) API 調(diào)用像橋驅(qū)動(dòng)程序一樣，這類驅(qū)動(dòng)程序要求在每一客戶機(jī)計(jì)算機(jī)上加載某些二進(jìn)制代碼。JDBC-Net，純 Java 驅(qū)動(dòng)程序，也稱為 Type 3 驅(qū)動(dòng)程序?qū)?JDBC API 調(diào)用發(fā)送至中間層服務(wù)器，其將這些調(diào)用翻譯為特定于 DBMS 的網(wǎng)絡(luò)協(xié)議然后將翻譯了的調(diào)用發(fā)送至特定的 DBMS。本地協(xié)議，純 Java 驅(qū)動(dòng)程序，也稱為 Type 4 驅(qū)動(dòng)程序直接將 J

39、DBC API 調(diào)用轉(zhuǎn)換為特定于 DBMS 的網(wǎng)絡(luò)協(xié)議，而不經(jīng)過中間層此驅(qū)動(dòng)程序允許客戶機(jī)應(yīng)用程序直接連接至數(shù)據(jù)庫服務(wù)器。GBase 8s JDBC 驅(qū)動(dòng)程序概述GBase 8s JDBC Driver 是本地協(xié)議，純 Java 驅(qū)動(dòng)程序（Type 4）。這意味著，當(dāng)您在使用JDBC API 來連接至 GBase 8s 數(shù)據(jù)庫的 Java 程序中，使用 GBase 8s JDBC 驅(qū)動(dòng)程序時(shí)，您的會(huì)話直接連接至數(shù)據(jù)庫或數(shù)據(jù)庫服務(wù)器，而不經(jīng)過中間層。Javadoc 頁面詳盡地描述 GBase 8s 擴(kuò)展類、接口和方法。在 UNIX 中，Javadoc 頁面位于 $JDBCLOCATION/doc

40、/javadoc 中，在此，$JDBCLOCATION 引用安裝了 GBase 8s JDBC 驅(qū)動(dòng)程序的那個(gè)目錄。在 Windows 中， Javadoc 頁面位于 %JDBCLOCATION%docjavadoc 中， 在此，%JDBCLOCATION% 引用安裝了 GBase 8s JDBC 驅(qū)動(dòng)程序的那個(gè)目錄。在 GBase 8s JDBC 驅(qū)動(dòng)程序中實(shí)現(xiàn)的類要支持 DataSource 對(duì)象、連接池和分布式事務(wù)，GBase 8s JDBC Driver 提供實(shí)現(xiàn)接口的類和 JDBC 3.0 API 中描述的類。實(shí)現(xiàn) Java 接口的 GBase 8s 類下表羅列 Java 接口和類，

41、以及實(shí)現(xiàn)它們的 GBase 8s 類。JDBC接口或類GBase8s類JDBC 接口或類GBase 8s類java.io.Serializablecom.gbasedbt.jdbcx.IfxCoreDataSourcejava.sql.Connectioncom.gbasedbt.jdbc.IfmxConnectionjavax.sql.ConnectionEventListene rcom.gbasedbt.jdbcx.IfxConnectionEventListene rjavax.sql.ConnectionPoolDataSour cecom.gbasedbt.jdbcx.IfxCon

42、nectionPoolDataSour cejavax.sql.DataSourcecom.gbasedbt.jdbcx.IfxDataSourcejavax.sql.PooledConnectioncom.gbasedbt.jdbcx.IfxPooledConnectionjavax.sql.XADataSourcecom.gbasedbt.jdbcx.IfxXADataSourcejava.sql.ParameterMetaDatacom.gbasedbt.jdbc.IfxParameterMetaDataGBase 8s JDBC Driver Version 3.0 及后來的版本，實(shí)現(xiàn)

43、由 JDBC 3.0 規(guī)范在 ResultSet 接口中定義的 updateXXX() 方法。在 J2SDK 1.4.x API 及后來的版本中，定義諸如 updateClob 這樣的這些方法，并要求可更新 ResultSet 對(duì)象。updateXXX() 方法允許通過使用 Java 變量和對(duì)象來更新行，并擴(kuò)展至包括附加的 JDBC 類型。這些方法更新以定位器實(shí)現(xiàn)的 JDBC 類型，而不是由定位器指定的數(shù)據(jù)，來實(shí)現(xiàn)的 JDBC類型。擴(kuò)展 Java 規(guī)范的 GBase 8s 類要支持 SQL 語句和數(shù)據(jù)類型的 GBase 8s 實(shí)現(xiàn)，GBase 8s JDBC Driver 提供擴(kuò)展 JDBC

44、3.0 API 的類。下表羅列 Java 類，以及應(yīng)用程序程序可用來擴(kuò)展它們的 GBase 8s 類。JDBC 接口或類GBase 8s類為添加方法或常量java.lang.Objectcom.gbasedbt.lang.IfxTypes表示數(shù)據(jù)類型java.lang.Objectcom.gbasedbt.jdbc.IfxStatementTyp es表示 SQL 語句java.lang.Objectcom.gbasedbt.jdbc.Interval對(duì)于下兩類（下兩個(gè)的基礎(chǔ)類），間隔限定符和某些通用方法java.lang.Objectcom.gbasedbt.jdbc.IntervalYM間

45、隔年至月JDBC 接口或類GBase 8s類為添加方法或常量java.lang.Objectcom.gbasedbt.jdbc.IntervalDF間隔日至部分java.lang.Objectcom.gbasedbt.jdbc.IfxSmartBlob智能大對(duì)象的訪問方法java.lang.Objectcom.gbasedbt.jdbc.IfxLocator大對(duì)象定位器指針java.lang.Objectcom.gbasedbt.jdbc.IfxLoStat關(guān)于智能大對(duì)象的統(tǒng)計(jì)信息java.lang.Objectcom.gbasedbt.jdbc.IfxLobDescripto r智能大對(duì)象的

46、內(nèi)部特征java.lang.Objectcom.gbasedbt.jdbc.IfxUDTInfo關(guān)于 opaque 和distinct 類型的通用信息，關(guān)于復(fù)合類型的詳盡信息java.sql.Blobcom.gbasedbt.jdbc.IfxBblob二進(jìn)制大對(duì)象java.sql.CallableStat ementcom.gbasedbt.jdbc.IfmxCallableSta tement以GBase 8s類型處理的參數(shù)java.sql.Clobcom.gbasedbt.jdbc.IfxCblob字符大對(duì)象java.sql.Connectioncom.gbasedbt.jdbc.Ifmx

47、Connectionopaque、distinct 和復(fù)合類型java.sql.SQLDatacom.gbasedbt.jdbc.IfxBSONObjectGBase 8sBSON 數(shù)據(jù)類型關(guān)于如何插入和查詢JSON 和 BSON 數(shù)據(jù)，以及如何使用IfxBSONObject 方法的示例，請(qǐng)參閱$GBS_HOME/demo/bson目錄中的IfxBSONObjectDemo.jaJDBC 接口或類GBase 8s類為添加方法或常量va 程序。java.sql.PreparedStat ementcom.gbasedbt.jdbc.IfmxPreparedSta tement以GBase 8s類

48、型處理的參數(shù)java.sql.ResultSetcom.gbasedbt.jdbc.IfmxResultSetGBase 8s間隔數(shù)據(jù)類型java.sql.ResultSetMet aDatacom.gbasedbt.jdbc.IfmxResultSetMe taData帶有GBase 8s數(shù)據(jù)類型的列java.sql.SQLInputcom.gbasedbt.jdbc.IfmxComplexSQLI nputopaque、distinct 和復(fù)合類型java.sql.SQLInputcom.gbasedbt.jdbc.IfmxUDTSQLInputopaque、distinct 和復(fù)合類型j

49、ava.sql.SQLOutputcom.gbasedbt.jdbc.IfmxComplexSQLO utputopaque、distinct 和復(fù)合類型java.sql.SQLOutputcom.gbasedbt.jdbc.IfmxUDTSQLOutpu topaque、distinct 和復(fù)合類型java.sql.Statementcom.gbasedbt.jdbc.IfmxStatement單結(jié)果集、autofree 方法、語句類型和 SERIAL 數(shù)據(jù)類型處理提供超出 Java 規(guī)范支持的 GBase 8s 類許多 GBase 8s 類提供對(duì)未出現(xiàn)在 Java 規(guī)范中的功能的支持。下表

50、中羅列這些類。JDBC 接口或類GBase 8s類為提供支持java.lang.ObjectUDTManager在數(shù)據(jù)庫服務(wù)器中部署 opaque 數(shù)據(jù)類型java.lang.ObjectUDTMetaData在數(shù)據(jù)庫服務(wù)器中部署 opaque 數(shù)據(jù)類型java.lang.ObjectUDRManager在數(shù)據(jù)庫服務(wù)器中部署用戶定義的例程java.lang.ObjectUDRMetaData在數(shù)據(jù)庫服務(wù)器中部署用戶定義的例程隨同 JDK Version 1.4 及后來版本的 UDTManager 和 UDRManager 類在先前版本中，不可從打包的類來訪問包括在 ifxtools.jar 中

51、的 UDTManager 和UDRManager helper 類。從 GBase 8s JDBC Driver 2.21.JC3 開始，所有這些類都在udtudrmgr 包中。為了向后兼容，也包括這些類的未打包版本。要訪問打包的類，請(qǐng)?jiān)诔绦蛑惺褂孟铝袑?dǎo)入語句：import udtudrmgr.UDTManager;import udtudrmgr.UDRManager;GBase 8s JDBC 驅(qū)動(dòng)程序中的文件在程序文件 setup.jar 中，可得到 GBase 8s JDBC Driver。要獲取關(guān)于如何安裝驅(qū)動(dòng)程序的指導(dǎo)，請(qǐng)參閱 安裝 JDBC 驅(qū)動(dòng)程序。在安裝之后，該產(chǎn)品由下列文件

52、組成， 其中某些是 Java 歸檔（JAR）文件：lib/ifxjdbc.jarJDBC API 接口、類和方法的優(yōu)化的實(shí)現(xiàn)以 javac 命令的 -O 選項(xiàng)來編譯該文件。lib/ifxtools.jar實(shí)用程序：ClassGenerator，輕量目錄訪問協(xié)議（LDAP）loader，及其他以 javac 命令的 -O 選項(xiàng)來編譯該文件。lib/ifxlang.jar驅(qū)動(dòng)程序支持的所有消息文本的本地化版本以 javac 命令的 -O 選項(xiàng)來編譯該文件。lib/ifxjdbcx.jar包括與 DataSource 相關(guān)的、與連接池相關(guān)的以及與 XA 相關(guān)的類文件的實(shí)現(xiàn)以 javac 命令的 -O

53、 選項(xiàng)來編譯該文件。lib/ifxsqlj.jar包括 SQLJ 程序的運(yùn)行時(shí)刻支持的類以 javac 命令的 -O 選項(xiàng)來編譯該文件。demo/basic/* demo/rmi/*demo/stores7/* demo/clob-blob/* demo/complex-types/*demo/pickaseat/* demo/xml/* demo/proxy/* demo/connection-pool/* demo/udt-distinct/ * demo/hdr/* demo/tools/udtudrmgr/*使用 JDBC API 的樣例程序要了解這些樣例文件的描述，請(qǐng)參閱 示例代碼文

54、件。proxy/IfxJDBCProxy.class http tunneling proxy 類文件proxy/SessionMgr.class支持 http tunneling proxy 的 session manager 類文件proxy/TimeoutMgr.class支持 http tunneling proxy 的 timeout manager 類文件doc/release/*聯(lián)機(jī)的版本與文檔說明doc/javadoc/*GBase 8s 擴(kuò)展類和接口的 Javadoc 頁面lib、demo、proxy 和 doc 目錄是安裝了 GBase 8s JDBC Driver 的目錄

55、的子目錄。客戶機(jī)和服務(wù)器 JDBC 驅(qū)動(dòng)程序GBase 8s JDBC Driver 存在兩個(gè)版本：客戶機(jī)側(cè)驅(qū)動(dòng)程序和服務(wù)器側(cè)驅(qū)動(dòng)程序?？蛻魴C(jī)側(cè)驅(qū)動(dòng)程序用于客戶機(jī) Java 應(yīng)用程序訪問 GBase 8s 數(shù)據(jù)庫服務(wù)器?？蛻魴C(jī)側(cè)驅(qū)動(dòng)程序包括 ifxjdbc.jar 和 ifxjdbcx.jar 加上幾個(gè)支持 .jar 文件，如 GBase 8s JDBC 驅(qū)動(dòng)程序中的文件 部分中描述的那樣。安裝服務(wù)器側(cè)驅(qū)動(dòng)程序作為數(shù)據(jù)庫服務(wù)器的一部分，且包括 jdbc.jar。由于 jdbc.jar 派生自ifxjdbc.jar，因此兩個(gè)驅(qū)動(dòng)程序有許多共同特性。本指南主要關(guān)于客戶機(jī)側(cè)驅(qū)動(dòng)程序；然而，共同特性的

56、信息同時(shí)適用于服務(wù)器側(cè)和客戶機(jī)側(cè)版本。重要： 請(qǐng)不要混淆或互換服務(wù)器側(cè)與客戶機(jī)側(cè)版本。J/Foundation 開發(fā)者指南 描述 GBase 8s JDBC Driver 專門為服務(wù)器側(cè) JDBC 應(yīng)用程序提供的接口和子協(xié)議，以及應(yīng)用于服務(wù)器側(cè) JDBC 應(yīng)用程序的限制。取得 JDBC 驅(qū)動(dòng)程序可從GBase 8s JDBC Driver 產(chǎn)品 CD，從 GBase 8s 產(chǎn)品包 CD 的 JDBC 目錄取得 GBase 8s JDBC Driver，或可從 HYPERLINK / 下載驅(qū)動(dòng)程序。CD 或網(wǎng)站下載包含下列文件：setup.jardoc/jdbcrel.htmdoc/instal

57、l.txtsetup.jar 文件是 GBase 8s JDBC Driver 安裝程序。文檔目錄 /doc 包含 HTML 格式的版本說明。要獲取這些主題內(nèi)得不到的任何新信息，請(qǐng)參閱此文檔。安裝 JDBC 驅(qū)動(dòng)程序要與 GBase 8s 一道安裝 GBase 8s JDBC Driver，對(duì)于您的特定操作系統(tǒng)，請(qǐng)遵循 GBase 8s安裝指南 中的指導(dǎo)：對(duì)于 UNIX： 在 UNIX 和 Linux 上安裝 GBase 8s 和客戶機(jī)產(chǎn)品對(duì)于 Windows： 在 Windows 上安裝 GBase 8s 和客戶機(jī)產(chǎn)品要單獨(dú)安裝 GBase 8s JDBC 驅(qū)動(dòng)程序：如果您從網(wǎng)站下載了 GB

58、ase 8s JDBC Driver .zip 文件，則請(qǐng)將文件提取至目錄。如果您正從 CD 安裝驅(qū)動(dòng)程序，則請(qǐng)將 CD 裝入 CD-ROM 驅(qū)動(dòng)器內(nèi)。在圖形或控制臺(tái)模式下安裝 JDBC 驅(qū)動(dòng)程序從命令提示符，通過使用下列命令之一來啟動(dòng)安裝程序：要在圖形模式下啟動(dòng)： java -jar dir/setup.jar -i gui 要在控制臺(tái)模式下啟動(dòng)： java -jar dir/setup.jar -i console在此，dir 是 setup.jar 文件的位置。閱讀許可協(xié)議，并接受條款。如安裝指導(dǎo)的那樣來響應(yīng)提示。當(dāng)出現(xiàn)提示時(shí)，請(qǐng)接受缺省目錄，或指定不同的目錄。在 Windows 平臺(tái)上

59、，缺省目錄是 C:Program FilesGBASEGBASEDBT_JDBC_Driver在安裝和卸載過程中，要防止錯(cuò)誤，請(qǐng)不要在安裝路徑中使用感嘆號(hào)（!）。當(dāng)出現(xiàn)提示時(shí)，請(qǐng)核實(shí)安裝路徑的位置。安裝程序安裝 GBase 8s JDBC Driver，并通知您正在將卸載程序添加至安裝目錄。提示： 當(dāng)連接至掛載了 NFS 的文件系統(tǒng)時(shí)，如果安裝停頓，則應(yīng)首先解決 NFS 問題。在某些情況下，卸載和重新掛載共享可解決該問題。否則，請(qǐng)強(qiáng)制終止卸載，清理任何孤立的進(jìn)程，并重新啟動(dòng)安裝。當(dāng)您看到此消息時(shí)，請(qǐng)指定 Finish：Congratulations. GBase 8s JDBC Driver

60、has been successfully installed to:在靜默模式下，安裝 JDBC 驅(qū)動(dòng)程序從目錄提示符，請(qǐng)運(yùn)行下列命令：java -jar dir/setup.jar i -silent-DUSER_INSTALL_DIR=destination_dir-DLICENSE_ACCEPTED=TRUE此處：dir 是 setup.jar 文件的位置。destination_dir 是想要安裝 JDBC 驅(qū)動(dòng)程序的目錄。當(dāng)該命令結(jié)束運(yùn)行時(shí)，安裝完成。在應(yīng)用程序中使用驅(qū)動(dòng)程序要在應(yīng)用程序中使用 GBase 8s JDBC Driver，您必須設(shè)置 CLASSPATH 環(huán)境變量來指向