JDBC ドライバを使用して Spanner Omni に接続する

このドキュメントでは、Spanner JDBC ドライバを使用して Java アプリケーションを Spanner Omni に接続し、SQL ステートメントを実行する方法について説明します。

Java Database Connectivity（JDBC）は、アプリケーションがリレーショナル データベースと一貫した方法でやり取りするための標準 Java API です。Spanner JDBC ドライバは、Spanner と同様に Spanner Omni で動作します。

JDBC ドライバを使用すると、標準の JDBC 互換ツールとライブラリを Spanner Omni で活用できます。

Spanner Omni JDBC 接続は、プレーン テキスト、TLS、認証情報付き TLS、mTLS をサポートしています。

詳細については、Spanner ドキュメントの JDBC で Spanner を使ってみるをご覧ください。

始める前に

JDBC ドライバで Spanner Omni を使用するには、Spanner JDBC ドライバ バージョン 2.41.0 以降を使用します。

部品構成表（BOM）なしで Maven を使用する場合は、pom.xml ファイルの依存関係に次のものを追加します。

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-jdbc</artifactId>
  <version>2.41.0</version>
</dependency>

接続 URL の考慮事項

Spanner Omni はGoogle Cloud プロジェクトに直接接続されていないため、JDBC 接続 URL に projects/name コンポーネントは必要ありません。同様に、各 Spanner Omni デプロイには、すでに作成されている単一のインスタンス（instances/default）があるため、instances/name コンポーネントは省略可能です。

JDBC ドライバを Spanner ではなく Spanner Omni に接続するには、接続 URL に ;type=omni プロパティを追加します。

Spanner Omni 接続を確立する

次の例は、サポートされている各セキュリティ構成で Spanner JDBC ドライバを使用して Spanner Omni との接続を確立する方法を示しています。

String url = "jdbc:spanner://HOST_ADDRESS:PORT/databases/DATABASE_ID;usePlainText=true;type=omni";
try (java.sql.Connection connection = DriverManager.getConnection(url)) {
  try (ResultSet rs = connection.createStatement().executeQuery("SELECT * FROM Singers")) {
    while (rs.next()) {
      System.out.print(rs.getLong(1) + "\t");
      System.out.println(rs.getString(2));
    }
  }
} catch (Exception e) {
  System.out.println(e.getMessage());
}

String url = "jdbc:spanner://HOST_ADDRESS:PORT/databases/DATABASE_ID;type=omni";

String url = "jdbc:spanner://HOST_ADDRESS:PORT/databases/DATABASE_ID;type=omni;username=USERNAME;password=PASSWORD";

String url = "jdbc:spanner://HOST_ADDRESS:PORT/databases/DATABASE_ID;type=omni;clientCertificate=PATH_TO_CLIENT_CERT;clientKey=PATH_TO_CLIENT_KEY";