You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This article outlines how to use the Copy Activity in an Azure Data Factory or Synapse Analytics pipeline to copy data from Jira. It builds on the [copy activity overview](copy-activity-overview.md) article that presents a general overview of copy activity.
19
19
20
+
> [!IMPORTANT]
21
+
> The Jira connector version 2.0 provides improved native Jira support. If you are using Jira connector version 1.0 in your solution, please [upgrade the Jira connector](#upgrade-the-jira-connector-from-version-10-to-version-20) before **March 31, 2026**. Refer to this [section](#jira-connector-lifecycle-and-upgrade) for details on the difference between version 2.0 and version 1.0.
22
+
20
23
## Supported capabilities
21
24
22
25
This Jira connector is supported for the following capabilities:
@@ -65,7 +68,50 @@ The following sections provide details about properties that are used to define
65
68
66
69
## Linked service properties
67
70
68
-
The following properties are supported for Jira linked service:
71
+
The Jira connector now supports version 2.0. Refer to this [section](#jira-connector-lifecycle-and-upgrade) to upgrade your Jira connector version from version 1.0. For the property details, see the corresponding sections.
72
+
73
+
-[Version 2.0](#version-20)
74
+
-[Version 1.0](#version-10)
75
+
76
+
### Version 2.0
77
+
78
+
The Jira linked service supports the following properties when applying version 2.0:
79
+
80
+
| Property | Description | Required |
81
+
|:--- |:--- |:--- |
82
+
| type | The type property must be set to: **Jira**| Yes |
83
+
| version | The version that you specify. The value is `2.0`. | Yes |
84
+
| host | The IP address or host name of the Jira service. For example, `jira.example.com`. | Yes |
85
+
| port | The TCP port that the Jira server uses to listen for client connections. The default value is 443 if connecting through HTTPS, or 8080 if connecting through HTTP. | No |
86
+
| username | The user name that you use to access Jira Service. | Yes |
87
+
| password | The [Atlassian API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) (if two-step verification is enabled on the Atlassian account) or password corresponding to the user name that you provided in the username field. Mark this field as a SecureString to store it securely, or [reference a secret stored in Azure Key Vault](store-credentials-in-key-vault.md). | Yes |
88
+
| connectVia | The [integration runtime](concepts-integration-runtime.md) to be used to connect to the data store. If no value is specified, the property uses the default Azure integration runtime. You can use the self-hosted integration runtime and its version should be 5.61 or above. | No |
89
+
90
+
91
+
**Example:**
92
+
93
+
```json
94
+
{
95
+
"name": "JiraLinkedService",
96
+
"properties": {
97
+
"type": "Jira",
98
+
"version": "2.0",
99
+
"typeProperties": {
100
+
"host" : "<host>",
101
+
"port" : "<port>",
102
+
"username" : "<username>",
103
+
"password": {
104
+
"type": "SecureString",
105
+
"value": "<password>"
106
+
}
107
+
}
108
+
}
109
+
}
110
+
```
111
+
112
+
### Version 1.0
113
+
114
+
The Jira linked service supports the following properties when applying version 1.0:
69
115
70
116
| Property | Description | Required |
71
117
|:--- |:--- |:--- |
@@ -107,7 +153,9 @@ To copy data from Jira, set the type property of the dataset to **JiraObject**.
107
153
| Property | Description | Required |
108
154
|:--- |:--- |:--- |
109
155
| type | The type property of the dataset must be set to: **JiraObject**| Yes |
110
-
| tableName | Name of the table. | No (if "query" in activity source is specified) |
156
+
| schema | Name of the schema. This property is only supported in version 2.0. | Yes |
157
+
| table | Name of the table. This property is only supported in version 2.0. | Yes |
158
+
| tableName | Name of the table. This property is only supported in version 1.0.| No (if "query" in activity source is specified) |
111
159
112
160
**Example**
113
161
@@ -126,11 +174,89 @@ To copy data from Jira, set the type property of the dataset to **JiraObject**.
126
174
}
127
175
```
128
176
177
+
The connector version 2.0 supports the following Jira tables:
178
+
179
+
- AdvancedSettings
180
+
- AllAccessibleProjectTypes
181
+
- AllApplicationRoles
182
+
- AllAvailableDashboardGadgets
183
+
- AllDashboards
184
+
- AllFieldConfigurations
185
+
- AllFieldConfigurationSchemes
186
+
- AllIssueTypeSchemes
187
+
- AllLabels
188
+
- AllPermissions
189
+
- AllPermissionSchemes
190
+
- AllProjectCategories
191
+
- AllProjectRoles
192
+
- AllProjectTypes
193
+
- AllUserDataClassificationLevels
194
+
- AllUsers
195
+
- AllUsersDefault
196
+
- AllWorkflowSchemes
197
+
- ApplicationProperty
198
+
- ApproximateLicenseCount
199
+
- AttachmentMeta
200
+
- AutoComplete
201
+
- AvailableTimeTrackingImplementations
202
+
- Banner
203
+
- BulkGetGroups
204
+
- Configuration
205
+
- CurrentUser
206
+
- DashboardsPaginated
207
+
- DefaultEditor
208
+
- DefaultShareScope
209
+
- Events
210
+
- FavouriteFilters
211
+
- FieldAutoCompleteForQueryString
212
+
- FieldConfigurationSchemeMappings
213
+
- Fields
214
+
- FieldsPaginated
215
+
- FiltersPaginated
216
+
- FindComponentsForProjects
217
+
- FindGroups
218
+
- IdsOfWorklogsDeletedSince
219
+
- IdsOfWorklogsModifiedSince
220
+
- IssueAllTypes
221
+
- IssueLimitReport
222
+
- IssueLinkTypes
223
+
- IssueNavigatorDefaultColumns
224
+
- IssuePickerResource
225
+
- IssueSecuritySchemes
226
+
- IssueTypeSchemesMapping
227
+
- IssueTypeScreenSchemeMappings
228
+
- IssueTypeScreenSchemes
229
+
- License
230
+
- Locale
231
+
- MyFilters
232
+
- NotificationSchemes
233
+
- NotificationSchemeToProjectMappings
234
+
- Plans
235
+
- PrioritySchemes
236
+
- Recent
237
+
- Screens
238
+
- ScreenSchemes
239
+
- Search
240
+
- SearchProjects
241
+
- SearchProjectsUsingSecuritySchemes
242
+
- SearchResolutions
243
+
- SearchSecuritySchemes
244
+
- SearchWorkflows
245
+
- SecurityLevelMembers
246
+
- SecurityLevels
247
+
- SelectedTimeTrackingImplementation
248
+
- ServerInfo
249
+
- SharedTimeTrackingConfiguration
250
+
- StatusCategories
251
+
- Statuses
252
+
- TrashedFieldsPaginated
253
+
- UserDefaultColumns
254
+
129
255
## Copy activity properties
130
256
131
257
For a full list of sections and properties available for defining activities, see the [Pipelines](concepts-pipelines-activities.md) article. This section provides a list of properties supported by Jira source.
132
258
133
-
### JiraSource as source
259
+
### Jira as source
134
260
135
261
To copy data from Jira, set the source type in the copy activity to **JiraSource**. The following properties are supported in the copy activity **source** section:
136
262
@@ -139,6 +265,9 @@ To copy data from Jira, set the source type in the copy activity to **JiraSource
139
265
| type | The type property of the copy activity source must be set to: **JiraSource**| Yes |
140
266
| query | Use the custom SQL query to read data. For example: `"SELECT * FROM MyTable"`. | No (if "tableName" in dataset is specified) |
141
267
268
+
> [!NOTE]
269
+
> `query` is not supported in version 2.0.
270
+
142
271
**Example:**
143
272
144
273
```json
@@ -171,9 +300,44 @@ To copy data from Jira, set the source type in the copy activity to **JiraSource
171
300
]
172
301
```
173
302
303
+
## Data type mapping for Jira
304
+
305
+
When you copy data from Jira, the following mappings apply from Jira's data types to the internal data types used by the service. To learn about how the copy activity maps the source schema and data type to the sink, see [Schema and data type mappings](copy-activity-schema-and-type-mapping.md).
306
+
307
+
| Jira data type | Interim service data type (for version 2.0) | Interim service data type (for version 1.0) |
To learn details about the properties, check [Lookup activity](control-flow-lookup-activity.md).
177
319
320
+
## Jira connector lifecycle and upgrade
321
+
322
+
The following table shows the release stage and change logs for different versions of the Jira connector:
323
+
324
+
| Version | Release stage | Change log |
325
+
| :----------- | :------- |:------- |
326
+
| Version 1.0 | End of support announced | / |
327
+
| Version 2.0 | GA version available | • Support `schema` and `table` in Dataset. <br><br>• Support specific Jira tables. For the supported table list, go to [Dataset properties](#dataset-properties). <br><br>• The self-hosted integration runtime version should be 5.61 or above. <br><br>• The data type mapping for the Jira linked service version 2.0 is different from that for the version 1.0. For the latest data type mapping, go to [Data type mapping for Jira](#data-type-mapping-for-jira). <br><br>• `useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` are not supported in the linked service. <br><br> • `query` is not supported. <br><br> • OAuth 1.0 authentication is not supported. |
328
+
329
+
### Upgrade the Jira connector from version 1.0 to version 2.0
330
+
331
+
1. In **Edit linked service** page, select version 2.0 and configure the linked service by referring to [Linked service properties version 2.0](#version-20).
332
+
333
+
1. The data type mapping for the Jira linked service version 2.0 is different from that for the version 1.0. To learn the latest data type mapping, see [Data type mapping for Jira](#data-type-mapping-for-jira).
334
+
335
+
1. If you use the self-hosted integration runtime, its version should be 5.61 or above.
336
+
337
+
1.`query` is only supported in version 1.0. You should use `schema` and `table` instead of `query` in version 2.0.
338
+
339
+
> [!NOTE]
340
+
> Version 2.0 supports specific Jira tables. For the supported table list, go to [Dataset properties](#dataset-properties).
341
+
178
342
## Related content
179
343
For a list of data stores supported as sources and sinks by the copy activity, see [supported data stores](copy-activity-overview.md#supported-data-stores-and-formats).
0 commit comments