閱讀(1.7k) 書簽贊(0) 我要糾錯

OceanBase 數(shù)據(jù)源的特性和屬性

2021-06-30 15:51 更新

通過將數(shù)據(jù)源功能與 JNDI 結(jié)合使用，就不需要注冊供應(yīng)商指定的 JDBC 驅(qū)動程序類名稱，還可以將邏輯名稱用于 URL 和其他屬性，這樣確保了用于打開數(shù)據(jù)庫連接的代碼可以移植到其他環(huán)境。

DataSource 接口

JDBC 數(shù)據(jù)源是實現(xiàn)標(biāo)準(zhǔn) ?javax.sql.DataSource? 接口類的實例，如下所示：

public interface DataSource
{
   Connection getConnection() throws SQLException;
   Connection getConnection(String username, String password)
      throws SQLException;
   ...
}

OceanBase 數(shù)據(jù)庫使用 ?ocanbase.jdbc.pool? 軟件包中的 ?OceanBaseDataSource? 類實現(xiàn)此接口，通過 ?getConnection? 方法重載返回到數(shù)據(jù)庫的連接。

要使用其他值，可以使用適當(dāng)?shù)?nbsp;?Setter? 方法設(shè)置對應(yīng)屬性。對于備用用戶名和密碼，還可以將這些參數(shù)作輸入到 ?getConnection?方法，這優(yōu)先于屬性設(shè)置。

DataSource 屬性

與實現(xiàn) ?DataSource? 接口的類一樣，?OceanBaseDataSource? 類提供了一組屬性，可用于指定要連接的數(shù)據(jù)庫。這些屬性遵循 JavaBeans 設(shè)計模式。

?OceanBaseDataSource? 依據(jù) Sun Microsystems 規(guī)范的標(biāo)準(zhǔn)屬性，如下表所示。

名稱	類型	描述
databaseName	String	服務(wù)器上指定數(shù)據(jù)庫的名稱。
dataSourceName	String	基礎(chǔ)數(shù)據(jù)源類的名稱。對于連接池，這是基礎(chǔ)池連接數(shù)據(jù)源類。對于分布式事務(wù)，這是基礎(chǔ) XA 數(shù)據(jù)源類。
description	String	對數(shù)據(jù)源的描述。
networkProtocol	String	與服務(wù)器通信的網(wǎng)絡(luò)協(xié)議。
password	String	連接用戶的密碼。
portNumber	int	服務(wù)器偵聽請求的端口號。
serverName	String	數(shù)據(jù)庫服務(wù)器名稱。
user	String	登錄名。

?OceanBaseDataSource? 擴展的數(shù)據(jù)源屬性如下表所示。

名稱	類型	描述

connectionCacheName	String	指定緩存的名稱。創(chuàng)建緩存后無法更改。
connection-Cache-Properties	java.util.Properties	指定隱式連接緩存的屬性。
connectionCachingEnabled	Boolean	指定是否使用隱式連接緩存。
connectionProperties	java.util.Properties	指定連接屬性。
driverType	String	指定 JDBC 驅(qū)動程序類型。
fastConnectionFailoverEnabled	Boolean	指定是否正在使用快速連接故障轉(zhuǎn)移。
implicitCachingEnabled	Boolean	指定是否啟用隱式語句連接緩存。
loginTimeout	int	指定此數(shù)據(jù)源在嘗試連接到數(shù)據(jù)庫時將等待的最長時間（以秒為單位）。
logWriter	java.io.PrintWriter	指定此數(shù)據(jù)源的日志編寫器。
maxStatements	int	指定應(yīng)用程序緩存中的最大語句數(shù)。
serviceName	String	指定此數(shù)據(jù)源的數(shù)據(jù)庫服務(wù)名稱。
tnsEntry	String	指定 TNS 條目名稱。TNS 條目名稱對應(yīng)于 `tnsnames.ora` 配置文件中指定的 TNS 條目。
url	String	指定數(shù)據(jù)庫連接字符串的 URL?？梢允褂么藢傩源?nbsp;`tnsEntry` 和 `driverType` 屬性以及標(biāo)準(zhǔn) `portNumber`、`networkProtocol`、`serverName` 和 `databaseName`屬性。
ONSConfiguration	String	指定用于遠(yuǎn)程訂閱 FAN/ONS 事件的 ONS 配置字符串。

使用 ?setConnectionProperties? 方法設(shè)置連接的屬性，并使用 ?setConnectionCacheProperties? 方法設(shè)置連接緩存的屬性。另外，只有在對數(shù)據(jù)源啟用了緩存之后才設(shè)置了數(shù)據(jù)源的 ?ConnectionCacheName? 屬性，?getConnectionCacheName()? 才會返回緩存的名稱。

以上內(nèi)容是否對您有幫助：

← OceanBase 數(shù)據(jù)源概述

OceanBase 創(chuàng)建數(shù)據(jù)源實例并連接 →

寫筆記

我要補充