集成外部数据

5 分钟

externaldata 运算符返回一个表，该表的架构在查询本身中定义。该表的数据从外部存储项目读取，例如 Azure Blob 存储中的 blob 或 Azure Data Lake Storage 文件。

语法

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

参数

ColumnName, ColumnType：这些参数定义表的架构。该语法与定义 .create table 中的表时所使用的语法相同。
StorageConnectionString：存储连接字符串，用于描述包含要返回的数据的存储项目。
PropertyName、PropertyValue 等：更多描述如何解释从存储检索的数据的属性，如引入属性下所列。

当前支持的属性包括：

参数

属性	类型	说明
format	字符串	数据格式。如果未指定，则会尝试从文件扩展名检测数据格式（默认为 CSV）。支持任何引入数据格式。
ignoreFirstRecord	bool	如果设置为 true，则表示每个文件中的第一条记录均会被忽略。在查询带有标题的 CSV 文件时，此属性很有用。
ingestionMapping	字符串	一个字符串值，表示如何将数据从源文件映射到运算符结果集中的实际列。请参阅数据映射。

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

继续

集成外部数据

反馈