Compartir a través de

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 utilizando el asistente de creación.

Requisitos previos

Creación de 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 de destino

  1. Los campos Cluster (Clúster) y Database (Base de datos) están preconfigurados. 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, incluidos caracteres 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 Vincular a contenedores, puede agregar un contenedor de dos maneras: Agregar un contenedor con el botón Seleccionar contenedor y Agregar un contenedor con el botón Agregar dirección 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 que usa el contenedor.

    Captura de pantalla de la ventana para seleccionar el contenedor

  3. Selecciona Agregar. Cuando finaliza la comprobación, aparece una marca de verificación verde a la derecha del enlace 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 cadenas de conexión de almacenamiento para su contenedor de origen con permisos de lectura y lista. Cuando finaliza la comprobación, aparece una marca de verificación verde a la derecha del enlace 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. Puede filtrar los archivos por ruta de acceso de carpeta, archivo que comienza con o por extensión de 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 muestra los archivos debajo de Filtros de archivo.

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 usa para generar el esquema de 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 el asistente no las admite. Puede configurar los mapeos posteriormente 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 vista para la tabla externa en Azure Data Explorer.

  2. Se abre la ventana de particiones. Una partición se define sobre una subruta del archivo, que puede cambiar mediante el campo Prefijo de ruta. Para cada partición que quiera 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 Subruta del archivo en el que se definen las 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 utiliza para construir la URI de ruta de acceso 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 declaran dos particiones: una partición sobre el nombre del cliente y una partición a lo largo de la fecha insertada en la dirección URL.

    Nota:

    Las columnas virtuales aparecen como parte del esquema, ya que los datos de estas columnas se extraen de la ruta del archivo, y puede usar estos datos más adelante 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. No se pueden cambiar las columnas con particiones en la versión preliminar.

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

  5. Seleccione Next: Create table (Siguiente: Crear tabla). Al crear la tabla, se abre una ventana con el mensaje External table successfully created.

  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 la tabla externa

La tabla resultante incluye datos de todos los archivos que se ajustan a los criterios definidos. Puede consultar esta tabla mediante la external_table() función . 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.

Contenido relacionado

  • Last updated on