選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料，以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用，但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意，AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定，並顯示相關內容，包括相關廣告。若要接受或拒絕所有非必要 Cookie，請按一下「接受」或「拒絕」。若要進行更詳細的選擇，請按一下「自訂」。

偏好設定
聯絡我們
意見回饋
AWS Documentation
建立 AWS 帳戶

從 Kustomer 實體讀取

PDF
RSS
焦點模式
從 Kustomer 實體讀取 - AWS Glue
Kustomer 實體和欄位詳細資訊分割查詢

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

必要條件

您想要讀取的 Kustomer 物件。您需要物件名稱，例如品牌或卡片。下表顯示支援的實體。

來源支援的實體：

實體 可以篩選 支援限制 支援 的訂單 支援選取 * 支援分割
品牌 否 是 否 是 否
卡 否 是 否 是 否
聊天設定 否 否 否 是 否
公司 是 是 是 是 是
對話 是 是 是 是 是
客戶 是 是 是 是 是
客戶搜尋固定 否 是 否 是 否
客戶搜尋位置 否 否 否 是 否
電子郵件勾點 否 是 否 是 否
Web 勾點 否 是 否 是 否
KB 文章 否 是 否 是 否
KB 類別 否 是 否 是 否
KB 表單 否 是 否 是 否
KB 路由 否 是 否 是 否
KB 標籤 否 是 否 是 否
KB 範本 否 是 否 是 否
KB 主題 否 是 否 是 否
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

