# 从 Kustomer 实体读取内容
<a name="kustomer-reading-from-entities"></a>

**先决条件**

要从中读取内容的 Kustomer 对象。需要 Brands 或 Cards 等对象名称。下表显示支持的实体。

**源支持的实体**：


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| Brands | 否 | 是 | 否 | 是 | 否 | 
| Cards | 否 | 是 | 否 | 是 | 否 | 
| Chat Settings | 否 | 否 | 否 | 是 | 否 | 
| 公司 | 支持 | 是 | 是 | 是 | 是 | 
| 对话 | 支持 | 是 | 是 | 是 | 是 | 
| Customers | 支持 | 是 | 是 | 是 | 是 | 
| Customer Searches Pinned | 否 | 是 | 否 | 是 | 否 | 
| Customer Searches Position | 否 | 否 | 否 | 是 | 否 | 
| Email Hooks | 否 | 是 | 否 | 是 | 否 | 
| Web Hooks | 否 | 是 | 否 | 是 | 否 | 
| KB Articles | 否 | 是 | 否 | 是 | 否 | 
| KB Categories | 否 | 是 | 否 | 是 | 否 | 
| KB Forms | 否 | 是 | 否 | 是 | 否 | 
| KB Routes | 否 | 是 | 否 | 是 | 否 | 
| KB Tags | 否 | 是 | 否 | 是 | 否 | 
| KB Templates | 否 | 是 | 否 | 是 | 否 | 
| KB Themes | 否 | 是 | 否 | 是 | 否 | 
| Klasses | 否 | 是 | 否 | 是 | 否 | 
| kViews | 否 | 是 | 否 | 是 | 否 | 
|  消息 | 支持 | 是 | 是 | 是 | 是 | 
| 备注 | 支持 | 是 | 是 | 是 | 是 | 
| 通知 | 否 | 是 | 否 | 是 | 否 | 

**示例：**

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "brands",
        "API_VERSION": "v1"
    }
