Domande frequenti

Questo documento fornisce le risposte alle domande più frequenti su Query Service e fornisce un elenco dei codici di errore più comuni durante l’utilizzo di Query Service. Per domande e risoluzione dei problemi relativi ad altri servizi in Adobe Experience Platform, consulta Guida alla risoluzione dei problemi di Experience Platform.

Il seguente elenco di risposte alle domande frequenti è suddiviso nelle seguenti categorie:

• Generale
• Esportazione dei dati
• Strumenti di terze parti
• Errori API PostgreSQL
• Errori REST API

Domande generali su Query Service

Questa sezione include informazioni su prestazioni, limiti e processi.

È possibile disattivare la funzione di completamento automatico nell’editor di Query Service?

+++Risposta n. La disattivazione della funzione di completamento automatico non è attualmente supportata dall’editor.
+++

Perché l'editor di query a volte diventa lento quando si digita una query?

+++Risposta Una possibile causa è la funzione di completamento automatico. La funzione elabora alcuni comandi di metadati che possono occasionalmente rallentare l’editor durante la modifica delle query.
+++

Posso utilizzare Postman per l’API Query Service?

+++Risposta Sì, puoi visualizzare e interagire con tutti i servizi API di Adobe utilizzando Postman (applicazione gratuita di terze parti). Osserva Postman guida alla configurazione per istruzioni dettagliate su come impostare un progetto in Adobe Developer Console e acquisire tutte le credenziali necessarie per l’utilizzo con Postman. Consulta la documentazione ufficiale per istruzioni su avvio, esecuzione e condivisione Postman raccolte.
+++

Esiste un limite al numero massimo di righe restituite da una query tramite l’interfaccia utente?

+++Risposta Sì, Query Service applica internamente un limite di 50.000 righe, a meno che non venga specificato esternamente un limite esplicito. Consulta la guida su esecuzione di query interattive per ulteriori dettagli.
+++

È possibile utilizzare le query per aggiornare le righe?

+++Risposta Nelle query batch, l’aggiornamento di una riga all’interno del set di dati non è supportato.
+++

Esiste un limite di dimensione dei dati per l’output risultante da una query?

+++Risposta n. Non vi è alcun limite alla dimensione dei dati, ma esiste un limite di timeout della query di 10 minuti da una sessione interattiva. Se la query viene eseguita come CTAS batch, non è applicabile un timeout di 10 minuti. Consulta la guida su esecuzione di query interattive per ulteriori dettagli.
+++

Come si aggira il limite del numero di righe di output da una query SELECT?

SELECT * FROM customers LIMIT 0;

Come posso evitare che le query scadano in 10 minuti?

Se vengono eseguite più query contemporaneamente, si verificano problemi o un impatto sulle prestazioni di Query Service?

+++Risposta n. Query Service dispone di una funzionalità di scalabilità automatica che garantisce che le query simultanee non abbiano alcun impatto rilevante sulle prestazioni del servizio.
+++

È possibile utilizzare parole chiave riservate come nome di colonna?

+++Risposta Esistono alcune parole chiave riservate che non possono essere utilizzate come nome di colonna, ad esempio, ORDER, GROUP BY, WHERE, DISTINCT. Se desideri utilizzare queste parole chiave, devi eseguire l’escape di queste colonne.
+++

Come si trova un nome di colonna da un set di dati gerarchico?

Come velocizzare una query su un set di dati contenente array?

+++Risposta Per migliorare le prestazioni delle query su set di dati contenenti array, è necessario esplodere l’array as a Query CTAS in fase di esecuzione, quindi esplorala ulteriormente per scoprire le opportunità di migliorare il tempo di elaborazione.
+++

Perché la query CTAS viene ancora elaborata dopo molte ore solo per un numero limitato di righe?

Come posso contattare l’assistenza clienti Adobe?

Come si implementa una serie sequenziale di job senza eseguire i job successivi se il job precedente non viene completato correttamente?

Come si implementa l’attribuzione personalizzata in Query Service?

Posso modellare le mie query in modo da poterle riutilizzare facilmente?

+++Risposta Sì, è possibile modellare le query tramite l'utilizzo di istruzioni preparate. Le istruzioni preparate possono ottimizzare le prestazioni ed evitare di rianalizzare ripetutamente una query. Consulta la documentazione delle dichiarazioni preparate per ulteriori dettagli.
+++

Come si recuperano i registri di errore per una query?

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

Cosa significa "Errore durante la convalida dello schema"?

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 ;

Come posso elaborare rapidamente i nuovi dati che entrano nel sistema ogni giorno?

+++Rispondi SNAPSHOT può essere utilizzata per leggere in modo incrementale i dati su una tabella basata su un ID snapshot. Questa funzione è ideale per l'utilizzo con carico incrementale modello di progettazione che elabora solo le informazioni nel set di dati creato o modificato dopo l’ultima esecuzione del caricamento. Di conseguenza, aumenta l’efficienza di elaborazione e può essere utilizzato sia con l’elaborazione dei dati in streaming che in batch.
+++

