关于 Openflow Connector for Jira Cloud

备注

使用该连接器需遵守 连接器条款。

本主题介绍 Openflow Connector for Jira Cloud 的基本概念、工作流程和限制。

Openflow Connector for Jira Cloud 将 Atlassian Jira 问题数据引入 Snowflake。它使用 Jira Cloud REST API (https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#about) 和 Jira 查询语言 (JQL) (https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/) 来检索数据，然后将其存储在 Snowflake 表中。数据引入分为两个阶段：

  1. 初始加载，在初始 API 调用期间检索所有数据。

  2. 增量加载，将更新内容和新数据合并到目标表中，并使用先前调用中的时间戳将结果限制为自上次加载以来更新的问题。

如果您希望实现以下功能，可以使用此连接器：

  • 提取 Jira 问题和项目详细信息，以获得跨团队可见性和更深入的洞察

工作流程

  1. Jira Cloud 管理员 执行以下任务：

    1. 在 Jira 实例内生成具有必要范围（read:jira-work 和 read:jira-user）的 API 令牌。连接器将使用此令牌进行身份验证。

    2. 定义搜索问题的标准，例如项目名称、创建的字段和更新的字段。

  2. Snowflake 账户管理员 执行以下任务：

    1. 下载连接器定义文件并将其导入到 Snowflake Openflow 画布中。

    2. 配置连接器：

      1. 提供 Jira API 令牌。

      2. 指定 Jira 实例 URL。

      3. 通过提供 JQL 查询，或者在更简单的情况下仅提供项目名称，来定义要引入的问题的标准。

      4. 在 Snowflake 账户中设置数据库和架构名称。

    3. 在 Openflow 画布中运行连接器流。执行后，连接器将执行以下操作：

      1. 创建 API 调用，从配置的 Jira 实例中提取问题。

      2. 提取相关数据，例如问题创建日期、状态和被分配者。

      3. 如果 API 调用返回至少一个结果，则在 Snowflake 数据库中创建已配置的目标表。

      4. 将处理后的数据加载到指定的 Snowflake 表中。

  3. Snowflake Business 用户 随后可以访问视图，并对从 Jira Cloud 下载到目标表的数据执行操作。

限制

  • 每个连接器实例只能与一个 JQL 搜索查询相关联。

  • 连接器属性中的时间戳反映了 Jira Cloud 的时区，这可能会导致与用户的本地时区不一致。Jira Cloud 时区仅提取一次，并保存在 FetchJiraIssues 处理器的状态中。更新连接器的时区需要清除该处理器的状态。

  • 由于 Jira Cloud REST API 不返回有关数据删除的信息，因此连接器无法反映目标 Snowflake 表中的删除情况。

  • 使用电子邮件和 API 令牌进行基本身份验证是唯一受支持的授权方法。因此，连接器只能引入 API 令牌所有者可以访问的数据。

  • FetchJiraIssues 处理器是单线程的，旨在主节点上运行。

后续步骤

设置 Openflow Connector for Jira Cloud

语言: 中文