Lesen aus Intercom-Entitäten
Voraussetzungen
-
Ein Intercom-Objekt, aus dem gelesen werden soll. In der Tabelle mit unterstützten Entitäten unten können Sie die verfügbaren Entitäten überprüfen.
Unterstützte Entitäten
| Entität | API_Version | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „* auswählen“ | Unterstützt Partitionierung |
|---|---|---|---|---|---|---|
| Administratoren | v2.5 | Nein | Nein | Nein | Ja | Nein |
| Unternehmen | v2.5 | Nein | Ja | Nein | Ja | Nein |
| Konversationen | v2.5 | Ja | Ja | Ja | Ja | Ja |
| Datenattribute | v2.5 | Nein | Nein | Nein | Ja | Nein |
| Kontakte | v2.5 | Ja | Ja | Ja | Ja | Ja |
| Segmente | v2.5 | Nein | Nein | Nein | Ja | Nein |
| Tags | v2.5 | Nein | Nein | Nein | Ja | Nein |
| Teams | v2.5 | Nein | Nein | Nein | Ja | Nein |
Beispiel
Intercom_read = glueContext.create_dynamic_frame.from_options( connection_type="Intercom", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "V2.5" } )
Intercom-Entitäts- und Felddetails
| Entität | Feld | Datentyp | Unterstützte Operatoren |
|---|---|---|---|
| Administratoren | Typ | String | N/A |
| Administratoren | id | String | N/A |
| Administratoren | avatar | Struct | N/A |
| Administratoren | Name | String | N/A |
| Administratoren | String | N/A | |
| Administratoren | away_mode_enabled | Boolesch | N/A |
| Administratoren | away_mode_reassign | Boolesch | N/A |
| Administratoren | has_inbox_seat | Boolesch | N/A |
| Administratoren | teams_ids | Auflisten | N/A |
| Administratoren | job_title | String | N/A |
| Unternehmen | Typ | String | N/A |
| Unternehmen | id | String | N/A |
| Unternehmen | app_id | String | N/A |
| Unternehmen | created_at | DateTime | N/A |
| Unternehmen | remote_created_at | DateTime | N/A |
| Unternehmen | updated_at | DateTime | N/A |
| Unternehmen | last_request_at | DateTime | N/A |
| Unternehmen | plan | Struct | N/A |
| Unternehmen | company_id | String | N/A |
| Unternehmen | Name | String | N/A |
| Unternehmen | custom_attributes | Struct | N/A |
| Unternehmen | session_count | Ganzzahl | N/A |
| Unternehmen | monthly_spend | Ganzzahl | N/A |
| Unternehmen | user_count | Ganzzahl | N/A |
| Unternehmen | industry | String | N/A |
| Unternehmen | size | Ganzzahl | N/A |
| Unternehmen | website | String | N/A |
| Unternehmen | tags | Struct | N/A |
| Unternehmen | segments | Struct | N/A |
| Kontakte | id | String | EQUAL_TO.NOT_EQUAL_TO |
| Kontakte | Typ | String | N/A |
| Kontakte | workspace_id | String | N/A |
| Kontakte | external_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | role | String | EQUAL_TO.NOT_EQUAL_TO |
| Kontakte | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO | |
| Kontakte | phone | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | Name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | avatar | String | N/A |
| Kontakte | owner_id | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | social_profiles | Struct | N/A |
| Kontakte | has_hard_bounced | Boolesch | EQUAL_TO |
| Kontakte | marked_email_as_spam | Boolesch | EQUAL_TO |
| Kontakte | unsubscribed_from_emails | Boolesch | EQUAL_TO |
| Kontakte | created_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | updated_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | signed_up_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | last_seen_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | last_replied_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | last_contacted_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | last_email_opened_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | last_email_clicked_at | DateTime | EQUAL_TO, GREATER_THAN, LESS_THAN |
| Kontakte | language_override | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | Browser | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | browser_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | browser_language | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | os | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | location | Struct | N/A |
| Kontakte | location_country | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | location_region | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | location_city | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | android_app_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | android_app_version | String | N/A |
| Kontakte | android_device | String | N/A |
| Kontakte | android_os_version | String | N/A |
| Kontakte | android_sdk_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | android_last_seen_at | Datum | N/A |
| Kontakte | ios_app_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | ios_app_version | String | N/A |
| Kontakte | ios_device | String | N/A |
| Kontakte | ios_os_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | ios_sdk_version | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Kontakte | ios_last_seen_at | DateTime | N/A |
| Kontakte | custom_attributes | Struct | N/A |
| Kontakte | tags | Struct | N/A |
| Kontakte | notes | Struct | N/A |
| Kontakte | companies | Struct | N/A |
| Kontakte | unsubscribed_from_sms | Boolesch | N/A |
| Kontakte | sms_consent | Boolesch | N/A |
| Kontakte | opted_out_subscription_types | Struct | N/A |
| Kontakte | referrer | String | N/A |
| Kontakte | utm_campaign | String | N/A |
| Kontakte | utm_content | String | N/A |
| Kontakte | utm_medium | String | N/A |
| Kontakte | utm_source | String | N/A |
| Kontakte | utm_term | String | N/A |
| Konversationen | Typ | String | N/A |
| Konversationen | id | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | created_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | updated_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | Quelle | Struct | N/A |
| Konversationen | source_id | String | EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_type | String | EQUAL_TO, NOT_EQUAL_TO, |
| Konversationen | source_delivered_as | String | EQUAL_TO, NOT_EQUAL_TO, |
| Konversationen | source_subject | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_body | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_author_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_author_type | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_author_name | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_author_email | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | source_url | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | Kontakte | Struct | N/A |
| Konversationen | teammates | Struct | N/A |
| Konversationen | Titel | String | N/A |
| Konversationen | admin_assignee_id | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | team_assignee_id | Ganzzahl | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | custom_attributes | Struct | N/A |
| Konversationen | geöffnet | Boolesch | EQUAL_TO |
| Konversationen | state | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | read | Boolesch | EQUAL_TO |
| Konversationen | waiting_since | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | snoozed_until | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | tags | Struct | N/A |
| Konversationen | first_contact_reply | Struct | N/A |
| Konversationen | priority | String | EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | topics | Struct | N/A |
| Konversationen | sla_applied | Struct | N/A |
| Konversationen | conversation_rating | Struct | N/A |
| Konversationen | conversation_rating_requested_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | conversation_rating_replied_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | conversation_rating_score | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | conversation_rating_remark | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | conversation_rating_contact_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | conversation_rating_admin_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | statistics | Struct | N/A |
| Konversationen | statistics_time_to_assignment | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_time_to_admin_reply | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_time_to_first_close | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_time_to_last_close | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_median_time_to_reply | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_first_contact_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_first_assignment_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_first_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_first_close_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_assignment_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_assignment_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_contact_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_admin_reply_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_close_at | DateTime | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_last_closed_by_id | String | CONTAINS, EQUAL_TO, NOT_EQUAL_TO |
| Konversationen | statistics_count_reopens | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_count_assignments | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | statistics_count_conversation_parts | Ganzzahl | EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN |
| Konversationen | conversation_parts | Auflisten | N/A |
| Datenattribute | id | Ganzzahl | N/A |
| Datenattribute | Typ | String | N/A |
| Datenattribute | model | String | N/A |
| Datenattribute | Name | String | N/A |
| Datenattribute | full_name | String | N/A |
| Datenattribute | Bezeichnung | String | N/A |
| Datenattribute | description | String | N/A |
| Datenattribute | data_type | String | N/A |
| Datenattribute | options | Auflisten | N/A |
| Datenattribute | api_writable | Boolesch | N/A |
| Datenattribute | ui_writable | Boolesch | N/A |
| Datenattribute | benutzerdefiniert | Boolesch | N/A |
| Datenattribute | archived | Boolesch | N/A |
| Datenattribute | created_at | Boolesch | N/A |
| Datenattribute | updated_at | DateTime | N/A |
| Datenattribute | admin_id | String | N/A |
| Segmente | Typ | String | N/A |
| Segmente | id | String | N/A |
| Segmente | Name | String | N/A |
| Segmente | created_at | DateTime | N/A |
| Segmente | updated_at | DateTime | N/A |
| Segmente | person_type | String | N/A |
| Segmente | count | Ganzzahl | N/A |
| Tags | Typ | String | N/A |
| Tags | id | String | N/A |
| Tags | Name | String | N/A |
| Teams | Typ | String | N/A |
| Teams | id | String | N/A |
| Teams | Name | String | N/A |
| Teams | admin_ids | Auflisten | N/A |
Partinionieren von Abfragen
Die zusätzlichen Spark-Optionen PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND und NUM_PARTITIONS können angegeben werden, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern würde die ursprüngliche Abfrage in NUM_PARTITIONS Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
-
PARTITION_FIELD: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll. -
LOWER_BOUND: ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.Als Datum akzeptieren wir das Spark-Datumsformat, das in Spark-SQL-Abfragen verwendet wird. Beispiel für gültige Werte:
"2024-02-06". -
UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds. -
NUM_PARTITIONS: Anzahl der Partitionen.
Details zur Unterstützung von Feldern für die entitätsbezogene Partitionierung sind in der folgenden Tabelle aufgeführt.
| Entity Name | Partitionierungsfeld | Datentyp |
|---|---|---|
| Kontakte | created_at, updated_at, last_seen_at | DateTime |
| Konversationen | id | Ganzzahl |
| Konversationen | created_at, updated_at | DateTime |
Beispiel
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" } )