Guía general para la ejecución de consultas en Query Service

Este documento detalla detalles importantes que deben conocerse al escribir consultas en Adobe Experience Platform Query Service.

Para obtener información detallada sobre la sintaxis SQL utilizada en Query Service, lea la documentación sobre sintaxis SQL.

Modelos de ejecución de consulta

Adobe Experience Platform Query Service tiene dos modelos de ejecución de consultas: interactivo y no interactivo. La ejecución interactiva se utiliza para el desarrollo de consultas y la generación de informes en las herramientas de inteligencia empresarial, mientras que la no interactiva se utiliza para trabajos de mayor tamaño y consultas operativas como parte de un flujo de trabajo de procesamiento de datos.

Ejecución de consulta interactiva

Las consultas se pueden ejecutar de forma interactiva enviándolas a través de la interfaz de usuario de Query Service o a través de un cliente conectado. Al ejecutar Query Service a través de un cliente conectado, se ejecuta una sesión activa entre el cliente y Query Service hasta que la consulta enviada devuelva o se agote el tiempo de espera.

La ejecución de consultas interactivas tiene las siguientes limitaciones:

De manera predeterminada, los resultados de las consultas interactivas se devuelven al cliente y no persisten. Para mantener los resultados como un conjunto de datos en Experience Platform, la consulta debe utilizar la sintaxis CREATE TABLE AS SELECT.

Ejecución de consulta no interactiva

Las consultas enviadas a través de la API Query Service se ejecutan de forma no interactiva. La ejecución no interactiva significa que Query Service recibe la llamada de API y ejecuta la consulta en el orden en que se recibió. Las consultas no interactivas siempre dan como resultado la generación de un nuevo conjunto de datos en Experience Platform para recibir los resultados o la inserción de filas nuevas en un conjunto de datos existente.

Acceso a un campo específico dentro de un objeto

Para tener acceso a un campo de un objeto de la consulta, puede usar la notación de puntos (.) o la notación de corchetes ([]). La siguiente instrucción SQL utiliza la notación de puntos para recorrer el objeto endUserIds hasta el objeto mcid.

SELECT endUserIds._experience.mcid
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

La siguiente instrucción SQL utiliza la notación de corchetes para recorrer el objeto endUserIds hasta el objeto mcid.

SELECT endUserIds['_experience']['mcid']
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

Las dos consultas de ejemplo anteriores devuelven un objeto aplanado, en lugar de un valor único:

              endUserIds._experience.mcid
--------------------------------------------------------
 (48168239533518554367684086979667672499,"(ECID)",true)
(1 row)

El objeto endUserIds._experience.mcid devuelto contiene los valores correspondientes para los parámetros siguientes:

Cuando la columna solo se declara hacia abajo en el objeto, devuelve todo el objeto como una cadena. Para ver solo el ID, utilice:

SELECT endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE endUserIds._experience.mcid IS NOT NULL
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 1

     endUserIds._experience.mcid.id
----------------------------------------
 48168239533518554367684086979667672499
(1 row)

Comillas

Las comillas simples, las comillas dobles y las comillas invertidas tienen usos diferentes en las consultas del servicio de consultas.

Comillas simples