```

## Kustomer 实体和字段详细信息
<a name="kustomer-reading-from-entities-field-details"></a>

有关实体和字段详细信息的更多信息，请参阅：
+ [Brands](https://api.kustomerapp.com/v1/brands)
+ [Cards](https://api.kustomerapp.com/v1/cards)
+ [Chat Settings](https://api.kustomerapp.com/v1/chat/settings)
+ [Companies](https://api.kustomerapp.com/v1/companies)
+ [Conversations](https://api.kustomerapp.com/v1/conversations)
+ [Customers](https://api.kustomerapp.com/v1/customers)
+ [Customers Searches Pinned](https://api.kustomerapp.com/v1/customers/searches/pinned)
+ [Customer Searches Positions](https://api.kustomerapp.com/v1/customers/searches/positions)
+ [Hooks Email](https://api.kustomerapp.com/v1/hooks/email)
+ [Hooks Web](https://api.kustomerapp.com/v1/hooks/web)
+ [KB Articles](https://api.kustomerapp.com/v1/kb/articles)
+ [KB Categories](https://api.kustomerapp.com/v1/kb/categories)
+ [KB Forms]( https://api.kustomerapp.com/v1/kb/forms)
+ [KB Routes](https://api.kustomerapp.com/v1/kb/routes)
+ [KB Tags](https://api.kustomerapp.com/v1/kb/tags)
+ [KB Templates](https://api.kustomerapp.com/v1/kb/templates)
+ [KB Themes](https://api.kustomerapp.com/v1/kb/themes)
+ [Klasses](https://api.kustomerapp.com/v1/klasses)
+ [Kviews](https://api.kustomerapp.com/v1/kviews)
+ [ 消息](https://api.kustomerapp.com/v1/messages)
+ [备注](https://api.kustomerapp.com/v1/notes)
+ [通知](https://api.kustomerapp.com/v1/notifications)

Kustomer API v1



- **Brands**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** iconUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 默认值 / **数据类型:** 布尔值 / **支持的运算符:** 不适用

- **Cards**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** description / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** contexts / **数据类型:** 列表 / **支持的运算符:** 不适用

- **Chat Settings**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** settingsVersion / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** widgetType / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** version / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** teamName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** greeting / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** autoreply / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** embedIconUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** embedIconColor / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** fallbackEmailSubject / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** fallbackEmailIntroduction / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 已启用 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** outboundChatEnabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** offhoursMessage / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** offhoursImageUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** closableChat / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** noHistory / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** disableAttachments / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** volumeControl / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** singleSessonChat / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** showTypingIndicatorWeb / **数据类型:** 布尔值 / **支持的运算符:** 不适用

- **公司**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** tags / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 域 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** emails / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** phones / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** whatsapps / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** socials / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** urls / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 位置 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** roleGroupVersions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用

- **对话**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** preview / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 通道 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** messageCount / **数据类型:** 整数 / **支持的运算符:**  =, \!=, >, >=, <, <=
  - **字段:** noteCount / **数据类型:** 整数 / **支持的运算符:**  =, \!=, >, >=, <, <=
  - **字段:** satisfaction / **数据类型:** 整数 / **支持的运算符:**  =, \!=, >, >=, <, <=
  - **字段:** satisfactionLevel / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** lastActivityAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 垃圾电子邮件 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** ended / **数据类型:** 布尔值 / **支持的运算符:**  =, \!=
  - **字段:** endedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** endedReason / **数据类型:** 字符串 / **支持的运算符:** CONTAINS
  - **字段:** endedByType / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** importedAt / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** tags / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** suggestedTags / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 情绪 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 预测 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** suggestedShortcuts / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** firstMessageIn / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** firstMessageOut / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastMessageIn / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastMessageOut / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastMessageAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** lastMessageUnrespondedTo / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastMessageUnrespondedToSinceLastDone / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** assignedUsers / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** assignedTeams / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** firstResponse / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** firstResponseSinceLastDone / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastResponse / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** firstDone / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** lastDone / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 方向 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** lastMessageDirection / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** outboundMessageCount / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** inboundMessageCount / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** priority / **数据类型:** 整数 / **支持的运算符:**  =, \!=, >, >=, <, <=
  - **字段:** roleGroupVersions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** accessOverride / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** assistant / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** phase / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 技能 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** matchedTimeBasedRules / **数据类型:** 列表 / **支持的运算符:** 不适用

- **Customers**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** displayName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** displayColor / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** displayIcon / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** externalId / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** externalIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** sharedExternalIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** emails / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** sharedEmails / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** phones / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** sharedPhones / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** whatsapps / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** facebookIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** instagramIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** socials / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** sharedSocials / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** urls / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 位置 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** activeUsers / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** watchers / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** recentLocation / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** locale / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** timeZone / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** gender / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:**  =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** lastActivityAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 已删除 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** lastConversation / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** conversationCounts / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** preview / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** tags / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** progressiveStatus / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** verified / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** recentItems / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** defaultLang / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** satisfactionLevel / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** roleGroupVersions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** accessOverride / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** companyName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** firstName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** lastName / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **Customer Searches Pinned**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** search / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **Customer Searches Positions**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** positions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** children / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用

- **Email Hooks**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** description / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** debug / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 电子邮件 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** eventName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 删除实例快照 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** hash / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 键 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **Web Hooks**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** description / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** eventName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** hash / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 删除实例快照 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** version / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** debug / **数据类型:** 布尔值 / **支持的运算符:** 不适用

- **KB Articles**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** hash / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 删除实例快照 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 源 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 范围 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 已删除 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** deletedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** publishedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** tags / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** categories / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** knowledgeBases / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** metaTitle / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** metaDescription / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** metaKeywords / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** langVersions / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** latestLangs / **数据类型:** 结构体 / **支持的运算符:** 不适用

- **KB Categories**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** hash / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** published / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** positions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** categoryPositions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** root / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** langs / **数据类型:** 结构体 / **支持的运算符:** 不适用

- **KB Forms**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 缩略名 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** hash / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** body / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** layout / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** layoutV2 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** componentsV2 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 条件 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** advanced / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** publishedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** published / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** snippets / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** recaptcha / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** klass / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 渠道 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** deflection / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** formHookEnabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** replyFrom / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** wcag / **数据类型:** 布尔值 / **支持的运算符:** 不适用

- **KB Routes**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** routableType / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** routableId / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **KB Tags**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **KB Templates**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 删除实例快照 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** description / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** beta / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 清单 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** jsxSnippets / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 映像 / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** version / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **KB Themes**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** active / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 默认值 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** lastfileUpdatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 自定义 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** templateVersionId / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** templateTitle / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** templateVersion / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 清单 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** configSnippets / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** jsxSnippets / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用

- **Klasses**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** icon / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** color / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** appDisabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** s3DataUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **kViews**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 资源 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 模板 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** context / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** meta / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** appDisabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 已启用 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** advanced / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** layout / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** 组件 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 条件 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **通知**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 事件 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- ** 消息**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** externalId / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 渠道 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** 应用程序 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** size / **数据类型:** 整数 / **支持的运算符:** =, \!=, >, >=, <, <=
  - **字段:** 方向 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** preview / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** subject / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** meta / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** directionType / **数据类型:** 字符串 / **支持的运算符:**  =, \!=, CONTAINS
  - **字段:** assignedTeams / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** assignedUsers / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** errorAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** 自动 / **数据类型:** 布尔值 / **支持的运算符:**  =, \!=
  - **字段:** sentAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** redacted / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** createdByTeams / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** rev / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** reactions / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** intentDetections / **数据类型:** 列表 / **支持的运算符:** 不适用

- **备注**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** body / **数据类型:** 字符串 / **支持的运算符:** CONTAINS
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** modifiedAt / **数据类型:** 日期时间 / **支持的运算符:** =, \!=, <, <=, >, >=, BETWEEN
  - **字段:** createdByTeams / **数据类型:** 列表 / **支持的运算符:** 不适用



## 对查询进行分区
<a name="kustomer-reading-from-partitioning"></a>

**基于字段的分区**

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

  对于日期时间字段，我们接受 ISO 格式的值。

  有效值示例：

  ```
  "2023-01-15T11:18:39.205Z"
  ```
+ `UPPER_BOUND`：所选分区字段的**排除**上限值。
+ `NUM_PARTITIONS`：分区的数量。

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



- **公司**
  - **分区字段:** modifiedAt
  - **数据类型:** 日期时间

- **对话**
  - **分区字段:** createdAt、updatedAt、modifiedAt、endedAt、lastMessageAt / **数据类型:** 日期时间
  - **分区字段:** messageCount、noteCount / **数据类型:** BigInteger
  - **分区字段:** priority / **数据类型:** 整数

- **Customers**
  - **分区字段:** createdAt、updatedAt、modifiedAt
  - **数据类型:** 日期时间

- ** 消息**
  - **分区字段:** errorAt、sentAt、createdAt / **数据类型:** 日期时间
  - **分区字段:** size / **数据类型:** BigInteger

- **备注**
  - **分区字段:** createdAt、updatedAt、modifiedAt
  - **数据类型:** 日期时间



示例：

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2023-01-15T11:18:39.205Z"
        "UPPER_BOUND": "2023-02-15T11:18:39.205Z"
        "NUM_PARTITIONS": "2"
    }
```