VOOZH about

URL: https://www.cdata.com/kb/tech/jira-jdbc-postgresql-fdw-mysql.rst

⇱ A PostgreSQL Interface for Jira Data (MySQL Remoting via JDBC)

A PostgreSQL Interface for Jira Data (MySQL Remoting via JDBC)

👁 Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Use the Remoting features of the Jira 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 the remoting features of our JDBC Drivers, you can now create PostgreSQL entry-points that you can connect to from any standard client.

To access Jira data as a PostgreSQL database, use the Remoting feature of the CData JDBC Driver for Jira and the MySQL foreign data wrapper (FDW) from EnterpriseDB. In this article, we install the FDW and query Jira data from PostgreSQL Server.

About Jira Data Integration

CData simplifies access and integration of live Jira data. Our customers leverage CData connectivity to:

  • Gain bi-directional access to their Jira objects like issues, projects, and workflows.
  • Use SQL stored procedures to perform functional actions like changing issues status, creating custom fields, download or uploading an attachment, modifying or retrieving time tracking settings, and more.
  • Authenticate securely using a variety of methods, including username and password, OAuth, personal access token, API token, Crowd or OKTA SSO, LDAP, and more.

Most users leverage CData solutions to integrate Jira data with their database or data warehouse, whether that's using CData Sync directly or relying on CData's compatibility with platforms like SSIS or Azure Data Factory. Others are looking to get analytics and reporting on live Jira data from preferred analytics tools like Tableau and Power BI.

Learn more about how customers are seamlessly connecting to their Jira data to solve business problems from our blog: Drivers in Focus: Collaboration Tools.


Getting Started


Configure the Connection to Jira

Follow the steps below to configure the driver's MySQL daemon to use the credentials and other connection properties needed to connect to Jira. The MySQL daemon exposes Jira data as a MySQL database named CDataJIRA. Add connection properties to the databases section of the configuration file for the daemon. The configuration file for the daemon is located in the lib subfolder of the installation directory for the driver.

Below is a typical connection string: 

[databases]
jira = "User=admin;Password=123abc;Url=https://yoursitename.atlassian.net;"

Additionally, create a user in the users section.

You can find all of the configuration options for the MySQL daemon in the help documentation.

Start the Remoting Service

Follow the steps below to enable the MySQL Remoting feature of the CData JDBC Driver for Jira.

  1. The driver creates a default configuration suitable for testing: Simply start the service to connect to Jira data.

  2. Start the MySQL Remoting Service with the following command: 
    java -jar cdata.jdbc.jira.jar -f cdata.jdbc.jira.remoting.ini

Build and Install the MySQL Foreign Data Wrapper

The Foreign Data Wrapper can be installed as an extension to PostgreSQL, without recompiling PostgreSQL.

If pgxn is available for your operating system, you can install with the following: 

pgxn install mysql_fdw USE_PGXS=1

Otherwise, follow the steps below to build it yourself:

  1. Install the MySQL C client library and obtain the source for the EnterpriseDB FDW for MySQL; from GitHub, for example.
  2. Build the FDW. Add the pg_config and mysql_config executables to your PATH: 
    env PATH=/usr/local/pgsql/bin:/usr/local/mysql/bin:$PATH make USE_PGXS=1
  3. Install the FDW: 
    make USE_PGXS=1 install

To complete the installation, you will need to load the libmysqlclient library into the environment; for example by adding it to the path.

Query Jira Data as a PostgreSQL Database

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

  1. Log into your database.
  2. Load the extension for the database: 
    postgres=#CREATE EXTENSION mysql_fdw;
  3. Create a server object for Jira data: 
    postgres=# CREATE SERVER JIRA FOREIGN DATA WRAPPER mysql_fdw OPTIONS (host
'127.0.0.1', port '3309');
  4. Create a user mapping for the username and password of a user known to the MySQL daemon. 
    postgres=# CREATE USER MAPPING for postgres SERVER JIRA OPTIONS (username
'admin', password 'test');
  5. Create the local schema: 
    postgres=# CREATE SCHEMA JIRA_db;
  6. Import all the tables in the Jira database you defined in the daemon configuration file: 
    postgres=# IMPORT FOREIGN SCHEMA "JIRA" FROM SERVER JIRA INTO JIRA_db;

You can now execute SELECT commands to Jira: 

postgres=# SELECT * FROM JIRA_db."issues";