La comilla simple (') se usa para crear cadenas de texto. Por ejemplo, se puede utilizar en la instrucción SELECT para devolver un valor de texto estático en el resultado y en la cláusula WHERE para evaluar el contenido de una columna.

La siguiente consulta declara un valor de texto estático ('datasetA') para una columna:

SELECT
  'datasetA',
  timestamp,
  web.webPageDetails.name
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

La siguiente consulta utiliza una cadena entre comillas simples ('homepage') en su cláusula WHERE para devolver eventos para una página específica.

SELECT
  timestamp,
  endUserIds._experience.mcid.id
FROM {ANALYTICS_TABLE_NAME}
WHERE web.webPageDetails.name = 'homepage'
AND TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Comillas dobles

Se usa el símbolo de comillas dobles (") para declarar un identificador con espacios.

La siguiente consulta utiliza comillas dobles para devolver valores de columnas especificadas cuando una columna contiene un espacio en su identificador:

SELECT
  no_space_column,
  "space column"
FROM
( SELECT
    'column1' as no_space_column,
    'column2' as "space column"
)

Comillas anteriores

La comilla invertida ` se usa para omitir los nombres de columna reservados solamente cuando se usa la sintaxis de notación de puntos. Por ejemplo, dado que order es una palabra reservada en SQL, debe utilizar comillas invertidas para acceder al campo commerce.order:

SELECT
  commerce.`order`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Las comillas invertidas también se utilizan para acceder a un campo que comienza con un número. Por ejemplo, para acceder al campo 30_day_value, debe utilizar la notación de comillas invertidas.

SELECT
    commerce.`30_day_value`
FROM {ANALYTICS_TABLE_NAME}
WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
LIMIT 10

Las comillas invertidas son no necesarias si usa notación de corchetes.

 SELECT
  commerce['order']
 FROM {ANALYTICS_TABLE_NAME}
 WHERE TIMESTAMP = to_timestamp('{TARGET_YEAR}-{TARGET_MONTH}-{TARGET_DAY}')
 LIMIT 10

Visualización de información de tabla

Después de conectarse al servicio de consultas, puede ver todas las tablas disponibles en Platform mediante los comandos \d o SHOW TABLES.

Vista de tabla estándar

El comando \d muestra la vista estándar PostgreSQL para enumerar tablas. A continuación se muestra un ejemplo de la salida de este comando:

             List of relations
 Schema |       Name      | Type  |  Owner
--------+-----------------+-------+----------
 public | luma_midvalues  | table | postgres
 public | luma_postvalues | table | postgres
(2 rows)

Vista de tabla detallada

El comando SHOW TABLES es un comando personalizado que proporciona información más detallada sobre las tablas. A continuación se muestra un ejemplo de la salida de este comando:

       name      |        dataSetId         |     dataSet    | description | resolved
-----------------+--------------------------+----------------+-------------+----------
 luma_midvalues  | 5bac030c29bb8d12fa992e58 | Luma midValues |             | false
 luma_postvalues | 5c86b896b3c162151785b43c | Luma midValues |             | false
(2 rows)

Información del esquema

Para ver información más detallada sobre los esquemas de la tabla, puede utilizar el comando \d {TABLE_NAME}, donde {TABLE_NAME} es el nombre de la tabla cuya información de esquema desea ver.

El ejemplo siguiente muestra la información de esquema de la tabla luma_midvalues, que se vería con \d luma_midvalues:

                         Table "public.luma_midvalues"
      Column       |             Type            | Collation | Nullable | Default
-------------------+-----------------------------+-----------+----------+---------
 timestamp         | timestamp                   |           |          |
 _id               | text                        |           |          |
 productlistitems  | anyarray                    |           |          |
 commerce          | luma_midvalues_commerce     |           |          |
 receivedtimestamp | timestamp                   |           |          |
 enduserids        | luma_midvalues_enduserids   |           |          |
 datasource        | datasource                  |           |          |
 web               | luma_midvalues_web          |           |          |
 placecontext      | luma_midvalues_placecontext |           |          |
 identitymap       | anymap                      |           |          |
 marketing         | marketing                   |           |          |
 environment       | luma_midvalues_environment  |           |          |
 _experience       | luma_midvalues__experience  |           |          |
 device            | device                      |           |          |
 search            | search                      |           |          |

Además, puede obtener más información sobre una columna concreta añadiendo el nombre de la columna al nombre de la tabla. Esto se escribiría en el formato \d {TABLE_NAME}_{COLUMN}.

El ejemplo siguiente muestra información adicional para la columna web y se invocaría mediante el comando siguiente: \d luma_midvalues_web:

                 Composite type "public.luma_midvalues_web"
     Column     |               Type                | Collation | Nullable | Default
----------------+-----------------------------------+-----------+----------+---------
 webpagedetails | luma_midvalues_web_webpagedetails |           |          |
 webreferrer    | web_webreferrer                   |           |          |

Unirse a conjuntos de datos

Puede unir varios conjuntos de datos para incluir datos de otros conjuntos de datos en la consulta.

El siguiente ejemplo uniría los dos conjuntos de datos siguientes (your_analytics_table y custom_operating_system_lookup) y crearía una instrucción SELECT para los 50 sistemas operativos principales según el número de vistas de página.

Consulta

SELECT
  b.operatingsystem AS OperatingSystem,
  SUM(a.web.webPageDetails.pageviews.value) AS PageViews
FROM your_analytics_table a
     JOIN custom_operating_system_lookup b
      ON a._experience.analytics.environment.operatingsystemID = b.operatingsystemid
WHERE TIMESTAMP >= TO_TIMESTAMP('2018-01-01') AND TIMESTAMP <= TO_TIMESTAMP('2018-12-31')
GROUP BY OperatingSystem
ORDER BY PageViews DESC
LIMIT 50;

Resultados

Anulación de duplicación

El servicio de consulta admite la anulación de duplicación de datos o la eliminación de filas duplicadas de los datos. Para obtener más información sobre la anulación de duplicación, lea la guía de anulación de duplicación del servicio de consultas.

Cálculos de zona horaria en el servicio de consultas

El servicio de consulta estandariza los datos persistentes en Adobe Experience Platform mediante el formato de marca de tiempo UTC. Para obtener más información sobre cómo traducir el requisito de zona horaria a y desde una marca de tiempo UTC, consulte la sección de preguntas frecuentes sobre cómo cambiar la zona horaria a y desde una marca de tiempo UTC.

Pasos siguientes

Al leer este documento, se le han presentado algunas consideraciones importantes al escribir consultas con Query Service. Para obtener más información sobre cómo usar la sintaxis SQL para escribir sus propias consultas, lea la documentación sobre sintaxis SQL.

Para obtener más ejemplos de consultas que se pueden utilizar en el servicio de consultas, lea la siguiente documentación de caso de uso: