エンティティ名

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel

Kusto エンティティは、名前によってクエリで参照されます。 名前で参照できるエンティティには、 databases、 tables、 columns、およびストアド関数 があります。 エンティティを割り当てる名前を識別子と呼びます。 エンティティに加えて、識別子を query パラメーターに割り当てたり、 let ステートメントを使用して設定された変数に割り当てることもできます。

エンティティの名前は、そのコンテナーのコンテキスト内のエンティティ型に固有です。 たとえば、同じデータベース内の 2 つのテーブルに同じ名前を付けることはできませんが、データベースとテーブルは異なるエンティティ型であるため、同じ名前を持つことができます。 同様に、テーブルとストアド関数の名前は同じでもかまいません。

Note

エンティティ名は、 Azure リソースとしても反映、 ARM 予約単語ルールに従います。

美しい名前

エンティティの名前に加えて、一部のエンティティには pretty 名があります。 エンティティ名の使用と同様に、クエリでエンティティを参照するためにかなり名前を使用できます。 ただし、エンティティ名とは異なり、美しい名前は必ずしもコンテナーのコンテキストで一意であるとは限りません。 同じプリティ名を持つ複数のエンティティがコンテナーに存在する場合、そのプリティ名を使用してエンティティを参照することはできません。

かなり名前を使用すると、中間層アプリケーションは、自動的に作成されたエンティティ名 (UUID など) を、表示および参照の目的で人間が判読できる名前にマップできます。

識別子の名前付け規則

識別子は、 entities、 query パラメーター、または変数セットに割り当てる let ステートメントに割り当てる名前です。 識別子を有効にするには次の規則に従う必要があります。

• 識別子では大文字と小文字が区別されます。 データベース名では大文字と小文字が区別されないため、この規則の例外です。
• 識別子の長さは 1 ~ 1024 文字にする必要があります。
• 識別子には、文字、数字、アンダースコア (_) を含めることができます。
• 識別子には、スペース、ドット (.)、ダッシュ (-) などの特殊文字を含めることができます。 特殊文字を使用して識別子を参照する方法については、「 クエリでの識別子の参照」を参照してください。

Note

• サポートされているのは、指定した UTF-8 文字の文字、数字、アンダースコア、ドット、ダッシュのみです。 たとえば、セミコロンとコロンはサポートされていません。
• $文字は、KQL 演算子によって生成されるときにエンティティ名で使用できます。

言語キーワードまたはリテラルとしての識別子の名前付けは避ける

KQL には、 identifiers と同様の名前付け規則を持つキーワードとリテラルがあります。 キーワードまたはリテラルと同じ名前の識別子を持つことができます。 ただし、クエリ内でそれらを参照するには、 特別な引用符が必要であるため、これを行わないようにすることをお勧めします。

where、summarize、1dayなどの言語キーワードまたはリテラルである可能性がある識別子を使用しないようにするには、言語キーワードには適用できない次の規則に従ってエンティティ名を選択できます。

• 大文字 (ZにA) で始まる名前を使用します。

• 1 つのアンダースコア (_) で始まる名前または末尾の名前を使用します。

  Note

  KQL は、2 つのアンダースコア文字 (__) のシーケンスで開始または終了するすべての識別子を予約します。ユーザーは、このような名前を独自に定義することはできません。

これらの識別子を参照する方法については、「 クエリでの識別子の参照」を参照してください。

クエリ内の参照識別子

次の表では、クエリで識別子を参照する方法について説明します。

識別子の種類	Identifier	リファレンス	説明
正常	entity	entity	特殊文字を含まない識別子 (entity) や、一部の言語キーワードにマップする識別子は、引用符で囲む必要はありません。
特殊文字	entity-name	['entity-name']	特殊文字 ( - など) を含む識別子名は、 [' と '] を使用するか、 [" と "]を使用して囲む必要があります。
language キーワード	where	["where"]	言語キーワードである識別子名は、 [' と '] または [" と "]を使用して囲む必要があります。
literal	1day	["1day"]	リテラルである識別子名は、 [' と '] または [" と "]を使用して囲む必要があります。

Note

識別子では大文字と小文字が区別されます。 たとえば、 ThisTable というテーブルを thisTABLEとして参照することはできません。

関連するコンテンツ

• エンティティ型。
• リファレンス ドキュメントの構文規則。