Lettura da entità Kustomer - AWS Glue
Dettagli dell'entità e del campo di KustomerQuery di partizionamento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lettura da entità Kustomer

Prerequisito

Un oggetto Kustomer da cui si desidera leggere. È necessario il nome dell'oggetto, come Marchi o Schede. Nella tabella seguente sono illustrate le entità supportate.

Entità supportate come origine:

Entità Può essere filtrato Supporta limite Supporta Ordina per Supporta Seleziona * Supporta il partizionamento
Marchi No Sì No Sì No
Schede No Sì No Sì No
Impostazioni chat No No No Sì No
Aziende Sì Sì Sì Sì Sì
Conversazioni Sì Sì Sì Sì Sì
Clienti Sì Sì Sì Sì Sì
Ricerche ancorate dei clienti No Sì No Sì No
Posizione di ricerca del cliente No No No Sì No
Hook e-mail No Sì No Sì No
Hook Web No Sì No Sì No
Articoli KB No Sì No Sì No
Categorie KB No Sì No Sì No
Moduli KB No Sì No Sì No
Percorsi KB No Sì No Sì No
Tag KB No Sì No Sì No
Modelli KB No Sì No Sì No
Temi KB No Sì No Sì No
Klasses No Sì No Sì No
KViews No Sì No Sì No
Messaggi Sì Sì Sì Sì Sì
Note Sì Sì Sì Sì Sì
Notifiche No Sì No Sì No

Esempio:

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

Dettagli dell'entità e del campo di Kustomer

Per ulteriori informazioni sui dettagli dell'entità e del campo, consultare:

API Kustomer v1