Perché esiste una differenza tra i numeri visualizzati nell’interfaccia utente del profilo e i numeri calcolati dal set di dati di esportazione del profilo?

Perché la query ha restituito un sottoinsieme vuoto e cosa devo fare?

SELECT count(1) FROM myTableName

Posso campionare i miei dati?

+++Risposta Questa funzione è attualmente in corso di elaborazione. I dettagli saranno resi disponibili in note sulla versione e nelle finestre di dialogo dell’interfaccia utente di Platform quando la funzione è pronta per il rilascio.
+++

Quali funzioni di assistenza sono supportate da Query Service?

+++Answer Query Service fornisce diverse funzioni di assistenza SQL integrate per estendere le funzionalità SQL. Consulta il documento per un elenco completo Funzioni SQL supportate da Query Service.
+++

Sono tutti nativi Spark SQL funzioni supportate o utenti limitati solo al wrapper Spark SQL le funzioni fornite da Adobe?

+++Risposta non ancora disponibile, non tutte open-source Spark SQL Le funzioni sono state testate sui dati del data lake. Una volta testate e confermate, verranno aggiunte all’elenco delle supportate. Fare riferimento al elenco di supportate Spark SQL funzioni per verificare la presenza di una funzione specifica.
+++

Gli utenti possono definire le proprie funzioni definite dall'utente (FDU) che possono essere utilizzate in altre query?

+++Risposta A causa di considerazioni sulla sicurezza dei dati, la definizione personalizzata di FDU non è consentita.
+++

Cosa devo fare se la query pianificata non riesce?

Cosa significa l’errore "Limite di sessione raggiunto"?

+++La risposta "Limite sessione raggiunto" indica che è stato raggiunto il numero massimo di sessioni di Query Service consentite per la tua organizzazione. Stabilisci una connessione con l’amministratore Adobe Experience Platform della tua organizzazione.
+++

In che modo il registro delle query gestisce le query relative a un set di dati eliminato?

+++Answer Query Service non elimina mai la cronologia delle query. Ciò significa che eventuali query che fanno riferimento a un set di dati eliminato restituirebbero come risultato "Nessun set di dati valido".
+++

Come posso ottenere solo i metadati per una query?

SELECT * FROM <table> WHERE 1=0

Come è possibile eseguire rapidamente l'iterazione su una query CTAS (Create Table As Select) senza materializzarla?

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

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;

Come si modifica il fuso orario in e da un timestamp UTC?

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

2021-08-30 15:00:00

8/30/2021, 3:00 PM

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

8/31/2021, 11:40 PM

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')

Come si utilizza correttamente il CAST per convertire i timestamp in query SQL?

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

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

È necessario utilizzare caratteri jolly, ad esempio *, per ottenere tutte le righe dai set di dati?

+++Risposta Non è possibile utilizzare i caratteri jolly per ottenere tutti i dati dalle righe, in quanto Query Service deve essere considerato come un columnar-store anziché utilizzare un sistema tradizionale basato su file.
+++

Devo utilizzare NOT IN nella query SQL?

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)

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

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

È possibile creare un set di dati utilizzando una query CTAS con un doppio nome di sottolineatura come quelli visualizzati nell’interfaccia utente? Ad esempio: test_table_001.

+++Risposta n., si tratta di una limitazione intenzionale in un Experience Platform che si applica a tutti i servizi Adobe, incluso Query Service. Un nome con due trattini bassi è accettabile come nome di schema e set di dati, ma il nome della tabella per il set di dati può contenere solo un singolo trattino basso.
+++

Quante query simultanee è possibile eseguire alla volta?

+++Risposta Non esiste alcun limite di concorrenza per le query in quanto le query batch vengono eseguite come processi back-end. Tuttavia, è stato impostato un limite di timeout per le query di 24 ore.
+++

Esiste un dashboard attività in cui è possibile visualizzare le attività e lo stato delle query?

+++Risposta Sono disponibili funzionalità di monitoraggio e di avviso per verificare le attività e gli stati delle query. Consulta la Integrazione del registro di controllo di Query Service e registri di query documenti per ulteriori informazioni.
+++

Esiste un modo per eseguire il rollback degli aggiornamenti? Ad esempio, in caso di errore o se alcuni calcoli devono essere riconfigurati durante la scrittura di dati in Platform, come deve essere gestito lo scenario?

+++Risposta Al momento, non sono supportati rollback o aggiornamenti di questo tipo.
+++

Come si ottimizzano le query in Adobe Experience Platform?

Gli accessi possono essere limitati ad alcuni aspetti di Query Service o si tratta di una soluzione "tutto o niente"?

+++Answer Query Service è una soluzione completa o nulla. Impossibile fornire l'accesso parziale.
+++

È possibile limitare i dati utilizzabili da Query Service o accedere semplicemente all’intero data lake di Adobe Experience Platform?

+++Risposta Sì, è possibile limitare la query ai set di dati con accesso in sola lettura.
+++

