Lesen aus Kustomer-Entitäten - AWS Glue
Kustomer-Entitäts- und FelddetailsPartitionieren von Abfragen

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 Kustomer-Entitäten

Voraussetzung

Ein Kustomer-Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen wie Marken oder Karten. Die folgende Tabelle zeigt die unterstützten Entitäten.

Unterstützte Entitäten für Quelle:

Entität Kann gefiltert werden Unterstützt Limit Unterstützt „Sortieren nach“ Unterstützt „* auswählen“ Unterstützt Partitionierung
Marken Nein Ja Nein Ja Nein
Karten Nein Ja Nein Ja Nein
Chat-Einstellungen Nein Nein Nein Ja Nein
Unternehmen Ja Ja Ja Ja Ja
Konversationen Ja Ja Ja Ja Ja
Kunden Ja Ja Ja Ja Ja
Kundensuchanfragen angeheftet Nein Ja Nein Ja Nein
Kundensuchanfragen Position Nein Nein Nein Ja Nein
E-Mail-Hooks Nein Ja Nein Ja Nein
Web-Hooks Nein Ja Nein Ja Nein
KB-Artikel Nein Ja Nein Ja Nein
KB-Kategorien Nein Ja Nein Ja Nein
KB-Formulare Nein Ja Nein Ja Nein
KB-Routen Nein Ja Nein Ja Nein
KB-Tags Nein Ja Nein Ja Nein
KB-Vorlagen Nein Ja Nein Ja Nein
KB-Themes Nein Ja Nein Ja Nein
Klassen Nein Ja Nein Ja Nein
KViews Nein Ja Nein Ja Nein
Nachrichten Ja Ja Ja Ja Ja
Hinweise Ja Ja Ja Ja Ja
Benachrichtigungen Nein Ja Nein Ja Nein

Beispiel:

Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "brands",
        "API_VERSION": "v1"
    }

Kustomer-Entitäts- und Felddetails

Weitere Informationen zu den Entitäten und Felddetails finden Sie unter:

Kustomer-API v1

