從 Intercom 實體中讀取 - AWS Glue

從 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
管理員 email 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
聯絡人 email 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_atDateTimeNA
資料屬性admin_idStringNA
客群typeStringNA
客群idStringNA
客群nameStringNA
客群created_atDateTimeNA
客群updated_atDateTimeNA
客群person_typeStringNA
客群countIntegerNA
Tags (標籤)typeStringNA
Tags (標籤)idStringNA
Tags (標籤)nameStringNA
團隊typeStringNA
團隊idStringNA
團隊nameStringNA
團隊admin_ids清單NA

分區查詢

如果想要在 Spark 中使用並行,可以提供其他 Spark 選項 PARTITION_FIELDLOWER_BOUNDUPPER_BOUNDNUM_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" } )