I guardrail sono soglie che guidano l’utilizzo dei dati e del sistema, l’ottimizzazione delle prestazioni e la prevenzione di errori o risultati imprevisti in Adobe Experience Platform.
In questo documento vengono indicati i limiti di utilizzo predefiniti per i dati di Query Service, che consentono di ottimizzare le prestazioni del sistema durante l’esecuzione di query sui dati in relazione ai diritti di licenza.
Prima di continuare con questo documento, è necessario avere una buona conoscenza delle definizioni e delle funzionalità chiave di Query Service. Sono descritti di seguito:
Query ad hoc: per l’esecuzione SELECT
query per esplorare, sperimentare e convalidare i dati in cui i risultati delle query non sono archiviati nel data lake.
Query batch: per l’esecuzione INSERT TABLE AS SELECT
e CREATE TABLE AS SELECT
query per pulire, modellare, manipolare e arricchire i dati. I risultati di queste query sono archiviati nel data lake. La metrica per misurare il consumo di questa funzionalità è costituita dalle ore di calcolo.
Utenti Query Service: gli utenti di Query Service forniti con la licenza corrente per Customer Journey Analytics, Adobe Real-time Customer Data Platform e/o Adobe Journey Optimizer possono essere utilizzati anche con Data Distiller. Gli utenti di Query Service sono condivisi tra le varie funzionalità.
Utenti ad hoc: gli utenti ad hoc sono quelli che eseguono query ad hoc.
Utenti batch: gli utenti batch sono quelli che eseguono query batch.
API di reporting: API per effettuare chiamate di recupero dati (internamente o esternamente). I modelli dati per rapporti estesi sono derivati dai modelli dati nativi per rapporti in Adobe Experience Platform, ad esempio il modello dati delle dashboard di Real-Time CDP.
L’illustrazione seguente riepiloga il modo in cui le funzionalità di Query Service sono attualmente incluse in pacchetti e concesse in licenza:
In questo documento sono disponibili due tipi di limiti predefiniti:
Limite morbido: è possibile superare un limite non vincolante; tuttavia, i limiti non permanenti forniscono una linea guida consigliata per le prestazioni del sistema.
Limite rigido: un limite rigido fornisce un massimo assoluto.
I limiti predefiniti descritti in questo documento vengono costantemente migliorati. Controlla regolarmente se ci sono aggiornamenti.
Le tabelle seguenti forniscono i limiti di guardrail e le descrizioni consigliati per l’esecuzione di query quando si utilizza un particolare modello di query.
Query ad hoc
Guardrail | Limite | Tipo di limite | Descrizione |
---|---|---|---|
Tempo massimo di esecuzione | 10 minuti | Rigido | Definisce il tempo massimo di output per una query SQL ad hoc. Il superamento del limite di tempo per restituire un risultato genera il codice di errore 53400. |
Utenti di Concurrent Query Service |
|
Rigido | Questo definisce quanti utenti possono creare sessioni simultaneamente per una particolare organizzazione. Se viene superato il limite di concorrenza, l’utente riceve un’e-mail Session Limit Reached errore. |
Concorrenza query |
|
Rigido | Definisce quante query possono essere eseguite contemporaneamente per una particolare organizzazione. Se viene superato il limite di concorrenza, le query vengono messe in coda. |
Connettore client e limite di output dei risultati | Connettore client
|
Rigido | Il risultato di una query può essere ricevuto nei modi seguenti:
LIMIT 5 , LIMIT 10 e così via. |
Risultati restituiti tramite | Interfaccia utente client | N/D | Definisce il modo in cui i risultati vengono resi disponibili agli utenti. |
Query batch
Guardrail | Limite | Tipo di limite | Descrizione |
---|---|---|---|
Tempo massimo di esecuzione | 24 ore | Rigido | Definisce il tempo massimo di esecuzione per una query SQL batch. Il tempo di elaborazione di una query dipende dal volume di dati da elaborare e dalla complessità della query. |
Utenti del servizio di query simultanee per batch non pianificato |
|
Rigido | Per le query batch non pianificate (ad esempio le query CTAS/ITAS in modalità interattiva), questo definisce quanti utenti possono creare sessioni simultaneamente per una particolare organizzazione. Se viene superato il limite di concorrenza, l’utente riceve un’e-mail Session Limit Reached errore. |
Utenti di Query Service simultanei per batch pianificato | Nessun limite utente | N/D | Le query batch pianificate sono processi asincroni, quindi non esistono limitazioni per gli utenti. |
Ore di calcolo per l’elaborazione dei dati in batch | Come specificato nell'ordine cliente SKU personalizzato di Adobe Experience Platform Intelligence Query del cliente | Morbido | Questo definisce la quantità di tempo computazionale nell’ambito per anno consentita a un cliente per l’esecuzione di query batch al fine di analizzare, elaborare e riscrivere i dati nel data lake. |
Concorrenza query | Supportati | N/D | Le query batch pianificate sono processi asincroni, pertanto sono supportate le query simultanee. |
Connettore client e limite di output dei risultati | Connettore client
|
Rigido | Il risultato di una query può essere reso disponibile utilizzando i metodi seguenti:
|
Risultati restituiti tramite | Set di dati | N/D | Definisce il modo in cui i risultati vengono resi disponibili agli utenti. |
La tabella seguente fornisce i limiti di guardrail e la descrizione consigliati per l’archivio query accelerato.
Guardrail | Limite | Tipo di limite | Descrizione |
---|---|---|---|
Concorrenza query | 4 | Rigido | Per garantire che le query sui dati aggregati tramite l’API di reporting (incluse le query che migliorano i modelli di dati come i modelli di dati di Real-Time CDP) dispongano delle risorse per essere eseguite in modo efficiente, l’API di reporting tiene traccia dell’utilizzo delle risorse assegnando slot di concorrenza a ogni query. Il sistema mette le query in coda e attende che gli slot di concorrenza siano disponibili o che possano essere serviti dalla cache. Sono disponibili al massimo quattro slot di query simultanei in un determinato momento. Se accedi all’API di reporting tramite uno strumento BI e hai bisogno di più concorrenza, è necessario un server BI. |
Dopo aver letto questo documento, sarai in grado di comprendere meglio i limiti predefiniti per l’esecuzione delle query con i modelli di query disponibili.
Per ulteriori informazioni su Query Service, consulta la seguente documentazione: