Query Editor Guía de IU

Query Editor es una herramienta interactiva que proporciona Adobe Experience Platform Query Service, que le permite escribir, validar y ejecutar consultas para datos de experiencia del cliente dentro de Experience Platform interfaz de usuario. Query Editor 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 de Query Service, consulte la 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 Introducción a IU del servicio de consultas.

Primeros pasos

Query Editor proporciona una ejecución flexible de consultas conectándose a Query ServiceLas consultas, y solo se ejecutarán mientras esta conexión esté activa.

Conectando con Query Service

Query Editor tarda unos segundos en inicializarse y conectarse a Query Service 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.

Ejecución de consultas desde Query Editor

Consultas ejecutadas desde Query Editor ejecutar de forma interactiva. Esto significa que si cierra el explorador o sale, la consulta se cancela. Esto también se aplica a las consultas realizadas para generar conjuntos de datos a partir de resultados de consultas.

Creación de consultas mediante Query Editor

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

Acceso a Query Editor

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

Escritura de consultas

Editor de consultas está organizado para que la escritura de consultas sea lo más sencilla 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 las 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 la salida.

Herramientas de escritura en Query Editor

• Resaltado automático de sintaxis: Facilita la lectura y organización de SQL.

• Palabra clave SQL autocompletada: Empiece a escribir la consulta y, a continuación, utilice las teclas de flecha para desplazarse hasta el término deseado y pulse Entrar.

• Autocompletar tabla y campo: Empiece a escribir el nombre de tabla que desea SELECT en, utilice las teclas de flecha para desplazarse a la tabla que está buscando y pulse Entrar. Una vez seleccionada una tabla, el completado automático reconocerá los campos de esa tabla.

Opción de configuración de IU de autocompletar

El Query Editor 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 seleccionando la opción Sintaxis autocompletada en la parte superior derecha 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.

Al utilizar la opción para habilitar la función de autocompletar, las sugerencias recomendadas para nombres de tablas y columnas, así como las palabras clave SQL, están disponibles después de una breve pausa. Un mensaje de éxito en la consola debajo del Editor de consultas indica que la función está activa.

Si deshabilita la característica de autocompletar, se requiere una actualización de la página para que la característica surta efecto. Aparecerá un cuadro de diálogo de confirmación con tres opciones cuando desactive la Sintaxis autocompletada alternar :

• Cancelar
• Guardar cambios y actualizar
• Actualizar sin guardar los cambios

Seleccione la opción adecuada para deshabilitar la función de autocompletar.

Detección de errores

Query Editor valida automáticamente una consulta a medida que la escribe, proporcionando validación SQL genérica y validación de ejecución específica. Si aparece una línea roja de subrayado debajo de la consulta (como se muestra en la imagen siguiente), representa un error dentro de la consulta.

Cuando se detectan errores, puede ver los mensajes de error específicos pasando el ratón por encima del código SQL.

Detalles de consulta

Seleccione cualquier plantilla guardada del Plantillas para verlo en el Editor de consultas. El panel de detalles de la consulta proporciona más información y herramientas para administrar la consulta seleccionada.

Este panel le permite generar un conjunto de datos de salida directamente desde la interfaz de usuario, eliminar o asignar un nombre a la consulta mostrada y agregar una programación a la consulta.

Este panel también muestra metadatos útiles, como la última vez que se modificó la consulta y quién la modificó, si corresponde. Para generar un conjunto de datos, seleccione Conjunto de datos de salida. El Conjunto de datos de salida aparece el cuadro de diálogo. Introduzca un nombre y una descripción y, a continuación, seleccione Ejecutar consulta. El nuevo conjunto de datos se muestra en la Conjuntos de datos de la pestaña Query Service interfaz de usuario en Platform.

Consultas programadas

Las consultas que se han guardado como plantilla se pueden programar desde el Editor de consultas. Esto le permite automatizar las ejecuciones de consulta que se ejecutan 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 desde el Editor de consultas. A continuación se muestra una lista de limitaciones para las consultas programadas al utilizar el Editor de consultas. No se aplican al Query Service API:

• Solo puede agregar una programación a una consulta que ya se ha creado, guardado y ejecutado.
• Usted no puede añada una programación a una consulta parametrizada.
• Consultas programadas no puede contiene un bloque anónimo.

Consulte la documentación de programaciones de consultas para obtener información sobre cómo crear programaciones de consultas en la interfaz de usuario. También puede aprender a añadir programaciones mediante la API leyendo el guía de extremo de consultas programadas.

Todas las consultas programadas se agregan a la lista de la Consultas programadas pestaña. 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 el Consultas programadas pestaña puede encontrar información importante sobre las ejecuciones de consultas y suscribirse a alertas. La información disponible incluye el estado, los detalles de la programación y los mensajes/códigos de error en caso de que falle una ejecución. Consulte la Documento de supervisión de consultas programadas para obtener más información.

Guardar consultas

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

Cómo encontrar consultas anteriores

Todas las consultas ejecutadas desde Query Editor se capturan en la Tabla de registro. Puede utilizar la funcionalidad de búsqueda en la Registro para buscar ejecuciones de consulta. Las consultas guardadas se enumeran en la variable Plantillas pestaña.

Si se ha programado una consulta, la variable Consultas programadas proporciona una visibilidad mejorada a través de la interfaz de usuario para esos trabajos de consulta. Consulte la documentación de monitorización de consultas para obtener más información.

Ejecución de consultas mediante el Editor de consultas

Para ejecutar una consulta en Query Editor, puede introducir SQL en el editor o cargar una consulta anterior desde el Registro o Plantillas y seleccione. Reproducir. El estado de ejecución de la consulta se muestra en la variable Consola , los datos de salida se muestran en la pestaña Resultados pestaña.

Consola

La consola proporciona información sobre el estado y el funcionamiento de Query Service. La consola muestra el estado de la conexión a Query Service, las operaciones de consulta que se están ejecutando y los mensajes de error resultantes de esas consultas.

Resultados de consulta

Una vez completada la consulta, los resultados se muestran en la variable Resultados , junto a la pestaña Consola pestaña. Esta vista muestra el resultado tabular de la consulta, con un máximo de 100 filas. 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 la salida. Consulte la 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 Query Editor.

Ejecutar consultas con Query Service tutorial en vídeo

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

Pasos siguientes

Ahora que sabe qué funciones están disponibles en Query Editor 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 en Data Lake, consulte la guía de ejecución de consultas.

Recursos de Business.Adobe.com

Enterprise Governance Product Recommendations Advertising Revenue Customer Segmentation Predictive Analytics Efficiency Tools