實體名稱

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

實體的名稱是其容器內容中實體類型的唯一名稱。 例如，相同資料庫中的兩個數據表不能有相同的名稱，但是資料庫和數據表可以有相同的名稱，因為它們是不同的實體類型。 同樣地，數據表和預存函式的名稱可能相同。

漂亮的名稱

除了實體的名稱之外，某些實體可能具有 相當的名稱。 類似於使用實體名稱，漂亮的名稱可用來參考查詢中的實體。 但與實體名稱不同，漂亮的名稱在容器的內容中不一定是唯一的。 當容器有多個具有相同漂亮名稱的實體時，無法使用漂亮的名稱來參考實體。

漂亮的名稱可讓仲介層應用程式將自動建立的實體名稱（例如 UUID）對應至人類可讀取的名稱，以供顯示和參考之用。

標識元命名規則

標識碼是您透過 let 語句設定給實體、查詢參數或變數的名稱。 有效的識別碼必須遵守下列規則：

• 標識碼會區分大小寫。 資料庫名稱不區分大小寫，因此此規則的例外狀況。
• 標識符長度必須介於 1 到 1024 個字元之間。
• 標識碼可能包含字母、數位和底線 （_）。
• 標識碼可能包含特定特殊字元：空格、點 （.） 和破折號 （-）。 如需如何使用特殊字元參考標識子的資訊，請參閱 查詢中的參考標識碼。

避免將標識碼命名為語言關鍵詞或常值

在 KQL 中，有關鍵詞和常值具有與標識符類似的命名規則。 您可以擁有與關鍵詞或常值相同名稱的識別碼。 不過，我們建議您避免這樣做，因為在查詢中參考它們需要 特殊引號。

若要避免使用可能也是語言關鍵詞或常值的標識碼，例如 where、 summarize和 1day，您可以根據下列慣例來選擇實體名稱，這些慣例不適用於語言關鍵詞：

• 使用開頭為大寫字母的名稱（A 至 Z）。

• 使用以單一底線開頭或結尾的名稱 （_）。

  注意

  KQL 會保留以兩個底線字元序列開頭或結尾的所有標識碼（__; 使用者無法定義這類名稱供自己使用。

如需如何參考這些標識子的資訊，請參閱 查詢中的參考標識碼。

查詢中的參考標識碼

下表提供如何在查詢中參考標識碼的說明。

相關內容

• 實體類型。
• 參考文件的語法慣例。