Copia de datos de Jira con Azure Data Factory o Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

En este artículo se explica cómo usar la actividad de copia en una canalización de Azure Data Factory o Synapse Analytics para copiar datos de Jira. El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.

Funcionalidades admitidas

El conector Jira es compatible para las siguientes funcionalidades:

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.

El servicio proporciona un controlador integrado para habilitar la conectividad. Por lo tanto, no es necesario instalar manualmente ningún controlador mediante este conector.

Introducción

Para realizar la actividad de copia con una canalización, puede usar una de las siguientes herramientas o SDK:

• Herramienta Copiar datos
• Azure Portal
• SDK de .NET
• SDK de Python
• Azure PowerShell
• REST API
• Plantilla de Azure Resource Manager

Creación de un servicio vinculado en Jira mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado en Jira en la interfaz de usuario de Azure Portal.

1. Vaya a la pestaña "Administrar" de su área de trabajo de Azure Data Factory o Synapse y seleccione "Servicios vinculados"; a continuación, haga clic en "Nuevo":

   • Azure Data Factory
   • Azure Synapse

   

2. Busque Jira y seleccione el conector de Jira.

   

3. Configure los detalles del servicio, pruebe la conexión y cree el servicio vinculado.

   

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas del conector de Jira.

Propiedades del servicio vinculado

El conector Jira ahora admite la versión 2.0. Consulte esta sección para actualizar la versión del conector jira desde la versión 1.0. Para obtener los detalles de la propiedad, consulte las secciones correspondientes.

• Versión 2.0
• Versión 1.0

Versión 2.0

El servicio vinculado Jira admite las siguientes propiedades al aplicar la versión 2.0:

Ejemplo:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "version": "2.0",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Versión 1.0

El servicio vinculado Jira admite las siguientes propiedades cuando se aplica la versión 1.0:

Ejemplo:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Propiedades del conjunto de datos

Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades compatibles con el conjunto de datos de Jira.

Para copiar datos de Jira, establezca la propiedad type del conjunto de datos en JiraObject. Se admiten las siguientes propiedades:

Ejemplo

{
    "name": "JiraDataset",
    "properties": {
        "type": "JiraObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Jira linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

La versión 2.0 del conector admite las siguientes tablas jira:

• AdvancedSettings
• AllAccessibleProjectTypes
• AllApplicationRoles
• TodosLosGadgetsDisponiblesDelTablero
• AllDashboards
• AllFieldConfigurations
• TodosLosEsquemasDeConfiguraciónDeCampos
• AllIssueTypeSchemes
• AllLabels
• AllPermissions
• TodosLosEsquemasDePermisos
• TodasLasCategoríasDeProyectos
• AllProjectRoles
• AllProjectTypes
• TodosLosNivelesDeClasificaciónDeDatosDeUsuario
• TodosLosUsuarios
• AllUsersDefault
• TodasLasEsquemasDeFlujoDeTrabajo
• Propiedad de la Aplicación
• CantidadAproximadaDeLicencias
• AttachmentMeta
• Autocompletar
• ImplementacionesDeSeguimientoDeTiempoDisponibles
• Bandera
• BulkGetGroups
• Configuration
• CurrentUser
• DashboardsPaginated
• EditorPredeterminado
• DefaultShareScope
• Eventos
• FavoriteFilters
• FieldAutoCompleteForQueryString
• FieldConfigurationSchemeMappings
• Campos
• FieldsPaginated
• FiltersPaginated
• BuscarComponentesParaProyectos
• Buscar Grupos
• IdsOfWorklogsDeletedSince
• IdsOfWorklogsModifiedSince
• EmitirTodosLosTipos
• Informe de Límite de Incidencias
• IssueLinkTypes
• IssueNavigatorDefaultColumns
• IssuePickerResource
• IssueSecuritySchemes
• IssueTypeSchemesMapping
• IssueTypeScreenSchemeMappings
• EsquemasDePantallaPorTipoDeIncidente
• Licencia
• Localidad
• MyFilters
• Esquemas de Notificación
• NotificationSchemeToProjectMappings
• Planes
• EsquemasDePrioridad
• Reciente
• Pantallas
• ScreenSchemes
• Search
• SearchProjects
• BuscarProyectosUsandoEsquemasDeSeguridad
• SearchResolutions
• SearchSecuritySchemes
• SearchWorkflows
• SecurityLevelMembers
• Niveles de Seguridad
• Implementación de Seguimiento de Tiempo Seleccionado
• Información del Servidor
• Configuración de Seguimiento de Tiempo Compartido
• StatusCategories
• Estados
• TrashedFieldsPaginated
• ColumnasPredeterminadasDelUsuario

Propiedades de la actividad de copia

Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades compatibles con el origen de Jira.

Jira como fuente

Para copiar datos de Jira, establezca el tipo de origen de la actividad de copia en JiraSource. Se admiten las siguientes propiedades en la sección source de la actividad de copia:

Ejemplo:

"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>"
            }
        }
    }
]

Asignación de tipos de datos para Jira

Al copiar datos de Jira, los siguientes mapeos se aplican desde los tipos de datos de Jira a los tipos de datos internos usados por el servicio. Para más información acerca de la forma en que la actividad de copia asigna el tipo de datos y el esquema de origen al receptor, consulte el artículo sobre asignaciones de tipos de datos y esquema.

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Ciclo de vida y actualización del conector jira

En la tabla siguiente se muestran la fase de lanzamiento y los registros de cambios para diferentes versiones del conector jira:

Actualización del conector jira de la versión 1.0 a la versión 2.0

1. En la página Editar servicio vinculado , seleccione la versión 2.0 y configure el servicio vinculado haciendo referencia a las propiedades del servicio vinculado versión 2.0.

2. La asignación de tipos de datos para la versión 2.0 del servicio vinculado de Jira es diferente de la de la versión 1.0. Para obtener información sobre la asignación de tipos de datos más reciente, consulte Asignación de tipos de datos para Jira.

3. Si usa el entorno de ejecución de integración autohospedado, su versión debe ser 5.61 o superior.

4. query solo se admite en la versión 1.0. Debe usar schema y table en lugar de query en la versión 2.0.

Contenido relacionado

Para obtener una lista de los almacenes de datos que admite la actividad de copia como orígenes y receptores, consulte Almacenes de datos compatibles.