Udostępnij za pośrednictwem

table()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Funkcja table() odwołuje się do tabeli, podając jej nazwę jako wyrażenie typu string.

Składnia

table(TableName [, DataScope])

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
TableName string ✔️ Nazwa przywoływanej tabeli. Wartość tego wyrażenia musi być stała w momencie wywołania funkcji, co oznacza, że nie może się różnić w zależności od kontekstu danych.
DataScope string Służy do ograniczania odwołania do tabeli do danych zgodnie z tym, jak te dane należą do obowiązujących zasad pamięci podręcznej tabeli. Jeśli jest używany, rzeczywisty argument musi być jedną z prawidłowych wartości zakresu danych.

Prawidłowe wartości zakresu danych

Wartość Opis
hotcache Będą przywoływane tylko dane sklasyfikowane jako gorąca pamięć podręczna.
all Wszystkie dane w tabeli zostaną przywołyne.
default Wartość domyślna to all, z wyjątkiem sytuacji, gdy została ustawiona na hotcache wartość przez administratora klastra.

Zwraca

table(T) Zwraca:

  • Dane z tabeli T , jeśli istnieje tabela o nazwie T .
  • Dane zwracane przez funkcję T, jeśli tabela o nazwie Nie istnieje, ale istnieje funkcja o nazwie T. Funkcja T nie może przyjmować żadnych argumentów i musi zwrócić wynik tabelaryczny.
  • Błąd semantyczny jest zgłaszany, jeśli nie ma tabeli o nazwie T i nie ma funkcji o nazwie T.

Przykłady

Uzyskiwanie dostępu do tabeli bieżącej bazy danych przy użyciu funkcji table()

table('StormEvents') | count

Wyjście

Count
59066

Używanie instrukcji table() wewnątrz instrukcji let

Powyższe zapytanie można przepisać jako funkcję zdefiniowaną przez zapytanie (let, instrukcja), która odbiera parametr tableName — który jest przekazywany do funkcji table().

let foo = (tableName:string)
{
    table(tableName) | count
};
foo('StormEvents')

Wyjście

Count
59066

Korzystanie z funkcji table() w usłudze Functions

To samo zapytanie, co powyższe, można ponownie napisać do użycia w funkcji, która odbiera parametr tableName — który jest przekazywany do funkcji table().

.create function foo(tableName:string)
{
    table(tableName) | count
};

Uwaga

Takie funkcje mogą być używane tylko lokalnie, a nie w zapytaniu między klastrami.

Używanie tabeli() z parametrem niestałym

Nie można przekazać parametru, który nie jest ciągiem stałej skalarnej, jako parametr funkcji table() .

Poniżej przedstawiono przykład obejścia takiego przypadku.

let T1 = print x=1;
let T2 = print x=2;
let _choose = (_selector:string)
{
    union
    (T1 | where _selector == 'T1'),
    (T2 | where _selector == 'T2')
};
_choose('T2')

Wyjście

x
2