# 从 Intercom 实体中读取
<a name="intercom-reading-from-entities"></a>

 **先决条件** 
+  您要从中读取内容的 Intercom 对象。请参阅下方支持的实体表，查看可用的实体。

 **支持的实体** 


| 实体 | API\$1Version | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \$1 | 支持分区 | 
| --- | --- | --- | --- | --- | --- | --- | 
| Admins | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 公司 | v2.5 | 否 | 是 | 否 | 是 | 否 | 
| 对话 | v2.5 | 支持 | 是 | 是 | 是 | 是 | 
| 数据属性 | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 联系人 | v2.5 | 支持 | 是 | 是 | 是 | 是 | 
| Segments | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 标签 | v2.5 | 否 | 否 | 否 | 是 | 否 | 
| 团队 | v2.5 | 否 | 否 | 否 | 是 | 否 | 

 **示例** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "V2.5"
    }
)
```

 **Intercom 实体和字段详细信息** 


| 实体 | 字段 | 数据类型 | 支持的运算符 | 
| --- | --- | --- | --- | 
| Admins | type | 字符串 | NA | 
| Admins | id | 字符串 | NA | 
| Admins | avatar | 结构体 | NA | 
| Admins | 名称 | 字符串 | NA | 
| Admins | 电子邮件 | 字符串 | NA | 
| Admins | away\$1mode\$1enabled | 布尔值 | NA | 
| Admins | away\$1mode\$1reassign | 布尔值 | NA | 
| Admins | has\$1inbox\$1seat | 布尔值 | NA | 
| Admins | teams\$1ids | 列表 | NA | 
| Admins | job\$1title | 字符串 | NA | 
| 公司 | type | 字符串 | NA | 
| 公司 | id | 字符串 | NA | 
| 公司 | app\$1id | 字符串 | NA | 
| 公司 | created\$1at | 日期时间 | NA | 
| 公司 | remote\$1created\$1at | 日期时间 | NA | 
| 公司 | updated\$1at | 日期时间 | NA | 
| 公司 | last\$1request\$1at | 日期时间 | NA | 
| 公司 | 计划 | 结构体 | NA | 
| 公司 | company\$1id | 字符串 | NA | 
| 公司 | 名称 | 字符串 | NA | 
| 公司 | custom\$1attributes | 结构体 | NA | 
| 公司 | session\$1count | 整数 | NA | 
| 公司 | monthly\$1spend | 整数 | NA | 
| 公司 | user\$1count | 整数 | NA | 
| 公司 | industry | 字符串 | NA | 
| 公司 | size | 整数 | NA | 
| 公司 | 网站 | 字符串 | NA | 
| 公司 | tags | 结构体 | NA | 
| 公司 | segments | 结构体 | NA | 
| 联系人 | id | 字符串 | EQUAL\$1TO.NOT\$1EQUAL\$1TO | 
| 联系人 | type | 字符串 | NA | 
| 联系人 | workspace\$1id | 字符串 | NA | 
| 联系人 | external\$1id | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | 角色 | 字符串 | EQUAL\$1TO.NOT\$1EQUAL\$1TO | 
| 联系人 | 电子邮件 | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | phone | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | 名称 | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | avatar | 字符串 | NA | 
| 联系人 | owner\$1id | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | social\$1profiles | 结构体 | NA | 
| 联系人 | has\$1hard\$1bounced | 布尔值 | EQUAL\$1TO | 
| 联系人 | marked\$1email\$1as\$1spam | 布尔值 | EQUAL\$1TO | 
| 联系人 | unsubscribed\$1from\$1emails | 布尔值 | EQUAL\$1TO | 
| 联系人 | created\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | updated\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | signed\$1up\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | last\$1seen\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | last\$1replied\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | last\$1contacted\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | last\$1email\$1opened\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | last\$1email\$1clicked\$1at | 日期时间 | EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 联系人 | language\$1override | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | 浏览器 | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | browser\$1version | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | browser\$1language | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | os | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | location | 结构体 | NA | 
| 联系人 | location\$1country | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | location\$1region | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | location\$1city | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | android\$1app\$1name | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | android\$1app\$1version | 字符串 | NA | 
| 联系人 | android\$1device | 字符串 | NA | 
| 联系人 | android\$1os\$1version | 字符串 | NA | 
| 联系人 | android\$1sdk\$1version | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | android\$1last\$1seen\$1at | 日期 | NA | 
| 联系人 | ios\$1app\$1name | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | ios\$1app\$1version | 字符串 | NA | 
| 联系人 | ios\$1device | 字符串 | NA | 
| 联系人 | ios\$1os\$1version | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | ios\$1sdk\$1version | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 联系人 | ios\$1last\$1seen\$1at | 日期时间 | NA | 
| 联系人 | custom\$1attributes | 结构体 | NA | 
| 联系人 | tags | 结构体 | NA | 
| 联系人 | notes | 结构体 | NA | 
| 联系人 | companies | 结构体 | NA | 
| 联系人 | unsubscribed\$1from\$1sms | 布尔值 | NA | 
| 联系人 | sms\$1consent | 布尔值 | NA | 
| 联系人 | opted\$1out\$1subscription\$1types | 结构体 | NA | 
| 联系人 | referrer | 字符串 | NA | 
| 联系人 | utm\$1campaign | 字符串 | NA | 
| 联系人 | utm\$1content | 字符串 | NA | 
| 联系人 | utm\$1medium | 字符串 | NA | 
| 联系人 | utm\$1source | 字符串 | NA | 
| 联系人 | utm\$1term | 字符串 | NA | 
| 对话 | type | 字符串 | NA | 
| 对话 | id | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | created\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | updated\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | 源 | 结构体 | NA | 
| 对话 | source\$1id | 字符串 | EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1type | 字符串 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, | 
| 对话 | source\$1delivered\$1as | 字符串 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, | 
| 对话 | source\$1subject | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1body | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1author\$1id | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1author\$1type | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1author\$1name | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1author\$1email | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | source\$1url | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | 联系人 | 结构体 | NA | 
| 对话 | teammates | 结构体 | NA | 
| 对话 | 删除实例快照 | 字符串 | NA | 
| 对话 | admin\$1assignee\$1id | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | team\$1assignee\$1id | 整数 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | custom\$1attributes | 结构体 | NA | 
| 对话 | 打开 | 布尔值 | EQUAL\$1TO | 
| 对话 | 状态 | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | read | 布尔值 | EQUAL\$1TO | 
| 对话 | waiting\$1since | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | snoozed\$1until | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | tags | 结构体 | NA | 
| 对话 | first\$1contact\$1reply | 结构体 | NA | 
| 对话 | priority | 字符串 | EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | topics | 结构体 | NA | 
| 对话 | sla\$1applied | 结构体 | NA | 
| 对话 | conversation\$1rating | 结构体 | NA | 
| 对话 | conversation\$1rating\$1requested\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | conversation\$1rating\$1replied\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | conversation\$1rating\$1score | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | conversation\$1rating\$1remark | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | conversation\$1rating\$1contact\$1id | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | conversation\$1rating\$1admin\$1id | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | statistics | 结构体 | NA | 
| 对话 | statistics\$1time\$1to\$1assignment | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1time\$1to\$1admin\$1reply | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1time\$1to\$1first\$1close | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1time\$1to\$1last\$1close | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1median\$1time\$1to\$1reply | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1first\$1contact\$1reply\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1first\$1assignment\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1first\$1admin\$1reply\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1first\$1close\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1assignment\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1assignment\$1admin\$1reply\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1contact\$1reply\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1admin\$1reply\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1close\$1at | 日期时间 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1last\$1closed\$1by\$1id | 字符串 | CONTAINS, EQUAL\$1TO, NOT\$1EQUAL\$1TO | 
| 对话 | statistics\$1count\$1reopens | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1count\$1assignments | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | statistics\$1count\$1conversation\$1parts | 整数 | EQUAL\$1TO, NOT\$1EQUAL\$1TO, GREATER\$1THAN, LESS\$1THAN | 
| 对话 | conversation\$1parts | 列表 | NA | 
| 数据属性 | id | 整数 | NA | 
| 数据属性 | type | 字符串 | NA | 
| 数据属性 | 模型 | 字符串 | NA | 
| 数据属性 | 名称 | 字符串 | NA | 
| 数据属性 | full\$1name | 字符串 | NA | 
| 数据属性 | label | 字符串 | NA | 
| 数据属性 | description | 字符串 | NA | 
| 数据属性 | data\$1type | 字符串 | NA | 
| 数据属性 | options | 列表 | NA | 
| 数据属性 | api\$1writable | 布尔值 | NA | 
| 数据属性 | ui\$1writable | 布尔值 | NA | 
| 数据属性 | 自定义 | 布尔值 | NA | 
| 数据属性 | archived | 布尔值 | NA | 
| 数据属性 | created\$1at | 布尔值 | NA | 
| 数据属性 | updated\$1at | 日期时间 | NA | 
| 数据属性 | admin\$1id | 字符串 | NA | 
| Segments | type | 字符串 | NA | 
| Segments | id | 字符串 | NA | 
| Segments | 名称 | 字符串 | NA | 
| Segments | created\$1at | 日期时间 | NA | 
| Segments | updated\$1at | 日期时间 | NA | 
| Segments | person\$1type | 字符串 | NA | 
| Segments | count | 整数 | NA | 
| 标签 | type | 字符串 | NA | 
| 标签 | id | 字符串 | NA | 
| 标签 | 名称 | 字符串 | NA | 
| 团队 | type | 字符串 | NA | 
| 团队 | id | 字符串 | NA | 
| 团队 | 名称 | 字符串 | NA | 
| 团队 | admin\$1ids | 列表 | NA | 

 **对查询进行分区** 

 如果您想在 Spark 中利用并发，可以提供附加 Spark 选项 `PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用这些参数，原始查询将被拆分为 `NUM_PARTITIONS` 个子查询，这些子查询可以由 Spark 任务同时执行。
+  `PARTITION_FIELD`：用于对查询进行分区的字段的名称。
+  `LOWER_BOUND`：所选分区字段的包含下限值。

   对于日期，我们接受 Spark SQL 查询中使用的 Spark 日期格式。有效值示例：`"2024-02-06"`。
+  `UPPER_BOUND`：所选分区字段的排除上限值。
+  `NUM_PARTITIONS`：分区的数量。

 基于实体的分区字段支持详细信息如下表中所示。


| 实体名称 | 分区字段 | 数据类型 | 
| --- | --- | --- | 
| 联系人 | created\$1at, updated\$1at,last\$1seen\$1at | 日期时间 | 
| 对话 | id | 整数 | 
| 对话 | created\$1at, updated\$1at | 日期时间 | 

 **示例** 

```
Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "V2.5",
        "PARTITION_FIELD": "created_at"
        "LOWER_BOUND": "2022-07-13T07:55:27.065Z"
        "UPPER_BOUND": "2022-08-12T07:55:27.065Z"
        "NUM_PARTITIONS": "2"
    }
)
```