本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Twilio 實體中讀取
<a name="twilio-reading-from-entities"></a>

**必要條件**

您要從中讀取的 Twilio 物件。您將需要物件名稱，例如 `SMS-Message` 或 `SMS-CountryPricing`。

**來源的支援實體**：


| 實體 | 介面 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \* | 支援分區 | 
| --- | --- | --- | --- | --- | --- | --- | 
| SMS-Message | REST | 是 | 是 | 否 | 是 | 是 | 
| SMS-CountryPricing | REST | 否 | 否 | 否 | 是 | 否 | 
| Voice-Call | REST | 是 | 是 | 否 | 是 | 否 | 
| Voice-Application | REST | 是 | 是 | 否 | 是 | 否 | 
| Voice-OutgoingCallerID | REST | 是 | 是 | 否 | 是 | 否 | 
| Voice-Queue | REST | 是 | 是 | 否 | 是 | 否 | 
| Conversations-Conversation | REST | 是 | 是 | 否 | 是 | 否 | 
| Conversations-User | REST | 否 | 是 | 否 | 是 | 否 | 
| Conversations-Role | REST | 否 | 是 | 否 | 是 | 否 | 
| Conversations-Configuration | REST | 否 | 否 | 否 | 是 | 否 | 
| Conversations-AddressConfiguration | REST | 是 | 是 | 否 | 是 | 否 | 
| Conversations-WebhookConfiguration | REST | 否 | 否 | 否 | 是 | 否 | 
| Conversations-ParticipantConversation | REST | 否 | 否 | 否 | 是 | 否 | 
| Conversations-Credential | REST | 否 | 是 | 否 | 是 | 否 | 
| Conversations-ConversationService | 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-Message**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** api\_version / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 本文 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_sent / **資料類型:** 日期時間 / **支援的運算子:** >=, <=, =
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** direction / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** error\_code / **資料類型:** Integer / **支援的運算子:** N/A
  - **欄位:** error\_message / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** from / **資料類型:** Integer / **支援的運算子:** =
  - **欄位:** messaging\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** num\_media / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** num\_segments / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 價格 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** price\_unit / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** sid / **資料類型:** Integer / **支援的運算子:** N/A
  - **欄位:** status / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** subresource\_uris / **資料類型:** Map / **支援的運算子:** N/A
  - **欄位:** 至 / **資料類型:** Integer / **支援的運算子:** =
  - **欄位:** uri / **資料類型:** 日期時間 / **支援的運算子:** N/A

- **SMS-CountryPricing**
  - **欄位:** 國家/地區 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** iso\_country / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** outbound\_sms\_prices / **資料類型:** 清單 / **支援的運算子:** N/A
  - **欄位:** inbound\_sms\_prices / **資料類型:** 清單 / **支援的運算子:** N/A
  - **欄位:** price\_unit / **資料類型:** String / **支援的運算子:** N/A

- **Voice-Call**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 註釋 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** answered\_by / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** api\_version / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** caller\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** direction / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** duration / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** end\_time / **資料類型:** 日期時間 / **支援的運算子:** >=, <=, =
  - **欄位:** forwarded\_from / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** from / **資料類型:** String / **支援的運算子:** =
  - **欄位:** from\_formatted / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** group\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** parent\_call\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** phone\_number\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 價格 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** price\_unit / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** start\_time / **資料類型:** 日期時間 / **支援的運算子:** >=, <=, =
  - **欄位:** status / **資料類型:** String / **支援的運算子:** =
  - **欄位:** subresource\_uris / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 至 / **資料類型:** String / **支援的運算子:** =
  - **欄位:** to\_formatted / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** trunk\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** uri / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** queue\_time / **資料類型:** String / **支援的運算子:** N/A

- **Voice-Application**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** api\_version / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** =
  - **欄位:** message\_status\_callback / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sms\_fallback\_method / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sms\_fallback\_url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sms\_method / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sms\_status\_callback / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sms\_url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** status\_callback / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** status\_callback\_method / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** uri / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** voice\_caller\_id\_lookup / **資料類型:** Boolean / **支援的運算子:** N/A
  - **欄位:** voice\_fallback\_method / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** voice\_fallback\_url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** voice\_method / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** voice\_url / **資料類型:** String / **支援的運算子:** N/A

