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 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:
Um carregamento inicial, em que todos os dados são recuperados durante a chamada inicial para API.
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¶
Um administrador Jira Cloud realiza as seguintes tarefas:
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
eread:jira-user
) e sem escopos são aceitos, embora tokens com escopos sejam recomendados para um melhor controle de acesso refinado.Define os critérios para pesquisar problemas, como nome do projeto, campo criado e campo atualizado.
Um administrador de conta Snowflake executa as seguintes tarefas:
Instala o conector.
Configura o conector:
Fornece o token da API Jira.
Especifica a instância do URL Jira.
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.
Define os nomes do banco de dados e do esquema na conta Snowflake.
Executa o fluxo do conector na tela do Openflow. Após a execução, o conector realiza as seguintes ações:
Cria uma chamada de API para buscar problemas na instância configurada do Jira.
Extrai dados relevantes, como datas de criação de problemas, status e responsáveis.
Cria a tabela de destino configurada no banco de dados do Snowflake se a chamada de API tiver retornado pelo menos um resultado.
Carrega os dados processados na tabela Snowflake especificada.
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.
O conector busca apenas até 20 logs de trabalho por problema, pois a API REST do Jira Cloud não oferece suporte à busca de mais de 20 logs de trabalho em uma única solicitação.