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

**先决条件**

要从中读取内容的 SendGrid 对象。需要 `lists`、`singlesends` 或 `segments` 等对象名称。

**源支持的实体**：


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| Lists | 否 | 是 | 否 | 是 | 否 | 
| 单次发送 | 支持 | 是 | 否 | 是 | 否 | 
| 营销活动统计数据-自动化 | 支持 | 是 | 否 | 是 | 否 | 
| 营销活动统计数据-单次发送 | 支持 | 是 | 否 | 是 | 否 | 
| Segments | 是 | 否 | 否 | 是 | 否 | 
| 联系人 | 是 | 否 | 否 | 是 | 否 | 
| 类别 | 否 | 否 | 否 | 是 | 否 | 
| 统计信息 | 是 | 否 | 否 | 是 | 否 | 
| 取消订阅组 | 是 | 否 | 否 | 是 | 否 | 

**示例：**

```
sendgrid_read = glueContext.create_dynamic_frame.from_options(
    connection_type="sendgrid",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "lists",
        "API_VERSION": "v3",
        "INSTANCE_URL": "instanceUrl"
    }
```

**SendGrid 实体和字段详细信息**：

具有静态元数据的实体：



- **Lists**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** contact\_count / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** \_metadata / **数据类型:** 结构体 / **支持的运算符:** 不适用

- **单次发送**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO
  - **字段:** abtest / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO
  - **字段:** categories / **数据类型:** 列表 / **支持的运算符:** EQUAL\_TO
  - **字段:** send\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** is\_abtest / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** updated\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** created\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 通道 / **数据类型:** 列表 / **支持的运算符:** 不适用

- **营销活动统计数据-自动化**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 聚合 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** step\_id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** stats / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** automation\_ids / **数据类型:** 列表 / **支持的运算符:** EQUAL\_TO

- **营销活动统计数据-单次发送**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** ab\_variation / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** ab\_phase / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 聚合 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** stats / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** singlesend\_ids / **数据类型:** 列表 / **支持的运算符:** EQUAL\_TO

- **Segments**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** query\_version / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** contacts\_count / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** sample\_updated\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** next\_sample\_update / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** created\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** updated\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** parent\_list\_id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** parent\_list\_ids / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO
  - **字段:** no\_parent\_list\_id / **数据类型:** 布尔值 / **支持的运算符:** EQUAL\_TO

- **联系人**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** first\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** last\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** unique\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 电子邮件 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** alternate\_emails / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** address\_line\_1 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** address\_line\_2 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** city / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** state\_province\_region / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** country / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** postal\_code / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** phone\_number / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** whatsapp / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 折线图 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** facebook / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** list\_ids / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** custom\_fields / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** created\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** updated\_at / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** \_metadata / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** event\_timestamp / **数据类型:** 日期时间 / **支持的运算符:** BETWEEN

- **类别**
  - **字段:** categories
  - **数据类型:** 列表
  - **支持的运算符:** 不适用

- **统计信息**
  - **字段:** date / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** stats / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** start\_date / **数据类型:** 日期时间 / **支持的运算符:** EQUAL\_TO、BETWEEN
  - **字段:** aggregated\_by / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO

- **取消订阅组**
  - **字段:** id / **数据类型:** 整数 / **支持的运算符:** EQUAL\_TO
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** description / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** last\_email\_sent\_at / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** is\_default / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 取消订阅 / **数据类型:** 整数 / **支持的运算符:** 不适用



**注意**  
在连接器的响应中，“结构体”和“列表”数据类型将转换为“字符串”数据类型，“日期时间”数据类型将转换为“时间戳”数据类型。

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

SendGrid 不支持基于筛选条件的分区或基于记录的分区。