Consultas parametrizadas parameterized-queries

El servicio de consultas admite el uso de consultas parametrizadas en el Editor de consultas. Con las consultas con parámetros, ahora puede utilizar marcadores de posición para parámetros y agregar los valores de parámetro en el momento de la ejecución. Los marcadores de posición permiten trabajar con datos dinámicos en los que no sabe cuáles serán los valores hasta que se ejecute la instrucción. También puede preparar sus consultas con antelación y reutilizarlas para fines similares. La reutilización de consultas ahorra un esfuerzo considerable ya que evita la creación de consultas SQL distintas para cada caso de uso.

Requisitos previos

Antes de continuar con esta guía, lea la guía de la interfaz de usuario del editor de consultas. La guía del Editor de consultas proporciona información detallada sobre cómo escribir, validar y ejecutar consultas para datos de experiencia del cliente en la interfaz de usuario de Experience Platform.

Sintaxis de consulta parametrizada syntax

Las consultas parametrizadas utilizan el formato '$YOUR_PARAMETER_NAME' y se pueden concatenar mediante notación de puntos. A continuación se muestra un ejemplo de una instrucción SQL que utiliza consultas parametrizadas.

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;

Creación de una consulta con parámetros create

Para crear la consulta parametrizada en la interfaz de usuario de, vaya al Editor de consultas. Consulte la sección sobre acceso al Editor de consultas para obtener más instrucciones.

Utilice el comienzo '$' para introducir un parámetro de consulta en su consulta del editor de texto. A continuación, seleccione la pestaña Parámetros de consulta junto a la Consola para agregar el valor que falta para la clave. La consulta no se puede ejecutar si no agrega un valor a ninguna de las claves requeridas. Un icono de alerta ( ) aparece en la sección Parámetros de consulta junto a cualquier campo de entrada Value vacío.

Utilice los detalles de registros de consulta para comprobar los valores de parámetros check-parameter-values

No se pueden guardar parámetros dentro de las plantillas porque los valores utilizados no son persistentes. Sin embargo, puede comprobar la página Detalles del registro de consultas para encontrar los valores de parámetros utilizados en una ejecución de consulta. En este caso, los registros no indican que la consulta fuera una consulta parametrizada. Consulte la documentación de registros de consulta para obtener instrucciones sobre cómo encontrar los valores utilizados.

Programar una consulta parametrizada schedule

Los valores de parámetro se guardan al programar una consulta parametrizada. Para programar una consulta parametrizada, siga el proceso típico para crear una consulta programada como se describe en la guía para crear una programación de consulta y, a continuación, introduzca los valores de parámetro que se utilizarán en la ejecución de la consulta. Esta sección de la interfaz de usuario solo aparece para consultas parametrizadas. Consulte la sección sobre configuración de parámetros para una consulta parametrizada programada para obtener instrucciones específicas.

Pasos siguientes

Al leer este documento, ha aprendido a parametrizar consultas en la interfaz de usuario de Adobe Experience Platform y a utilizarlas en ejecuciones de consultas programadas. El documento también resaltaba cómo comprobar los registros para los valores de parámetro utilizados en las ejecuciones de consultas.

A continuación, se recomienda leer la guía sobre supervisión de consultas programadas para comprender mejor el estado de todos los trabajos de consulta a través de la interfaz de usuario de Platform.