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:
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 na instância do Jira com os escopos necessários (
read:jira-work
eread:jira-user
). Esse token será usado pelo conector para autenticação.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:
Faz o download do arquivo de definição do conector e o importa para a tela do Snowflake Openflow.
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 único e foi projetado para funcionar no nó primário.