Интегрирование внешних данных

  • 5 мин

Оператор externaldata возвращает таблицу, схема которой определена в самом запросе. Данные, которые считываются из объекта внешнего хранилища, например, из BLOB-объекта в Azure Blob Storage или из файла в Azure Data Lake Storage.

Синтаксис

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

Аргументы

  • ColumnName, ColumnType: аргументы определяют схему таблицы. Синтаксис совпадает с синтаксисом, используемым при определении таблицы. создайте таблицу.

  • StorageConnectionString: строки подключения к хранилищу, описывающие артефакты хранилища, которые содержат возвращаемые данные.

  • PropertyName, PropertyValue, ...: Дополнительные свойства, описывающие интерпретацию данных, полученных из хранилища, как указано в свойствах приема.

В настоящее время поддерживаются следующие свойства:

АРГУМЕНТЫ

Недвижимость Тип Описание
формат струна Формат данных. Если это не указано, предпринята попытка определить формат данных из расширения файла (по умолчанию — CSV). Все форматы данных для импорта поддерживаются.
игнорироватьПервуюЗапись булевая переменная (bool) Если задано значение true, указывает, что первая запись в каждом файле игнорируется. Это свойство полезно при запросе CSV-файлов с заголовками.
Карта приёма данных струна Строковое значение, указывающее, как сопоставить данные из исходного файла с фактическими столбцами в результирующем наборе операторов. См. сопоставления данных.

Возвраты

Оператор externaldata возвращает таблицу данных данной схемы с данными, проанализированными из указанного артефакта хранилища, указанного строкой подключения к хранилищу.

Замечание

Этот пример недоступен в демонстрационной среде.

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
    ]))
| ...