关于 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 实例中生成 API 令牌。此令牌将由连接器用于进行身份验证。同时支持含作用域（含 read:jira-work 和 read:jira-user 作用域）和不含作用域的令牌，但建议使用含作用域的令牌以实现更精细的访问控制。

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

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

    1. 安装连接器。

    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 处理器是单线程的，用于在主节点上运行。

  • 该连接器每个问题最多仅提取 20 个工作日志，因为 Jira Cloud REST API 不支持在单次请求中提取超过 20 个工作日志。

后续步骤

设置 Openflow Connector for Jira Cloud

语言: 中文