Guía de IU del Editor de consultas

El Editor de consultas es una herramienta interactiva proporcionada por el Servicio de consultas de Adobe Experience Platform, que le permite escribir, validar y ejecutar consultas para datos de experiencia del cliente en la interfaz de usuario de Experience Platform. El Editor de consultas admite el desarrollo de consultas para análisis y exploración de datos, y permite ejecutar consultas interactivas con fines de desarrollo, así como consultas no interactivas para rellenar conjuntos de datos en Experience Platform.

Para obtener más información acerca de los conceptos y características del servicio de consultas, vea Introducción al servicio de consultas. Para obtener más información sobre cómo navegar por la interfaz de usuario del servicio de consultas en Platform, consulte la descripción general de la interfaz de usuario del servicio de consultas.

Introducción getting-started

El Editor de consultas permite una ejecución flexible de las consultas conectándose al Servicio de consultas, y las consultas sólo se ejecutan mientras está activa esta conexión.

Acceso al Editor de consultas accessing-query-editor

En la interfaz de usuario Experience Platform, seleccione Consultas en el menú de navegación de la izquierda para abrir el área de trabajo del servicio de consultas. A continuación, para empezar a escribir consultas, seleccione Crear consulta en la parte superior derecha de la pantalla. Este vínculo está disponible en cualquiera de las páginas del espacio de trabajo del servicio de consultas.

Conectando con el servicio de consultas connecting-to-query-service

El Editor de consultas tarda unos segundos en inicializarse y conectarse al Servicio de consultas cuando se abre. La consola le indica cuándo está conectada, como se muestra a continuación. Si intenta ejecutar una consulta antes de que el editor se haya conectado, retrasará la ejecución hasta que se complete la conexión.

Cómo se ejecutan las consultas desde el Editor de consultas run-a-query

Las consultas ejecutadas desde el Editor de consultas se ejecutan de forma interactiva, lo que significa que si cierra el explorador o sale, la consulta se cancela. Lo mismo ocurre con las consultas realizadas para generar conjuntos de datos a partir de resultados de consultas.

Creación de consultas mediante el Editor de consultas mejorado query-authoring

Con el Editor de consultas, puede escribir, ejecutar y guardar consultas para datos de experiencia del cliente. Todas las consultas ejecutadas o guardadas en el Editor de consultas están disponibles para todos los usuarios de su organización con acceso al Servicio de consultas.

Configuración settings

Un icono de configuración sobre el campo de entrada del Editor de consultas incluye una opción para habilitar/deshabilitar el tema oscuro o para deshabilitar/habilitar el autocompletado.

Para habilitar los temas oscuros o claros, seleccione el icono de configuración ( ) seguido de la opción en el menú desplegable que aparece.

Completar automáticamente auto-complete

El Editor de consultas sugiere automáticamente palabras clave SQL potenciales junto con detalles de tabla o columna para la consulta a medida que la escribe. La función de autocompletar está habilitada de forma predeterminada y se puede deshabilitar o habilitar en cualquier momento desde la configuración del Editor de consultas.

La configuración de autocompletar es por usuario y se recuerda por los inicios de sesión consecutivos de ese usuario. Al deshabilitar esta función, se detienen varios comandos de metadatos y se proporcionan recomendaciones que generalmente benefician la velocidad del autor al editar consultas.

Ejecutar varias consultas secuenciales execute-multiple-sequential-queries

Utilice el Editor de consultas mejorado para escribir más de una consulta y ejecutar todas las consultas de forma secuencial. La ejecución de varias consultas en una secuencia genera cada una una una entrada de registro. Sin embargo, solo se muestran los resultados de la primera consulta en la consola del Editor de consultas. Consulte el registro de consultas si necesita solucionar problemas o confirmar las consultas que se ejecutaron. Consulte la documentación de registros de consulta para obtener más información.

Ejecutar consulta seleccionada execute-selected-query

Si ha escrito varias consultas pero sólo necesita ejecutar una, puede resaltar la consulta elegida y seleccionar
Ejecutar consulta seleccionada icono. Este icono está desactivado de forma predeterminada hasta que seleccione una sintaxis de consulta en el editor.

Cancelar sesión del Editor de consultas cancel-query

