Query con parametri parameterized-queries

Query Service supporta l’utilizzo di query con parametri nell’editor delle query. Con le query con parametri, ora puoi utilizzare segnaposto per i parametri e aggiungere i valori dei parametri al momento dell’esecuzione. I segnaposto consentono di lavorare con dati dinamici in cui non si sa quali saranno i valori fino all’esecuzione dell’istruzione. Puoi anche preparare le query in anticipo e riutilizzarle per scopi simili. Il riutilizzo delle query consente di risparmiare tempo evitando di creare query SQL distinte per ogni caso d’uso.

Prerequisiti

Prima di continuare con questa guida, leggere la Guida dell'interfaccia utente di Query Editor. La guida dell’editor delle query fornisce informazioni dettagliate su come scrivere, convalidare ed eseguire query per i dati sull’esperienza del cliente nell’interfaccia utente di Experience Platform.

Sintassi delle query con parametri syntax

Le query con parametri utilizzano il formato '$YOUR_PARAMETER_NAME' e possono essere concatenate utilizzando la notazione del punto. Di seguito è riportato un esempio di istruzione SQL che utilizza query con parametri.

INSERT INTO
   $Database_Name.Schema_Name.adwh_lkup_process_delta_log
   (process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
   '$Table_Process_Name' process_name,
   hash('$Merge_PolicyID') merge_policy_id,
   '$process_status' process_status,
   to_date('$date_key') process_date,
   CURRENT_TIMESTAMP create_ts,
   CURRENT_TIMESTAMP change_ts;

Creare una query con parametri create

Per creare una query con parametri nell’interfaccia utente, passa all’editor delle query. Per ulteriori istruzioni, vedere la sezione relativa all'accesso di all'editor di query.

Utilizza la premessa '$' per immettere un parametro di query nella query nell’editor di testo. Quindi, seleziona la scheda Parametri query accanto alla Console per aggiungere il valore mancante alla chiave. Impossibile eseguire la query se si omette di aggiungere un valore a una delle chiavi richieste. Icona di avviso ( ) viene visualizzato nella sezione Parametri query accanto a qualsiasi campo di input Value vuoto.

Utilizzare i dettagli dei registri di query per verificare i valori dei parametri check-parameter-values

Non è possibile salvare i parametri all’interno dei modelli in quanto i valori utilizzati non sono persistenti. Tuttavia, è possibile controllare la pagina Dettagli registro query per trovare i valori dei parametri utilizzati in un'esecuzione di query. In questo caso, i registri non indicano che la query era con parametri. Per istruzioni su come trovare i valori utilizzati, consulta la documentazione dei registri di query.

Pianificare una query con parametri schedule

I valori dei parametri vengono salvati quando si pianifica una query con parametri. Per pianificare una query con parametri, seguire il processo tipico per creare una query pianificata come descritto nella guida per creare una pianificazione di query, quindi immettere i valori dei parametri da utilizzare nell'esecuzione della query. Questa sezione dell’interfaccia utente viene visualizzata solo per le query con parametri. Per istruzioni specifiche, consulta la sezione sull'impostazione di parametri per una query con parametri pianificata.

Passaggi successivi

Dopo aver letto questo documento, hai imparato a parametrizzare le query nell’interfaccia utente di Adobe Experience Platform e a utilizzarle nelle esecuzioni pianificate delle query. Nel documento è anche evidenziato come verificare nei registri i valori dei parametri utilizzati nelle esecuzioni delle query.

Successivamente, ti consigliamo di leggere la guida su monitoraggio delle query pianificate per comprendere meglio lo stato di tutti i processi di query tramite l'interfaccia utente di Platform.