Ready to get started?

Download a free trial of the Google Sheets Driver to get started:

 Download Now

Learn more:

Google Sheets Icon Google Sheets JDBC Driver

Easily connect Java applications with real-time data from spreadsheets stored in Google Docs. Use Google Sheets to manage the data that powers your applications.

A PostgreSQL Interface for Google Sheets Data



Use the Remoting features of the Google Sheets JDBC Driver to create a PostgreSQL entry-point for data access.

There are a vast number of PostgreSQL clients available on the Internet. From standard Drivers to BI and Analytics tools, PostgreSQL is a popular interface for data access. Using our JDBC Drivers, you can now create PostgreSQL entry-points that you can connect to from any standard client.

To access Google Sheets data as a PostgreSQL database, use the CData JDBC Driver for Google Sheets and a JDBC foreign data wrapper (FDW). In this article, we compile the FDW, install it, and query Google Sheets data from PostgreSQL Server.

Connect to Google Sheets Data as a JDBC Data Source

To connect to Google Sheets as a JDBC data source, you will need the following:

  • Driver JAR path: The JAR is located in the lib subfolder of the installation directory.
  • Driver class: cdata.jdbc.googlesheets.GoogleSheetsDriver

  • JDBC URL: The URL must start with "jdbc:googlesheets:" and can include any of the connection properties in name-value pairs separated with semicolons.

    You can connect to a spreadsheet by providing authentication to Google and then setting the Spreadsheet connection property to the name or feed link of the spreadsheet. If you want to view a list of information about the spreadsheets in your Google Drive, execute a query to the Spreadsheets view after you authenticate.

    ClientLogin (username/password authentication) has been officially deprecated since April 20, 2012 and is now no longer available. Instead, use the OAuth 2.0 authentication standard. To access Google APIs on behalf on individual users, you can use the embedded credentials or you can register your own OAuth app.

    OAuth also enables you to use a service account to connect on behalf of users in a Google Apps domain. To authenticate with a service account, you will need to register an application to obtain the OAuth JWT values.

    See the Getting Started chapter in the help documentation to connect to Google Sheets from different types of accounts: Google accounts, Google Apps accounts, and accounts using two-step verification.

    Built-in Connection String Designer

    For assistance in constructing the JDBC URL, use the connection string designer built into the Google Sheets JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

    java -jar cdata.jdbc.googlesheets.jar

    Fill in the connection properties and copy the connection string to the clipboard.

    A typical JDBC URL is below:

    jdbc:googlesheets:Spreadsheet=MySheet;InitiateOAuth=GETANDREFRESH

Build the JDBC Foreign Data Wrapper

The Foreign Data Wrapper can be installed as an extension to PostgreSQL, without recompiling PostgreSQL. The jdbc2_fdw extension is used as an example (downloadable here).

  1. Add a symlink from the shared object for your version of the JRE to /usr/lib/libjvm.so. For example: ln -s /usr/lib/jvm/java-6-openjdk/jre/lib/amd64/server/libjvm.so /usr/lib/libjvm.so
  2. Start the build: make install USE_PGXS=1

Query Google Sheets Data as a PostgreSQL Database

After you have installed the extension, follow the steps below to start executing queries to Google Sheets data:

  1. Log into your database.
  2. Load the extension for the database: CREATE EXTENSION jdbc2_fdw;
  3. Create a server object for Google Sheets: CREATE SERVER GoogleSheets FOREIGN DATA WRAPPER jdbc2_fdw OPTIONS ( drivername 'cdata.jdbc.googlesheets.GoogleSheetsDriver', url 'jdbc:googlesheets:Spreadsheet=MySheet;InitiateOAuth=GETANDREFRESH', querytimeout '15', jarfile '/home/MyUser/CData/CData\ JDBC\ Driver\ for\ Salesforce MyDriverEdition/lib/cdata.jdbc.googlesheets.jar');
  4. Create a user mapping for the username and password of a user known to the MySQL daemon. CREATE USER MAPPING for postgres SERVER GoogleSheets OPTIONS ( username 'admin', password 'test');
  5. Create a foreign table in your local database: postgres=# CREATE FOREIGN TABLE orders ( orders_id text, orders_Shipcountry text, orders_OrderPrice numeric) SERVER GoogleSheets OPTIONS ( table_name 'orders');
You can now execute read/write commands to Google Sheets: postgres=# SELECT * FROM orders;