Connecter JDBC à une base de données en dialecte PostgreSQL

Vous pouvez utiliser le pilote JDBC PostgreSQL ou le pilote JDBC Spanner avec une base de données Spanner utilisant le dialecte PostgreSQL. Cette page explique comment vous connecter à votre base de données avec ces pilotes.

Pilote JDBC PostgreSQL

Cette section explique comment connecter le pilote JDBC PostgreSQL à une base de données avec dialecte PostgreSQL dans Spanner. JDBC est le pilote Java standard pour PostgreSQL.

Si vous utilisez le pilote PostgreSQL JDBC, vous devez utiliser PGAdapter pour traduire entre le protocole réseau PostgreSQL et le protocole réseau Spanner. Vous pouvez ajouter PGAdapter en tant que dépendance et l'exécuter en cours de traitement avec votre application.

  1. Ajoutez PGAdapter et le pilote JDBC PostgreSQL en tant que dépendances à votre application. 

    <dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>0.50.2</version>
</dependency>
<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-pgadapter</artifactId>
  <version>0.50.2</version>
</dependency>
  2. Démarrez PGAdapter en cours de traitement avec votre application. 
    OptionsMetadata.Builder builder =
  OptionsMetadata.newBuilder()
    .setProject("PROJECT_NAME")
    .setInstance("INSTANCE_NAME")
    .setPort(PORT);
ProxyServer server = new ProxyServer(builder.build());
server.startServer();
server.awaitRunning();

    Remplacez les éléments suivants :

    • PORT : numéro de port sur lequel PGAdapter est en cours d'exécution. Définissez la valeur sur 5432 dans la plupart des cas ou sur 0 pour utiliser un port attribué de manière dynamique.
  3. Assurez-vous que le pilote JDBC PostgreSQL est chargé. 
    Class.forName("org.postgresql.Driver");
    
try (Connection connection =
    DriverManager.getConnection("jdbc:postgresql://APPLICATION_HOST:PORT/DATABASE_NAME")) {
  try (ResultSet resultSet =
      connection.createStatement().executeQuery("select 'Hello world!' as hello")) {
    while (resultSet.next()) {
      System.out.printf(
        "Greetings from Cloud Spanner PostgreSQL: %s\n", resultSet.getString(1));
      }
    }
  }

    Remplacez les éléments suivants :

    • APPLICATION_HOST : nom d'hôte ou adresse IP de la machine sur laquelle PGAdapter est exécuté. Si vous exécutez le code en local, utilisez localhost.

    Le dépôt GitHub PGAdapter contient un exemple d'application.

Sockets de domaine Unix

Cette section explique comment utiliser les sockets de domaine Unix pour connecter le pilote JDBC PostgreSQL à une base de données de dialecte PostgreSQL. Utilisez des sockets de domaine Unix pour obtenir la latence la plus faible possible.

Pour utiliser des sockets de domaine Unix, PGAdapter doit être exécuté sur le même hôte que l'application cliente.

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

try (Connection connection = DriverManager.getConnection("jdbc:postgresql://APPLICATION_HOST/DATABASE_NAME"
    + "?socketFactory=org.newsclub.net.unix.AFUNIXSocketFactory$FactoryArg"
    + "&socketFactoryArg=DIRECTORY_NAME.s.PGSQL.PORT")) {
  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));
      }
    }
  }

Remplacez les éléments suivants :

  • APPLICATION_HOST : nom d'hôte ou adresse IP de la machine sur laquelle PGAdapter est exécuté. Si vous exécutez le code en local, utilisez localhost.
    • argument de ligne de commande. Par exemple, /tmp.
  • PORT : numéro de port sur lequel PGAdapter est exécuté. Modifiez cette valeur dans la chaîne de connexion si PGAdapter s'exécute sur un port personnalisé. Sinon, utilisez le port par défaut, 5432.

Pilote JDBC Spanner

Cette section explique comment utiliser le pilote JDBC Spanner pour se connecter à une base de données avec le dialecte PostgreSQL.

  1. Ajoutez le pilote JDBC Spanner en tant que dépendance à votre application. 

    <dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.67.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. Utilisez une URL de connexion JDBC Spanner pour vous connecter à la base de données avec dialecte PostgreSQL. 

        // Make sure the PostgreSQL JDBC driver is loaded.
    Class.forName("org.postgresql.Driver");
    
    try (Connection connection = DriverManager.getConnection(
        "jdbc:cloudspanner:/projects/PROJECT_NAME/instances/INSTANCE_NAME/databases/DATABASE_NAME")) {
      try (ResultSet resultSet =
          connection.createStatement().executeQuery("select 'Hello world!' as hello")) {
        while (resultSet.next()) {
          System.out.printf(
            "Greetings from Cloud Spanner PostgreSQL: %s\n", resultSet.getString(1));
        }
      }
    }

    Le pilote détecte automatiquement le dialecte SQL de la base de données spécifiée. Un paramètre de dialecte n'est pas requis dans l'URL de connexion.

Étapes suivantes