Configure o Openflow Connector for Jira Cloud¶

Pré-requisitos¶

1. Certifique-se de ter revisado Sobre a Openflow Connector for Jira Cloud.

2. Certifique-se de ter configurado um Openflow.

Obtenha as credenciais¶

Como administrador do Jira Cloud, execute as seguintes tarefas em sua conta Atlassian:

1. Navegue até a página de tokens da API.

2. Selecione Create API token with scopes.

3. Na caixa de diálogo Create an API token, forneça um nome descritivo ao token de API e selecione uma data de expiração para o token de API. Isso pode variar de 1 a 365 dias.

4. Selecione o aplicativo de token de API Jira.

5. Selecione os escopos do Jira read:jira-work e read:jira-user.

6. Selecione Create token.

7. Na caixa de diálogo Copy your API token, selecione Copy para copiar o token de API gerado e, em seguida, cole o token nos parâmetros do conector ou salve-o com segurança.

8. Selecione Close para fechar a caixa de diálogo.

Configure a conta Snowflake¶

Como administrador de conta Snowflake, execute as seguintes tarefas:

1. Crie uma nova função ou use uma função existente.

2. Crie um novo usuário de serviço Snowflake com o tipo SERVICE.

3. Conceda ao usuário do serviço Snowflake a função que você criou nas etapas anteriores.

4. Configure com a autenticação de pares de chaves para o usuário do Snowflake SERVICE da etapa 2.

5. A Snowflake recomenda enfaticamente essa etapa. Configure um gerenciador de segredos compatível com o Openflow, por exemplo, AWS, Azure e Hashicorp, e armazene as chaves públicas e privadas no armazenamento de segredos.

   Nota

   Se, por algum motivo, você não quiser usar um gerenciador de segredos, será responsável por proteger os arquivos de chave pública e chave privada usados para autenticação de pares de chaves de acordo com as políticas de segurança de sua organização.

   1. Depois que o gerenciador de segredos estiver configurado, determine como você se autenticará nele. No AWS, é recomendável que você use a função de instância EC2 associada ao Openflow, pois dessa forma nenhum outro segredo precisa ser mantido.

   2. No Openflow, configure um provedor de parâmetros associado a esse gerenciador de segredos, no menu de três traços no canto superior direito. Navegue até Controller Settings » Parameter Provider e, em seguida, busque os valores dos parâmetros.

   3. Nesse momento, todas as credenciais podem ser referenciadas com os caminhos de parâmetros associados e nenhum valor sensível precisa ser mantido no Openflow.

6. Se qualquer outro usuário Snowflake precisar de acesso aos documentos e tabelas brutos ingeridos pelo conector (por exemplo, para processamento personalizado no Snowflake), conceda a esses usuários a função criada na etapa 1.

7. Crie um banco de dados e um esquema no Snowflake para que o conector armazene os dados ingeridos. Conceda os seguintes Privilégios de banco de dados à função criada na primeira etapa.

   CREATE DATABASE jira_destination_db;
   CREATE SCHEMA jira_destination_db.jira_destination_schema;
   GRANT USAGE ON DATABASE jira_destination_db TO ROLE <jira_connector_role>;
   GRANT USAGE ON SCHEMA jira_destination_db.jira_destination_schema TO ROLE <jira_connector_role>;
   GRANT CREATE TABLE ON SCHEMA jira_destination_db.jira_destination_schema TO ROLE <jira_connector_role>;
   

   Copy

8. Crie um warehouse que será usado pelo conector ou use um já existente. Comece com o menor tamanho de warehouse e, em seguida, experimente o tamanho, dependendo do número de tabelas sendo replicadas e da quantidade de dados transferidos. Os números de tabelas grandes normalmente são mais bem dimensionados com warehouses multicluster, em vez de warehouses maiores.

9. Certifique-se de que o usuário com a função usada pelo conector tenha os privilégios necessários para usar o warehouse. Se esse não for o caso, conceda os privilégios necessários à função.

   CREATE WAREHOUSE jira_connector_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE jira_connector_warehouse TO ROLE <jira_connector_role>;
   

   Copy

Configuração do conector¶

Como engenheiro de dados, execute as seguintes tarefas para instalar e configurar o conector:

Execute o fluxo¶

1. Clique com o botão direito do mouse no plano e selecione Enable all Controller Services.

2. Clique com o botão direito do mouse no grupo de processos importado e selecione Start. O conector inicia a ingestão de dados.

Se você precisar alterar os critérios de consulta de emissão ou quiser reiniciar a ingestão do zero, execute as seguintes etapas para garantir que os dados na tabela de destino sejam consistentes:

1. Clique com o botão direito do mouse no processador FetchJiraIssues e pare-o.

2. Clique com o botão direito do mouse no processador FetchJiraIssues e selecione View State.

3. Na caixa de diálogo State, selecione Clear State. Essa ação limpa o estado do processador e permite que ele busque todos os problemas novamente.

4. Opcional: se quiser alterar os critérios de consulta de problemas, clique com o botão direito do mouse no grupo de processos importado e selecione Parameters. Atualize os parâmetros conforme necessário.

5. Opcional: se quiser alterar o nome da tabela de destino, clique com o botão direito do mouse no grupo de processos importado e selecione Parameters. Atualize o parâmetro Tabela de destino.

6. Clique com o botão direito do mouse no processador FetchJiraIssues e selecione Start. O conector inicia a ingestão de dados.