Tome el control de la ejecución de consultas y mejore su productividad cancelando consultas de larga duración. Esta acción borra el Editor de consultas durante la ejecución de una consulta. Tenga en cuenta que la consulta sigue ejecutándose en segundo plano. Si es una consulta CTAS, seguirá generando un conjunto de datos de salida. Para cancelar la ejecución en el editor y continuar maquetando una instrucción SQL, seleccione Cancelar consulta después de ejecutar una consulta.

Aparecerá un cuadro de diálogo de confirmación. Seleccione Confirmar para cancelar la ejecución de la consulta.

Recuento de resultados result-count

El Editor de consultas tiene un resultado máximo de 50 000 filas. Puede elegir el número de filas que se muestran a la vez en la consola del Editor de consultas. Para cambiar el número de filas que se muestran en la consola, seleccione la lista desplegable Recuento de resultados y elija entre las opciones 50, 100, 150, 300 y 500.

Escritura de consultas writing-queries

Editor de consultas está organizado para que escribir consultas sea lo más fácil posible. La captura de pantalla siguiente muestra cómo aparece el editor en la interfaz de usuario, con el campo de entrada SQL y Reproducir resaltado.

Para minimizar el tiempo de desarrollo, se recomienda desarrollar las consultas con límites en la cantidad de filas devueltas. Por ejemplo, SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Después de comprobar que la consulta produce el resultado esperado, quite los límites y ejecute la consulta con CREATE TABLE tablename AS SELECT para generar un conjunto de datos con el resultado.

Herramientas de escritura en el Editor de consultas writing-tools

Formatear texto format-text

La característica Formato de texto hace que la consulta sea más legible al agregar un estilo de sintaxis estandarizado. Seleccione Dar formato al texto para estandarizar todo el texto dentro del Editor de consultas.

Copiar SQL copy-sql

Seleccione el icono Copiar para copiar SQL desde el Editor de consultas al portapapeles. Esta función de copia está disponible tanto para plantillas de consulta como para consultas recién creadas en el Editor de consultas.

Detalles de consulta query-details

Para ver una consulta en el Editor de consultas, seleccione cualquier plantilla guardada de la ficha Plantillas. El panel de detalles de la consulta proporciona más información y herramientas para administrar la consulta seleccionada. También muestra metadatos útiles, como la última vez que se modificó la consulta y quién la modificó, si corresponde.

Desde el panel de detalles puede generar un conjunto de datos de salida directamente desde la interfaz de usuario, eliminar o asignar un nombre a la consulta mostrada, ver la programación de ejecución de la consulta y agregar la consulta a una programación.

Para generar un conjunto de datos de salida, seleccione Ejecutar como CTAS. Aparecerá el cuadro de diálogo Introducir detalles del conjunto de datos de salida. Escriba un nombre y una descripción y, a continuación, seleccione Ejecutar como CTAS. El nuevo conjunto de datos se muestra en la ficha Examinar Conjuntos de datos. Consulte la documentación de la vista de conjuntos de datos para obtener más información sobre los conjuntos de datos disponibles para su organización.

Después de ejecutar la acción Ejecutar como CTAS, aparece un mensaje de confirmación para notificarle que la acción se ha realizado correctamente. Este mensaje emergente contiene un vínculo que proporciona una forma cómoda de desplazarse al espacio de trabajo de registros de consultas. Consulte la documentación de registros de consultas para obtener más información sobre los registros de consultas.

Guardar consultas saving-queries

El Editor de consultas proporciona una función de guardado que le permite guardar una consulta y trabajar en ella más adelante. Para guardar una consulta, selecciona Guardar en la esquina superior derecha del Editor de consultas. Para poder guardar una consulta, se debe proporcionar un nombre para la consulta mediante el panel Detalles de la consulta.

Al guardar una consulta en el Editor de consultas, aparece un mensaje de confirmación para notificarle que la acción se ha realizado correctamente. Este mensaje emergente contiene un vínculo que proporciona una forma cómoda de desplazarse al espacio de trabajo de programación de consultas. Consulte la documentación de consultas de programación para obtener información sobre cómo ejecutar consultas en una cadencia personalizada.

Consultas programadas scheduled-queries