Entità Campo Tipo di dati Operatori supportati
Marchi id Stringa N/A
nome Stringa N/A
iconUrl Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
default Booleano N/D
Schede id Stringa N/A
nome Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
description Stringa N/A
url Stringa N/A
contesti Elenco N/D
Impostazioni chat id Stringa N/A
settingsVersion Numero intero N/D
widgetType Stringa N/A
version Numero intero N/D
teamName Stringa N/A
saluto Stringa N/A
autoreply Stringa N/A
embedIconUrl Stringa N/A
embedIconColor Stringa N/A
fallbackEmailSubject Stringa N/A
fallbackEmailIntroduction Stringa N/A
enabled Booleano N/D
outboundChatEnabled Booleano N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
offhoursMessage Stringa N/A
offhoursImageUrl Stringa N/A
closableChat Booleano N/D
noHistory Booleano N/D
disableAttachments Booleano N/D
volumeControl Struct N/D
singleSessonChat Booleano N/D
showTypingIndicatorWeb Booleano N/D
Aziende id Stringa N/A
nome Stringa =, !=, CONTAINS
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
tags Elenco N/D
domains Elenco N/D
e-mail Elenco N/D
telefoni Elenco N/D
whatsapp Elenco N/D
social Elenco N/D
url Elenco N/D
posizioni Elenco N/D
roleGroupVersions Elenco N/D
rev Numero intero N/D
Conversazioni id Stringa N/A
nome Stringa =, !=, CONTAINS
anteprima Stringa N/A
canali Elenco N/D
status Stringa =, !=, CONTAINS
messageCount Numero intero =, !=, >, >=, <, <=
noteCount Numero intero =, !=, >, >=, <, <=
soddisfazione Numero intero =, !=, >, >=, <, <=
satisfactionLevel Struct N/D
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastActivityAt DateTime N/D
spam Booleano N/D
terminato Booleano =, !=
endedAt DateTime =, !=, >, >=, <, <=, BETWEEN
endedReason Stringa CONTAINS
endedByType Stringa N/A
importedAt Stringa N/A
tags Elenco N/D
suggestedTags Elenco N/D
sentiment Stringa N/A
previsioni Elenco N/D
suggestedShortcuts Elenco N/D
firstMessageIn Struct N/D
firstMessageOut Struct N/D
lastMessageIn Struct N/D
lastMessageOut Struct N/D
lastMessageAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastMessageUnrespondedTo Struct N/D
lastMessageUnrespondedToSinceLastDone Struct N/D
assignedUsers Elenco N/D
assignedTeams Elenco N/D
firstResponse Struct N/D
firstResponseSinceLastDone Struct N/D
lastResponse Struct N/D
firstDone Struct N/D
lastDone Struct N/D
direzione Stringa =, !=, CONTAINS
lastMessageDirection Stringa N/A
outboundMessageCount Numero intero N/D
inboundMessageCount Numero intero N/D
rev Numero intero N/D
priority Numero intero =, !=, >, >=, <, <=
roleGroupVersions Elenco N/D
accessOverride Elenco N/D
assistente Struct N/D
fase Stringa N/A
Competenze Elenco N/D
matchedTimeBasedRules Elenco N/D
Clienti id Stringa N/A
nome Stringa =, !=, CONTAINS
displayName Stringa N/A
displayColor Stringa N/A
displayIcon Stringa N/A
externalId Stringa =, !=, CONTAINS
externalIds Elenco N/D
sharedExternalIds Elenco N/D
e-mail Elenco N/D
sharedEmails Elenco N/D
telefoni Elenco N/D
sharedPhones Elenco N/D
whatsapp Elenco N/D
facebookIds Elenco N/D
instagramIds Elenco N/D
social Elenco N/D
sharedSocials Elenco N/D
url Elenco N/D
posizioni Elenco N/D
activeUsers Elenco N/D
watcher Elenco N/D
recentLocation Struct N/D
locale Stringa =, !=, CONTAINS
timezone Stringa N/A
gender Stringa =, !=, CONTAINS
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
lastActivityAt DateTime N/D
deleted (eliminato) Booleano N/D
lastConversation Struct N/D
conversationCounts Struct N/D
anteprima Struct N/D
tags Elenco N/D
progressiveStatus Stringa =, !=, CONTAINS
verified Booleano N/D
rev Numero intero N/D
recentItems Elenco N/D
defaultLang Stringa =, !=, CONTAINS
satisfactionLevel Struct N/D
roleGroupVersions Elenco N/D
accessOverride Elenco N/D
companyName Stringa N/A
firstName Stringa N/A
lastName Stringa N/A
Ricerche ancorate dei clienti id Stringa N/A
Ricerca Stringa N/A
createdAt DateTime N/D
Posizione di ricerca del cliente id Stringa N/A
posizioni Elenco N/D
figli Elenco N/D
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
rev Numero intero N/D
Hook e-mail id Stringa N/A
description Stringa N/A
debug Booleano N/D
e-mail Stringa N/A
eventName Stringa N/A
titolo Stringa N/A
hash Stringa N/A
key Stringa N/A
createdAt DateTime N/D
modifiedAt DateTime N/D
updatedAt DateTime N/D
Hook Web id Stringa N/A
description Stringa N/A
eventName Stringa N/A
hash Stringa N/A
url Stringa N/A
createdAt DateTime N/D
modifiedAt DateTime N/D
updatedAt DateTime N/D
titolo Stringa N/A
version Numero intero N/D
debug Booleano N/D
Articoli KB id Stringa N/A
hash Stringa N/A
titolo Stringa N/A
source Stringa N/A
status Stringa N/A
scope Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
deleted (eliminato) Booleano N/D
deletedAt DateTime N/D
modifiedAt DateTime N/D
publishedAt DateTime N/D
tags Elenco N/D
categorie Elenco N/D
knowledgeBases Elenco N/D
metaTitle Stringa N/A
metaDescription Stringa N/A
metaKeywords Elenco N/D
langVersions Struct N/D
latestLangs Struct N/D
Categorie KB id Stringa N/A
hash Stringa N/A
createdAt DateTime N/D
modifiedAt DateTime N/D
updatedAt DateTime N/D
pubblicato Booleano N/D
posizioni Elenco N/D
categoryPositions Elenco N/D
root Booleano N/D
langs Struct N/D
Moduli KB id Stringa N/A
nome Stringa N/A
slug Stringa N/A
hash Stringa N/A
body Stringa N/A
layout Elenco N/D
layoutV2 Elenco N/D
componentsV2 Struct N/D
condizioni Struct N/D
avanzato Booleano N/D
createdAt DateTime N/D
updatedAt DateTime N/D
publishedAt DateTime N/D
modifiedAt Stringa N/A
pubblicato Booleano N/D
frammenti Elenco N/D
recaptcha Booleano N/D
klass Stringa N/A
canale Stringa N/A
deflection Booleano N/D
formHookEnabled Booleano N/D
replyFrom Stringa N/A
wcag Booleano N/D
Percorsi KB id Stringa N/A
url Stringa N/A
routableType Stringa N/A
routableId Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
Tag KB id Stringa N/A
nome Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
Modelli KB id Stringa N/A
titolo Stringa N/A
description Stringa N/A
beta Booleano N/D
manifest Struct N/D
jsxSnippets Elenco N/D
images Elenco N/D
version Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
Temi KB id Stringa N/A
nome Stringa N/A
attiva Booleano N/D
default Booleano N/D
lastfileUpdatedAt DateTime N/D
personalizzato Booleano N/D
status Stringa N/A
templateVersionId Stringa N/A
templateTitle Stringa N/A
templateVersion Stringa N/A
manifest Struct N/D
configSnippets Elenco N/D
jsxSnippets Elenco N/D
createdAt DateTime N/D
updatedAt DateTime N/D
modifiedAt DateTime N/D
rev Numero intero N/D
Klasses id Stringa N/A
nome Stringa N/A
icon Stringa N/A
color Stringa N/A
appDisabled Booleano N/D
status Stringa N/A
updatedAt DateTime N/D
createdAt DateTime N/D
s3DataUrl Stringa N/A
KViews id Stringa N/A
risorsa Stringa N/A
modello Stringa N/A
context Stringa N/A
meta Struct N/D
appDisabled Booleano N/D
enabled Booleano N/D
avanzato Booleano N/D
layout Elenco N/D
componenti Struct N/D
condizioni Struct N/D
rev Numero intero N/D
createdAt DateTime N/D
modifiedAt DateTime N/D
updatedAt DateTime N/D
Notifiche id Stringa N/A
nome Stringa N/A
status Stringa N/A
evento Struct N/D
createdAt DateTime N/D
updatedAt DateTime N/D
Messaggi id Stringa N/A
externalId Stringa N/A
canale Stringa =, !=, CONTAINS
app Stringa N/A
formato Numero intero =, !=, >, >=, <, <=
direzione Stringa =, !=, CONTAINS
anteprima Stringa N/A
subject Stringa N/A
meta Struct N/D
status Stringa =, !=, CONTAINS
directionType Stringa =, !=, CONTAINS
assignedTeams Elenco N/D
assignedUsers Elenco N/D
errorAt DateTime =, !=, >, >=, <, <=, BETWEEN
auto Booleano =, !=
sentAt DateTime =, !=, >, >=, <, <=, BETWEEN
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime N/D
modifiedAt DateTime N/D
redatto Booleano N/D
createdByTeams Elenco N/D
rev Numero intero N/D
reazioni Elenco N/D
intentDetections Elenco N/D
Note id Stringa N/A
body Stringa CONTAINS
createdAt DateTime =, !=, >, >=, <, <=, BETWEEN
updatedAt DateTime =, !=, >, >=, <, <=, BETWEEN
modifiedAt DateTime =, !=, >, >=, <, <=, BETWEEN
createdByTeams Elenco N/D

Query di partizionamento

Partizionamento basato sul campo

Puoi fornire le opzioni Spark aggiuntive PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS se desideri utilizzare la concorrenza in Spark. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.

  • PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.

  • LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

    Per il campo DateTime, accettiamo il valore in formato ISO.

    Esempio di valore valido:

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

  • UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  • NUM_PARTITIONS: il numero di partizioni.

I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella seguente:

Nome dell'entità Campi di partizionamento Tipo di dati
Aziende modifiedAt DateTime
Conversazioni createdAt, updatedAt, modifiedAt, endedAt, lastMessageAt DateTime
messageCount, noteCount BigInteger
priority Numero intero
Clienti createdAt, updatedAt, modifiedAt DateTime
Messaggi errorAt, sentAt, createdAt DateTime
formato BigInteger
Note createdAt, updatedAt, modifiedAt DateTime

Esempio:

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