Kustomer 엔터티에서 읽기
사전 조건
읽으려는 Kustomer 객체. 객체 이름(예: Brands 또는 Cards)이 필요합니다. 다음 표에는 지원되는 엔터티가 나와 있습니다.
소스에 대해 지원되는 엔터티:
| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select * 지원 | 분할 지원 |
|---|---|---|---|---|---|
| Brands | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Cards | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Chat Settings | 아니요 | 아니요 | 아니요 | 예 | 아니요 |
| Companies | 예 | 예 | 예 | 예 | 예 |
| Conversations | 예 | 예 | 예 | 예 | 예 |
| Customers | 예 | 예 | 예 | 예 | 예 |
| Customer Searches Pinned | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Customer Searches Position | 아니요 | 아니요 | 아니요 | 예 | 아니요 |
| Email Hooks | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Web Hooks | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Articles | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Categories | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Forms | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Routes | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Tags | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Templates | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KB Themes | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Klasses | 아니요 | 예 | 아니요 | 예 | 아니요 |
| KViews | 아니요 | 예 | 아니요 | 예 | 아니요 |
| 메시지 | 예 | 예 | 예 | 예 | 예 |
| Notes | 예 | 예 | 예 | 예 | 예 |
| 알림 | 아니요 | 예 | 아니요 | 예 | 아니요 |
예시:
Kustomer_read = glueContext.create_dynamic_frame.from_options( connection_type="kustomer", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "brands", "API_VERSION": "v1" }
Kustomer 엔터티 및 필드 세부 정보
엔터티 및 필드 세부 정보에 대한 자세한 내용은 다음을 참조하세요.
Kustomer API v1
| 개체 | 필드 | 데이터 유형 | 지원되는 연산자 |
|---|---|---|---|
| Brands | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| iconUrl | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| 기본값 | 불 | N/A | |
| Cards | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| 설명 | String | 해당 사항 없음 | |
| url | String | 해당 사항 없음 | |
| contexts | 나열 | N/A | |
| Chat Settings | id | String | 해당 사항 없음 |
| settingsVersion | Integer | N/A | |
| widgetType | String | 해당 사항 없음 | |
| version | Integer | N/A | |
| teamName | String | 해당 사항 없음 | |
| greeting | String | 해당 사항 없음 | |
| autoreply | String | 해당 사항 없음 | |
| embedIconUrl | String | 해당 사항 없음 | |
| embedIconColor | String | 해당 사항 없음 | |
| fallbackEmailSubject | String | 해당 사항 없음 | |
| fallbackEmailIntroduction | String | 해당 사항 없음 | |
| 활성화 | 불 | N/A | |
| outboundChatEnabled | 불 | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| offhoursMessage | String | 해당 사항 없음 | |
| offhoursImageUrl | String | 해당 사항 없음 | |
| closableChat | 불 | N/A | |
| noHistory | 불 | N/A | |
| disableAttachments | 불 | N/A | |
| volumeControl | Struct | N/A | |
| singleSessonChat | 불 | N/A | |
| showTypingIndicatorWeb | 불 | N/A | |
| Companies | id | String | 해당 사항 없음 |
| name | String | =, !=, CONTAINS | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| tags | 나열 | N/A | |
| domains | 나열 | N/A | |
| emails | 나열 | N/A | |
| phones | 나열 | N/A | |
| whatsapps | 나열 | N/A | |
| socials | 나열 | N/A | |
| urls | 나열 | N/A | |
| 위치 | 나열 | N/A | |
| roleGroupVersions | 나열 | N/A | |
| rev | Integer | N/A | |
| Conversations | id | String | 해당 사항 없음 |
| name | String | =, !=, CONTAINS | |
| preview | String | 해당 사항 없음 | |
| channels | 나열 | N/A | |
| status | String | =, !=, CONTAINS | |
| messageCount | Integer | =, !=, >, >=, <, <= | |
| noteCount | Integer | =, !=, >, >=, <, <= | |
| satisfaction | Integer | =, !=, >, >=, <, <= | |
| satisfactionLevel | Struct | N/A | |
| createdAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| updatedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| modifiedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| lastActivityAt | DateTime | N/A | |
| 스팸 | 불 | N/A | |
| ended | 불 | =, != | |
| endedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| endedReason | String | CONTAINS | |
| endedByType | String | 해당 사항 없음 | |
| importedAt | String | 해당 사항 없음 | |
| tags | 나열 | N/A | |
| suggestedTags | 나열 | N/A | |
| 감성 | String | 해당 사항 없음 | |
| 예측 | 나열 | N/A | |
| suggestedShortcuts | 나열 | N/A | |
| firstMessageIn | Struct | N/A | |
| firstMessageOut | Struct | N/A | |
| lastMessageIn | Struct | N/A | |
| lastMessageOut | Struct | N/A | |
| lastMessageAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| lastMessageUnrespondedTo | Struct | N/A | |
| lastMessageUnrespondedToSinceLastDone | Struct | N/A | |
| assignedUsers | 나열 | N/A | |
| assignedTeams | 나열 | N/A | |
| firstResponse | Struct | N/A | |
| firstResponseSinceLastDone | Struct | N/A | |
| lastResponse | Struct | N/A | |
| firstDone | Struct | N/A | |
| lastDone | Struct | N/A | |
| direction | String | =, !=, CONTAINS | |
| lastMessageDirection | String | 해당 사항 없음 | |
| outboundMessageCount | Integer | N/A | |
| inboundMessageCount | Integer | N/A | |
| rev | Integer | N/A | |
| priority | Integer | =, !=, >, >=, <, <= | |
| roleGroupVersions | 나열 | N/A | |
| accessOverride | 나열 | N/A | |
| 어시스턴트 | Struct | N/A | |
| phase | String | 해당 사항 없음 | |
| Skills | 나열 | N/A | |
| matchedTimeBasedRules | 나열 | N/A | |
| Customers | id | String | 해당 사항 없음 |
| name | String | =, !=, CONTAINS | |
| displayName | String | 해당 사항 없음 | |
| displayColor | String | 해당 사항 없음 | |
| displayIcon | String | 해당 사항 없음 | |
| externalId | String | =, !=, CONTAINS | |
| externalIds | 나열 | N/A | |
| sharedExternalIds | 나열 | N/A | |
| emails | 나열 | N/A | |
| sharedEmails | 나열 | N/A | |
| phones | 나열 | N/A | |
| sharedPhones | 나열 | N/A | |
| whatsapps | 나열 | N/A | |
| facebookIds | 나열 | N/A | |
| instagramIds | 나열 | N/A | |
| socials | 나열 | N/A | |
| sharedSocials | 나열 | N/A | |
| urls | 나열 | N/A | |
| 위치 | 나열 | N/A | |
| activeUsers | 나열 | N/A | |
| watchers | 나열 | N/A | |
| recentLocation | Struct | N/A | |
| locale | String | =, !=, CONTAINS | |
| timeZone | String | 해당 사항 없음 | |
| gender | String | =, !=, CONTAINS | |
| createdAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| updatedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| modifiedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| lastActivityAt | DateTime | N/A | |
| deleted | 불 | N/A | |
| lastConversation | Struct | N/A | |
| conversationCounts | Struct | N/A | |
| preview | Struct | N/A | |
| tags | 나열 | N/A | |
| progressiveStatus | String | =, !=, CONTAINS | |
| verified | 불 | N/A | |
| rev | Integer | N/A | |
| recentItems | 나열 | N/A | |
| defaultLang | String | =, !=, CONTAINS | |
| satisfactionLevel | Struct | N/A | |
| roleGroupVersions | 나열 | N/A | |
| accessOverride | 나열 | N/A | |
| companyName | String | 해당 사항 없음 | |
| firstName | String | 해당 사항 없음 | |
| lastName | String | 해당 사항 없음 | |
| Customer Searches Pinned | id | String | 해당 사항 없음 |
| search | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| Customer Searches Positions | id | String | 해당 사항 없음 |
| positions | 나열 | N/A | |
| children | 나열 | N/A | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| rev | Integer | N/A | |
| Email Hooks | id | String | 해당 사항 없음 |
| 설명 | String | 해당 사항 없음 | |
| debug | 불 | N/A | |
| 이메일 | String | 해당 사항 없음 | |
| eventName | String | 해당 사항 없음 | |
| 제목 | String | 해당 사항 없음 | |
| hash | String | 해당 사항 없음 | |
| 키 | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| Web Hooks | id | String | 해당 사항 없음 |
| 설명 | String | 해당 사항 없음 | |
| eventName | String | 해당 사항 없음 | |
| hash | String | 해당 사항 없음 | |
| url | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| 제목 | String | 해당 사항 없음 | |
| version | Integer | N/A | |
| debug | 불 | N/A | |
| KB Articles | id | String | 해당 사항 없음 |
| hash | String | 해당 사항 없음 | |
| 제목 | String | 해당 사항 없음 | |
| source | String | 해당 사항 없음 | |
| status | String | 해당 사항 없음 | |
| scope | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| deleted | 불 | N/A | |
| deletedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| publishedAt | DateTime | N/A | |
| tags | 나열 | N/A | |
| categories | 나열 | N/A | |
| knowledgeBases | 나열 | N/A | |
| metaTitle | String | 해당 사항 없음 | |
| metaDescription | String | 해당 사항 없음 | |
| metaKeywords | 나열 | N/A | |
| langVersions | Struct | N/A | |
| latestLangs | Struct | N/A | |
| KB Categories | id | String | 해당 사항 없음 |
| hash | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| published | 불 | N/A | |
| positions | 나열 | N/A | |
| categoryPositions | 나열 | N/A | |
| root | 불 | N/A | |
| langs | Struct | N/A | |
| KB Forms | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| slug | String | 해당 사항 없음 | |
| hash | String | 해당 사항 없음 | |
| 본문 | String | 해당 사항 없음 | |
| layout | 나열 | N/A | |
| layoutV2 | 나열 | N/A | |
| componentsV2 | Struct | N/A | |
| 조건 | Struct | N/A | |
| advanced | 불 | N/A | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| publishedAt | DateTime | N/A | |
| modifiedAt | String | 해당 사항 없음 | |
| published | 불 | N/A | |
| snippets | 나열 | N/A | |
| recaptcha | 불 | N/A | |
| klass | String | 해당 사항 없음 | |
| 채널 | String | 해당 사항 없음 | |
| deflection | 불 | N/A | |
| formHookEnabled | 불 | N/A | |
| replyFrom | String | 해당 사항 없음 | |
| wcag | 불 | N/A | |
| KB Routes | id | String | 해당 사항 없음 |
| url | String | 해당 사항 없음 | |
| routableType | String | 해당 사항 없음 | |
| routableId | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| KB Tags | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| KB Templates | id | String | 해당 사항 없음 |
| 제목 | String | 해당 사항 없음 | |
| 설명 | String | 해당 사항 없음 | |
| beta | 불 | N/A | |
| 매니페스트 | Struct | N/A | |
| jsxSnippets | 나열 | N/A | |
| 이미지 | 나열 | N/A | |
| version | String | 해당 사항 없음 | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| KB Themes | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| 활성화 | 불 | N/A | |
| 기본값 | 불 | N/A | |
| lastfileUpdatedAt | DateTime | N/A | |
| 사용자 지정 | 불 | N/A | |
| status | String | 해당 사항 없음 | |
| templateVersionId | String | 해당 사항 없음 | |
| templateTitle | String | 해당 사항 없음 | |
| templateVersion | String | 해당 사항 없음 | |
| 매니페스트 | Struct | N/A | |
| configSnippets | 나열 | N/A | |
| jsxSnippets | 나열 | N/A | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| rev | Integer | N/A | |
| Klasses | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| icon | String | 해당 사항 없음 | |
| color | String | 해당 사항 없음 | |
| appDisabled | 불 | N/A | |
| status | String | 해당 사항 없음 | |
| updatedAt | DateTime | N/A | |
| createdAt | DateTime | N/A | |
| s3DataUrl | String | 해당 사항 없음 | |
| KViews | id | String | 해당 사항 없음 |
| 리소스 | String | 해당 사항 없음 | |
| 템플릿 | String | 해당 사항 없음 | |
| context | String | 해당 사항 없음 | |
| meta | Struct | N/A | |
| appDisabled | 불 | N/A | |
| 활성화 | 불 | N/A | |
| advanced | 불 | N/A | |
| layout | 나열 | N/A | |
| 구성 요소 | Struct | N/A | |
| 조건 | Struct | N/A | |
| rev | Integer | N/A | |
| createdAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| 알림 | id | String | 해당 사항 없음 |
| name | String | 해당 사항 없음 | |
| status | String | 해당 사항 없음 | |
| 이벤트 | Struct | N/A | |
| createdAt | DateTime | N/A | |
| updatedAt | DateTime | N/A | |
| 메시지 | id | String | 해당 사항 없음 |
| externalId | String | 해당 사항 없음 | |
| 채널 | String | =, !=, CONTAINS | |
| 앱 | String | 해당 사항 없음 | |
| size | Integer | =, !=, >, >=, <, <= | |
| direction | String | =, !=, CONTAINS | |
| preview | String | 해당 사항 없음 | |
| subject | String | 해당 사항 없음 | |
| meta | Struct | N/A | |
| status | String | =, !=, CONTAINS | |
| directionType | String | =, !=, CONTAINS | |
| assignedTeams | 나열 | N/A | |
| assignedUsers | 나열 | N/A | |
| errorAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| auto | 불 | =, != | |
| sentAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| createdAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| updatedAt | DateTime | N/A | |
| modifiedAt | DateTime | N/A | |
| redacted | 불 | N/A | |
| createdByTeams | 나열 | N/A | |
| rev | Integer | N/A | |
| reactions | 나열 | N/A | |
| intentDetections | 나열 | N/A | |
| Notes | id | String | 해당 사항 없음 |
| 본문 | String | CONTAINS | |
| createdAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| updatedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| modifiedAt | DateTime | =, !=, <, <=, >, >=, BETWEEN | |
| createdByTeams | 나열 | N/A |
분할 쿼리
필드 기반 분할
Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND, NUM_PARTITIONS)을 제공할 수 있습니다. 이러한 파라미터를 사용하면 Spark 작업에서 동시에 실행할 수 있는 NUM_PARTITIONS개의 하위 쿼리로 원래 쿼리가 분할됩니다.
PARTITION_FIELD: 쿼리 분할에 사용할 필드의 이름입니다.LOWER_BOUND: 선택한 파티션 필드의 하한 값(경계 포함).DateTime 필드의 경우 ISO 형식의 값이 허용됩니다.
유효한 값의 예제:
"2023-01-15T11:18:39.205Z"UPPER_BOUND: 선택한 파티션 필드의 상한 값(경계 제외).NUM_PARTITIONS: 파티션 수.
엔터티 수준 분할 필드 지원 세부 정보는 다음 표에 나와 있습니다.
| 엔터티 이름 | 분할 필드 | 데이터 유형 |
|---|---|---|
| Companies | modifiedAt | DateTime |
| Conversations | createdAt, updatedAt, modifiedAt, endedAt, lastMessageAt | DateTime |
| messageCount, noteCount | BigInteger | |
| priority | Integer | |
| Customers | createdAt, updatedAt, modifiedAt | DateTime |
| 메시지 | errorAt, sentAt, createdAt | DateTime |
| size | BigInteger | |
| Notes | createdAt, updatedAt, modifiedAt | DateTime |
예시:
Kustomer_read = glueContext.create_dynamic_frame.from_options( connection_type="kustomer", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "conversation", "API_VERSION": "v1", "PARTITION_FIELD": "createdAt" "LOWER_BOUND": "2023-01-15T11:18:39.205Z" "UPPER_BOUND": "2023-02-15T11:18:39.205Z" "NUM_PARTITIONS": "2" }