Las consultas que se han guardado como plantilla se pueden programar desde el Editor de consultas. La programación de consultas permite automatizar las ejecuciones de consultas en una cadencia personalizada. Puede programar consultas en función de la frecuencia, la fecha y la hora, y también elegir un conjunto de datos de salida para los resultados si es necesario. Las programaciones de consultas también se pueden deshabilitar o eliminar a través de la interfaz de usuario.

Las programaciones se establecen en el Editor de consultas. Al utilizar el Editor de consultas, solo puede agregar una programación a una consulta que ya se ha creado y guardado. La misma limitación no se aplica a la API del servicio de consultas.

Consulte la documentación de programaciones de consultas para obtener información sobre cómo crear programaciones de consultas en la interfaz de usuario. Como alternativa, para aprender a agregar programaciones mediante la API, lea la guía de extremo de consultas programadas.

Todas las consultas programadas se agregan a la lista en la ficha Consultas programadas. Desde ese espacio de trabajo, puede monitorizar el estado de todos los trabajos de consulta programados a través de la interfaz de usuario. En la ficha Consultas programadas, puede encontrar información importante acerca de las ejecuciones de consultas y la suscripción a alertas. La información disponible incluye el estado, los detalles de la programación y los mensajes/códigos de error si falla una ejecución. Consulte el documento Supervisión de consultas programadas para obtener más información.

Cómo encontrar consultas anteriores previous-queries

Todas las consultas ejecutadas desde el Editor de consultas se capturan en la Tabla de registro. Puede utilizar la funcionalidad de búsqueda en la pestaña Log para encontrar ejecuciones de consulta. Las consultas guardadas se muestran en la ficha Plantillas.

Si se programó una consulta, entonces la ficha Consultas programadas proporciona una visibilidad mejorada a través de la interfaz de usuario para esos trabajos de consulta. Consulte la documentación de supervisión de consultas para obtener más información.

Ejecución de consultas mediante el Editor de consultas executing-queries

Para ejecutar una consulta en el Editor de consultas, puede escribir SQL en el editor o cargar una consulta anterior desde la ficha Registro o Plantillas y seleccionar Reproducir. El estado de ejecución de la consulta se muestra en la ficha Consola a continuación y los datos de salida en la ficha Resultados.

Consola console

La consola proporciona información sobre el estado y el funcionamiento del servicio de consultas. La consola muestra el estado de conexión al servicio de consultas, las operaciones de consulta que se están ejecutando y los mensajes de error que resulten de esas consultas.

Resultados de consulta query-results

Una vez finalizada una consulta, los resultados se muestran en la ficha Resultados, junto a la ficha Consola. Esta vista muestra el resultado tabular de la consulta, mostrando entre 50 y 500 filas de resultados según el recuento de resultados que haya elegido. Esta vista le permite comprobar que la consulta produce el resultado esperado. Para generar un conjunto de datos con la consulta, quite los límites de las filas devueltas y ejecute la consulta con CREATE TABLE tablename AS SELECT para generar un conjunto de datos con el resultado. Consulte el tutorial de generación de conjuntos de datos para obtener instrucciones sobre cómo generar un conjunto de datos a partir de los resultados de la consulta en el Editor de consultas.

Casos de uso use-cases

El servicio de consulta proporciona soluciones para una variedad de casos de uso en industrias y escenarios empresariales. Estos ejemplos prácticos demuestran la flexibilidad y el impacto del servicio para abordar diversas necesidades. Para descubrir cómo el servicio de consultas puede aportar valor a sus necesidades comerciales específicas, explore la colección completa de documentos de casos de uso. Aprenda a utilizar el servicio de consulta para proporcionar perspectivas y soluciones que mejoren la eficacia operativa y el éxito empresarial.

Tutorial en vídeo de ejecución de consultas con el servicio de consultas query-tutorial-video

El siguiente vídeo muestra cómo ejecutar consultas en la interfaz de Adobe Experience Platform y en un cliente SQL. En el vídeo también se muestra el uso de propiedades individuales en un objeto XDM, funciones definidas por el Adobe y cómo utilizar CREATE TABLE AS SELECT (CTAS).

Pasos siguientes

Ahora que sabe qué características están disponibles en el Editor de consultas y cómo navegar por la aplicación, puede empezar a crear sus propias consultas directamente en Platform. Para obtener más información sobre la ejecución de consultas SQL en conjuntos de datos de Data Lake, consulte la guía sobre ejecución de consultas.