Quali altre opzioni sono disponibili per limitare i dati a cui può accedere Query Service?

Una volta che i dati sono stati restituiti da Query Service, vengono eseguiti alcuni controlli da parte di Platform per verificare che non siano stati restituiti dati protetti?

• Query Service supporta il controllo degli accessi basato su attributi. Puoi limitare l’accesso ai dati a livello di colonna/foglia e/o di struttura. Per ulteriori informazioni sul controllo degli accessi basato su attributi, consulta la documentazione.

È possibile specificare una modalità SSL per la connessione a un client di terze parti? È possibile, ad esempio, utilizzare "verify-full" con Power BI?

+++Risposta Sì, sono supportate le modalità SSL. Consulta la Documentazione sulle modalità SSL suddividendo le diverse modalità SSL disponibili e il livello di protezione che offrono.
+++

Usiamo TLS 1.2 per tutte le connessioni dai client Power BI al servizio di query?

+++Risposta Sì. I dati in transito sono sempre conformi a HTTPS. La versione attualmente supportata è TLS1.2.
+++

Una connessione effettuata sulla porta 80 utilizza ancora https?

+++Risposta Sì, una connessione effettuata sulla porta 80 utilizza ancora SSL. È inoltre possibile utilizzare la porta 5432.
+++

Posso controllare l’accesso a set di dati e colonne specifici per una particolare connessione? Come si configura?

+++Risposta Sì, se configurato, viene applicato il controllo degli accessi basato su attributi. Consulta la panoramica sul controllo degli accessi basato su attributi per ulteriori informazioni.
+++

Query Service supporta il comando "INSERT OVERWRITE INTO"?

+++Risposta no, Query Service non supporta il comando "INSERT OVERWRITE INTO".
+++

Esportazione dei dati

Questa sezione fornisce informazioni sull’esportazione di dati e sui limiti.

Esiste un modo per estrarre i dati da Query Service dopo l’elaborazione delle query e salvare i risultati in un file CSV?

SELECT column1, column2
FROM <table_name>
\g <table_name>.out

Posso estrarre il contenuto del set di dati finale che è stato acquisito tramite query CTAS (supponendo che si tratti di quantità di dati più grandi, come Terabyte)?

+++Risposta n. Al momento non è disponibile alcuna funzione per l’estrazione dei dati acquisiti.
+++

Perché il connettore dati di Analytics non restituisce dati?

SELECT * FROM prod_table LIMIT 1;

SELECT * FROM prod_table
WHERE
timestamp >= to_timestamp('2022-07-22')
and timestamp < to_timestamp('2022-07-23');

Strumenti di terze parti

Questa sezione include informazioni sull’utilizzo di strumenti di terze parti come PSQL e Power BI.

È possibile collegare Query Service a uno strumento di terze parti?

+++Risposta Sì, è possibile collegare più client desktop di terze parti a Query Service. Consulta la documentazione per informazioni complete sui client disponibili e su come collegarli a Query Service.
+++

Esiste un modo per connettere Query Service una volta per un utilizzo continuo con uno strumento di terze parti?

+++Risposta Sì, i client desktop di terze parti possono essere collegati a Query Service tramite l’impostazione una tantum di credenziali senza scadenza. Le credenziali senza scadenza possono essere generate da un utente autorizzato e ricevute in un file JSON che viene scaricato automaticamente nel computer locale. Completo istruzioni su come creare e scaricare credenziali senza scadenza sono disponibili nella documentazione.
+++

Perché le mie credenziali senza scadenza non funzionano?

Che tipo di editor SQL di terze parti è possibile connettere a Query Service Editor?

+++Rispondi a qualsiasi editor SQL di terze parti che sia PSQL o Postgres è possibile connettersi all’editor di Query Service con la compatibilità del client. Consulta la documentazione per connessione dei client a Query Service per un elenco delle istruzioni disponibili.
+++

È possibile collegare lo strumento Power BI a Query Service?

+++Risposta Sì, è possibile collegare Power BI a Query Service. Consulta la documentazione per istruzioni per la connessione dell’app desktop Power BI a Query Service.
+++

Perché il caricamento delle dashboard richiede molto tempo quando si è connessi a Query Service?

È possibile accedere a Query Service utilizzando lo strumento di connessione pgAdmin?

+++Risposta n.: la connettività pgAdmin non è supportata. A elenco dei client di terze parti disponibili e istruzioni su come collegarli a Query Service sono disponibili nella documentazione.
+++

Errori API PostgreSQL

Nella tabella seguente sono riportati i codici di errore PSQL e le possibili cause.

Perché è stato ricevuto un codice di errore 58000 quando si utilizza il metodo history_meta() nella tabella?

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

Query complete in {timeframe}. 0 rows returned.

Errori REST API

Nella tabella seguente sono riportati i codici di errore HTTP e le possibili cause.

Risorse Business.Adobe.com

Targeted Content Audio Analytics Third Party Integrations General Data Protection Regulation Web Analytics Search Marketing Management