- **public\_application\_connect\_enabled**
  - **欄位:** Boolean
  - **資料類型:** N/A

- **Voice-OutgoingCallerID**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** =
  - **欄位:** phone\_number / **資料類型:** String / **支援的運算子:** =
  - **欄位:** uri / **資料類型:** String / **支援的運算子:** N/A

- **Voice-Queue**
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** current\_size / **資料類型:** Integer / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** uri / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** average\_wait\_time / **資料類型:** Integer / **支援的運算子:** N/A
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** max\_size / **資料類型:** Integer / **支援的運算子:** N/A

- **Conversations-Conversation**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** chat\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** messaging\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** unique\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 屬性 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** state / **資料類型:** String / **支援的運算子:** =
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** timers / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** links / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** bindings / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** start\_date / **資料類型:** 日期時間 / **支援的運算子:** =
  - **欄位:** end\_date / **資料類型:** 日期時間 / **支援的運算子:** =
  - **欄位:** Timers.DateInactive / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** Timers.DateClosed / **資料類型:** String / **支援的運算子:** N/A

- **Conversations-User**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** chat\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** role\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 身分 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 屬性 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** is\_online / **資料類型:** Boolean / **支援的運算子:** N/A
  - **欄位:** is\_notifiable / **資料類型:** Boolean / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** links / **資料類型:** Struct / **支援的運算子:** N/A

- **Conversations-Role**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** chat\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** type / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 許可 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A

- **Conversations-Configuration**
  - **欄位:** account\_sid / **資料類型:** Long / **支援的運算子:** N/A
  - **欄位:** default\_chat\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** default\_messaging\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** default\_inactive\_timer / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** default\_closed\_timer / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** links / **資料類型:** Map / **支援的運算子:** N/A

- **Conversations-AddressConfiguration**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** type / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** address / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** auto\_creation / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** address\_country / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.Enabled / **資料類型:** Boolean / **支援的運算子:** N/A
  - **欄位:** AutoCreation.Type / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.ConversationServiceSid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.WebhookUrl / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.WebhookMethod / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.WebhookFilters / **資料類型:** 清單 / **支援的運算子:** N/A
  - **欄位:** AutoCreation.StudioFlowSid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** AutoCreation.StudioRetryCount / **資料類型:** Integer / **支援的運算子:** N/A

- **Conversations-WebhookConfiguration**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 方法 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 篩選條件 / **資料類型:** 清單 / **支援的運算子:** N/A
  - **欄位:** pre\_webhook\_url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** post\_webhook\_url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 目標 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A

- **Converations-ParticipantConversation**
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** chat\_service\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** participant\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** participant\_user\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** participant\_identity / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** participant\_messaging\_binding / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** Conversation\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_unique\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_attributes / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** conversation\_date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** conversation\_created\_by / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_state / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** conversation\_timers / **資料類型:** Struct / **支援的運算子:** N/A
  - **欄位:** links / **資料類型:** Map / **支援的運算子:** N/A
  - **欄位:** address / **資料類型:** String / **支援的運算子:** =
  - **欄位:** 身分 / **資料類型:** String / **支援的運算子:** =

- **Conversation-Credentials**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** type / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 沙盒 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** dated\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 憑證 / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** private\_key / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** api\_key / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** 秘密 / **資料類型:** String / **支援的運算子:** N/A

- **Conversations-ConversationService**
  - **欄位:** sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** account\_sid / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** friendly\_name / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** date\_created / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** date\_updated / **資料類型:** 日期時間 / **支援的運算子:** N/A
  - **欄位:** url / **資料類型:** String / **支援的運算子:** N/A
  - **欄位:** links / **資料類型:** Map / **支援的運算子:** N/A



## 分區查詢
<a name="twilio-reading-partitioning-queries"></a>

**支援分區的欄位**：

在 Twilio 中，DateTime 資料類型欄位支援欄位型分區。

如果想要在 Spark 中使用並行，可以提供其他 Spark 選項 `PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用這些參數，原始查詢會分區為可由 Spark 任務並行執行的子查詢的 `NUM_PARTITIONS` 數目。
+ `PARTITION_FIELD`：用來分區查詢的欄位名稱。
+ `LOWER_BOUND`：所選分區欄位的**包含**下限值。

  對於 Datetime 欄位，我們接受 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"
    }
```