從 Intercom 實體中讀取
先決條件
-
您想要從中進行讀取的 Intercom 物件。請參閱以下支援的實體表格,以檢查可用實體。
支援的實體
| 實體 | API_Version | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 * | 支援分區 |
|---|---|---|---|---|---|---|
| 管理員 | v2.5 | 否 | 否 | 否 | 是 | 否 |
| 公司 | v2.5 | 否 | 是 | 否 | 是 | 否 |
| 對話 | v2.5 | 是 | 是 | 是 | 是 | 是 |
| 資料屬性 | v2.5 | 否 | 否 | 否 | 是 | 否 |
| 聯絡人 | v2.5 | 是 | 是 | 是 | 是 | 是 |
| 客群 | v2.5 | 否 | 否 | 否 | 是 | 否 |
| Tags (標籤) | 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 實體和欄位詳細資訊
| 實體 | 欄位 | 資料類型 | 支援的運算子 |
|---|---|---|---|
| 管理員 | type | String | NA |
| 管理員 | id | String | NA |
| 管理員 | avatar | Struct | NA |
| 管理員 | name | String | NA |
| 管理員 | String | NA | |
| 管理員 | away_mode_enabled | Boolean | NA |
| 管理員 | away_mode_reassign | Boolean | NA |
| 管理員 | has_inbox_seat | Boolean | NA |
| 管理員 | team_ids | 清單 | NA |
| 管理員 | job_title | String | NA |
| 公司 | type | String | NA |
| 公司 | id | String | NA |
| 公司 | app_id | String | NA |
| 公司 | created_at | DateTime | NA |
| 公司 | remote_created_at | DateTime | NA |
| 公司 | updated_at | DateTime | NA |
| 公司 | last_request_at | DateTime | NA |
| 公司 | plan | Struct | NA |
| 公司 | company_id | String | NA |
| 公司 | name | String | NA |
| 公司 | custom_attributes | Struct | NA |
| 公司 | session_count | Integer | NA |
| 公司 | monthly_spend | Integer | NA |
| 公司 | user_count | Integer | NA |
| 公司 | industry | String | NA |
| 公司 | size | Integer | NA |
| 公司 | website | String | NA |
| 公司 | 標籤 | Struct | NA |
| 公司 | segments | Struct | NA |
| 聯絡人 | id | String | EQUAL_TO.NOT_EQUAL_TO |
| 聯絡人 | type | String | NA |
| 聯絡人 | workspace_id | String | NA |
| 聯絡人 | external_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | role | String | EQUAL_TO.NOT_EQUAL_TO |
| 聯絡人 | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO | |
| 聯絡人 | phone | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | avatar | String | NA |
| 聯絡人 | owner_id | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | social_profiles | Struct | NA |
| 聯絡人 | has_hard_bounced | Boolean | EQUAL_TO |
| 聯絡人 | marked_email_as_spam | Boolean | EQUAL_TO |
| 聯絡人 | unsubscribed_from_emails | Boolean | EQUAL_TO |
| 聯絡人 | created_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | updated_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | signed_up_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | last_seen_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | last_replied_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | last_contacted_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | last_email_opened_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | last_email_clicked_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| 聯絡人 | language_override | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | browser | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | browser_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | 瀏覽器_語言 | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | os | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | location | Struct | NA |
| 聯絡人 | location_country | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | location_region | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | location_city | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | android_app_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | android_app_version | String | NA |
| 聯絡人 | android_device | String | NA |
| 聯絡人 | android_os_version | String | NA |
| 聯絡人 | android_sdk_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | android_last_seen_at | 日期 | NA |
| 聯絡人 | ios_app_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | ios_app_version | String | NA |
| 聯絡人 | ios_device | String | NA |
| 聯絡人 | ios_os_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | ios_sdk_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 聯絡人 | ios_last_seen_at | DateTime | NA |
| 聯絡人 | custom_attributes | Struct | NA |
| 聯絡人 | 標籤 | Struct | NA |
| 聯絡人 | notes | Struct | NA |
| 聯絡人 | 公司 | Struct | NA |
| 聯絡人 | unsubscribed_from_sms | Boolean | NA |
| 聯絡人 | sms_consent | Boolean | NA |
| 聯絡人 | opted_out_subscription_types | Struct | NA |
| 聯絡人 | referrer | String | NA |
| 聯絡人 | utm_campaign | String | NA |
| 聯絡人 | utm_content | String | NA |
| 聯絡人 | utm_medium | String | NA |
| 聯絡人 | utm_source | String | NA |
| 聯絡人 | utm_term | String | NA |
| 對話 | type | String | NA |
| 對話 | id | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | created_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | updated_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | source | Struct | NA |
| 對話 | source_id | String | EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_type | String | EQUAL_TO, NOT_EQUAL_TO, |
| 對話 | source_delivered_as | String | EQUAL_TO, NOT_EQUAL_TO, |
| 對話 | source_subject | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_body | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_author_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_author_type | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_author_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_author_email | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | source_url | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | 聯絡人 | Struct | NA |
| 對話 | 隊友 | Struct | NA |
| 對話 | 標題 | String | NA |
| 對話 | admin_assignee_id | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | team_assignee_id | Integer | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | custom_attributes | Struct | NA |
| 對話 | 開啟 | Boolean | EQUAL_TO |
| 對話 | state | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | 讀取 | Boolean | EQUAL_TO |
| 對話 | waiting_since | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | snoozed_until | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | 標籤 | Struct | NA |
| 對話 | first_contact_reply | Struct | NA |
| 對話 | priority | String | EQUAL_TO, NOT_EQUAL_TO |
| 對話 | topics | Struct | NA |
| 對話 | sla_applied | Struct | NA |
| 對話 | conversation_rating | Struct | NA |
| 對話 | conversation_rating_requested_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | conversation_rating_replied_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | conversation_rating_score | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | conversation_rating_remark | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | conversation_rating_contact_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | conversation_rating_admin_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | 統計資訊 | Struct | NA |
| 對話 | statistics_time_to_assignment | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_time_to_admin_reply | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_time_to_first_close | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_time_to_last_close | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_median_time_to_reply | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_first_contact_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_first_assignment_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_first_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_first_close_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_assignment_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_assignment_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_contact_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_close_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_last_closed_by_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| 對話 | statistics_count_reopens | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_count_assignments | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | statistics_count_conversation_parts | Integer | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| 對話 | conversation_parts | 清單 | NA |
| 資料屬性 | id | Integer | NA |
| 資料屬性 | type | String | NA |
| 資料屬性 | 模型 | String | NA |
| 資料屬性 | name | String | NA |
| 資料屬性 | full_name | String | NA |
| 資料屬性 | label | String | NA |
| 資料屬性 | 描述 | String | NA |
| 資料屬性 | data_type | String | NA |
| 資料屬性 | options | 清單 | NA |
| 資料屬性 | api_writable | Boolean | NA |
| 資料屬性 | ui_writable | Boolean | NA |
| 資料屬性 | 自訂 | Boolean | NA |
| 資料屬性 | archived | Boolean | NA |
| 資料屬性 | created_at | Boolean | NA |
| 資料屬性 | updated_at | DateTime | NA |
| 資料屬性 | admin_id | String | NA |
| 客群 | type | String | NA |
| 客群 | id | String | NA |
| 客群 | name | String | NA |
| 客群 | created_at | DateTime | NA |
| 客群 | updated_at | DateTime | NA |
| 客群 | person_type | String | NA |
| 客群 | count | Integer | NA |
| Tags (標籤) | type | String | NA |
| Tags (標籤) | id | String | NA |
| Tags (標籤) | name | String | NA |
| 團隊 | type | String | NA |
| 團隊 | id | String | NA |
| 團隊 | name | String | NA |
| 團隊 | admin_ids | 清單 | NA |
分區查詢
如果想要在 Spark 中使用並行,可以提供其他 Spark 選項 PARTITION_FIELD、LOWER_BOUND、UPPER_BOUND、NUM_PARTITIONS。使用這些參數,原始查詢會分區為可由 Spark 任務並行執行的子查詢的 NUM_PARTITIONS 數目。
-
PARTITION_FIELD:用來分區查詢的欄位名稱。 -
LOWER_BOUND:所選分區欄位的包含下限值。對於日期,我們接受 Spark SQL 查詢中使用的 Spark 日期格式。有效值的範例:
"2024-02-06"。 -
UPPER_BOUND:所選分區欄位的唯一上限值。 -
NUM_PARTITIONS:分區數目。
實體分區欄位支援詳細資訊如下表所示。
| 實體名稱 | 分區欄位 | 資料類型 |
|---|---|---|
| 聯絡人 | created_at, updated_at,last_seen_at | DateTime |
| 對話 | id | Integer |
| 對話 | created_at, updated_at | DateTime |
範例
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" } )