Intercom 엔터티에서 읽기 - AWS Glue

Intercom 엔터티에서 읽기

사전 조건

  • 읽으려는 Intercom 객체. 사용 가능한 엔터티를 확인하려면 아래 지원되는 엔터티 테이블을 참조하세요.

지원되는 엔터티

개체 API_Version 필터링 가능 제한 지원 정렬 기준 지원 Select * 지원 분할 지원
Admins v2.5 아니요 아니요 아니요 아니요
회사 v2.5 아니요 아니요 아니요
Conversations v2.5
데이터 속성 v2.5 아니요 아니요 아니요 아니요
Contacts v2.5
Segments 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 엔터티 및 필드 세부 정보

개체 필드 데이터 형식 지원되는 연산자
Admins type String NA
Admins id String NA
Admins avatar Struct NA
Admins name String NA
Admins 이메일 String NA
Admins away_mode_enabled NA
Admins away_mode_reassign NA
Admins has_inbox_seat NA
Admins teams_ids 나열 NA
Admins 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
회사 계획 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
회사 웹 사이트 String NA
회사 tags Struct NA
회사 segments Struct NA
Contacts id String EQUAL_TO.NOT_EQUAL_TO
Contacts type String NA
Contacts workspace_id String NA
Contacts external_id String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts role String EQUAL_TO.NOT_EQUAL_TO
Contacts 이메일 String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts phone String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts name String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts avatar String NA
Contacts owner_id Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts social_profiles Struct NA
Contacts has_hard_bounced EQUAL_TO
Contacts marked_email_as_spam EQUAL_TO
Contacts unsubscribed_from_emails EQUAL_TO
Contacts created_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts updated_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts signed_up_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts last_seen_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts last_replied_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts last_contacted_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts last_email_opened_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts last_email_clicked_at DateTime EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts language_override String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts 브라우저 String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts browser_version String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts browser_language String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts os String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts location Struct NA
Contacts location_country String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts location_region String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts location_city String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts android_app_name String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts android_app_version String NA
Contacts android_device String NA
Contacts android_os_version String NA
Contacts android_sdk_version String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts android_last_seen_at 날짜 NA
Contacts ios_app_name String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts ios_app_version String NA
Contacts ios_device String NA
Contacts ios_os_version String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts ios_sdk_version String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts ios_last_seen_at DateTime NA
Contacts custom_attributes Struct NA
Contacts tags Struct NA
Contacts notes Struct NA
Contacts companies Struct NA
Contacts unsubscribed_from_sms NA
Contacts sms_consent NA
Contacts opted_out_subscription_types Struct NA
Contacts referrer String NA
Contacts utm_campaign String NA
Contacts utm_content String NA
Contacts utm_medium String NA
Contacts utm_source String NA
Contacts utm_term String NA
Conversations type String NA
Conversations id Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations created_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations updated_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations source Struct NA
Conversations source_id String EQUAL_TO, NOT_EQUAL_TO
Conversations source_type String EQUAL_TO, NOT_EQUAL_TO,
Conversations source_delivered_as String EQUAL_TO, NOT_EQUAL_TO,
Conversations source_subject String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_body String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_author_id String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_author_type String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_author_name String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_author_email String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations source_url String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations contacts Struct NA
Conversations teammates Struct NA
Conversations 제목 String NA
Conversations admin_assignee_id Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations team_assignee_id Integer CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations custom_attributes Struct NA
Conversations open EQUAL_TO
Conversations state String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations 읽기 EQUAL_TO
Conversations waiting_since DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations snoozed_until DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations tags Struct NA
Conversations 첫 번째_연락처_회신 Struct NA
Conversations priority String EQUAL_TO, NOT_EQUAL_TO
Conversations topics Struct NA
Conversations sla_applied Struct NA
Conversations conversation_rating Struct NA
Conversations conversation_rating_requested_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations conversation_rating_replied_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations conversation_rating_score Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations conversation_rating_remark String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations conversation_rating_contact_id String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations conversation_rating_admin_id String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations 통계 Struct NA
Conversations statistics_time_to_assignment Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_time_to_admin_reply Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_time_to_first_close Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_time_to_last_close Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_median_time_to_reply Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_first_contact_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_first_assignment_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_first_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_first_close_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_assignment_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_assignment_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_contact_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_admin_reply_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_close_at DateTime EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_last_closed_by_id String CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations statistics_count_reopens Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_count_assignments Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations statistics_count_conversation_parts Integer EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations conversation_parts 나열 NA
데이터 속성 id Integer NA
데이터 속성 type String NA
데이터 속성 모델 String NA
데이터 속성 name String NA
데이터 속성 full_name String NA
데이터 속성 레이블 String NA
데이터 속성 설명 String NA
데이터 속성 data_type String NA
데이터 속성 옵션 나열 NA
데이터 속성 api_writable NA
데이터 속성 ui_writable NA
데이터 속성 사용자 지정 NA
데이터 속성 archived NA
데이터 속성 created_at NA
데이터 속성updated_atDateTimeNA
데이터 속성admin_idStringNA
SegmentstypeStringNA
SegmentsidStringNA
SegmentsnameStringNA
Segmentscreated_atDateTimeNA
Segmentsupdated_atDateTimeNA
Segmentsperson_typeStringNA
SegmentscountIntegerNA
TagstypeStringNA
TagsidStringNA
TagsnameStringNA
typeStringNA
idStringNA
nameStringNA
admin_ids나열NA

분할 쿼리

Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND, NUM_PARTITIONS)을 제공할 수 있습니다. 이러한 파라미터를 사용하면 Spark 태스크에서 동시에 실행할 수 있는 NUM_PARTITIONS개의 하위 쿼리로 원본 쿼리가 분할됩니다.

  • PARTITION_FIELD: 쿼리 분할에 사용할 필드의 이름입니다.

  • LOWER_BOUND: 선택한 파티션 필드의 하한 값(경계 포함).

    날짜의 경우 Spark SQL 쿼리에 사용된 Spark 날짜 형식을 허용합니다. 유효한 값의 예제: "2024-02-06".

  • UPPER_BOUND: 선택한 파티션 필드의 상한 값(경계 제외).

  • NUM_PARTITIONS: 파티션 수.

엔터티 수준의 분할 필드 지원 세부 정보는 다음 표에 캡처되어 있습니다.

Entity Name 분할 필드 데이터 형식
Contacts created_at, updated_at,last_seen_at DateTime
Conversations id Integer
Conversations 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" } )