Query Service guida alla risoluzione dei problemi

SELECT * FROM customers LIMIT 0;

• Convertire la query in una query CTAS e pianificare l'esecuzione. La pianificazione di un'esecuzione può essere eseguita tramite l’interfaccia utente o API.
• Esegui la query su un blocco dati più piccolo applicando ulteriori condizioni di filtro.
• Esegui il comando EXPLAIN per raccogliere ulteriori dettagli.
• Esamina le statistiche dei dati all’interno del set di dati.
• Convertire la query in un modulo semplificato ed eseguirla nuovamente utilizzando dichiarazioni preparate.

• Dopo aver effettuato l’accesso all’Experience Platform, seleziona Set di dati nella navigazione a sinistra dell’interfaccia utente per passare a Set di dati dashboard.
• Set di dati Sfoglia viene visualizzata la scheda . Puoi usare la barra di ricerca per perfezionare le opzioni disponibili. Seleziona un set di dati dall’elenco visualizzato.

• La Attività set di dati viene visualizzata la schermata . Seleziona Anteprima set di dati per aprire una finestra di dialogo dello schema XDM e una visualizzazione tabulare dei dati appiattiti dal set di dati selezionato. Maggiori dettagli sono disponibili nella sezione visualizzare in anteprima la documentazione del set di dati

• Seleziona un campo qualsiasi dallo schema per visualizzarne il contenuto in una colonna appiattita. Il nome della colonna viene visualizzato sopra il relativo contenuto sul lato destro della pagina. È necessario copiare questo nome da utilizzare per eseguire query su questo set di dati.

Consulta la documentazione per maggiori informazioni come utilizzare le strutture dati nidificate utilizzando l’editor delle query o un client di terze parti.

È possibile che una query sia bloccata durante l’elaborazione per diversi motivi. Per determinare la causa esatta è necessaria un'analisi approfondita caso per caso. Contattare l'assistenza clienti di Adobe a questo processo.

Elenco completo dei numeri di telefono dell'assistenza clienti Adobi è disponibile nella pagina della guida di Adobe. In alternativa, puoi trovare la guida online completando i seguenti passaggi:

• Passa a https://www.adobe.com/ nel browser web.
• Sul lato destro della barra di navigazione superiore, seleziona Accesso.

• Utilizza il tuo Adobe ID e la password registrati con la tua licenza di Adobe.
• Seleziona Aiuto e supporto dalla barra di navigazione superiore.

Viene visualizzato un banner a discesa contenente un Aiuto e supporto sezione . Seleziona Contattaci per aprire Adobe Customer Care Virtual Assistant o selezionare Supporto aziendale per un aiuto dedicato alle grandi organizzazioni.

Consulta la sezione documentazione relativa al blocco anonimo per ulteriori dettagli.

1. Utilizza una combinazione di Funzioni definite dall'Adobe per identificare se le esigenze del caso d’uso sono soddisfatte.
2. Se il suggerimento precedente non soddisfa il caso d’uso, è necessario utilizzare una combinazione di funzioni della finestra. Le funzioni finestra visualizzano tutti gli eventi in una sequenza. Consentono inoltre di rivedere i dati storici e possono essere utilizzati in qualsiasi combinazione.

Utilizzare il comando GET per recuperare più query. Le informazioni su come effettuare una chiamata all’API sono disponibili nella sezione documentazione di esempio sulle chiamate API.

Dalla risposta, identifica la query da esaminare ed effettua un’altra richiesta di GET utilizzando la relativa id valore. Le istruzioni complete sono disponibili nella sezione recuperare una query per documentazione ID.

Una risposta corretta restituisce lo stato HTTP 200 e contiene il errors array. La risposta è stata abbreviata per brevità.

{
    "isInsertInto": false,
    "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
    "clientId": "8c2455819a624534bb665c43c3759877",
    "state": "SUCCESS",
    "rowCount": 0,
    "errors": [{
      'code': '58000',
      'message': 'Batch query execution gets : [failed reason ErrorCode: 58000 Batch query execution gets : [Analysis error encountered. Reason: [sessionId: f055dc73-1fbd-4c9c-8645-efa609da0a7b Function [varchar] not defined.]]]',
      'errorType': 'USER_ERROR'
      }],
    "isCTAS": false,
    "version": 1,
    "id": "343388b0-e0dd-4227-a75b-7fc945ef408a",
}

La Documentazione di riferimento API del servizio query fornisce ulteriori informazioni su tutti gli endpoint disponibili.

L'esempio seguente illustra l'utilizzo di una sintassi CTAS e di un tipo di dati struct:

CREATE TABLE table_name WITH (SCHEMA='schema_name')

AS SELECT '1' as _id,

 STRUCT

  ('2021-02-17T15:39:29.0Z' AS taskActualCompletionDate,

    '2020-09-09T21:21:16.0Z' AS taskActualStartDate,

    'Consulting' AS taskdescription,

    '5f6527c10011e09b89666c52d9a8c564' AS taskguide,

    'Stakeholder Consulting Engagement' AS taskname,

    '2020-09-09T15:00:00.0Z' AS taskPlannedStartDate,

    '2021-02-15T11:00:00.0Z' AS taskPlannedCompletionDate

  ) AS _workfront ;

Puoi anche confermare che il set di dati contiene dati utilizzando una piccola query come:

SELECT count(1) FROM myTableName

È inoltre necessario consultare la documentazione per informazioni su come eseguire query pianificate nell’interfaccia utente e API.

