Поделиться через

Имена сущностей

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Сущности Kusto ссылаются в запросе по имени. Сущности, на которые можно ссылаться по имени, включают базы данных, таблицы, столбцы и хранимые функции, но не кластеры. Имя, назначаемое сущностью, называется идентификатором. Помимо сущностей, можно также назначить идентификатор параметрам запроса или переменным, заданным с помощью инструкции let.

Сущности Kusto ссылаются в запросе по имени. Сущности, на которые можно ссылаться по имени, включают базы данных, таблицы, столбцы и хранимые функции. Имя, назначаемое сущностью, называется идентификатором. Помимо сущностей, можно также назначить идентификатор параметрам запроса или переменным, заданным с помощью инструкции let.

Имя сущности уникально для типа сущности в контексте контейнера. Например, две таблицы в одной базе данных не могут иметь одинаковое имя, но база данных и таблица могут иметь то же имя, так как они разные типы сущностей. Аналогичным образом таблица и хранимая функция могут иметь то же имя.

Примечание.

Имена сущностей, которые также отражаются в качестве ресурса Azure, следуйте правилам резервирования слов ARM.

Красивые имена

Помимо имени сущности некоторые сущности могут иметь довольное имя. Как и в случае с именами сущностей, довольно имена можно использовать для ссылки на сущность в запросах. Но в отличие от имен сущностей, красивые имена не обязательно уникальны в контексте их контейнера. Если контейнер содержит несколько сущностей с одинаковым именем, то для ссылки на сущность нельзя использовать довольно имя.

Красивые имена позволяют приложениям среднего уровня сопоставлять автоматически созданные имена сущностей (например, UUID) с именами, которые доступны для отображения и ссылки.

Пример назначения довольного имени см . в команде alter database prettyname.

Правила именования идентификаторов

Идентификатор — это имя, присвоенное сущностям, параметрам запроса или переменной, заданным с помощью инструкции let. Допустимые идентификаторы должны соответствовать следующим правилам.

  • Идентификаторы чувствительны к регистру. Имена баз данных не учитывает регистр, поэтому исключение из этого правила.
  • Идентификаторы должны иметь длину от 1 до 1024 символов.
  • Идентификаторы могут содержать буквы, цифры и символы подчеркивания (_).
  • Идентификаторы могут содержать определенные специальные символы: пробелы, точки (.) и дефисы (-). Сведения о том, как ссылаться на идентификаторы со специальными символами, см. в разделе "Справочные идентификаторы" в запросах.

Примечание.

  • Поддерживаются только указанные символы UTF-8 букв, цифр, символов подчеркивания, точек и дефисов. Например, точки с запятой и двоеточия не поддерживаются.
  • Символ $ допускается в именах сущностей при создании оператором KQL.

Избегайте именования идентификаторов в качестве ключевых слов языка или литералов

В KQL есть ключевые слова и литералы, которые имеют аналогичные правила именования в качестве идентификаторов. Вы можете иметь идентификаторы с тем же именем, что и ключевые слова или литералы. Однако рекомендуется избегать этого, так как ссылки на них в запросах требуют специального кавыкания.

Чтобы избежать использования идентификатора, который также может быть ключевым словом языка или литералом, например wheresummarize, и 1dayвы можете выбрать имя сущности в соответствии со следующими соглашениями, которые не применимы к ключевым словам языка:

  • Используйте имя, начинающееся с прописной буквы (A в Z).

  • Используйте имя, которое начинается или заканчивается одним символом подчеркивания (_).

    Примечание.

    KQL резервирует все идентификаторы, которые начинаются или заканчиваются последовательностью двух символов подчеркивания (__); пользователи не могут определять такие имена для собственного использования.

Сведения о том, как ссылаться на эти идентификаторы, см. в разделе "Справочные идентификаторы" в запросах.

Ссылочные идентификаторы в запросах

В следующей таблице приведено описание того, как ссылаться на идентификаторы в запросах.

Тип идентификатора Идентификатор Справочные материалы Описание
Обычная entity entity Идентификаторы (entity) не включают специальные символы или сопоставляются с некоторыми ключевыми словами языка, не должны быть заключены в кавычки.
Специальный знак entity-name ['entity-name'] Имена идентификаторов, включающие специальные символы (например-), должны быть заключены в состав с использованием [' и '] использованием или использованием["."]
ключевое слово языка where ["where"] Имена идентификаторов, которые являются ключевыми словами языка, должны быть заключены в скобки с помощью [' и '] (или) [" ."]
литерал 1day ["1day"] Имена идентификаторов, которые являются литералами, должны быть заключены в скобки с помощью [' и '] (или) [" и "].

Примечание.

Идентификаторы чувствительны к регистру. Например, нельзя ссылаться на таблицу, которая thisTABLEназывается ThisTable .

Связанный контент