このセクションでは、JDBC DriverManager またはIBMCloudSQLQueryDataSource インターフェースに接続する方法について説明します。

DriverManager で接続

DriverManager クラスを使用して接続する場合、CData JDBC Driver for IBM Cloud Data Engine はJDBC 規則に従います。最初にIBMCloudSQLQuery ドライバークラスをロードします。次に、接続を作成します。

ドライバーのロード

JDBC 4.0仕様では、次の手順はオプションです。

Class.forName("cdata.jdbc.ibmcloudsqlquery.IBMCloudSQLQueryDriver");

接続の確立

静的なDriverManager クラスのgetConnection メソッドで接続文字列を指定します。接続文字列を"jdbc:ibmcloudsqlquery:" で始めます。一般的な接続文字列は以下のとおりです。

Connection conn = DriverManager.getConnection("jdbc:ibmcloudsqlquery:Api Key=MyAPIKey;");

または、Properties オブジェクトを使用して接続オプションを準備できます。Properties オブジェクトをDriverManager に渡します。

prop.setProperty("Api Key","MyAPIKey");
prop.setProperty("Instance CRN","myInstanceCRN");
prop.setProperty("Region","myRegion");
prop.setProperty("Schema","mySchema");
prop.setProperty("OAuth Client Id","myOAuthClientId");
prop.setProperty("OAuth Client Secret","myOAuthClientSecret");

Connection conn = DriverManager.getConnection("jdbc:ibmcloudsqlquery:",prop);

IBMCloudSQLQueryDataSource クラスで接続

以下の例に示すように、IBMCloudSQLQueryDataSource クラスを使用してプールされた接続を作成できます。詳しくは、接続プール を参照してください。

次の例は、プールされたConnection オブジェクトをインスタンス化します。

IBMCloudSQLQueryDataSource ds = new IBMCloudSQLQueryDataSource("jdbc:ibmcloudsqlquery:UseConnectionPooling=true;Api Key=MyAPIKey;"); 
Connection conn = ds.getConnection();