動的なデータ型

dynamicスカラー データ型には、次のいずれかの値を指定できます。

• 0 から始まるインデックスを持つ、0 以上の値が保持される dynamic 値の配列。
• 一意の string 値を dynamic 値にマップするプロパティ バッグ。 プロパティ バッグには、一意の string 値によってインデックス付けされたこのようなマッピング ("スロット" と呼ばれる) が 0 以上あります。 スロットは順序付けられていません。
• プリミティブ スカラー データ型の任意の値: bool、datetime、guid、int、long、real、string、および timespan。
• Null。 詳細については、「null 値の」を参照してください。

動的リテラル

dynamicリテラルを指定するには、次のいずれかの構文オプションを使用します。

構文規則について詳しく知る。

動的オブジェクトのアクセサー

ディクショナリを添字で指定するには、ドット表記 (dict.key) または角かっこ表記 (dict["key"]) のいずれかを使用します。 添字が文字列定数の場合は、どちらのオプションも同等になります。

次の例では、dict と arr は動的な型の列です。

dynamic 値のサブオブジェクトにアクセスすると、サブオブジェクトの基になる型が異なる場合でも、もう 1 つの dynamic 値が生成されます。 gettype 関数を使用して実際に値の基になっている型を検出し、以下の一覧にあるいずれかのキャスト関数によって実際の型にキャストします。

動的オブジェクトをキャストする

動的オブジェクトを添字で指定した後に、値を単純な型にキャストする必要があります。

CAST 関数は次のとおりです。

• tolong()
• todouble()
• todatetime()
• totimespan()
• tostring()
• toguid()
• parse_json()

動的オブジェクトをビルドする

以下に示すいくつかの関数を使用して、新しい dynamic オブジェクトを作成できます。

• bag_pack() は、名前と値のペアからプロパティ バッグを作成します。
• pack_array() は、値のリストから配列を作成します (列のリストを指定できます。各行に対して、指定した列から配列を作成します)。
• range() は、一連の算術数値を含む配列を作成します。
• zip() は、2 つの配列から "並列" の値を組み合わせて、1 つの配列にします。
• repeat() は、繰り返し値を持つ配列を作成します。

さらに、集計値を保持する dynamic 配列を作成する集計関数がいくつかあります。

• buildschema() は、複数の dynamic 値の集計スキーマを返します。
• make_bag() は、グループ内の動的な値のプロパティ バッグを返します。
• make_bag_if() は、グループ内の動的な値のプロパティ バッグを (述語を使用して) 返します。
• make_list() は、すべての値を保持する配列を順番に返します。
• make_list_if() は、すべての値を保持する配列を (述語を使用して) 順番に返します。
• make_list_with_nulls() は、すべての値を保持する配列 (null 値を含む) を順番に返します。
• make_set() は、すべての一意の値を保持する配列を返します。
• make_set_if() は、すべての一意の値を保持する配列を (述語を使用して) 返します。

動的な型に対する演算子と関数

スカラーの動的/配列関数の完全なリストについては、「動的/配列関数」を参照してください。

動的データのインデックス作成

データの取り込み中に、すべてのフィールドにインデックスが作成されます。 インデックスのスコープは、個々のデータ シャードです。

動的な列にインデックスを付けるために、インジェストプロセスで、動的な値に含まれる"アトミック"な要素(プロパティ名、値、配列要素)がすべて列挙されてインデックス ビルダーに転送されます。 それ以外には、動的フィールドには、文字列フィールドと同じ逆引きの語句インデックスが作成されます。

例

動的プロパティ バッグ

次のクエリでは、動的プロパティ バッグが作成されます。

print o=dynamic({"a":123, "b":"hello", "c":[1,2,3], "d":{}})
| extend a=o.a, b=o.b, c=o.c, d=o.d

便宜上、クエリ テキスト自体に表示される dynamic リテラルには、datetime、timespan、real、long、guid、bool、および dynamic 型を持つ他の Kusto リテラルが含まれる場合もあります。 JSON に対するこの拡張機能は、文字列を解析する場合 (parse_json 関数を使用する場合やデータを取り込む場合など) には使用できませんが、次の操作を行うことができます。

print d=dynamic({"a": datetime(1970-05-11)})

JSON エンコーディング規則に従う string 値を dynamic 値に解析するために、parse_json 関数を使用します。 次に例を示します。

• parse_json('[43, 21, 65]') - 数値の配列
• parse_json('{"name":"Alan", "age":21, "address":{"street":432,"postcode":"JLK32P"}}') - ディクショナリ
• parse_json('21') - 数値を示す、動的な型の単一の値
• parse_json('"21"') - 文字列を示す、動的な型の単一の値
• parse_json('{"a":123, "b":"hello", "c":[1,2,3], "d":{}}') - 上記の例のoと同じ値を指定します。

動的列にデータを取り込む

次の例では、 dynamic 列 (および datetime 列) を保持するテーブルを定義し、そのテーブルに単一レコードを取り込む方法を示します。 また、CSV ファイルで JSON 文字列をエンコードする方法も示します。

// dynamic is just like any other type:
.create table Logs (Timestamp:datetime, Trace:dynamic)

// Everything between the "[" and "]" is parsed as a CSV line would be:
// 1. Since the JSON string includes double-quotes and commas (two characters
//    that have a special meaning in CSV), we must CSV-quote the entire second field.
// 2. CSV-quoting means adding double-quotes (") at the immediate beginning and end
//    of the field (no spaces allowed before the first double-quote or after the second
//    double-quote!)
// 3. CSV-quoting also means doubling-up every instance of a double-quotes within
//    the contents.

.ingest inline into table Logs
  [2015-01-01,"{""EventType"":""Demo"", ""EventValue"":""Double-quote love!""}"]

出力

関連するコンテンツ

• 動的オブジェクトとオブジェクト アクセサーを使用してクエリを実行する方法の例については、「 セット間の値のマップ」を参照してください。