你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
.ingest inline 命令(推送)
此命令通过将命令中包含的数据推送到表中,将这些数据插入表中。
注意
此引入方法用于探索和原型制作。 请勿在生产或大批量方案中使用它。
权限
你必须至少具有表引入者权限才能运行此命令。
语法
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName=
IngestionPropertyValue [,
...] )
] <|
Data
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName=
IngestionPropertyValue [,
...] )
] [
Data]
详细了解语法约定。
参数
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
TableName | string |
✔️ | 要在其中引入数据的表的名称。 表名在上下文中始终相对于数据库,如果未提供架构映射对象,则其架构是将为数据采用的架构。 |
数据 | string |
✔️ | 要引入的数据内容。 除非已通过引入属性进行其他修改,否则此内容将作为 CSV 进行分析。 |
IngestionPropertyName, IngestionPropertyValue | string |
影响引入过程的任意数量的引入属性。 |
注意
与大多数管理命令和查询不同,此命令的 Data 部分的文本不一定要遵循语言的语法约定。 例如,空格字符很重要,否则系统不会将 //
组合视为注释。
返回
结果是一个表,其中包含的记录数目与生成的数据分片(“盘区”)的数目相同。 如果未生成任何数据分片,则返回一条带有空(零值)盘区 ID 的记录。
名称 | 类型 | 说明 |
---|---|---|
ExtentId | guid |
该命令生成的数据分片的唯一标识符 |
示例
使用 <|
语法引入
以下命令将数据引入到包含 SKU
列(类型为 string
)和 Quantity
列(类型为 long
)的表 Purchases
。
.ingest inline into table Purchases <|
Shoes,1000
Wide Shoes,50
"Coats black",20
"Coats with ""quotes""",5
使用括号语法引入
以下命令将数据引入到包含 Date
列(类型为 datetime
)和 EventDetails
列(类型为 dynamic
)的表 Logs
。
.ingest inline into table Logs
[2015-01-01,"{""EventType"":""Read"", ""Count"":""12""}"]
[2015-01-01,"{""EventType"":""Write"", ""EventValue"":""84""}"]
相关内容
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