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 | Sì | No |
| Aziende | v2.5 | No | Sì | No | Sì | No |
| Conversazioni | v2.5 | Sì | Sì | Sì | Sì | Sì |
| Attributi dei dati | v2.5 | No | No | No | Sì | No |
| Contatti | v2.5 | Sì | Sì | Sì | Sì | Sì |
| Segmenti | v2.5 | No | No | No | Sì | No |
| Tag | v2.5 | No | No | No | Sì | No |
| Team | v2.5 | No | No | No | Sì | 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 | 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 | 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 dati | updated_at | DateTime | N/A |
| Attributi dei dati | admin_id | Stringa | N/A |
| Segmenti | tipo | Stringa | N/A |
| Segmenti | id | Stringa | N/A |
| Segmenti | nome | Stringa | N/A |
| Segmenti | created_at | DateTime | N/A |
| Segmenti | updated_at | DateTime | N/A |
| Segmenti | person_type | Stringa | N/A |
| Segmenti | count | Numero intero | N/A |
| Tag | tipo | Stringa | N/A |
| Tag | id | Stringa | N/A |
| Tag | nome | Stringa | N/A |
| Team | tipo | Stringa | N/A |
| Team | id | Stringa | N/A |
| Team | nome | Stringa | N/A |
| Team | admin_ids | Elenco | N/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" } )