Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
S’APPLIQUE À :
Azure Data Factory
Azure Synapse Analytics
Conseil
Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !
Cet article explique comment utiliser l’activité de copie dans le pipeline Azure Data Factory ou Synapse Analytics pour copier des données de Jira. Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.
Important
Le connecteur Jira version 2.0 offre une prise en charge native améliorée de Jira. Si vous utilisez le connecteur Jira version 1.0 dans votre solution, mettez à niveau le connecteur Jira avant le 31 mars 2026. Pour plus de détails sur les différences entre la version 2.0 et la version 1.0, reportez-vous à cette section.
Fonctionnalités prises en charge
Ce connecteur Jira est pris en charge pour les capacités suivantes :
| Fonctionnalités prises en charge | IR |
|---|---|
| Activité de copie (source/-) | (1) (2) |
| Activité de recherche | (1) (2) |
① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé
Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs, consultez la table Magasins de données pris en charge.
La service fournit un pilote intégré qui permet la connexion. Vous n'avez donc pas besoin d'installer manuellement un pilote à l'aide de ce connecteur.
Bien démarrer
Pour effectuer l’activité Copy avec un pipeline, vous pouvez vous servir de l’un des outils ou kits SDK suivants :
- Outil Copier des données
- portail Azure
- Kit de développement logiciel (SDK) .NET
- Kit de développement logiciel (SDK) Python
- Azure PowerShell
- REST API
- Modèle Azure Resource Manager
Créer un service lié à Jira à l’aide de l’interface utilisateur
Utilisez les étapes suivantes pour créer un service lié à Jira dans l’interface utilisateur du portail Azure.
Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse, sélectionnez Services liés, puis cliquez sur Nouveau :
Recherchez Jira et sélectionnez le connecteur Jira.
Configurez les informations du service, testez la connexion et créez le nouveau service lié.
Détails de configuration du connecteur
Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory spécifiques du connecteur Jira.
Propriétés du service lié
Le connecteur Jira prend désormais en charge la version 2.0. Reportez-vous à cette section pour mettre à niveau votre version de connecteur Jira à partir de la version 1.0. Pour plus d’informations sur la propriété, consultez les sections correspondantes.
Version 2.0
Le service lié Jira prend en charge les propriétés suivantes lors de l’application de la version 2.0 :
| Propriété | Description | Obligatoire |
|---|---|---|
| type | La propriété type doit être définie sur : Jira | Oui |
| version | Version que vous spécifiez. La valeur est 2.0. |
Oui |
| host | Adresse IP ou nom d’hôte du serveur Jira Par exemple : jira.example.com. |
Oui |
| port | Port TCP utilisé par le serveur Jira pour écouter les connexions clientes. La valeur par défaut est 443 si vous vous connectez via HTTPS, ou 8080 via HTTP. | Non |
| nom d’utilisateur | Nom d’utilisateur utilisé pour accéder au service Jira. | Oui |
| mot de passe | Le jeton d’API Atlassian (si la vérification en deux étapes est activée sur le compte Atlassian) ou le mot de passe correspondant au nom d’utilisateur que vous avez fourni dans le champ de nom d’utilisateur. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault. | Oui |
| connectVia | Le runtime d’intégration à utiliser pour se connecter à la banque de données. Si aucune valeur n’est spécifiée, la propriété utilise le runtime d’intégration Azure par défaut. Vous pouvez utiliser le runtime d’intégration auto-hébergé et sa version doit être 5.61 ou ultérieure. | Non |
Exemple :
{
"name": "JiraLinkedService",
"properties": {
"type": "Jira",
"version": "2.0",
"typeProperties": {
"host" : "<host>",
"port" : "<port>",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
Version 1.0
Le service lié Jira prend en charge les propriétés suivantes lors de l’application de la version 1.0 :
| Propriété | Description | Obligatoire |
|---|---|---|
| type | La propriété type doit être définie sur : Jira | Oui |
| host | Adresse IP ou nom d’hôte du serveur Jira (par exemple, jira.exemple.com). | Oui |
| port | Port TCP utilisé par le serveur Jira pour écouter les connexions clientes. La valeur par défaut est 443 si vous vous connectez via HTTPS, ou 8080 via HTTP. | Non |
| nom d’utilisateur | Nom d’utilisateur utilisé pour accéder au service Jira. | Oui |
| mot de passe | Le jeton d’API Atlassian (si la vérification en deux étapes est activée sur le compte Atlassian) ou le mot de passe correspondant au nom d’utilisateur que vous avez fourni dans le champ de nom d’utilisateur. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault. | Oui |
| useEncryptedEndpoints | Indique si les points de terminaison de la source de données sont chiffrés suivant le protocole HTTPS. La valeur par défaut est true. | Non |
| useHostVerification | Indique si le nom d’hôte du certificat du serveur doit correspondre à celui du serveur en cas de connexion TLS. La valeur par défaut est true. | Non |
| usePeerVerification | Indique s’il faut vérifier l’identité du serveur en cas de connexion TLS. La valeur par défaut est true. | Non |
Exemple :
{
"name": "JiraLinkedService",
"properties": {
"type": "Jira",
"typeProperties": {
"host" : "<host>",
"port" : "<port>",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
Propriétés du jeu de données
Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données. Cette section fournit la liste des propriétés prises en charge par le jeu de données Jira.
Pour copier des données de Jira, affectez la valeur JiraObject à la propriété de type du jeu de données. Les propriétés prises en charge sont les suivantes :
| Propriété | Description | Obligatoire |
|---|---|---|
| type | La propriété type du jeu de données doit être définie sur : JiraObject | Oui |
| schéma | Nom du schéma. Cette propriété est uniquement prise en charge dans la version 2.0. | Oui |
| table | Nom de la table. Cette propriété est uniquement prise en charge dans la version 2.0. | Oui |
| tableName | Nom de la table. Cette propriété est uniquement prise en charge dans la version 1.0. | Non (si « query » dans la source de l’activité est spécifié) |
Exemple
{
"name": "JiraDataset",
"properties": {
"type": "JiraObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Jira linked service name>",
"type": "LinkedServiceReference"
}
}
}
Le connecteur version 2.0 prend en charge les tables Jira suivantes :
- AdvancedSettings
- AllAccessibleProjectTypes
- AllApplicationRoles
- TousLesGadgetsDisponiblesDuTableauDeBord
- AllDashboards
- AllFieldConfigurations
- AllFieldConfigurationSchemes
- AllIssueTypeSchemes
- AllLabels
- ToutesLesPermissions
- AllPermissionSchemes
- ToutesLesCatégoriesDeProjets
- TousLesRôlesDuProjet
- AllProjectTypes
- AllUserDataClassificationLevels
- TousLesUtilisateurs
- AllUsersDefault
- TousLesSchémasDeFluxDeTravail
- ApplicationProperty
- Nombre approximatif de licences
- AttachmentMeta
- AutoComplete
- ImplémentationsDisponiblesDeSuiviDuTemps
- Bannière
- BulkGetGroups
- Configuration
- CurrentUser
- DashboardsPaginated
- DefaultEditor
- DefaultShareScope
- Événements
- FavoriteFilters
- FieldAutoCompleteForQueryString
- FieldConfigurationSchemeMappings
- Champs
- FieldsPaginated
- FiltersPaginated
- TrouverComposantsPourProjets
- FindGroups
- IdentifiantsDesJournauxDeTravailSupprimésDepuis
- IdsOfWorklogsModifiedSince
- IssueAllTypes
- IssueLimitReport
- IssueLinkTypes
- IssueNavigatorDefaultColumns
- IssuePickerResource
- IssueSecuritySchemes
- IssueTypeSchemesMapping
- IssueTypeScreenSchemeMappings
- SchémasD'ÉcranParTypeDeProblème
- Licence
- Paramètres régionaux
- MyFilters
- Schémas de notification
- NotificationSchemeToProjectMappings
- Plans
- Schémas de Priorité
- Récent
- Écrans
- ScreenSchemes
- Search
- SearchProjects
- RechercheDeProjetsEnUtilisantDesSchemasDeSecurite
- RésolutionsDeRecherche
- SearchSecuritySchemes
- SearchWorkflows
- SecurityLevelMembers
- Niveaux de sécurité
- Implémentation de suivi du temps sélectionnée
- Informations du Serveur
- ConfigurationPartagéeDuSuiviDuTemps
- StatusCategories
- Statuses
- TrashedFieldsPaginated
- UserDefaultColumns
Propriétés de l’activité de copie
Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines. Cette section fournit la liste des propriétés prises en charge par la source Jira.
Jira en tant que source
Pour copier des données de Jira, définissez le type de source dans l’activité de copie sur JiraSource. Les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :
| Propriété | Description | Obligatoire |
|---|---|---|
| type | La propriété type de la source d’activité de copie doit être définie sur : JiraSource | Oui |
| query | Utiliser la requête SQL personnalisée pour lire les données. Par exemple : "SELECT * FROM MyTable". |
Non (si « tableName » est spécifié dans dataset) |
Note
query n’est pas pris en charge dans la version 2.0.
Exemple :
"activities":[
{
"name": "CopyFromJira",
"type": "Copy",
"inputs": [
{
"referenceName": "<Jira input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "JiraSource",
"query": "SELECT * FROM MyTable"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Mappage de type de données pour Jira
Lorsque vous copiez des données à partir de Jira, les mappages suivants s’appliquent des types de données de Jira aux types de données internes utilisés par le service. Pour découvrir comment l’activité de copie mappe le schéma et le type de données la source au récepteur, consultez Mappage de schéma dans l’activité de copie.
| Type de données Jira | Type de données de service intermédiaire (pour la version 2.0) | Type de données de service intermédiaire (pour la version 1.0) |
|---|---|---|
| ficelle | Chaîne | Varchar, Texte |
| entier | Nombre entier | Int, Bigint |
| datetime | String (Chaîne), DateTime (Date et heure) | DateTime, Timestamp |
| boolean | Booléen | Bit, Boolean |
| objet | Objet | Aplatir, Json |
| tableau | Array | Json, table séparée |
Propriétés de l’activité Lookup
Pour en savoir plus sur les propriétés, consultez Activité Lookup.
Cycle de vie et mise à niveau du connecteur Jira
Le tableau suivant présente l’étape de mise en production et les journaux des modifications pour différentes versions du connecteur Jira :
| Version | Phase de mise en production | Journal des modifications |
|---|---|---|
| Version 1.0 | Fin du support annoncé | / |
| Version 2.0 | Version en disponibilité générale disponible | • Prise en charge schema et table dans le jeu de données. • Prise en charge de tables Jira spécifiques Pour la liste de tables prise en charge, accédez aux propriétés du jeu de données. • La version du runtime d’intégration auto-hébergée doit être 5.61 ou ultérieure. • Le mappage de type de données pour le service lié Jira version 2.0 est différent de celui de la version 1.0. Pour obtenir le mappage de type de données le plus récent, accédez au mappage de type de données pour Jira. • useEncryptedEndpoints, useHostVerificationusePeerVerification ne sont pas pris en charge dans le service lié. • query n’est pas pris en charge. • L’authentification OAuth 1.0 n’est pas prise en charge. |
Mettre à niveau le connecteur Jira de la version 1.0 vers la version 2.0
Dans la page Modifier le service lié , sélectionnez la version 2.0 et configurez le service lié en faisant référence aux propriétés du service lié version 2.0.
Le mappage de type de données pour le service lié Jira version 2.0 est différent de celui de la version 1.0. Pour découvrir le mappage de type de données le plus récent, consultez Mappage de type de données pour Jira.
Si vous utilisez le runtime d’intégration auto-hébergé, sa version doit être 5.61 ou ultérieure.
queryest uniquement pris en charge dans la version 1.0. Vous devez utiliserschemaettableau lieu dequerydans la version 2.0.
Note
La version 2.0 prend en charge des tables Jira spécifiques. Pour la liste de tables prise en charge, accédez aux propriétés du jeu de données.
Contenu connexe
Pour obtenir une liste des magasins de données pris en charge comme sources et récepteurs par l’activité de copie, consultez la section sur les magasins de données pris en charge.