tree: dd560da13c85c26f84cf44068cea4268c09b7869 [path history] [tgz]
  1. scripts/
  2. src/
  3. connector.svg

Apache Geode JDBC Connector Example

The JDBC Connector allows Apache Geode to connect to external data sources with JDBC.

Apache Geode JDBC Connector


  1. Install MySQL:

If your MySQL installation does not include JDBC driver, download it from

  1. Start MySQL server with mysql.server start. Use mysql CLI to create database, table and populate the table:
create database geode_db;

use geode_db;

create table parent(id bigint, name varchar(100), income double);

insert into parent values (2, 'Parent_2', 987654321.0);
  1. Build this example's jar file jdbc.jar by running ../gradlew clean build.

The jar file jdbc.jar will be generated in build/libs directory.

  1. Add MySQL JDBC driver jar and jdbc.jar to CLASSPATH.


export CLASSPATH=/path/to/mysql-connector-java-8.0.15.jar:/path/to/geode-examples/jdbc/build/libs/jdbc.jar
  1. Start the Geode cluster with gfsh run --file=scripts/start.gfsh.

This will start the locator and two servers. And create Parent region, data source and JDBC mapping.

  1. Create data source and map the Apache Geode region and MySQL table.


create data-source --name=mysql_data_source --url="jdbc:mysql://localhost/geode_db?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC" --username=root --password="changeme"

create jdbc-mapping --data-source=mysql_data_source --region=Parent --table=parent --pdx-name=org.apache.geode_examples.jdbc.Parent --catalog=geode_db --id=id

  1. Run the example with ../gradlew run.

This will first put an entry with key 1 in Parent region. The entry will be propagated to MySQL's parent table in database geode_db. Then it will invoke a get with key 2. Since Parent region does not have an entry with key equals 2, it will trigger JDBC Connector to load the entry from parent table in database geode_db from MySQL.

You can also use gfsh to connect to cluster and run the following commands: list data-source describe data-source list jdbc-mapping describe jdbc-mapping destroy jdbc-mapping destroy data-source

And use mysql to query the parent table.

  1. Shutdown the cluster with gfsh run --file=scripts/stop.gfsh.