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

**先决条件**

要从中读取内容的 Twilio 对象。您将需要 `SMS-Message` 或 `SMS-CountryPricing` 等对象名称。

**源支持的实体**：


| 实体 | 接口 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | --- | 
| SMS-消息 | REST | 支持 | 是 | 否 | 是 | 是 | 
| SMS-国家定价 | REST | 否 | 否 | 否 | 是 | 否 | 
| 语音-呼叫 | REST | 支持 | 是 | 否 | 是 | 否 | 
| 语音-应用程序 | REST | 支持 | 是 | 否 | 是 | 否 | 
| 语音-主叫方 ID | REST | 支持 | 是 | 否 | 是 | 否 | 
| 语音-队列 | REST | 支持 | 是 | 否 | 是 | 否 | 
| 对话-对话 | REST | 支持 | 是 | 否 | 是 | 否 | 
| 对话-用户 | REST | 否 | 是 | 否 | 是 | 否 | 
| 对话-角色 | REST | 否 | 是 | 否 | 是 | 否 | 
| 对话-配置 | REST | 否 | 否 | 否 | 是 | 否 | 
| 对话-地址配置 | REST | 支持 | 是 | 否 | 是 | 否 | 
| 对话-Webhook 配置 | REST | 否 | 否 | 否 | 是 | 否 | 
| 对话-参与者对话 | REST | 否 | 否 | 否 | 是 | 否 | 
| 对话-凭证 | REST | 否 | 是 | 否 | 是 | 否 | 
| 对话-对话服务 | REST | 否 | 是 | 否 | 是 | 否 | 

**示例：**

```
twilio_read = glueContext.create_dynamic_frame.from_options(
    connection_type="twilio",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "sms-message",
        "API_VERSION": "2010-04-01",
        "Edge_Location": "sydney.us1"
    }
```

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



- **SMS-消息**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** api\_version / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** body / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_sent / **数据类型:** 日期时间 / **支持的运算符:** >=, <=, =
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 方向 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** error\_code / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** error\_message / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** from / **数据类型:** 整数 / **支持的运算符:** =
  - **字段:** messaging\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** num\_media / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** num\_segments / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 价格 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** price\_unit / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** sid / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** subresource\_uris / **数据类型:** Map / **支持的运算符:** 不适用
  - **字段:** 到 / **数据类型:** 整数 / **支持的运算符:** =
  - **字段:** uri / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **SMS-国家定价**
  - **字段:** country / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** iso\_country / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** outbound\_sms\_prices / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** inbound\_sms\_prices / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** price\_unit / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **语音-呼叫**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** annotation / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** answered\_by / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** api\_version / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** caller\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 方向 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** duration / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** end\_time / **数据类型:** 日期时间 / **支持的运算符:** >=, <=, =
  - **字段:** forwarded\_from / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** from / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** from\_formatted / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** group\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** parent\_call\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** phone\_number\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 价格 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** price\_unit / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** start\_time / **数据类型:** 日期时间 / **支持的运算符:** >=, <=, =
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** subresource\_uris / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 到 / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** to\_formatted / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** trunk\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** uri / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** queue\_time / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **语音-应用程序**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** api\_version / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** message\_status\_callback / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sms\_fallback\_method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sms\_fallback\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sms\_method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sms\_status\_callback / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sms\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** status\_callback / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** status\_callback\_method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** uri / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** voice\_caller\_id\_lookup / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** voice\_fallback\_method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** voice\_fallback\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** voice\_method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** voice\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **public\_application\_connect\_enabled**
  - **字段:** 布尔值
  - **数据类型:** 不适用

- **语音-主叫方 ID**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** phone\_number / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** uri / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **语音-队列**
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** current\_size / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** uri / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** average\_wait\_time / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** max\_size / **数据类型:** 整数 / **支持的运算符:** 不适用

- **对话-对话**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** chat\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** messaging\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** unique\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 属性 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 状态 / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** 计时器 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** links / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** 绑定 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** start\_date / **数据类型:** 日期时间 / **支持的运算符:** =
  - **字段:** end\_date / **数据类型:** 日期时间 / **支持的运算符:** =
  - **字段:** Timers.DateInactive / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** Timers.DateClosed / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **对话-用户**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** chat\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** role\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** identity / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 属性 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** is\_online / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** is\_notifiable / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** links / **数据类型:** 结构体 / **支持的运算符:** 不适用

- **对话-角色**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** chat\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 权限 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **对话-配置**
  - **字段:** account\_sid / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** default\_chat\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** default\_messaging\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** default\_inactive\_timer / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** default\_closed\_timer / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** links / **数据类型:** Map / **支持的运算符:** 不适用

- **对话-地址配置**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 地址 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** auto\_creation / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** address\_country / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.Enabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.Type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.ConversationServiceSid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.WebhookUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.WebhookMethod / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.WebhookFilters / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.StudioFlowSid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** AutoCreation.StudioRetryCount / **数据类型:** 整数 / **支持的运算符:** 不适用

- **对话-Webhook 配置**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** filters / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** pre\_webhook\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** post\_webhook\_url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** target / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **对话-参与者对话**
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** chat\_service\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** participant\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** participant\_user\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** participant\_identity / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** participant\_messaging\_binding / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** Conversation\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_unique\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_attributes / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** conversation\_date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** conversation\_created\_by / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_state / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** conversation\_timers / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** links / **数据类型:** Map / **支持的运算符:** 不适用
  - **字段:** 地址 / **数据类型:** 字符串 / **支持的运算符:** =
  - **字段:** identity / **数据类型:** 字符串 / **支持的运算符:** =

- **对话-凭证**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 沙盒 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** dated\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 证书 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** private\_key / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** api\_key / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** secret / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **对话-对话服务**
  - **字段:** sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** account\_sid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** friendly\_name / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** date\_created / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** date\_updated / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** url / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** links / **数据类型:** Map / **支持的运算符:** 不适用



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

**支持分区的字段**：

在 Twilio 中，“日期时间”数据类型字段支持基于字段的分区。

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

  对于“日期时间”字段，我们接受 Spark SQL 查询中使用的 Spark 时间戳格式。

  有效值示例：

  ```
  "2024-05-01T20:55:02.000Z"
  ```
+ `UPPER_BOUND`：所选分区字段的**排除**上限值。
+ `NUM_PARTITIONS`：分区的数量。

示例：

```
twilio_read = glueContext.create_dynamic_frame.from_options(
    connection_type="twilio",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "sms-message",
        "API_VERSION": "2010-04-01",
        "PARTITION_FIELD": "date_sent"
        "LOWER_BOUND": "2024-05-01T20:55:02.000Z"
        "UPPER_BOUND": "2024-06-01T20:55:02.000Z"
        "NUM_PARTITIONS": "10"
    }
```