Entität Feld Datentyp Unterstützte Operatoren
Marken id Zeichenfolge –
Name Zeichenfolge –
iconUrl Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
default Boolesch –
Karten id Zeichenfolge –
Name Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
description Zeichenfolge –
URL Zeichenfolge –
contexts Auflisten –
Chat-Einstellungen id Zeichenfolge –
settingsVersion Ganzzahl –
widgetType Zeichenfolge –
version Ganzzahl –
teamName Zeichenfolge –
greeting Zeichenfolge –
autoreply Zeichenfolge –
embedIconUrl Zeichenfolge –
embedIconColor Zeichenfolge –
fallbackEmailSubject Zeichenfolge –
fallbackEmailIntroduction Zeichenfolge –
aktiviert Boolesch –
outboundChatEnabled Boolesch –
updatedAt DateTime –
modifiedAt DateTime –
offhoursMessage Zeichenfolge –
offhoursImageUrl Zeichenfolge –
closableChat Boolesch –
noHistory Boolesch –
disableAttachments Boolesch –
volumeControl Struct –
singleSessonChat Boolesch –
showTypingIndicatorNetz Boolesch –
Unternehmen id Zeichenfolge –
Name Zeichenfolge =, !=, CONTAINS
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
tags Auflisten –
domains Auflisten –
emails Auflisten –
phones Auflisten –
whatsapps Auflisten –
socials Auflisten –
urls Auflisten –
locations Auflisten –
roleGroupVersions Auflisten –
rev Ganzzahl –
Konversationen id Zeichenfolge –
Name Zeichenfolge =, !=, CONTAINS
preview Zeichenfolge –
Kanäle Auflisten –
Status Zeichenfolge =, !=, CONTAINS
messageCount Ganzzahl =, !=, >, >=, <, <=
noteCount Ganzzahl =, !=, >, >=, <, <=
satisfaction Ganzzahl =, !=, >, >=, <, <=
satisfactionLevel Struct –
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastActivityAt DateTime –
Spam Boolesch –
ended Boolesch =, !=
endedAt DateTime =, !=, >, >=, <, <=, BETWEEN
endedReason Zeichenfolge CONTAINS
endedByType Zeichenfolge –
importedAt Zeichenfolge –
tags Auflisten –
suggestedTags Auflisten –
sentiment Zeichenfolge –
Voraussagen Auflisten –
suggestedShortcuts Auflisten –
firstMessageIn Struct –
firstMessageOut Struct –
lastMessageIn Struct –
lastMessageOut Struct –
lastMessageAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastMessageUnrespondedZu Struct –
lastMessageUnrespondedToSinceLastDone Struct –
assignedUsers Auflisten –
assignedTeams Auflisten –
firstResponse Struct –
firstResponseSinceLastDone Struct –
lastResponse Struct –
firstDone Struct –
lastDone Struct –
direction Zeichenfolge =, !=, CONTAINS
lastMessageDirection Zeichenfolge –
outboundMessageCount Ganzzahl –
inboundMessageCount Ganzzahl –
rev Ganzzahl –
priority Ganzzahl =, !=, >, >=, <, <=
roleGroupVersions Auflisten –
accessOverride Auflisten –
assistant Struct –
phase Zeichenfolge –
Fähigkeiten Auflisten –
matchedTimeBasedRegeln Auflisten –
Kunden id Zeichenfolge –
Name Zeichenfolge =, !=, CONTAINS
displayName Zeichenfolge –
displayColor Zeichenfolge –
displayIcon Zeichenfolge –
externalId Zeichenfolge =, !=, CONTAINS
externalIds Auflisten –
sharedExternalIds Auflisten –
emails Auflisten –
sharedEmails Auflisten –
phones Auflisten –
sharedPhones Auflisten –
whatsapps Auflisten –
facebookIds Auflisten –
instagramIds Auflisten –
socials Auflisten –
sharedSocials Auflisten –
urls Auflisten –
locations Auflisten –
activeUsers Auflisten –
watchers Auflisten –
recentLocation Struct –
locale Zeichenfolge =, !=, CONTAINS
timeZone Zeichenfolge –
gender Zeichenfolge =, !=, CONTAINS
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastActivityAt DateTime –
deleted Boolesch –
lastConversation Struct –
conversationCounts Struct –
preview Struct –
tags Auflisten –
progressiveStatus Zeichenfolge =, !=, CONTAINS
verified Boolesch –
rev Ganzzahl –
recentItems Auflisten –
defaultLang Zeichenfolge =, !=, CONTAINS
satisfactionLevel Struct –
roleGroupVersions Auflisten –
accessOverride Auflisten –
companyName Zeichenfolge –
firstName Zeichenfolge –
lastName Zeichenfolge –
Kundensuchanfragen angeheftet id Zeichenfolge –
search Zeichenfolge –
createdAt DateTime –
Kundensuchanfragen Positionen id Zeichenfolge –
positions Auflisten –
children Auflisten –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
rev Ganzzahl –
E-Mail-Hooks id Zeichenfolge –
description Zeichenfolge –
debug Boolesch –
E-Mail Zeichenfolge –
eventName Zeichenfolge –
Titel Zeichenfolge –
hash Zeichenfolge –
Schlüssel Zeichenfolge –
createdAt DateTime –
modifiedAt DateTime –
updatedAt DateTime –
Web-Hooks id Zeichenfolge –
description Zeichenfolge –
eventName Zeichenfolge –
hash Zeichenfolge –
URL Zeichenfolge –
createdAt DateTime –
modifiedAt DateTime –
updatedAt DateTime –
Titel Zeichenfolge –
version Ganzzahl –
debug Boolesch –
KB-Artikel id Zeichenfolge –
hash Zeichenfolge –
Titel Zeichenfolge –
Quelle Zeichenfolge –
Status Zeichenfolge –
scope Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
deleted Boolesch –
deletedAt DateTime –
modifiedAt DateTime –
publishedAt DateTime –
tags Auflisten –
categories Auflisten –
knowledgeBases Auflisten –
metaTitle Zeichenfolge –
metaDescription Zeichenfolge –
metaKeywords Auflisten –
langVersions Struct –
latestLangs Struct –
KB-Kategorien id Zeichenfolge –
hash Zeichenfolge –
createdAt DateTime –
modifiedAt DateTime –
updatedAt DateTime –
published Boolesch –
positions Auflisten –
categoryPositions Auflisten –
Root Boolesch –
langs Struct –
KB-Formulare id Zeichenfolge –
Name Zeichenfolge –
slug Zeichenfolge –
hash Zeichenfolge –
body Zeichenfolge –
layout Auflisten –
layoutV2 Auflisten –
componentsV2 Struct –
conditions Struct –
advanced Boolesch –
createdAt DateTime –
updatedAt DateTime –
publishedAt DateTime –
modifiedAt Zeichenfolge –
published Boolesch –
snippets Auflisten –
recaptcha Boolesch –
klass Zeichenfolge –
channel Zeichenfolge –
deflection Boolesch –
formHookEnabled Boolesch –
replyFrom Zeichenfolge –
wcag Boolesch –
KB-Routen id Zeichenfolge –
URL Zeichenfolge –
routableType Zeichenfolge –
routableId Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
KB-Tags id Zeichenfolge –
Name Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
KB-Vorlagen id Zeichenfolge –
Titel Zeichenfolge –
description Zeichenfolge –
beta Boolesch –
Manifest Struct –
jsxSnippets Auflisten –
images Auflisten –
version Zeichenfolge –
createdAt DateTime –
updatedAt DateTime –
KB-Themes id Zeichenfolge –
Name Zeichenfolge –
aktiv Boolesch –
default Boolesch –
lastfileUpdatedAt DateTime –
benutzerdefiniert Boolesch –
Status Zeichenfolge –
templateVersionId Zeichenfolge –
templateTitle Zeichenfolge –
templateVersion Zeichenfolge –
Manifest Struct –
configSnippets Auflisten –
jsxSnippets Auflisten –
createdAt DateTime –
updatedAt DateTime –
modifiedAt DateTime –
rev Ganzzahl –
Klassen id Zeichenfolge –
Name Zeichenfolge –
icon Zeichenfolge –
color Zeichenfolge –
appDisabled Boolesch –
Status Zeichenfolge –
updatedAt DateTime –
createdAt DateTime –
s3 DataUrl Zeichenfolge –
KViews id Zeichenfolge –
Ressource Zeichenfolge –
Vorlage Zeichenfolge –
context Zeichenfolge –
meta Struct –
appDisabled Boolesch –
aktiviert Boolesch –
advanced Boolesch –
layout Auflisten –
components Struct –
conditions Struct –
rev Ganzzahl –
createdAt DateTime –
modifiedAt DateTime –
updatedAt DateTime –
Benachrichtigungen id Zeichenfolge –
Name Zeichenfolge –
Status Zeichenfolge –
event Struct –
createdAt DateTime –
updatedAt DateTime –
Nachrichten id Zeichenfolge –
externalId Zeichenfolge –
channel Zeichenfolge =, !=, CONTAINS
App Zeichenfolge –
size Ganzzahl =, !=, >, >=, <, <=
direction Zeichenfolge =, !=, CONTAINS
preview Zeichenfolge –
subject Zeichenfolge –
meta Struct –
Status Zeichenfolge =, !=, CONTAINS
directionType Zeichenfolge =, !=, CONTAINS
assignedTeams Auflisten –
assignedUsers Auflisten –
errorAt DateTime =, !=, >, >=, <, <=, BETWEEN
auto Boolesch =, !=
sentAt DateTime =, !=, >, >=, <, <=, BETWEEN
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime –
modifiedAt DateTime –
redacted Boolesch –
createdByTeams Auflisten –
rev Ganzzahl –
reactions Auflisten –
intentDetections Auflisten –
Hinweise id Zeichenfolge –
body Zeichenfolge CONTAINS
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
createdByTeams Auflisten –

Partitionieren von Abfragen

Feldbasierte Partitionierung

Sie können die zusätzlichen Spark-Optionen PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND und NUM_PARTITIONS angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird 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.

    Für das DateTime Feld akzeptieren wir den Wert im ISO-Format.

    Beispiel für gültigen Wert:

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

  • UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.

  • NUM_PARTITIONS: Die Anzahl an Partitionen.

Details zur Unterstützung von Feldern für die entitätsbezogene Partitionierung sind in der folgenden Tabelle aufgeführt.

Entitätsname Partitionieren von Feldern Datentyp
Unternehmen modifiedAt DateTime
Konversationen createdAt, updatedAt, GeändertAm, EndDatum, lastMessageAt DateTime
messageCount, noteCount BigInteger
priority Ganzzahl
Kunden createdAt, updatedAt, modifiedAt DateTime
Nachrichten errorAt, sentAt, createdAt DateTime
size BigInteger
Hinweise createdAt, updatedAt, modifiedAt DateTime

Beispiel:

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"
    }