Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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" } )