Sobre a Openflow Connector for Jira Cloud

Nota

This connector is subject to the Snowflake Connector Terms.

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 para o Snowflake. Ele usa a API REST do Jira Cloud e a Jira Query Language (JQL) para recuperar dados, que são armazenados em uma tabela do Snowflake e podem ser acessados ​ ​por meio de uma exibição. 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 dentro da instância do Jira. Esse token será usado pelo conector para autenticação. Tokens com escopos (com escopos read:jira-work e read:jira-user) e sem escopos são aceitos, embora tokens com escopos sejam recomendados para um melhor controle de acesso refinado.

    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. Instala o conector.

    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 única e projetado para funcionar no nó primário.

Próximos passos

Configure o Openflow Connector for Jira Cloud

Linguagem: Português