Copiar dados do Jira utilizando o Azure Data Factory ou Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a atividade de cópia nos pipelines do Azure Data Factory ou do Azure Synapse Analytics para copiar dados de uma tabela do Jira. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.

Funcionalidades com suporte

O conector Jira é compatível com as seguintes funcionalidades:

① Tempo de execução de integração do Azure ② Tempo de execução de integração auto-hospedado

Para obter uma lista de armazenamentos de dados com suporte como origens e coletores, confira a tabela Armazenamentos de dados com suporte.

O serviço fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse conector.

Introdução

Para executar a atividade de cópia com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

• Ferramenta de Cópia de Dados
• Portal do Azure
• SDK do .NET
• SDK do Python
• PowerShell do Azure
• REST API
• Modelo do Azure Resource Manager

Criar um serviço vinculado ao Jira usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao Jira na interface do usuário do portal do Azure.

1. Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse e selecione Serviços Vinculados. Depois, clique em Novo:

   • Fábrica de dados do Azure
   • Azure Synapse

   

2. Procure Jira e escolha o conector do Jira.

   

3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

   

Detalhes da configuração do conector

As seções a seguir fornecem detalhes sobre as propriedades usadas para definir entidades do Data Factory específicas ao conector do Jira.

Propriedades do serviço vinculado

O conector Jira agora dá suporte à versão 2.0. Consulte esta seção para atualizar a versão do seu conector Jira a partir da versão 1.0. Para obter detalhes sobre as propriedades, consulte as seções correspondentes.

• Versão 2.0
• versão 1.0

Versão 2.0

O serviço vinculado do Jira dá suporte às seguintes propriedades ao aplicar a versão 2.0:

Exemplo:

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

Versão 1.0

O serviço vinculado do Jira dá suporte às seguintes propriedades ao aplicar a versão 1.0:

Exemplo:

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

Propriedades do conjunto de dados

Para obter uma lista completa das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados de Jira.

Para copiar dados do Jira, defina a propriedade type do conjunto de dados como JiraObject. Há suporte para as seguintes propriedades:

Exemplo

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

O conector versão 2.0 dá suporte às seguintes tabelas Jira:

• AdvancedSettings
• TodosTiposDeProjetosAcessíveis
• AllApplicationRoles
• TodosOsGadgetsDisponíveisNoPainelDeControle
• AllDashboards
• AllFieldConfigurations
• AllFieldConfigurationSchemes
• AllIssueTypeSchemes
• AllLabels
• TodasAsPermissões
• AllPermissionSchemes
• TodasCategoriasDeProjetos
• TodasAsFunçõesDoProjeto
• AllProjectTypes
• TodosOsNíveisDeClassificaçãoDeDadosDoUsuário
• TodosOsUsuários
• AllUsersDefault
• Todos os Esquemas de Fluxo de Trabalho
• Propriedade da Aplicação
• ContagemAproximadaDeLicenças
• AttachmentMeta
• AutoComplete
• ImplementaçõesDeRastreamentoDeTempoDisponíveis
• Banner
• BulkGetGroups
• Configuração
• UsuárioAtual
• DashboardsPaginated
• DefaultEditor
• DefaultShareScope
• Eventos
• FavoriteFilters
• FieldAutoCompleteForQueryString
• Mapeamentos de Esquema de Configuração de Campo
• Campos
• FieldsPaginated
• FiltersPaginated
• EncontreComponentesParaProjetos
• EncontrarGrupos
• IdsOfWorklogsDeletedSince
• IdsOfWorklogsModifiedSince
• IssueAllTypes
• Relatório de Limite de Emissão
• IssueLinkTypes
• IssueNavigatorDefaultColumns
• IssuePickerResource
• IssueSecuritySchemes
• IssueTypeSchemesMapping
• IssueTypeScreenSchemeMappings
• EsquemasDeTelaPorTipoDeProblema
• Licença
• Localidade
• MyFilters
• Esquemas de Notificação
• EsquemaDeNotificaçãoParaMapeamentosDeProjeto
• Planos
• Esquemas de Prioridade
• Recente
• Telas
• ScreenSchemes
• Pesquisa
• SearchProjects
• PesquisarProjetosUsandoEsquemasDeSegurança
• SearchResolutions
• Esquemas de Segurança de Pesquisa
• SearchWorkflows
• SecurityLevelMembers
• Níveis de Segurança
• ImplementaçãoDeRastreamentoDeTempoSelecionada
• Informações do Servidor
• Configuração de Rastreamento de Tempo Compartilhado
• StatusCategories
• Status
• TrashedFieldsPaginated
• UserDefaultColumns

Propriedades da atividade de cópia

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista das propriedades com suporte pela fonte de Jira.

Jira como origem

Para copiar dados de Jira, defina o tipo de fonte na atividade de cópia como JiraSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:

Exemplo:

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

Mapeamento de tipo de dados para Jira

Quando você copia dados do Jira, os mapeamentos a seguir se aplicam dos tipos de dados do Jira aos tipos de dados internos usados pelo serviço. Para saber mais sobre como a atividade Copy mapeia o tipo de dados e esquema de origem para o coletor, consulte Mapeamentos de tipo de dados e esquema.

Pesquisar propriedades de atividade

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.

Ciclo de vida e atualização do conector do Jira

A tabela a seguir mostra o estágio de lançamento e os logs de alteração para versões diferentes do conector Jira:

Atualizar o conector Jira da versão 1.0 para a versão 2.0

1. Na página Editar serviço vinculado , selecione a versão 2.0 e configure o serviço vinculado referindo-se às propriedades do serviço vinculado versão 2.0.

2. O mapeamento de tipo de dados para o serviço vinculado Jira versão 2.0 é diferente do da versão 1.0. Para saber o mapeamento de tipo de dados mais recente, consulte o mapeamento de tipo de dados para Jira.

3. Se você usar o runtime de integração auto-hospedada, sua versão deverá ser 5.61 ou superior.

4. query só tem suporte na versão 1.0. Você deve usar schema e table em vez de query na versão 2.0.

Conteúdo relacionado

Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.