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

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

 **支持的实体** 


| 实体 | API\_Version | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | --- | 
| 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\_mode\_enabled | 布尔值 | NA | 
| Admins | away\_mode\_reassign | 布尔值 | NA | 
| Admins | has\_inbox\_seat | 布尔值 | NA | 
| Admins | teams\_ids | 列表 | NA | 
| Admins | job\_title | 字符串 | NA | 
| 公司 | type | 字符串 | NA | 
| 公司 | id | 字符串 | NA | 
| 公司 | app\_id | 字符串 | NA | 
| 公司 | created\_at | 日期时间 | NA | 
| 公司 | remote\_created\_at | 日期时间 | NA | 
| 公司 | updated\_at | 日期时间 | NA | 
| 公司 | last\_request\_at | 日期时间 | NA | 
| 公司 | 计划 | 结构体 | NA | 
| 公司 | company\_id | 字符串 | NA | 
| 公司 | 名称 | 字符串 | NA | 
| 公司 | custom\_attributes | 结构体 | NA | 
| 公司 | session\_count | 整数 | NA | 
| 公司 | monthly\_spend | 整数 | NA | 
| 公司 | user\_count | 整数 | NA | 
| 公司 | industry | 字符串 | NA | 
| 公司 | size | 整数 | NA | 
| 公司 | 网站 | 字符串 | NA | 
| 公司 | tags | 结构体 | NA | 
| 公司 | segments | 结构体 | NA | 
| 联系人 | id | 字符串 | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 联系人 | type | 字符串 | NA | 
| 联系人 | workspace\_id | 字符串 | NA | 
| 联系人 | external\_id | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | 角色 | 字符串 | EQUAL\_TO.NOT\_EQUAL\_TO | 
| 联系人 | 电子邮件 | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | phone | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | 名称 | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | avatar | 字符串 | NA | 
| 联系人 | owner\_id | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | social\_profiles | 结构体 | NA | 
| 联系人 | has\_hard\_bounced | 布尔值 | EQUAL\_TO | 
| 联系人 | marked\_email\_as\_spam | 布尔值 | EQUAL\_TO | 
| 联系人 | unsubscribed\_from\_emails | 布尔值 | EQUAL\_TO | 
| 联系人 | created\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | updated\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | signed\_up\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | last\_seen\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | last\_replied\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | last\_contacted\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | last\_email\_opened\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | last\_email\_clicked\_at | 日期时间 | EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 联系人 | language\_override | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | 浏览器 | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | browser\_version | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | browser\_language | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | os | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | location | 结构体 | NA | 
| 联系人 | location\_country | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | location\_region | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | location\_city | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | android\_app\_name | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | android\_app\_version | 字符串 | NA | 
| 联系人 | android\_device | 字符串 | NA | 
| 联系人 | android\_os\_version | 字符串 | NA | 
| 联系人 | android\_sdk\_version | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | android\_last\_seen\_at | 日期 | NA | 
| 联系人 | ios\_app\_name | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | ios\_app\_version | 字符串 | NA | 
| 联系人 | ios\_device | 字符串 | NA | 
| 联系人 | ios\_os\_version | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | ios\_sdk\_version | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 联系人 | ios\_last\_seen\_at | 日期时间 | NA | 
| 联系人 | custom\_attributes | 结构体 | NA | 
| 联系人 | tags | 结构体 | NA | 
| 联系人 | notes | 结构体 | NA | 
| 联系人 | companies | 结构体 | NA | 
| 联系人 | unsubscribed\_from\_sms | 布尔值 | NA | 
| 联系人 | sms\_consent | 布尔值 | NA | 
| 联系人 | opted\_out\_subscription\_types | 结构体 | NA | 
| 联系人 | referrer | 字符串 | NA | 
| 联系人 | utm\_campaign | 字符串 | NA | 
| 联系人 | utm\_content | 字符串 | NA | 
| 联系人 | utm\_medium | 字符串 | NA | 
| 联系人 | utm\_source | 字符串 | NA | 
| 联系人 | utm\_term | 字符串 | NA | 
| 对话 | type | 字符串 | NA | 
| 对话 | id | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | created\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | updated\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | 源 | 结构体 | NA | 
| 对话 | source\_id | 字符串 | EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_type | 字符串 | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| 对话 | source\_delivered\_as | 字符串 | EQUAL\_TO, NOT\_EQUAL\_TO, | 
| 对话 | source\_subject | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_body | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_author\_id | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_author\_type | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_author\_name | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_author\_email | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | source\_url | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | 联系人 | 结构体 | NA | 
| 对话 | teammates | 结构体 | NA | 
| 对话 | 删除实例快照 | 字符串 | NA | 
| 对话 | admin\_assignee\_id | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | team\_assignee\_id | 整数 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | custom\_attributes | 结构体 | NA | 
| 对话 | 打开 | 布尔值 | EQUAL\_TO | 
| 对话 | 状态 | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | read | 布尔值 | EQUAL\_TO | 
| 对话 | waiting\_since | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | snoozed\_until | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | tags | 结构体 | NA | 
| 对话 | first\_contact\_reply | 结构体 | NA | 
| 对话 | priority | 字符串 | EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | topics | 结构体 | NA | 
| 对话 | sla\_applied | 结构体 | NA | 
| 对话 | conversation\_rating | 结构体 | NA | 
| 对话 | conversation\_rating\_requested\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | conversation\_rating\_replied\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | conversation\_rating\_score | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | conversation\_rating\_remark | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | conversation\_rating\_contact\_id | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | conversation\_rating\_admin\_id | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | statistics | 结构体 | NA | 
| 对话 | statistics\_time\_to\_assignment | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_time\_to\_admin\_reply | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_time\_to\_first\_close | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_time\_to\_last\_close | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_median\_time\_to\_reply | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_first\_contact\_reply\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_first\_assignment\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_first\_admin\_reply\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_first\_close\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_assignment\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_assignment\_admin\_reply\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_contact\_reply\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_admin\_reply\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_close\_at | 日期时间 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_last\_closed\_by\_id | 字符串 | CONTAINS, EQUAL\_TO, NOT\_EQUAL\_TO | 
| 对话 | statistics\_count\_reopens | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_count\_assignments | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | statistics\_count\_conversation\_parts | 整数 | EQUAL\_TO, NOT\_EQUAL\_TO, GREATER\_THAN, LESS\_THAN | 
| 对话 | conversation\_parts | 列表 | NA | 
| 数据属性 | id | 整数 | NA | 
| 数据属性 | type | 字符串 | NA | 
| 数据属性 | 模型 | 字符串 | NA | 
| 数据属性 | 名称 | 字符串 | NA | 
| 数据属性 | full\_name | 字符串 | NA | 
| 数据属性 | label | 字符串 | NA | 
| 数据属性 | description | 字符串 | NA | 
| 数据属性 | data\_type | 字符串 | NA | 
| 数据属性 | options | 列表 | NA | 
| 数据属性 | api\_writable | 布尔值 | NA | 
| 数据属性 | ui\_writable | 布尔值 | NA | 
| 数据属性 | 自定义 | 布尔值 | NA | 
| 数据属性 | archived | 布尔值 | NA | 
| 数据属性 | created\_at | 布尔值 | NA | 
| 数据属性 | updated\_at | 日期时间 | NA | 
| 数据属性 | admin\_id | 字符串 | NA | 
| Segments | type | 字符串 | NA | 
| Segments | id | 字符串 | NA | 
| Segments | 名称 | 字符串 | NA | 
| Segments | created\_at | 日期时间 | NA | 
| Segments | updated\_at | 日期时间 | NA | 
| Segments | person\_type | 字符串 | NA | 
| Segments | count | 整数 | NA | 
| 标签 | type | 字符串 | NA | 
| 标签 | id | 字符串 | NA | 
| 标签 | 名称 | 字符串 | NA | 
| 团队 | type | 字符串 | NA | 
| 团队 | id | 字符串 | NA | 
| 团队 | 名称 | 字符串 | NA | 
| 团队 | admin\_ids | 列表 | 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\_at, updated\_at,last\_seen\_at | 日期时间 | 
| 对话 | id | 整数 | 
| 对话 | created\_at, updated\_at | 日期时间 | 

 **示例** 

```
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"
    }
)
```