Use el asistente del generador de aplicaciones de ejemplo a fin de crear código para ingerir y consultar los datos

  • Artículo

El asistente del generador de aplicaciones de ejemplo es una herramienta que permite crear una aplicación de trabajo para ingerir y consultar los datos en el lenguaje de programación que prefiera. El código generado hace referencia a los marcos de SDK pertinentes y se adapta al clúster y a los datos. La aplicación es un ejemplo independiente, ejecutable que muestra cómo conectarse a un clúster mediante la autenticación y cómo administrar, ingerir y consultar datos mediante el SDK.

Puede usar el código generado como base de referencia para escribir sus propias aplicaciones, modificar el código a medida que lo necesite, o puede copiar secciones de código en sus propias aplicaciones. El código incluye comentarios con sugerencias, procedimientos recomendados, vínculos a material de referencia y cambios de tareas pendientes recomendados para adaptar el código a sus necesidades.

Prerrequisitos

Nota

Para habilitar el acceso entre un clúster y una cuenta de almacenamiento sin acceso público (restringido al punto de conexión privado o al punto de conexión de servicio), consulte Creación de un punto de conexión privado administrado.

Acceso al asistente

El asistente del generador de aplicaciones de ejemplo le guía a través del proceso de ingesta.

Para acceder al asistente desde la interfaz de usuario web de Azure Data Explorer:

  1. Seleccione Query (Consulta) en el panel de la izquierda.

  2. Haga clic con el botón derecho en la tabla deseada y seleccione Generar>código de ejemplo.

    Captura de pantalla que muestra la tarjeta generadora de aplicaciones de ejemplo en el menú contextual de la tabla.

Generación de una aplicación de ejemplo

En esta sección se describe el asistente en general. Las opciones que seleccione dependen del formato de datos que va a ingerir, del tipo de origen de datos desde el que va a ingerir y de si va a ingerir en una tabla nueva o existente.

Este asistente le guía por las siguientes opciones:

Destination

En la pestaña Destino :

  1. Seleccione el clúster y la base de datos.

  2. Elija si desea usar una tabla existente o una tabla nueva. Para una tabla existente, seleccione la tabla en las opciones. Para una nueva tabla, asigne un nombre a la tabla.

  3. Seleccione el lenguaje de programación de la aplicación.

    Captura de pantalla de la interfaz de usuario web de Azure Data Explorer que muestra la pestaña De destino del generador de aplicaciones de ejemplo.

  4. Seleccione Next: Source (Siguiente: Origen).

Source

En la pestaña Origen:

  1. Elija entre las siguientes opciones:

    • Consulta e ingesta: cargue los datos para la ingesta y reciba el código correspondiente para la ingesta y la consulta de los datos especificados.
    • Solo consulta: obtenga el código para consultar la tabla seleccionada en la pestaña anterior.

  2. Si seleccionó Consulta e ingesta, seleccione el archivo de origen o el blob para la ingesta.

  3. Seleccione Next: Schema (Siguiente: Esquema).

Schema

En la pestaña Esquema , el servicio genera automáticamente propiedades de esquema e ingesta, que puede modificar según sea necesario. Para configurar el esquema:

  1. Confirme el tipo de compresión generada automáticamente.

  2. Elija el formato De datos de los formatos admitidos por Azure Data Explorer para la ingesta. Los diferentes formatos tienen especificaciones diferentes.

  3. En la ventana Vista previa de datos parciales , ajuste el esquema según sea necesario. Para ello, seleccione la flecha situada en la parte superior de una columna para abrir un menú con opciones para cambiar el tipo de datos, crear una nueva columna, eliminar una columna y mucho más. Si los datos están en formato Parquet, JSON o Avro, puede aplicar transformaciones de asignación.

    Captura de pantalla de cómo abrir las opciones de ajuste del esquema.

  4. Seleccione Siguiente: Generar aplicación de ejemplo.

Sugerencia

Para ver, editar y copiar los comandos generados a partir de las entradas, abra el visor de comandos encima de la ventana Vista previa de datos parciales .

Asignación de transformaciones

Los formatos de datos Parquet, JSON y Avro admiten transformaciones en tiempo de ingesta simples. Para aplicar transformaciones de asignación, cree o actualice una columna en la ventana Vista previa de datos parciales .

Las transformaciones de asignación se pueden realizar en una columna de tipo cadena o datetime, con los datos de origen que tienen el tipo de datos int o long. Las asignaciones de transformaciones que se admiten son:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Para obtener más información, consulte Transformaciones de asignación.

Generate

Una vez completada la asignación de esquemas y las manipulaciones de columnas, el Asistente para generadores de aplicaciones de ejemplo inicia el proceso de generación de código. Después de la generación de código, el proyecto de la aplicación de ejemplo estará disponible para su descarga como un archivo ZIP.

Las instrucciones detalladas para ejecutar el proyecto con el SDK seleccionado se proporcionan tras una generación correcta y dentro del archivo de proyecto de ejemplo. Además, el asistente ofrece opciones para usar consultas rápidas para la exploración inicial de los datos.

Nota

Es posible que tenga que ejecutar la aplicación descargada para que las consultas rápidas funcionen.

Contenido relacionado