Documentazione Experience Platform Guida di Query Service

Query con parametri

Ultimo aggiornamento: 9 maggio 2025

Argomenti:
Query

Creato per:

Utente
Sviluppatore

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.

NOTE

Nell’interfaccia utente di Adobe Experience Platform, le query con parametri sono supportate solo a livello principale dei modelli in linea. Ciò significa che le query con parametri funzionano solo se utilizzate nel modello originale. I modelli figlio devono essere statici e non possono avere parametri dinamici. Per ulteriori informazioni, consulta la documentazione sui modelli in linea.

Sintassi delle query con parametri

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

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.

NOTE

Se la query non accetta parametri, è comunque possibile immettere parametri non necessari nell'editor di query. L’editor delle query ignora tutte le coppie chiave-valore non necessarie e non ha alcun effetto sull’esecuzione o sui risultati della query.

Editor query con una query con parametri e la sezione Parametri query evidenziata.

TIP

Modificare le schede da Parametri query a Console per visualizzare l'output della console della query.

Utilizzare i dettagli dei registri di query per verificare i valori dei parametri

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.

La visualizzazione dei registri delle query con listruzione SQL di una query con parametri è evidenziata nella sezione dei dettagli.

Pianificare una query con parametri

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.

TIP

Query Service supporta le istruzioni preparate tramite l’utilizzo di query con parametri. Per ulteriori informazioni sulla sintassi SQL interessata, vedere la guida alla sintassi delle istruzioni preparate.

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.

Ti consigliamo quindi 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 Experience Platform.

recommendation-more-help