實體 欄位 資料類型 支援的運算子
品牌 id 字串 N/A
name 字串 N/A
iconUrl 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
預設 Boolean N/A
卡 id 字串 N/A
name 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
描述 字串 N/A
url 字串 N/A
內容 清單 N/A
聊天設定 id 字串 N/A
settingsVersion Integer N/A
widgetType 字串 N/A
version Integer N/A
teamName 字串 N/A
問候語 字串 N/A
自動回應 字串 N/A
embedIconUrl 字串 N/A
embedIconColor 字串 N/A
fallbackEmailSubject 字串 N/A
fallbackEmailIntroduction 字串 N/A
啟用 Boolean N/A
outboundChatEnabled Boolean N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
offhoursMessage 字串 N/A
offhoursImageUrl 字串 N/A
closableChat Boolean N/A
noHistory Boolean N/A
disableAttachments Boolean N/A
volumeControl Struct N/A
singleSessonChat Boolean N/A
showTypingIndicatorWeb Boolean N/A
公司 id 字串 N/A
name 字串 =、！=、ConTAINS
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime =、！=、＞、>=、＜、<=、介於
標籤 清單 N/A
domains 清單 N/A
電子郵件 清單 N/A
電話 清單 N/A
Whatsapps 清單 N/A
社交 清單 N/A
URL 清單 N/A
位置 清單 N/A
roleGroupVersions 清單 N/A
修訂版 Integer N/A
對話 id 字串 N/A
name 字串 =、！=、ConTAINS
預覽 字串 N/A
頻道 清單 N/A
status 字串 =、！=、ConTAINS
messageCount Integer =, !=, >, >=, <, <=
noteCount Integer =, !=, >, >=, <, <=
滿意度 Integer =, !=, >, >=, <, <=
satisfactionLevel Struct N/A
createdAt DateTime =、！=、＞、>=、＜、<=、介於
updatedAt DateTime =、！=、＞、>=、＜、<=、介於
modifiedAt DateTime =、！=、＞、>=、＜、<=、介於
lastActivityAt DateTime N/A
垃圾郵件 Boolean N/A
已結束 Boolean =, !=
endedAt DateTime =、！=、＞、>=、＜、<=、介於
endedReason 字串 CONTAINS
endedByType 字串 N/A
importedAt 字串 N/A
標籤 清單 N/A
suggestedTags 清單 N/A
sentiment 字串 N/A
預測 清單 N/A
suggestedShortcuts 清單 N/A
firstMessageIn Struct N/A
firstMessageOut Struct N/A
lastMessageIn Struct N/A
lastMessageOut Struct N/A
lastMessageAt DateTime =、！=、＞、>=、＜、<=、介於
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
方向 字串 =、！=、ConTAINS
lastMessageDirection 字串 N/A
outboundMessageCount Integer N/A
inboundMessageCount Integer N/A
修訂版 Integer N/A
priority Integer =, !=, >, >=, <, <=
roleGroupVersions 清單 N/A
accessOverride 清單 N/A
助理 Struct N/A
階段 字串 N/A
技能 清單 N/A
matchedTimeBasedRules 清單 N/A
客戶 id 字串 N/A
name 字串 =、！=、ConTAINS
displayName 字串 N/A
displayColor 字串 N/A
displayIcon 字串 N/A
externalId 字串 =、！=、ConTAINS
externalIds 清單 N/A
sharedExternalIds 清單 N/A
電子郵件 清單 N/A
sharedEmails 清單 N/A
電話 清單 N/A
sharedPhones 清單 N/A
Whatsapps 清單 N/A
facebookIds 清單 N/A
instagramIds 清單 N/A
社交 清單 N/A
sharedSocials 清單 N/A
URL 清單 N/A
位置 清單 N/A
activeUsers 清單 N/A
監看器 清單 N/A
recentLocation Struct N/A
locale 字串 =、！=、ConTAINS
timeZone 字串 N/A
gender 字串 =、！=、ConTAINS
createdAt DateTime =、！=、＞、>=、＜、<=、介於
updatedAt DateTime =、！=、＞、>=、＜、<=、介於
modifiedAt DateTime =、！=、＞、>=、＜、<=、介於
lastActivityAt DateTime N/A
已刪除 Boolean N/A
lastConversation Struct N/A
conversationCounts Struct N/A
預覽 Struct N/A
標籤 清單 N/A
progressiveStatus 字串 =、！=、ConTAINS
verified Boolean N/A
修訂版 Integer N/A
recentItems 清單 N/A
defaultLang 字串 =、！=、ConTAINS
satisfactionLevel Struct N/A
roleGroupVersions 清單 N/A
accessOverride 清單 N/A
companyName 字串 N/A
firstName 字串 N/A
lastName 字串 N/A
客戶搜尋固定 id 字串 N/A
search 字串 N/A
createdAt DateTime N/A
客戶搜尋位置 id 字串 N/A
位置 清單 N/A
子系 清單 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
修訂版 Integer N/A
電子郵件勾點 id 字串 N/A
描述 字串 N/A
偵錯 Boolean N/A
email 字串 N/A
eventName 字串 N/A
標題 字串 N/A
hash 字串 N/A
金鑰 字串 N/A
createdAt DateTime N/A
modifiedAt DateTime N/A
updatedAt DateTime N/A
Web 勾點 id 字串 N/A
描述 字串 N/A
eventName 字串 N/A
hash 字串 N/A
url 字串 N/A
createdAt DateTime N/A
modifiedAt DateTime N/A
updatedAt DateTime N/A
標題 字串 N/A
version Integer N/A
偵錯 Boolean N/A
KB 文章 id 字串 N/A
hash 字串 N/A
標題 字串 N/A
source 字串 N/A
status 字串 N/A
scope 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
已刪除 Boolean N/A
deletedAt DateTime N/A
modifiedAt DateTime N/A
publishedAt DateTime N/A
標籤 清單 N/A
categories 清單 N/A
knowledgeBases 清單 N/A
metaTitle 字串 N/A
metaDescription 字串 N/A
metaKeywords 清單 N/A
langVersions Struct N/A
latestLangs Struct N/A
KB 類別 id 字串 N/A
hash 字串 N/A
createdAt DateTime N/A
modifiedAt DateTime N/A
updatedAt DateTime N/A
已發佈 Boolean N/A
位置 清單 N/A
categoryPositions 清單 N/A
根 Boolean N/A
語言 Struct N/A
KB 表單 id 字串 N/A
name 字串 N/A
slug 字串 N/A
hash 字串 N/A
本文 字串 N/A
配置 清單 N/A
layoutV2 清單 N/A
componentsV2 Struct N/A
條件 Struct N/A
進階 Boolean N/A
createdAt DateTime N/A
updatedAt DateTime N/A
publishedAt DateTime N/A
modifiedAt 字串 N/A
已發佈 Boolean N/A
程式碼片段 清單 N/A
recaptcha Boolean N/A
klass 字串 N/A
通道 字串 N/A
偏轉 Boolean N/A
formHookEnabled Boolean N/A
replyFrom 字串 N/A
wcag Boolean N/A
KB 路由 id 字串 N/A
url 字串 N/A
routableType 字串 N/A
routableId 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
KB 標籤 id 字串 N/A
name 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
KB 範本 id 字串 N/A
標題 字串 N/A
描述 字串 N/A
Beta 版 Boolean N/A
資訊清單 Struct N/A
jsxSnippets 清單 N/A
images 清單 N/A
version 字串 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
KB 主題 id 字串 N/A
name 字串 N/A
active Boolean N/A
預設 Boolean N/A
lastfileUpdatedAt DateTime N/A
自訂 Boolean N/A
status 字串 N/A
templateVersionId 字串 N/A
templateTitle 字串 N/A
templateVersion 字串 N/A
資訊清單 Struct N/A
configSnippets 清單 N/A
jsxSnippets 清單 N/A
createdAt DateTime N/A
updatedAt DateTime N/A
modifiedAt DateTime N/A
修訂版 Integer N/A
Klasses id 字串 N/A
name 字串 N/A
icon 字串 N/A
color 字串 N/A
appDisabled Boolean N/A
status 字串 N/A
updatedAt DateTime N/A
createdAt DateTime N/A
s3DataUrl 字串 N/A
KViews id 字串 N/A
資源 字串 N/A
template 字串 N/A
context 字串 N/A
中繼 Struct N/A
appDisabled Boolean N/A
啟用 Boolean N/A
進階 Boolean N/A
配置 清單 N/A
元件 Struct N/A
條件 Struct N/A
修訂版 Integer N/A
createdAt DateTime N/A
modifiedAt DateTime N/A
updatedAt DateTime N/A
通知 id 字串 N/A
name 字串 N/A
status 字串 N/A
事件 Struct N/A
createdAt DateTime N/A
updatedAt DateTime N/A
訊息 id 字串 N/A
externalId 字串 N/A
通道 字串 =、！=、ConTAINS
應用程式 字串 N/A
size Integer =, !=, >, >=, <, <=
方向 字串 =、！=、ConTAINS
預覽 字串 N/A
subject 字串 N/A
中繼 Struct N/A
status 字串 =、！=、ConTAINS
directionType 字串 =、！=、ConTAINS
assignedTeams 清單 N/A
assignedUsers 清單 N/A
errorAt DateTime =、！=、＞、>=、＜、<=、介於
auto Boolean =, !=
sentAt DateTime =、！=、＞、>=、＜、<=、介於
createdAt DateTime =、！=、＞、>=、＜、<=、介於
updatedAt DateTime N/A
modifiedAt DateTime N/A
已修訂 Boolean N/A
createdByTeams 清單 N/A
修訂版 Integer N/A
反應 清單 N/A
intentDetections 清單 N/A
備註 id 字串 N/A
本文 字串 CONTAINS
createdAt DateTime =、！=、＞、>=、＜、<=、介於
updatedAt DateTime =、！=、＞、>=、＜、<=、介於
modifiedAt DateTime =、！=、＞、>=、＜、<=、介於
createdByTeams 清單 N/A

