Sobre a Openflow Connector for Jira Cloud

Nota

O conector está sujeito aos termos do conector.

Este tópico descreve os conceitos básicos do Openflow Connector for Jira Cloud, seu fluxo de trabalho e suas limitações.

O Openflow Connector for Jira Cloud ingere dados de problemas do Atlassian Jira no Snowflake. Ele usa a Jira Cloud REST API e a Jira Query Language (JQL) para recuperar dados, que são armazenados em uma tabela Snowflake. A ingestão de dados ocorre em duas fases:

  1. Um carregamento inicial, em que todos os dados são recuperados durante a chamada inicial para API.

  2. Cargas incrementais, que mesclam atualizações e novos dados na tabela de destino e usam carimbos de data/hora de chamadas anteriores para limitar o resultado aos problemas que foram atualizados desde a última carga.

Use esse conector se quiser fazer o seguinte:

  • Extraia os itens do Jira e detalhes do projeto para obter visibilidade de toda a equipe e insights mais profundos

Fluxo de trabalho

  1. Um administrador Jira Cloud realiza as seguintes tarefas:

    1. Gera um token de API na instância do Jira com os escopos necessários (read:jira-work e read:jira-user). Esse token será usado pelo conector para autenticação.

    2. Define os critérios para pesquisar problemas, como nome do projeto, campo criado e campo atualizado.

  2. Um administrador de conta Snowflake executa as seguintes tarefas:

    1. Faz o download do arquivo de definição do conector e o importa para a tela do Snowflake Openflow.

    2. Configura o conector:

      1. Fornece o token da API Jira.

      2. Especifica a instância do URL Jira.

      3. Define os critérios para os problemas que estão sendo ingeridos, fornecendo a consulta JQL ou, em casos mais simples, apenas o nome do projeto.

      4. Define os nomes do banco de dados e do esquema na conta Snowflake.

    3. Executa o fluxo do conector na tela do Openflow. Após a execução, o conector realiza as seguintes ações:

      1. Cria uma chamada de API para buscar problemas na instância configurada do Jira.

      2. Extrai dados relevantes, como datas de criação de problemas, status e responsáveis.

      3. Cria a tabela de destino configurada no banco de dados do Snowflake se a chamada de API tiver retornado pelo menos um resultado.

      4. Carrega os dados processados na tabela Snowflake especificada.

  3. Os usuários Snowflake Business podem então acessar as exibições e realizar operações nos dados baixados do Jira Cloud para as tabelas de destino.

Limitações

  • Cada instância de conector pode ser associada a apenas uma consulta de pesquisa JQL.

  • Os carimbos de data/hora nas propriedades do conector refletem o fuso horário do Jira Cloud, o que pode resultar em discrepâncias com o fuso horário local do usuário. O fuso horário do Jira Cloud é obtido uma vez e mantido no estado do processador FetchJiraIssues. A atualização do fuso horário do conector requer a limpeza do estado desse processador.

  • O conector não consegue refletir as exclusões nas tabelas Snowflake de destino, pois a Jira Cloud REST API não retorna informações sobre a exclusão de dados.

  • A autenticação básica usando um e-mail e um token de API é o único método de autorização compatível. Como resultado, o conector só pode ingerir dados acessíveis pelo proprietário do token de API.

  • O processador FetchJiraIssues é de thread único e foi projetado para funcionar no nó primário.

Próximos passos

Configure o Openflow Connector for Jira Cloud