Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Before you start, your Jira administrator should grant you Administer Jira permissions to create, edit, watch, and export connectors.

Users with Administer Jira permissions always have access to SQL Connector for Jira.

Table of Contents

Before exporting data, we kindly recommend you to create a separate database for Jira data export and add its configurations to SQL Connector. Since it’s just a recommendation, feel free to export Jira data in a convenient way for you.

Info

You can use our comprehensive step-by-step guide to configure database you need.

Info

Read a comprehensive step-by-step guide on how to use SQL Connector for Jira in our blog ⬇️

https://www.alphaservesp.com/blog/how-to-export-data-from-jira-to-sql-complete-step-by-step-instructions

How to Add Database Configuration

  1. Being signed in to your Jira instance, select SQL Connector, and then select Databases.

  1. Select Add Database.

  1. In the Title* section, enter the title for your database.

  2. [Optional] In the Comment field, enter any useful information.

  3. In the Database Type* field, select the type of your database.

  4. In the Host* field, enter the host of your database.

  5. In the Port* field, enter the host of your database.

  6. In the Database Name*, enter the name of your database.

  7. [Optional] In the Database Schema*, enter the data schema.

Info

By leave the Database Schema* field empty, the default data schema will be applied.

  1. In the Username* field, enter your username.

  2. In the Password* field, enter your password.

  3. Select Test connection to check if everything is correct, and then select Create.

How to Create Data Source

  1. Being signed in to your Jira instance, select SQL Connector, and then select Data Sources.

  1. Select Create a Data Source.

Image RemovedSQL - Create data source.gifImage Added

  1. In the Name* field, enter your data source name.

  2. Select + to add database.

Info

If you have already created the database where you’d like to export your Jira data, simply select it from the drop-down list.

  1. In the Title* section, enter the title for your database.

  2. [Optional] In the Comment field, enter any useful information.

  3. In the Database Type* field, select the type of your database.

  4. In the Host* field, enter the host of your database.

  5. In the Port* field, enter the host of your database.

  6. In the Database Name*, enter the name of your database.

  7. [Optional] In the Database Schema*, enter the data schema.

Info

By leaving the Database Schema* field empty, the default data schema will be applied.

  1. In the Username* field, enter your username.

  2. In the Password* field, enter your password.

  3. Select Test connection to check if everything is correct.

If everything is correct, you will get the corresponding message.

Tip

Test connection success.

  1. Select Create.

  1. [Optional] In the Description field, enter the description for your data source.

Info

Enable auto-export to have your data source exported at the set time interval.

  1. Optional] Select Share settings.

  2. [Optional] In the Select users field, enter the username you want to share the data source with.

Info

Once you start typing, the drop-down list with username suggestions will appear. Select the user from the list.

  1. [Optional] In the Select group field, select the group you need.

Info

Once you select the Select group field, the drop-down list with available groups will appear. Select a group from the list.

  1. [Optional] In the Select project role field, select the roles you need.

Info

Once you select the Select project role field, the drop-down list with available project roles will appear. Select a role from the list.

  1. Select Save.

Note

Other users who have access to SQL Connector might not get all the data from this data source due to different Jira permissions.

You can also allow other users who have permissions to use SQL Connector to re-share the data source.

  1. Select all filters and fields you want to be in your data source, and then select Save.

You can select different filter groups:

  • All (by default) - will return all data, select it, if you want to export all existing issues.

  • JQL - Jira Query Language, is a flexible tool that allows you to search for issues, projects, etc. in Jira and pinpoint exactly what you are looking for. Select it, if you want to use JQL to create your own request and filter data.

  • Basic - select it, if you want to use standard fields filters; to set up Basic filter, select the Issue filter button.

Info

For a detailed description of all fields, filters, and buttons, refer to this article.

How to Export Data into SQL Database

Info

The newly-created data source has the NOT EXPORTED status and doesn’t have a progress bar in the Progress data export column.

Image RemovedSQL - Not Exported.gifImage Added

  • Select Export data.

Image RemovedSQL - Export data.gifImage Added

Info

The data source NOT EXPORTED status will be changed to LOADINGthe progress bar.

Image RemovedSQL - Progress bar.gifImage Added

Info

After the export is finished, the data source status will be set to EXPORTED, and the progress bar will appear.

Image RemovedSQL - Exported.gifImage Added

Tip

Now you can check that data was successfully exported to the database.