Názvy entit

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Na entity Kusto se odkazuje v dotazu podle názvu. Entity, na které lze odkazovat podle jejich názvu, patří databáze, tabulky, sloupce a uložené funkce, ale ne clustery. Název, který přiřadíte entitě, se nazývá identifikátor. Kromě entit můžete také přiřadit identifikátor parametrům dotazu nebo proměnným nastaveným příkazem let.

Na entity Kusto se odkazuje v dotazu podle názvu. Mezi entity, na které lze odkazovat podle jejich názvu, patří databáze, tabulky, sloupce a uložené funkce. Název, který přiřadíte entitě, se nazývá identifikátor. Kromě entit můžete také přiřadit identifikátor parametrům dotazu nebo proměnným nastaveným příkazem let.

Název entity je jedinečný pro typ entity v kontextu kontejneru. Například dvě tabulky ve stejné databázi nemohou mít stejný název, ale databáze a tabulka můžou mít stejný název, protože se jedná o různé typy entit. Podobně může mít tabulka a uložená funkce stejný název.

Poznámka:

Názvy entit, které se také projeví jako prostředek Azure, se řídí pravidly rezerv ARM.

Hezká jména

Kromě názvu entity můžou mít některé entity hezký název. Podobně jako při použití názvů entit lze k odkazování na entitu v dotazech použít hezké názvy. Na rozdíl od názvů entit ale v kontextu kontejneru nemusí být hezké názvy nutně jedinečné. Pokud má kontejner více entit se stejným názvem, nedá se k odkazu na entitu použít hezký název.

Docela názvy umožňují aplikacím střední vrstvy mapovat automaticky vytvořené názvy entit (například UUID) na názvy, které jsou čitelné pro účely zobrazení a odkazování.

Příklad přiřazení hezkého názvu najdete v příkazu .alter database prettyname.

Pravidla pojmenování identifikátorů

Identifikátor je název, který přiřadíte entitě, parametrům dotazu nebo proměnné nastavené pomocí příkazu let. Platné identifikátory musí dodržovat tato pravidla:

  • Identifikátory rozlišují malá a velká písmena. Názvy databází nerozlišují malá a velká písmena, a proto výjimku tohoto pravidla.
  • Identifikátory musí mít délku 1 až 1024 znaků.
  • Identifikátory mohou obsahovat písmena, číslice a podtržítka (_).
  • Identifikátory mohou obsahovat určité speciální znaky: mezery, tečky (.) a pomlčky (-). Informace o odkazování identifikátorů se speciálními znaky naleznete v tématu Referenční identifikátory v dotazech.

Poznámka:

  • Podporují se pouze zadané znaky UTF-8 písmen, číslic, podtržítka, tečky a pomlčky. Například středníky a dvojtečky se nepodporují.
  • Znak $ je povolen v názvech entit při generování operátorem KQL.

Vyhněte se pojmenování identifikátorů jako klíčových slov jazyka nebo literálů

V jazyce KQL existují klíčová slova a literály, které mají podobná pravidla pojmenování jako identifikátory. Můžete mít identifikátory se stejným názvem jako klíčová slova nebo literály. Doporučujeme, abyste se tomu vyhnuli, protože odkazování na ně v dotazech vyžaduje speciální uvozování.

Abyste se vyhnuli použití identifikátoru, který může být také klíčovým slovem jazyka nebo literálem, například where, summarizea 1daymůžete zvolit název entity podle následujících konvencí, které se nevztahují na klíčová slova jazyka:

  • Použijte název začínající velkým písmenem (A do Z).

  • Použijte název, který začíná nebo končí jedním podtržítkem (_).

    Poznámka:

    KQL si vyhrazuje všechny identifikátory, které začínají nebo končí sekvencí dvou podtržítka (__); uživatelé nemůžou takové názvy definovat pro vlastní použití.

Informace o tom, jak odkazovat na tyto identifikátory, naleznete v tématu Referenční identifikátory v dotazech.

Referenční identifikátory v dotazech

Následující tabulka obsahuje vysvětlení, jak odkazovat na identifikátory v dotazech.

Typ identifikátoru Identifikátor Reference Vysvětlení
Normální entity entity Identifikátory (entity), které neobsahují speciální znaky ani mapování na některé klíčové slovo jazyka, nemusí být uzavřeny do uvozovek.
Speciální znak entity-name ['entity-name'] Názvy identifikátorů, které obsahují speciální znaky (například -) musí být uzavřeny pomocí [' a '] nebo použití [" a "].
klíčové slovo jazyka where ["where"] Názvy identifikátorů, které jsou jazyková klíčová slova, musí být uzavřeny pomocí [' a '] nebo [" a ."]
literal 1day ["1day"] Názvy identifikátorů, které jsou literály, musí být uzavřeny pomocí [' a '] nebo [" a ."]

Poznámka:

Identifikátory rozlišují malá a velká písmena. Nemůžete například odkazovat na tabulku s názvem ThisTable thisTABLE.

Související obsah