.ingest inline コマンド (プッシュ)
このコマンドは、コマンドに含まれるデータをテーブルにプッシュすることで、テーブルにデータを挿入します。
Note
このインジェスト方法は、探索とプロトタイプ作成を目的としています。 運用環境や大量のシナリオでは使用しないでください。
アクセス許可
このコマンドを実行するには、少なくとも Table Ingestor アクセス許可が必要です。
構文
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName =
IngestionPropertyValue [,
...] )
] <|
データ
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName =
IngestionPropertyValue [,
...] )
] [
データ ]
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
TableName | string |
✔️ | データを取り込むテーブルの名前。 テーブル名は必ずコンテキスト内のデータベースに対応するものになり、そのスキーマは、スキーマ マッピング オブジェクトが指定されていない場合にデータに対して想定されるスキーマになります。 |
Data | string |
✔️ | 取り込むデータ コンテンツ。 インジェスト プロパティによって変更されない限り、このコンテンツは CSV として解析されます。 |
IngestionPropertyName、 IngestionPropertyValue | string |
インジェスト プロセスに影響を与える任意の数の ingestion プロパティ 。 |
Note
ほとんどの管理コマンドやクエリとは異なり、コマンドの Data 部分のテキストは、言語の構文規則に従う必要はありません。 たとえば、空白文字が重要であるとか、//
の組み合わせがコメントとして扱われないといったことです。
返品
結果は、生成されたデータ シャード ("エクステント") の数と同数のレコードを含むテーブルになります。 データ シャードが生成されない場合、エクステント ID が空 (0 値) の 1 つのレコードが返されます。
名前 | 種類 | 説明 |
---|---|---|
ExtentId | guid |
コマンドによって生成されたデータ シャードの一意識別子 |
例
<|
構文を使用した取り込み
次のコマンドは、SKU
(string
型) とQuantity
(long
型) の 2 つの列を持つテーブル Purchases
にデータを取り込みます。
.ingest inline into table Purchases <|
Shoes,1000
Wide Shoes,50
"Coats black",20
"Coats with ""quotes""",5
角かっこ構文を使用した取り込み
次のコマンドは、Date
(datetime
型) とEventDetails
(dynamic
型) の 2 つの列を持つテーブル Logs
にデータを取り込みます。
.ingest inline into table Logs
[2015-01-01,"{""EventType"":""Read"", ""Count"":""12""}"]
[2015-01-01,"{""EventType"":""Write"", ""EventValue"":""84""}"]