Documentation
搜索文档
karat

+

K

API 参考 ↗
数据连接与集成可用连接器Asana

注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

Asana

使用CData JDBC驱动程序将Foundry连接到Asana，以将数据导入Foundry数据集。

支持的功能

功能状态
探索🟢 普遍可用
批量导入🟢 普遍可用
增量🟢 普遍可用

数据模型

CData驱动程序将Asana数据建模为关系数据库中的表列表，可以使用标准SQL语句查询这些表。有关可用表及其内容的信息，请查阅CData文档中的Asana表 ↗。

设置

  1. 打开数据连接应用程序，并在屏幕右上角选择**+ 新来源**。
  2. 从可用的连接器类型中选择Asana。
  3. 选择使用互联网直接连接或通过中介代理连接。
  4. 按照以下部分中的信息继续连接器设置，遵循其他配置提示。

了解更多关于在Foundry中设置连接器的信息。

认证

Asana的认证通过个人或服务访问词元进行。

要生成服务帐户或个人访问词元，请按照Asana文档中的指南操作：

  • 服务帐户词元 ↗
    • 使用服务帐户词元创建持久和可靠的来源，不直接链接到单个用户。
  • 个人访问词元 ↗
    • 有些组织不允许用户创建访问词元。如果获取词元有问题，请联系您的Asana管理员。

网络

Asana连接器需要访问app.asana.com的443端口。如果您使用的是互联网直接连接，请确保存在出口策略。对于代理运行时，运行代理的服务器必须能够访问该域。

配置选项

以下配置选项适用于Asana连接器：

选项必需？描述
项目ID是在Asana中项目的URL中找到项目ID。例如：https://app.asana.com/0/PROJECT_ID/list
凭证设置是按照上面的认证指南进行配置。
代理设置否启用并输入用户名和密码，以允许代理连接到Asana。
日志否启用以控制连接器如何记录信息。查看下面的日志设置部分以获取更多详情。

日志设置

详细日志可能需要用来排除连接问题。使用详细程度级别设置来增加或减少记录的信息量。

增加日志详细程度可能会导致敏感信息保存到Foundry搭建日志中。在共享这些日志之前，请根据需要编辑任何密码。查看CData文档以了解更多关于不同详细程度级别 ↗的信息。

从Asana同步数据

要设置Asana同步，请在来源概述屏幕的右上角选择探索和创建同步。接下来，选择要同步到Foundry的表。当您准备同步时，选择为x数据集创建同步。

了解更多关于在Foundry中来源探索的信息。

配置Asana同步

Asana连接器允许高级同步配置，以确定将哪些数据导入Foundry。

在探索可用表并将其添加到连接后，导航到编辑同步。从左侧的同步面板中找到要配置的同步并选择右侧的**>**。

选项必需？描述
表是选择要从Asana复制到Foundry的表。查看数据模型以了解支持哪些表。
列选择否选择要同步到Foundry的列子集。查看下面的列选择部分以获取更多信息。
行筛选否启用并添加筛选以移除不符合其列值标准的行。查看下面的行筛选部分以获取更多信息。
限制否向基础查询添加SQL limit子句。此设置可用于限制单次运行中同步到Foundry的行数。
增量否启用以小批量同步数据到Foundry。查看下面的增量部分以获取更多信息。

增量

通常，同步会从目标表中导入所有匹配行，无论同步之间数据是否更改。相反，增量同步会维护最近同步的状态，并且仅摄取新的匹配行。

增量同步可用于从Asana摄取大表。要使用增量同步，表必须包含一个严格单调递增的列。此外，读取的表必须包含以下数据类型之一的列：

  • DATE
  • TIMESTAMP

数值列类型：

  • int
  • TINYINT
  • SMALLINT
  • INTEGER
  • long
  • BIGINT
  • NUMERIC
  • NUMBER
  • DECIMAL
  • DEC

字符串列类型：

  • string
  • VARCHAR
  • CHAR
  • NVARCHAR
  • NCHAR
  • LONGNVARCHAR
  • LONGVARCHAR

增量同步需要以下配置：

选项必需？描述
列是选择将用于增量摄取的列。如果表不包含任何支持的列类型，则下拉菜单将为空。
初始值是开始同步数据的值。

示例：一个5TB的表包含数十亿行，我们希望同步到Asana。该表具有一个单调递增的列，称为id。可以使用id列作为增量列，初始值为-1，并配置限制为每次摄取5000万行。

当初次运行同步时，将摄取包含id值大于-1的前5000万行（按id升序）。例如，如果此同步运行了几次，并且在上次运行期间摄取的最大id为19384004822，则下一次同步将从第一个id大于19384004822的下一组5000万行开始，依此类推。

列选择

选择要同步到Foundry的列。如果未选择任何列，则所有列将同步到Foundry。

所有列名必须以下划线或英文字母开头。名称只能包含下划线、英文字母或数字。

以下示例是有效的列名：

  • _colum_name
  • a_column_name_123

以下示例是无效的列名：

  • 1ColumnName; 以数字开头。
  • a-column-name*; 包含连字符和星号。
  • å-column-name; 包含非英语字符。

行筛选

可以添加筛选，以减少同步的行数或单独选择将要同步到Foundry的行。要配置行筛选，表的预览必须成功。在配置行筛选之前，建议使用界面底部的预览入站数据部分刷新预览。可以刷新预览以验证添加的筛选的行为。

筛选配置由一组条件组成，每行必须通过这些条件才能同步到Foundry。每组条件可以评估为所有条件匹配或至少一个条件匹配。这些条件集可以嵌套，以提供更精细的导入控制和高度的灵活性。这些相当于标准SQL中的AND和OR语句。

条件本身是Asana中表的列中的值与可以在界面中输入的值的简单比较。例如，条件CreatedAt等于12/04/2021将仅导入CreatedAt列中的值为12/04/2021的行。列的数据类型决定支持的比较操作。

比较操作

筛选中支持以下操作：

  • 等于
  • 大于
  • 小于
  • 大于或等于
  • 小于或等于
  • 不等于
  • 为空
  • 不为空

这些比较操作的行为相当于这些操作在标准SQL中的行为。

字符串类型列还支持Like和Not like操作符，使用标准SQL-92语法。