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

DriverManager で接続

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

ドライバーのロード

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

Class.forName("cdata.jdbc.cosmosdb.CosmosDBDriver");

接続の確立

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

Connection conn = DriverManager.getConnection("jdbc:cosmosdb:AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;");

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

prop.setProperty("AccountEndpoint","myAccountEndpoint");
prop.setProperty("AccountKey","myAccountKey");

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

CosmosDBDataSource クラスで接続

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

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

CosmosDBDataSource ds = new CosmosDBDataSource("jdbc:cosmosdb:UseConnectionPooling=true;AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;"); 
Connection conn = ds.getConnection();