Kustomer エンティティからの読み取り - AWS Glue
Kustomer のエンティティとフィールドの詳細パーティショニングクエリ

Kustomer エンティティからの読み取り

前提条件

読み取り元の Kustomer オブジェクト。Brands または Cards などのオブジェクト名が必要です。次の表に、サポートされているエンティティを示します。

ソースに対応するエンティティ:

エンティティ フィルタリング可能 制限をサポートする Order By をサポートする 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 なし あり なし あり なし
メッセージ はい あり あり あり はい
コメント はい あり あり あり あり
通知 なし あり なし あり なし

例:

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 文字列 該当なし
名前 文字列 該当なし
iconUrl 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
デフォルト ブール値 該当なし
[Cards] (カード) id 文字列 該当なし
名前 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
description 文字列 該当なし
url 文字列 該当なし
contexts リスト 該当なし
Chat Settings id 文字列 該当なし
settingsVersion 整数 該当なし
widgetType 文字列 該当なし
version 整数 該当なし
teamName 文字列 該当なし
greeting 文字列 該当なし
autoreply 文字列 該当なし
embedIconUrl 文字列 該当なし
embedIconColor 文字列 該当なし
fallbackEmailSubject 文字列 該当なし
fallbackEmailIntroduction 文字列 該当なし
有効 ブール値 該当なし
outboundChatEnabled ブール値 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
offhoursMessage 文字列 該当なし
offhoursImageUrl 文字列 該当なし
closableChat ブール値 該当なし
noHistory ブール値 該当なし
disableAttachments ブール値 該当なし
volumeControl Struct 該当なし
singleSessonChat ブール値 該当なし
showTypingIndicatorWeb ブール値 該当なし
Companies id 文字列 該当なし
名前 文字列 =、!=、CONTAINS
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime =, !=, <, <=, >, >=, BETWEEN
tags リスト 該当なし
domains リスト 該当なし
emails リスト 該当なし
phones リスト 該当なし
whatsapps リスト 該当なし
socials リスト 該当なし
urls リスト 該当なし
ロケーション リスト 該当なし
roleGroupVersions リスト 該当なし
rev 整数 該当なし
Conversations id 文字列 該当なし
名前 文字列 =、!=、CONTAINS
プレビュー 文字列 該当なし
チャンネル リスト 該当なし
ステータス 文字列 =、!=、CONTAINS
messageCount 整数 =, !=, >, >=, <, <=
noteCount 整数 =, !=, >, >=, <, <=
satisfaction 整数 =, !=, >, >=, <, <=
satisfactionLevel Struct 該当なし
createdAt DateTime =, !=, <, <=, >, >=, BETWEEN
updatedAt DateTime =, !=, <, <=, >, >=, BETWEEN
modifiedAt DateTime =, !=, <, <=, >, >=, BETWEEN
lastActivityAt DateTime 該当なし
スパム ブール値 該当なし
ended ブール値 =, !=
endedAt DateTime =, !=, <, <=, >, >=, BETWEEN
endedReason 文字列 CONTAINS
endedByType 文字列 該当なし
importedAt 文字列 該当なし
tags リスト 該当なし
suggestedTags リスト 該当なし
感情 文字列 該当なし
予測 リスト 該当なし
suggestedShortcuts リスト 該当なし
firstMessageIn Struct 該当なし
firstMessageOut Struct 該当なし
lastMessageIn Struct 該当なし
lastMessageOut Struct 該当なし
lastMessageAt DateTime =, !=, <, <=, >, >=, BETWEEN
lastMessageUnrespondedTo Struct 該当なし
lastMessageUnrespondedToSinceLastDone Struct 該当なし
assignedUsers リスト 該当なし
assignedTeams リスト 該当なし
firstResponse Struct 該当なし
firstResponseSinceLastDone Struct 該当なし
lastResponse Struct 該当なし
firstDone Struct 該当なし
lastDone Struct 該当なし
direction 文字列 =、!=、CONTAINS
lastMessageDirection 文字列 該当なし
outboundMessageCount 整数 該当なし
inboundMessageCount 整数 該当なし
rev 整数 該当なし
priority 整数 =, !=, >, >=, <, <=
roleGroupVersions リスト 該当なし
accessOverride リスト 該当なし
assistant Struct 該当なし
phase 文字列 該当なし
スキル リスト 該当なし
matchedTimeBasedRules リスト 該当なし
Customers id 文字列 該当なし
名前 文字列 =、!=、CONTAINS
displayName 文字列 該当なし
displayColor 文字列 該当なし
displayIcon 文字列 該当なし
externalId 文字列 =、!=、CONTAINS
externalIds リスト 該当なし
sharedExternalIds リスト 該当なし
emails リスト 該当なし
sharedEmails リスト 該当なし
phones リスト 該当なし
sharedPhones リスト 該当なし
whatsapps リスト 該当なし
facebookIds リスト 該当なし
instagramIds リスト 該当なし
socials リスト 該当なし
sharedSocials リスト 該当なし
urls リスト 該当なし
ロケーション リスト 該当なし
activeUsers リスト 該当なし
watchers リスト 該当なし
recentLocation Struct 該当なし
サイト 文字列 =、!=、CONTAINS
timeZone 文字列 該当なし
gender 文字列 =、!=、CONTAINS
createdAt DateTime =, !=, <, <=, >, >=, BETWEEN
updatedAt DateTime =, !=, <, <=, >, >=, BETWEEN
modifiedAt DateTime =, !=, <, <=, >, >=, BETWEEN
lastActivityAt DateTime 該当なし
削除済み ブール値 該当なし
lastConversation Struct 該当なし
conversationCounts Struct 該当なし
プレビュー Struct 該当なし
tags リスト 該当なし
progressiveStatus 文字列 =、!=、CONTAINS
verified ブール値 該当なし
rev 整数 該当なし
recentItems リスト 該当なし
defaultLang 文字列 =、!=、CONTAINS
satisfactionLevel Struct 該当なし
roleGroupVersions リスト 該当なし
accessOverride リスト 該当なし
companyName 文字列 該当なし
firstName 文字列 該当なし
lastName 文字列 該当なし
Customer Searches Pinned id 文字列 該当なし
検索 文字列 該当なし
createdAt DateTime 該当なし
Customer Searches Positions id 文字列 該当なし
positions リスト 該当なし
children リスト 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
rev 整数 該当なし
Email Hooks id 文字列 該当なし
description 文字列 該当なし
デバッグ ブール値 該当なし
email 文字列 該当なし
eventName 文字列 該当なし
title 文字列 該当なし
ハッシュ 文字列 該当なし
キー 文字列 該当なし
createdAt DateTime 該当なし
modifiedAt DateTime 該当なし
updatedAt DateTime 該当なし
Web Hooks id 文字列 該当なし
description 文字列 該当なし
eventName 文字列 該当なし
ハッシュ 文字列 該当なし
url 文字列 該当なし
createdAt DateTime 該当なし
modifiedAt DateTime 該当なし
updatedAt DateTime 該当なし
title 文字列 該当なし
version 整数 該当なし
デバッグ ブール値 該当なし
KB Articles id 文字列 該当なし
ハッシュ 文字列 該当なし
title 文字列 該当なし
ソース 文字列 該当なし
ステータス 文字列 該当なし
scope 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
削除済み ブール値 該当なし
deletedAt DateTime 該当なし
modifiedAt DateTime 該当なし
publishedAt DateTime 該当なし
tags リスト 該当なし
カテゴリ リスト 該当なし
knowledgeBases リスト 該当なし
metaTitle 文字列 該当なし
metaDescription 文字列 該当なし
metaKeywords リスト 該当なし
langVersions Struct 該当なし
latestLangs Struct 該当なし
KB Categories id 文字列 該当なし
ハッシュ 文字列 該当なし
createdAt DateTime 該当なし
modifiedAt DateTime 該当なし
updatedAt DateTime 該当なし
published ブール値 該当なし
positions リスト 該当なし
categoryPositions リスト 該当なし
ルート ブール値 該当なし
langs Struct 該当なし
KB Forms id 文字列 該当なし
名前 文字列 該当なし
slug 文字列 該当なし
ハッシュ 文字列 該当なし
本文 文字列 該当なし
layout リスト 該当なし
layoutV2 リスト 該当なし
componentsV2 Struct 該当なし
条件 Struct 該当なし
advanced ブール値 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
publishedAt DateTime 該当なし
modifiedAt 文字列 該当なし
published ブール値 該当なし
snippets リスト 該当なし
recaptcha ブール値 該当なし
klass 文字列 該当なし
チャンネル 文字列 該当なし
deflection ブール値 該当なし
formHookEnabled ブール値 該当なし
replyFrom 文字列 該当なし
wcag ブール値 該当なし
KB Routes id 文字列 該当なし
url 文字列 該当なし
routableType 文字列 該当なし
routableId 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
KB Tags id 文字列 該当なし
名前 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
KB Templates id 文字列 該当なし
title 文字列 該当なし
description 文字列 該当なし
beta ブール値 該当なし
マニフェスト Struct 該当なし
jsxSnippets リスト 該当なし
画像 リスト 該当なし
version 文字列 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
KB Themes id 文字列 該当なし
名前 文字列 該当なし
ACTIVE ブール値 該当なし
デフォルト ブール値 該当なし
lastfileUpdatedAt DateTime 該当なし
カスタム ブール値 該当なし
ステータス 文字列 該当なし
templateVersionId 文字列 該当なし
templateTitle 文字列 該当なし
templateVersion 文字列 該当なし
マニフェスト Struct 該当なし
configSnippets リスト 該当なし
jsxSnippets リスト 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
rev 整数 該当なし
Klasses id 文字列 該当なし
名前 文字列 該当なし
icon 文字列 該当なし
color 文字列 該当なし
appDisabled ブール値 該当なし
ステータス 文字列 該当なし
updatedAt DateTime 該当なし
createdAt DateTime 該当なし
s3DataUrl 文字列 該当なし
KViews id 文字列 該当なし
リソース 文字列 該当なし
テンプレート 文字列 該当なし
context 文字列 該当なし
meta Struct 該当なし
appDisabled ブール値 該当なし
有効 ブール値 該当なし
advanced ブール値 該当なし
layout リスト 該当なし
コンポーネント Struct 該当なし
条件 Struct 該当なし
rev 整数 該当なし
createdAt DateTime 該当なし
modifiedAt DateTime 該当なし
updatedAt DateTime 該当なし
通知 id 文字列 該当なし
名前 文字列 該当なし
ステータス 文字列 該当なし
イベント Struct 該当なし
createdAt DateTime 該当なし
updatedAt DateTime 該当なし
メッセージ id 文字列 該当なし
externalId 文字列 該当なし
チャンネル 文字列 =、!=、CONTAINS
アプリケーション 文字列 該当なし
size 整数 =, !=, >, >=, <, <=
direction 文字列 =、!=、CONTAINS
プレビュー 文字列 該当なし
subject 文字列 該当なし
meta Struct 該当なし
ステータス 文字列 =、!=、CONTAINS
directionType 文字列 =、!=、CONTAINS
assignedTeams リスト 該当なし
assignedUsers リスト 該当なし
errorAt DateTime =, !=, <, <=, >, >=, BETWEEN
自動 ブール値 =, !=
sentAt DateTime =, !=, <, <=, >, >=, BETWEEN
createdAt DateTime =, !=, <, <=, >, >=, BETWEEN
updatedAt DateTime 該当なし
modifiedAt DateTime 該当なし
redacted ブール値 該当なし
createdByTeams リスト 該当なし
rev 整数 該当なし
reactions リスト 該当なし
intentDetections リスト 該当なし
メモ id 文字列 該当なし
本文 文字列 CONTAINS
createdAt DateTime =, !=, <, <=, >, >=, BETWEEN
updatedAt DateTime =, !=, <, <=, >, >=, BETWEEN
modifiedAt DateTime =, !=, <, <=, >, >=, BETWEEN
createdByTeams リスト 該当なし

パーティショニングクエリ

フィールドベースのパーティション分割

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 整数
Customers createdAt、updatedAt、modifiedAt DateTime
メッセージ errorAt、sentAt、createdAt DateTime
size BigInteger
メモ 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"
    }