Di seguito è riportato un elenco di considerazioni per le query pianificate quando si utilizza il Query Editor. Non si applicano al Query Service API:
È possibile aggiungere una pianificazione solo a una query già creata, salvata ed eseguita.
You impossibile aggiungi una pianificazione a una query con parametri.
Query pianificate impossibile contiene un blocco anonimo.
È possibile pianificare solo uno modello di query utilizzando l’interfaccia utente. Se desideri aggiungere ulteriori pianificazioni a un modello di query, dovrai utilizzare l’API . Se una pianificazione è già stata aggiunta utilizzando l’API , non potrai aggiungere altre pianificazioni utilizzando l’interfaccia utente .

SELECT * FROM <table> WHERE 1=0

Ad esempio, puoi creare una tabella temporanea:

CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

Quindi puoi utilizzare la tabella temporanea come segue:

INSERT INTO temp_dataset
SELECT a._company AS _company,
a._id AS _id,
a.timestamp AS timestamp
FROM actual_dataset a
WHERE timestamp >= TO_TIMESTAMP('2021-01-21 12:00:00')
AND timestamp < TO_TIMESTAMP('2021-01-21 13:00:00')
LIMIT 100;

Query Service supporta funzioni SQL integrate per convertire una data marca temporale in e dal formato UTC. Entrambi i to_utc_timestamp() e from_utc_timestamp() i metodi richiedono due parametri: marca temporale e fuso orario.

Converti in timestamp UTC

La to_utc_timestamp() interpreta i parametri specificati e li converte alla marca temporale del fuso orario locale in formato UTC. Ad esempio, il fuso orario a Seoul, Corea del Sud, è UTC/GMT +9 ore. Fornendo una marca temporale di sola data, il metodo utilizza un valore predefinito di mezzanotte della mattina. La marca temporale e il fuso orario vengono convertiti in formato UTC dall’ora di tale regione a una marca temporale UTC della propria area locale.

SELECT to_utc_timestamp('2021-08-31', 'Asia/Seoul');

La query restituisce una marca temporale nell’ora locale dell’utente. In questo caso, alle 15.00 del giorno precedente, mentre Seoul è in attesa di 9 ore.

2021-08-30 15:00:00

Un altro esempio, se la marca temporale è stata 2021-07-14 12:40:00.0 per Asia/Seoul fuso orario, la marca temporale UTC restituita sarà 2021-07-14 03:40:00.0

L’output della console fornito nell’interfaccia utente del servizio query è un formato più leggibile dall’utente:

8/30/2021, 3:00 PM

Converti dalla marca temporale UTC

La from_utc_timestamp() interpreta i parametri indicati dalla marca temporale del fuso orario locale e fornisce la marca temporale equivalente della regione desiderata in formato UTC. Nell’esempio seguente, l’ora è 2:40 nel fuso orario locale dell’utente. Il fuso orario di Seoul passato come variabile è nove ore prima del fuso orario locale.

SELECT from_utc_timestamp('2021-08-31 14:40:00.0', 'Asia/Seoul');

La query restituisce una marca temporale in formato UTC per il fuso orario passato come parametro. Il risultato è nove ore prima del fuso orario in cui è stata eseguita la query.

8/31/2021, 11:40 PM

Come posso filtrare i dati della serie temporale?

SELECT a._company  AS _company,
       a._id       AS _id,
       a.timestamp AS timestamp
FROM   dataset a
WHERE  timestamp >= To_timestamp('2021-01-21 12:00:00')
       AND timestamp < To_timestamp('2021-01-21 13:00:00')

Ad esempio, se manca il componente tempo , come illustrato di seguito, si verifica un errore:

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021' AS timestamp)

L'uso corretto del CAST l’operatore è mostrato di seguito:

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021 00:00:00' AS timestamp)

Invece di utilizzare NOT IN, puoi utilizzare NOT EXISTS o LEFT OUTER JOIN.

Ad esempio, se sono state create le tabelle seguenti:

CREATE TABLE T1 (ID INT)
CREATE TABLE T2 (ID INT)
INSERT INTO T1 VALUES (1)
INSERT INTO T1 VALUES (2)
INSERT INTO T1 VALUES (3)
INSERT INTO T2 VALUES (1)
INSERT INTO T2 VALUES (2)

Se utilizzi NOT EXISTS è possibile replicare utilizzando NOT IN utilizzando la seguente query:

SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

In alternativa, se utilizzi il LEFT OUTER JOIN è possibile replicare utilizzando NOT IN utilizzando la seguente query:

SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

Se desideri migliorare i tempi di risposta per le dashboard, implementa un server di Business Intelligence (BI) come livello di memorizzazione in cache tra gli strumenti Query Service e BI. In genere, la maggior parte degli strumenti BI presenta un’offerta aggiuntiva per un server.

Lo scopo di aggiungere il livello del server cache è quello di memorizzare in cache i dati da Query Service e utilizzare lo stesso per le dashboard per velocizzare la risposta. Ciò è possibile in quanto i risultati per le query eseguite vengono memorizzati nella cache del server BI ogni giorno. Il server di caching distribuisce quindi questi risultati per qualsiasi utente con la stessa query per ridurre la latenza. Fare riferimento alla documentazione dell'utilità o dello strumento di terze parti utilizzato per i chiarimenti su questa configurazione.

ErrorCode: 58000 Internal System Error [Invalid table your_table_name. historyMeta can be used on datalake tables only.]

Errore. Nessun valore restituito per la query. Questo comportamento è stato corretto per restituire il seguente messaggio:

Query complete in {timeframe}. 0 rows returned.