Integración de datos externos

  • 5 minutos

El operador externaldata devuelve una tabla cuyo esquema se define en la propia consulta. Sus datos se leen de un artefacto de almacenamiento externo, como un blob de Azure Blob Storage o un archivo de Azure Data Lake Storage.

Sintaxis

 externaldata ( ColumnName : ColumnType [, ...] )
  [ StorageConnectionString [, ...] ]
  [with ( PropertyName = PropertyValue [, ...] )]

Argumentos

  • ColumnName, ColumnType: los argumentos definen el esquema de la tabla. La sintaxis es la misma que la que se usa para definir una tabla en .create.table.

  • StorageConnectionString: cadenas de conexión del almacenamiento que describen los artefactos de almacenamiento que contienen los datos que se van a devolver.

  • PropertyName, PropertyValue, ...: más propiedades que describen cómo interpretar los datos recuperados del almacenamiento, como se muestra en propiedades de ingesta.

Actualmente, las propiedades admitidas son:

ARGUMENTOS

Propiedad Tipo Descripción
format string Formato de datos. Si no se especifica, se intenta detectar el formato de los datos por la extensión del archivo (el valor predeterminado es CSV). Se admite cualquiera de los formatos de datos de ingesta.
ignoreFirstRecord bool Si se establece en true, indica que se omite el primer registro de cada archivo. Esta propiedad es útil cuando se consultan archivos .csv con encabezados.
ingestionMapping string Valor de cadena que indica cómo se asignan los datos del archivo de origen a las columnas reales del conjunto de resultados del operador. Consulte Asignaciones de datos.

Devoluciones

El operador externaldata devuelve una tabla de datos del esquema dado con los datos analizados del artefacto de almacenamiento especificado, que viene indicado por la cadena de conexión del almacenamiento.

Nota:

Este ejemplo no está disponible en el entorno de demostración.

Users
| where UserID in ((externaldata (UserID:string) [
    @"https://storageaccount.blob.core.windows.net/storagecontainer/users.txt" 
      h@"?...SAS..." // Secret token needed to access the blob
    ]))
| ...