Referência rápida de KQLKQL quick reference

Este artigo mostra-lhe uma lista de funções e suas descrições para ajudá-lo a começar a usar a Linguagem De Consulta Kusto.This article shows you a list of functions and their descriptions to help get you started using Kusto Query Language.

Operador/FunçãoOperator/Function DescriçãoDescription SintaxeSyntax
Filtro/Pesquisa/CondiçãoFilter/Search/Condition Encontre dados relevantes filtrando ou procurandoFind relevant data by filtering or searching
onde ondewhere Filtros num predicado específicoFilters on a specific predicate T | where Predicate
onde contém/temwhere contains/has Contains: Procura qualquer correspondência de substringContains: Looks for any substring match
Has: Procura uma palavra específica (melhor desempenho)Has: Looks for a specific word (better performance)
T | where col1 contains/has "[search term]"
pesquisasearch Procura todas as colunas na tabela pelo valorSearches all columns in the table for the value [TabularSource |] search [kind=CaseSensitivity] [in (TableSources)] SearchPredicate
tomartake Devolve o número especificado de registos.Returns the specified number of records. Usar para testar uma consultaUse to test a query
Nota: _take_ _limite _ são sinónimos.Note: _take_ and _limit_ are synonyms.
T | take NumberOfRows
casocase Adiciona uma declaração de condição, semelhante a se/then/elseif em outros sistemas.Adds a condition statement, similar to if/then/elseif in other systems. case(predicate_1, then_1, predicate_2, then_2, predicate_3, then_3, else)
distinctdistinct Produz uma tabela com a combinação distinta das colunas fornecidas da tabela de entradaProduces a table with the distinct combination of the provided columns of the input table distinct [ColumnName], [ColumnName]
Data/HoraDate/Time Operações que utilizam funções de data e horaOperations that use date and time functions
atrásago Devolve o tempo compensado em relação ao tempo que a consulta executa.Returns the time offset relative to the time the query executes. Por exemplo, ago(1h) é uma hora antes da leitura do relógio atual.For example, ago(1h) is one hour before the current clock's reading. ago(a_timespan)
format_datetimeformat_datetime Devolve dados em vários formatosde data.Returns data in various date formats. format_datetime(datetime , format)
caixote do lixobin Arredonda todos os valores num prazo e agrupa-osRounds all values in a timeframe and groups them bin(value,roundTo)
Criar/Remover ColunasCreate/Remove Columns Adicione ou remova colunas numa tabelaAdd or remove columns in a table
imprimirprint Saídas de uma única linha com uma ou mais expressões escalarOutputs a single row with one or more scalar expressions print [ColumnName =] ScalarExpression [',' ...]
projetoproject Seleciona as colunas a incluir na ordem especificadaSelects the columns to include in the order specified T | project ColumnName [= Expression] [, ...]
OuOr
T | project [ColumnName | (ColumnName[,]) =] Expression [, ...]
projeto-longeproject-away Seleciona as colunas para excluir da saídaSelects the columns to exclude from the output T | project-away ColumnNameOrPattern [, ...]
estenderextend Cria uma coluna calculada e adiciona-a ao conjunto de resultadosCreates a calculated column and adds it to the result set T | extend [ColumnName | (ColumnName[, ...]) =] Expression [, ...]
Ordenar e Agregar DatasetSort and Aggregate Dataset Reestruturar os dados separando ou agrupando-os de forma significativaRestructure the data by sorting or grouping them in meaningful ways
classificarsort Classifica as linhas da tabela de entrada por uma ou mais colunas em ordem ascendente ou descendenteSorts the rows of the input table by one or more columns in ascending or descending order T | sort by expression1 [asc|desc], expression2 [asc|desc], …
Iníciotop Devolve as primeiras linhas N do conjunto de dados quando o conjunto de dados é classificado usandobyReturns the first N rows of the dataset when the dataset is sorted using by T | top numberOfRows by expression [asc|desc] [nulls first|last]
resumosummarize Agrupa as by linhas de acordo com as colunas do grupo, e calcula as agregações em cada grupoGroups the rows according to the by group columns, and calculates aggregations over each group T | summarize [[Column =] Aggregation [, ...]] [by [Column =] GroupExpression [, ...]]
contarcount Conta os registos na tabela de entrada (por exemplo, T)Counts records in the input table (for example, T)
Este operador é abreviado parasummarize count() This operator is shorthand for summarize count()
T | count
juntar-sejoin Funde as linhas de duas tabelas para formar uma nova tabela, combinando valores das colunas especificadas de cada tabela.Merges the rows of two tables to form a new table by matching values of the specified column(s) from each table. Suporta uma gama completa de flouter innertipos innerunique leftantide leftantisemi leftouteradesão: , leftsemi, , , , rightanti, , rightantisemi rightouter``rightsemiSupports a full range of join types: flouter, inner, innerunique, leftanti, leftantisemi, leftouter, leftsemi, rightanti, rightantisemi, rightouter, rightsemi LeftTable | join [JoinParameters] ( RightTable ) on Attributes
uniãounion Leva duas ou mais mesas e devolve todas as suas fileirasTakes two or more tables and returns all their rows [T1] | union [T2], [T3], …
alcancerange Gera uma tabela com uma série aritmética de valoresGenerates a table with an arithmetic series of values range columnName from start to stop step step
Dados do FormatoFormat Data Reestruturar os dados para a produção de forma útilRestructure the data to output in a useful way
olhar para cimalookup Estende as colunas de uma tabela de factos com valores olhados numa tabela de dimensãoExtends the columns of a fact table with values looked-up in a dimension table T1 | lookup [kind = (leftouter|inner)] ( T2 ) on Attributes
mv-expandirmv-expand Transforma matrizes dinâmicas em linhas (expansão de vários valores)Turns dynamic arrays into rows (multi-value expansion) T | mv-expand Column
parseparse Avalia uma expressão de cadeia e analisa o seu valor numa ou mais colunas calculadas.Evaluates a string expression and parses its value into one or more calculated columns. Utilização para estruturar dados não estruturados.Use for structuring unstructured data. T | parse [kind=regex [flags=regex_flags] |simple|relaxed] Expression with * (StringConstant ColumnName [: ColumnType]) *...
séries de faz-sériesmake-series Cria uma série de valores agregados especificados ao longo de um eixo especificadoCreates series of specified aggregated values along a specified axis T | make-series [MakeSeriesParamters] [Column =] Aggregation [default = DefaultValue] [, ...] on AxisColumn from start to end step step [by [Column =] GroupExpression [, ...]]
deixelet Liga um nome a expressões que podem referir-se ao seu valor vinculado.Binds a name to expressions that can refer to its bound value. Os valores podem ser expressões de lambda para criar funções ad-hoc como parte da consulta.Values can be lambda expressions to create ad-hoc functions as part of the query. Use let para criar expressões sobre tabelas cujos resultados parecem uma nova tabela.Use let to create expressions over tables whose results look like a new table. let Name = ScalarExpression | TabularExpression | FunctionDefinitionExpression
GeneralGeneral Operações diversas e funçãoMiscellaneous operations and function
invocarinvoke Executa a função na tabela que recebe como entrada.Runs the function on the table that it receives as input. T | invoke function([param1, param2])
avaliar o pluginNameevaluate pluginName Avalia extensões de linguagem de consulta (plugins)Evaluates query language extensions (plugins) [T |] evaluate [ evaluateParameters ] PluginName ( [PluginArg1 [, PluginArg2]... )
VisualizaçãoVisualization Operações que exibem os dados num formato gráficoOperations that display the data in a graphical format
renderrender Renderiza resultados como uma saída gráficaRenders results as a graphical output T | render Visualization [with (PropertyName = PropertyValue [, ...] )]