JDBC mit einer Datenbank im PostgreSQL-Dialekt verbinden

Sie können sowohl den PostgreSQL-JDBC-Treiber als auch den Spanner-JDBC-Treiber verwenden. mit einer PostgreSQL-Dialektdatenbank von Spanner erstellen. Auf dieser Seite wird erläutert, wie Sie mit einem dieser Treiber in Ihre Datenbank hochladen.

PostgreSQL-JDBC-Treiber

In diesem Abschnitt wird erläutert, wie Sie den PostgreSQL-JDBC-Treiber mit einer PostgreSQL-Dialect-Datenbank verbinden in Spanner erstellen. JDBC ist der Standard-Java-Treiber für PostgreSQL.

Wenn Sie den PostgreSQL-JDBC-Treiber nutzen möchten, müssen Sie PGAdapter verwenden, die Übersetzung zwischen dem PostgreSQL-Netzwerkprotokoll Spanner-Netzwerkprotokoll. Sie können PGAdapter als Abhängigkeit hinzufügen und es als Verarbeitungsprozess mit Ihrer Anwendung ausführen.

1. Fügen Sie Ihrer Anwendung PGAdapter und den PostgreSQL-JDBC-Treiber als Abhängigkeiten hinzu.

<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>0.39.0</version>
</dependency>
<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-pgadapter</artifactId>
  <version>0.39.0</version>
</dependency>

2. Starten Sie PGAdapter während der Verarbeitung mit Ihrer Anwendung.

OptionsMetadata.Builder builder =
    OptionsMetadata.newBuilder()
        .setProject("my-project")
        .setInstance("my-instance")
        // Set the port to 0 to use a dynamically assigned port.
        .setPort(5432);
ProxyServer server = new ProxyServer(builder.build());
server.startServer();
server.awaitRunning();
      

3. Geben Sie localhost und 5432 als Datenbankserver-Host und Port in der JDBC-Verbindungsstring.

// Make sure the PG JDBC driver is loaded.
Class.forName("org.postgresql.Driver");

// Replace localhost and 5432 with the host and port number where PGAdapter is running.
try (Connection connection =
    DriverManager.getConnection("jdbc:postgresql://localhost:5432/my-database")) {
  try (ResultSet resultSet =
      connection.createStatement().executeQuery("select 'Hello world!' as hello")) {
    while (resultSet.next()) {
      System.out.printf(
        "Greeting from Cloud Spanner PostgreSQL: %s\n", resultSet.getString(1));
    }
  }
}
      

Das GitHub-Repository von PGAdapter enthält ein funktionierende Beispielanwendung.

Spanner-JDBC-Treiber

In diesem Abschnitt wird erläutert, wie Sie mit dem JDBC-Treiber von Spanner eine Verbindung herstellen. Datenbankdatenbank mit PostgreSQL-Dialectoren.

1. Fügen Sie den Spanner-JDBC-Treiber als Abhängigkeit zu Ihrer Anwendung hinzu.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.48.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-jdbc</artifactId>
    <exclusions>
      <exclusion>
        <groupId>com.google.api.grpc</groupId>
        <artifactId>proto-google-cloud-spanner-executor-v1</artifactId>
      </exclusion>
    </exclusions>
  </dependency>

2. Verwenden Sie eine JDBC-Verbindungs-URL von Spanner, um eine Verbindung zur PostgreSQL-Dialect-Datenbank herzustellen.

try (Connection connection = DriverManager.getConnection(
    "jdbc:cloudspanner:/projects/my-project/instances/my-instance/databases/my-database")) {
  try (ResultSet resultSet =
      connection.createStatement().executeQuery("select 'Hello world!' as hello")) {
    while (resultSet.next()) {
      System.out.printf(
        "Greeting from Cloud Spanner PostgreSQL: %s\n", resultSet.getString(1));
    }
  }
}
        

Der Treiber erkennt automatisch den SQL-Dialekt der angegebenen Datenbank. Ein Dialektparameter in der Verbindungs-URL ist nicht erforderlich.

Nächste Schritte