分割查詢

欄位型分割

如果您想要NUM_PARTITIONS在 Spark 中使用並行PARTITION_FIELD，您可以提供其他 Spark 選項 LOWER_BOUNDUPPER_BOUND、、 和 。透過這些參數，原始查詢會分割為 Spark 任務可同時執行的子查詢NUM_PARTITIONS數目。

  • PARTITION_FIELD：用於分割查詢的欄位名稱。

  • LOWER_BOUND：所選分割區欄位的包含下限值。

    對於 DateTime 欄位，我們接受 ISO 格式的值。

    有效值的範例：

    "2023-01-15T11:18:39.205Z"

  • UPPER_BOUND：所選分割區欄位的專屬上限值。

  • NUM_PARTITIONS：分割區的數量。

下表會擷取實體分割欄位支援詳細資訊：

實體名稱 分割欄位 資料類型
公司 modifiedAt DateTime
對話 createdAt、updatedAt、modifiedAt、endedAt、lastMessageAt DateTime
messageCount， noteCount BigInteger
priority Integer
客戶 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"
    }

在本頁面

Related resources

AWS Glue DataBrew 開發人員指南
AWS CLI 的 命令 AWS Glue
SDK 與工具 

Related resources

AWS Glue DataBrew 開發人員指南
AWS CLI 的 命令 AWS Glue
SDK 與工具 
隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。