Lettura da entità Intercom - AWS Glue

Lettura da entità Intercom

Prerequisiti

  • Un oggetto di Intercom da cui desideri leggere. Consultare la tabella delle entità supportate qui di seguito per verificare quelle disponibili.

Entità supportate

Entità API_Version Può essere filtrato Supporta Limite Supporta Ordina per Supporta Seleziona * Supporta Partizionamento
Admins v2.5 No No No No
Aziende v2.5 No No No
Conversazioni v2.5
Attributi dei dati v2.5 No No No No
Contatti v2.5
Segmenti v2.5 No No No No
Tag v2.5 No No No No
Team v2.5 No No No No

Esempio

Intercom_read = glueContext.create_dynamic_frame.from_options( connection_type="Intercom", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "V2.5" } )

Dettagli dell'entità e del campo di Intercom

Entità Campo Tipo di dati Operatori supportati
Admins tipo Stringa N/A
Admins id Stringa N/A
Admins avatar Struct N/A
Admins nome Stringa N/A
Admins e-mail Stringa N/A
Admins away_mode_enabled Booleano N/A
Admins away_mode_reassign Booleano N/A
Admins has_inbox_seat Booleano N/A
Admins teams_ids Elenco N/A
Admins job_title Stringa N/A
Aziende tipo Stringa N/A
Aziende id Stringa N/A
Aziende app_id Stringa N/A
Aziende created_at DateTime N/A
Aziende remote_created_at DateTime N/A
Aziende updated_at DateTime N/A
Aziende last_request_at DateTime N/A
Aziende pianificazione Struct N/A
Aziende company_id Stringa N/A
Aziende nome Stringa N/A
Aziende custom_attributes Struct N/A
Aziende session_count Numero intero N/A
Aziende monthly_spend Numero intero N/A
Aziende user_count Numero intero N/A
Aziende Industria Stringa N/A
Aziende formato Numero intero N/A
Aziende website Stringa N/A
Aziende tags Struct N/A
Aziende segmenti Struct N/A
Contatti id Stringa EQUAL_TO.NOT_EQUAL_TO
Contatti tipo Stringa N/A
Contatti workspace_id Stringa N/A
Contatti external_id Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti role Stringa EQUAL_TO.NOT_EQUAL_TO
Contatti e-mail Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti telefono Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti nome Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti avatar Stringa N/A
Contatti owner_id Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti social_profiles Struct N/A
Contatti has_hard_bounced Booleano EQUAL_TO
Contatti marked_email_as_spam Booleano EQUAL_TO
Contatti unsubscribed_from_emails Booleano EQUAL_TO
Contatti created_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti updated_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti signed_up_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti last_seen_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti last_replied_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti last_contacted_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti last_email_opened_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti last_email_clicked_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contatti language_override Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti browser Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti browser_version Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti browser_language Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti so Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti posizione Struct N/A
Contatti location_country Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti location_region Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti location_city Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti android_app_name Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti android_app_version Stringa N/A
Contatti android_device Stringa N/A
Contatti android_os_version Stringa N/A
Contatti android_sdk_version Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti android_last_seen_at Data N/A
Contatti ios_app_name Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti ios_app_version Stringa N/A
Contatti ios_device Stringa N/A
Contatti ios_os_version Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti ios_sdk_version Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contatti ios_last_seen_at DateTime N/A
Contatti custom_attributes Struct N/A
Contatti tags Struct N/A
Contatti notes Struct N/A
Contatti aziende Struct N/A
Contatti unsubscribed_from_sms Booleano N/A
Contatti sms_consent Booleano N/A
Contatti opted_out_subscription_types Struct N/A
Contatti referrer Stringa N/A
Contatti utm_campaign Stringa N/A
Contatti utm_content Stringa N/A
Contatti utm_medium Stringa N/A
Contatti utm_source Stringa N/A
Contatti utm_term Stringa N/A
Conversazioni tipo Stringa N/A
Conversazioni id Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni created_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni updated_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni source Struct N/A
Conversazioni source_id Stringa EQUAL_TO, NON_EQUAL_TO
Conversazioni source_type Stringa EQUAL_TO, NOT_EQUAL_TO,
Conversazioni source_delivered_as Stringa EQUAL_TO, NOT_EQUAL_TO,
Conversazioni source_subject Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_body Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_author_id Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_author_type Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_author_name Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_author_email Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni source_url Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni contatti Struct N/A
Conversazioni compagni di squadra Struct N/A
Conversazioni titolo Stringa N/A
Conversazioni admin_assignee_id Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni team_assignee_id Numero intero CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni custom_attributes Struct N/A
Conversazioni aperto Booleano EQUAL_TO
Conversazioni stato Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni read Booleano EQUAL_TO
Conversazioni waiting_since DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni snoozed_until DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni tags Struct N/A
Conversazioni first_contact_reply Struct N/A
Conversazioni priority Stringa EQUAL_TO, NON_EQUAL_TO
Conversazioni topics Struct N/A
Conversazioni sla_applied Struct N/A
Conversazioni conversation_rating Struct N/A
Conversazioni conversation_rating_requested_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni conversation_rating_replied_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni conversation_rating_score Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni conversation_rating_remark Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni conversation_rating_contact_id Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni conversation_rating_admin_id Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni statistiche Struct N/A
Conversazioni statistics_time_to_assignment Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_time_to_admin_reply Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_time_to_first_close Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_time_to_last_close Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_median_time_to_reply Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_first_contact_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_first_assignment_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_first_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_first_close_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_assignment_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_assignment_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_contact_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_close_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_last_closed_by_id Stringa CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversazioni statistics_count_reopens Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_count_assignments Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni statistics_count_conversation_parts Numero intero EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversazioni conversation_parts Elenco N/A
Attributi dei dati id Numero intero N/A
Attributi dei dati tipo Stringa N/A
Attributi dei dati modello Stringa N/A
Attributi dei dati nome Stringa N/A
Attributi dei dati full_name Stringa N/A
Attributi dei dati etichetta Stringa N/A
Attributi dei dati description Stringa N/A
Attributi dei dati data_type Stringa N/A
Attributi dei dati options Elenco N/A
Attributi dei dati api_writable Booleano N/A
Attributi dei dati ui_writable Booleano N/A
Attributi dei dati personalizzato Booleano N/A
Attributi dei dati archived Booleano N/A
Attributi dei dati created_at Booleano N/A
Attributi dei datiupdated_atDateTimeN/A
Attributi dei datiadmin_idStringaN/A
SegmentitipoStringaN/A
SegmentiidStringaN/A
SegmentinomeStringaN/A
Segmenticreated_atDateTimeN/A
Segmentiupdated_atDateTimeN/A
Segmentiperson_typeStringaN/A
SegmenticountNumero interoN/A
TagtipoStringaN/A
TagidStringaN/A
TagnomeStringaN/A
TeamtipoStringaN/A
TeamidStringaN/A
TeamnomeStringaN/A
Teamadmin_idsElencoN/A

Query di partizionamento

Se desideri utilizzare la concorrenza in Spark, possono essere fornite le opzioni aggiuntive PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.

  • PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.

  • LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

    Per la data, accettiamo il formato di data di Spark utilizzato nelle query di Spark SQL. Esempio di valori validi: "2024-02-06".

  • UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  • NUM_PARTITIONS: numero di partizioni.

I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella seguente.

Nome entità Campo di partizionamento Tipo di dati
Contatti created_at, updated_at,last_seen_at DateTime
Conversazioni id Numero intero
Conversazioni created_at, updated_at DateTime

Esempio

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" } )