Compartir vía


Creación de una tabla externa mediante el asistente de la interfaz de usuario web de Azure Data Explorer

Una tabla externa es una entidad de esquema que hace referencia a los datos almacenados fuera de una base de datos de Azure Data Explorer. La interfaz de usuario web de Azure Data Explorer puede crear tablas externas tomando archivos de ejemplo de un contenedor de almacenamiento y creando esquemas basados en estos ejemplos. Después, puede analizar y consultar los datos de las tablas externas sin ninguna ingesta en Azure Data Explorer. Para obtener información general breve, consulte tablas externas. Para más información sobre las distintas formas de crear tablas externas, consulte Creación y modificación de tablas externas de Azure Storage. En este artículo se indica cómo crear una tabla externa con la experiencia del asistente de creación.

Requisitos previos

Crear una tabla externa

  1. En el menú de la izquierda, seleccione Query (Consulta).

  2. Haga clic con el botón derecho en la base de datos donde desea crear la tabla externa. Seleccione Crear tabla externa.

    Captura de pantalla de la opción para crear una tabla externa desde la página de consulta.

La ventana Create external table (Crear tabla externa) se abre con la pestaña Destination (Destino) seleccionada.

Pestaña Destination (Destino)

  1. Los campos Cluster (Clúster) y Database (Base de datos) se rellenan previamente. Puede seleccionar otro destino en el menú desplegable.
  2. En Table name (Nombre de la tabla), escriba un nombre para la tabla.

    Sugerencia

    Los nombres de tabla pueden tener hasta 1024 caracteres, entre los que se incluyen alfanuméricos, guiones y caracteres de subrayado. No se admiten caracteres especiales.

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

Captura de pantalla de la pestaña Destination (Destino) con los campos Cluster, Database y Table name (Clúster, Base de datos y Nombre de tabla).

Pestaña Source (Origen)

En Link to containers (Vincular a contenedores), hay dos formas de agregar un contenedor: agregar un contenedor con el botón Select container (Seleccionar contenedor) y agregar un contenedor con el botón Add URL or Add container (Agregar URL o Agregar contenedor).

Puede agregar hasta diez contenedores de origen.

Agregue el contenedor con el botón Select container.

  1. Seleccione Seleccionar contenedor.

    Captura de pantalla del botón para seleccionar el contenedor en la pestaña de origen.

  2. Elija la suscripción y la cuenta de almacenamiento correspondientes asociadas al contenedor.

    Captura de pantalla de la ventana para seleccionar el contenedor

  3. Seleccione el botón Agregar. Una vez completada la comprobación, aparecerá una comprobación verde a la derecha del vínculo del contenedor.

    Captura de pantalla del vínculo de contenedor comprobado

Agregue el contenedor con el botón Add URL or Add container (Agregar URL o Agregar contenedor).

  1. Seleccione el botón Add URL (Agregar URL) o Add container (Agregar contenedor).

    Captura de pantalla del botón para agregar la URL

  2. Escriba una cadena de conexión de almacenamiento en el contenedor de origen con permisos de lectura y lista. Una vez completada la comprobación, aparecerá una comprobación verde a la derecha del vínculo del contenedor.

    Captura de pantalla de la adición de la dirección URL de SAS.

Filtros de archivo

Use los filtros de archivos para filtrar los archivos que la tabla debe incluir. Los archivos se pueden filtrar según la ruta de acceso de la carpeta, según cómo empieza el nombre del archivo o según la extensión del archivo.

Captura de pantalla de la selección del archivo que define el esquema.

Archivo de definición de esquema

El primer contenedor de origen mostrará archivos debajo de los filtros de archivos.

Captura de pantalla de la pestaña de origen para crear una tabla externa en Azure Data Explorer.

  1. Para elegir el archivo que define el esquema, seleccione el círculo situado a la izquierda del archivo. Este archivo se utilizará para generar el esquema de la tabla.
  2. Seleccione Next: Schema (Siguiente: Esquema). Se abre la pestaña Schema (Esquema).

Pestaña Esquema

En el lado derecho de la pestaña, puede obtener una vista previa de los datos. En el lado izquierdo, puede agregar particiones a las definiciones de tabla para acceder a los datos de origen más rápidamente y lograr un mejor rendimiento.

Nota

Las asignaciones no forman parte de la definición de una tabla externa y no se admiten en este asistente. Las asignaciones se pueden configurar más adelante si es necesario. Algunas funcionalidades, como la eliminación de la última columna de archivos CSV o el cambio de los nombres de columnas en archivos JSON, requieren asignaciones para que funcionen correctamente.

  1. Seleccione Add partition (Agregar partición).

    Captura de pantalla del archivo de vistas de la tabla externa en Azure Data Explorer.

  2. Se abrirá la ventana de particiones. Una partición se define en un subtrazado del archivo, el cual se puede modificar mediante el campo Prefijo de ruta de acceso. Para cada partición que desee aplicar, rellene los campos como se indica a continuación:

    Campo Descripción Obligatorio/opcional
    Nombre de la partición Se utiliza para la identificación de la partición. El nombre puede ser arbitrario. Obligatorio
    Tipo El tipo de datos de la columna de partición de datos. Obligatorio
    Columna de datos Columna usada para la creación de particiones. Partición de columnas virtuales según la ruta de acceso URL. Obligatorio
    Función La función que se aplica a la columna de datos utilizada para la creación de particiones. Opcionales
    Argumento de la función Argumento que se va a usar en la función de partición. Es obligatorio si se usa la función.
    Prefijo de ruta de acceso Subtrazado del archivo en el que se define la creación de particiones. Este prefijo cambia la dirección URL de la tabla externa, tal como se muestra en el cuadro Uri preview (Vista previa del URI), y debe coincidir con el URI del archivo que define el esquema. Opcionales
    Patrón de fecha y hora Formato de fecha que se usará para construir la ruta de acceso del URI de la tabla. Opcionales

    Captura de pantalla para agregar particiones a la tabla externa en Azure Data Explorer.

    Por ejemplo, el nombre de partición CustomerName sugiere que el valor mediante el cual se va a crear la partición se encuentra en la parte del nombre del cliente de la dirección URL. En el ejemplo anterior se declararon dos particiones: una partición en el nombre del cliente y una partición en la fecha insertada en la dirección URL.

    Nota

    Las columnas virtuales aparecen como parte del esquema como los datos de las columnas extraídos de la ruta de acceso del archivo, y estos datos se pueden usar posteriormente en las consultas.

  3. Seleccione Add partition (Agregar partición) para agregar otra partición.

  4. Seleccione Guardar. Las particiones que ha agregado aparecen ahora en la lista de particiones del panel izquierdo. Las columnas con particiones no se pueden cambiar en la vista previa.

    Captura de pantalla de la tabla externa de esquema de Azure Data Explorer.

  5. Seleccione Next: Create table (Siguiente: Crear tabla). Cuando se crea la tabla, se abre una ventana que indica que la tabla externa se ha creado correctamente.

  6. Para ver el comando que se usa para crear la tabla, seleccione View command (Ver comando).

    Captura de pantalla de la creación correcta de una tabla externa en Azure Data Explorer.

  7. Para deshacer la creación de la tabla externa, seleccione Herramientas>Deshacer.

Consulta de la tabla externa

La tabla resultante incluye los datos de todos los archivos que se ajustan a los criterios definidos anteriormente. Puede consultar esta tabla mediante la función external_table(). Para más información sobre cómo consultar tablas externas, lea Consulta de una tabla externa.

Captura de pantalla de la salida de la tabla desde la consulta de la tabla externa en Azure Data Explorer.