集成外部数据
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
]))
| ...