Funções de tabela
Essas funções criam e manipulam valores de tabela.
Table construction
Nome | Descrição |
---|---|
#table | Cria um valor de tabela a partir de colunas e linhas. |
ItemExpression.From | Retorna a árvore de sintaxe abstrata (AST) para o corpo de uma função. |
ItemExpression.Item | Um nó de AST (árvore de sintaxe abstrata) que representa o item em uma expressão de item. |
RowExpression.Column | Retorna uma árvore de sintaxe abstrata (AST) que representa o acesso a uma coluna em meio a uma expressão de linha. |
RowExpression.From | Retorna a árvore de sintaxe abstrata (AST) para o corpo de uma função. |
RowExpression.Row | Um nó de AST (árvore de sintaxe abstrata) que representa a linha em uma expressão de linha. |
Table.FromColumns | Cria uma tabela com base em uma lista de colunas e valores especificados. |
Table.FromList | Converte uma lista em uma tabela aplicando a função de divisão especificada a cada item na lista. |
Table.FromRecords | Converte uma lista de registros em uma tabela. |
Table.FromRows | Cria uma tabela com base em uma lista de valores de linha e colunas opcionais. |
Table.FromValue | Cria uma tabela com uma coluna com base no valor ou valores fornecidos. |
Table.WithErrorContext | Essa função destina-se apenas ao uso interno. |
Table.View | Cria ou estende uma tabela com manipuladores definidos pelo usuário para operações de consulta e ação. |
Table.ViewError | Cria um registro de erro modificado que não aciona um fallback quando disparado por um manipulador definido em uma visualização (via Table.View). |
Table.ViewFunction | Cria uma função que pode ser interceptada por um manipulador definido em uma visualização (via Table.View). |
Conversões
Nome | Descrição |
---|---|
Table.ToColumns | Cria listas aninhadas de valores de colunas a partir de uma tabela. |
Table.ToList | Converte uma tabela em uma lista aplicando a função de combinação especificada a cada linha de valores na tabela. |
Table.ToRecords | Converte uma tabela em uma lista de registros. |
Table.ToRows | Cria uma lista de listas aninhadas de valores de linha de uma tabela. |
Informação
Nome | Descrição |
---|---|
Table.ApproximateRowCount | Retorna o número aproximado de linhas na tabela. |
Table.ColumnCount | Retorna o número de colunas na tabela. |
Table.IsEmpty | Indica se a tabela contém alguma linha. |
Table.PartitionValues | Retorna informações sobre como uma tabela é particionada. |
Table.Profile | Retorna um perfil das colunas de uma tabela. |
Table.RowCount | Retorna o número de linhas na tabela. |
Table.Schema | Retorna uma tabela que contém uma descrição das colunas (ou seja, o esquema) da tabela especificada. |
Tables.GetRelationships | Obtém as relações entre um conjunto de tabelas. |
Row operations
Nome | Descrição |
---|---|
Table.AlternateRows | Mantém o deslocamento inicial e alterna o uso e não uso das linhas a seguir. |
Table.Combine | Retorna uma tabela que é o resultado da mesclagem de uma lista de tabelas. |
Table.FindText | Retorna todas as linhas que contêm o texto especificado na tabela. |
Table.First | Retorna a primeira linha ou um valor padrão especificado. |
Table.FirstN | Retorna as primeiras linhas de contagem especificadas. |
Table.FirstValue | Retorna a primeira coluna da primeira linha da tabela ou um valor padrão especificado. |
Table.FromPartitions | Retorna uma tabela que é o resultado da combinação de um conjunto de tabelas particionadas. |
Table.InsertRows | Insere uma lista de linhas na tabela na posição especificada. |
Table.Last | Retorna a última linha ou um valor padrão especificado. |
Table.LastN | Retorna o último número especificado de linhas. |
Table.MatchesAllRows | Indica se todas as linhas da tabela atendem à condição fornecida. |
Table.MatchesAnyRows | Indica se as linhas na tabela atendem à condição fornecida. |
Table.Partition | Particiona a tabela em uma lista de tabelas com base no número de grupos e coluna especificados. |
Table.Range | Retorna as linhas que começam no deslocamento especificado. |
Table.RemoveFirstN | Retorna uma tabela com o número especificado de linhas removidas da tabela começando na primeira linha. |
Table.RemoveLastN | Retorna uma tabela com o número especificado de linhas removidas da tabela começando na última linha. |
Table.RemoveRows | Remove o número especificado de linhas. |
Table.RemoveRowsWithErrors | Retorna uma tabela com as linhas removidas da tabela de entrada que contêm um erro em pelo menos uma das células. Se uma lista de colunas for especificada, somente as células nas colunas especificadas serão inspecionadas quanto a erros. |
Table.Repeat | Repete as linhas das tabelas um número especificado de vezes. |
Table.ReplaceRows | Substitui o intervalo de linhas especificado pela linha ou linhas fornecidas. |
Table.ReverseRows | Retorna uma tabela com as linhas em ordem inversa. |
Table.SelectRows | Seleciona as linhas que atendem à função condicional. |
Table.SelectRowsWithErrors | Retorna uma tabela com apenas as linhas da tabela de entrada que contêm um erro em pelo menos uma das células. Se uma lista de colunas for especificada, somente as células nas colunas especificadas serão inspecionadas quanto a erros. |
Table.SingleRow | Retorna uma única linha na tabela. |
Table.Skip | Retorna uma tabela com o primeiro número especificado de linhas ignoradas. |
Table.SplitAt | Retorna uma lista que contém as primeiras linhas de contagem especificadas e as linhas restantes. |
Column operations
Nome | Descrição |
---|---|
Table.Column | Retorna uma coluna de dados especificada da tabela como uma lista. |
Table.ColumnNames | Retorna os nomes de coluna como uma lista. |
Table.ColumnsOfType | Retorna uma lista com os nomes das colunas que correspondem aos tipos especificados. |
Table.DemoteHeaders | Rebaixa os cabeçalhos de coluna para a primeira linha de valores. |
Table.DuplicateColumn | Duplica uma coluna com o nome especificado. Os valores e o tipo são copiados da coluna de origem. |
Table.HasColumns | Indica se a tabela contém a coluna ou colunas especificadas. |
Table.Pivot | Dado um par de colunas que representam pares de atributo/valor, gira os dados na coluna de atributo para um título de coluna. |
Table.PrefixColumns | Retorna uma tabela em que todas as colunas foram prefixadas com o texto especificado. |
Table.PromoteHeaders | Promove a primeira linha de valores para serem os novos cabeçalhos, ou seja, nomes de coluna. |
Table.RemoveColumns | Remove as colunas especificadas. |
Table.ReorderColumns | Retorna uma tabela com as colunas na ordem especificada. |
Table.RenameColumns | Retorna uma tabela com as colunas renomeadas conforme especificado. |
Table.SelectColumns | Retorna uma tabela com apenas as colunas especificadas. |
Table.TransformColumnNames | Transforma os nomes das colunas utilizando a função fornecida. |
Table.Unpivot | Converte um conjunto de colunas em uma tabela em pares de atributo-valor. |
Table.UnpivotOtherColumns | Converte todas as colunas que não sejam um conjunto especificado em pares de atributo-valor. |
Transformação
Nome | Descrição |
---|---|
Table.AddColumn | Adiciona uma coluna com o nome especificado. O valor é calculado usando a função de seleção especificada com cada linha usada como entrada. |
Table.AddFuzzyClusterColumn | Adiciona uma nova coluna com valores representativos obtidos por valores de agrupamento difuso da coluna especificada na tabela. |
Table.AddIndexColumn | Acrescenta uma coluna com valores de posição explícitos. |
Table.AddJoinColumn | Executa uma junção entre tabelas em colunas fornecidas e produz o resultado de junção em uma nova coluna. |
Table.AddKey | Adiciona uma chave a uma tabela. |
Table.AggregateTableColumn | Agrega uma coluna de tabelas em várias colunas da tabela em questão. |
Table.CombineColumns | Combina as colunas especificadas em uma nova coluna usando a função combinada especificada. |
Table.CombineColumnsToRecord | Combina as colunas especificadas em uma nova coluna com valor de registro em que cada registro tem nomes de campo e valores correspondentes aos nomes e valores das colunas que foram combinadas. |
Table.ConformToPageReader | Essa função destina-se apenas ao uso interno. |
Table.ExpandListColumn | Dada uma coluna de listas em uma tabela, crie uma cópia de uma linha para cada valor em sua lista. |
Table.ExpandRecordColumn | Expande uma coluna de registros em colunas com cada um dos valores. |
Table.ExpandTableColumn | Expande uma coluna de registros ou uma coluna de tabelas em várias colunas dentro da tabela que as contém. |
Table.FillDown | Propaga o valor de uma célula anterior para as células com valor nulo abaixo na coluna. |
Table.FillUp | Propaga o valor de uma célula para as células com valor nulo acima na coluna. |
Table.FilterWithDataTable | Essa função destina-se apenas ao uso interno. |
Table.FuzzyGroup | Agrupa linhas na tabela com base na correspondência difusa de chaves. |
Table.FuzzyJoin | Une as linhas das duas tabelas com correspondência difusa com base nas chaves fornecidas. |
Table.FuzzyNestedJoin | Executa uma junção difusa entre tabelas em colunas fornecidas e produz o resultado de junção em uma nova coluna. |
Table.Group | Agrupa linhas na tabela que têm a mesma chave. |
Table.Join | Une as linhas das duas tabelas que correspondem com base nas chaves fornecidas. |
Table.Keys | Retorna as chaves da tabela especificada. |
Table.NestedJoin | Executa uma junção entre tabelas em colunas fornecidas e produz o resultado de junção em uma nova coluna. |
Table.ReplaceErrorValues | Substitui os valores de erro nas colunas especificadas pelo valor especificado correspondente. |
Table.ReplaceKeys | Substitui as chaves da tabela especificada. |
Table.ReplaceRelationshipIdentity | Essa função destina-se apenas ao uso interno. |
Table.ReplaceValue | Substitui um valor por outro nas colunas especificadas. |
Table.Split | Divide a tabela especificada em uma lista de tabelas usando o tamanho da página especificado. |
Table.SplitColumn | Divide as colunas especificadas em um conjunto de colunas adicionais usando a função de divisor especificada. |
Table.TransformColumns | Transforma os valores de uma ou mais colunas. |
Table.TransformColumnTypes | Aplica transformações de tipo do formulário { coluna, type } usando uma cultura específica. |
Table.TransformRows | Transforma as linhas da tabela usando a função de transformação especificada. |
Table.Transpose | Transforma colunas em linhas e linhas em colunas. |
Associação
Nome | Descrição |
---|---|
Table.Contains | Indica se o registro especificado aparece como uma linha na tabela. |
Table.ContainsAll | Indica se todos os registros especificados aparecem como linhas na tabela. |
Table.ContainsAny | Indica se algum dos registros especificados aparece como linhas na tabela. |
Table.Distinct | Remove linhas duplicadas da tabela. |
Table.IsDistinct | Indica se a tabela contém apenas linhas distintas (sem duplicatas). |
Table.PositionOf | Retorna a posição ou as posições da linha dentro da tabela. |
Table.PositionOfAny | Retorna a posição ou as posições de qualquer uma das linhas especificadas dentro da tabela. |
Table.RemoveMatchingRows | Remove todas as ocorrências das linhas especificadas da tabela. |
Table.ReplaceMatchingRows | Substitui todas as linhas especificadas pela linha ou linhas fornecidas. |
Pedido
Nome | Descrição |
---|---|
Table.AddRankColumn | Acrescenta uma coluna com a classificação de uma ou mais colunas. |
Table.Max | Retorna a maior linha ou valor padrão usando os critérios fornecidos. |
Table.MaxN | Retorna a maior linha ou as maiores linhas usando o(s) dado(s) critério(s). |
Table.Min | Retorna a menor linha ou um valor padrão usando os critérios fornecidos. |
Table.MinN | Retorna a menor linha ou linhas usando os critérios especificados. |
Table.Sort | Classifica a tabela usando um ou mais nomes de coluna e critérios de comparação. |
Outro
Nome | Descrição |
---|---|
Table.Buffer | Armazena em buffer uma tabela na memória, isolando-a de alterações externas durante a avaliação. |
Table.StopFolding | Impede que quaisquer operações posteriores sejam executadas contra a fonte original dos dados. |
Valores de parâmetro
Nomeando colunas de saída
Esse parâmetro é uma lista de valores de texto que especifica os nomes de coluna da tabela resultante. Esse parâmetro é geralmente utilizado nas funções de construção de tabela , como Table.FromRows e Table.FromList.
Critérios de comparação
O critério de comparação pode ser fornecido como um dos seguintes valores:
Um valor numérico para especificar uma ordem de classificação. Mais informações: ordem de classificação
Para calcular uma chave a ser usada para classificação, uma função de um argumento pode ser usada.
Para selecionar uma chave e uma ordem de controle, o critério de comparação pode ser uma lista que contém a chave e a ordem.
Para controlar completamente a comparação, uma função de dois argumentos pode ser usada que retorna -1, 0 ou 1 dada a relação entre as entradas esquerda e direita. Value.Compare pode ser usado para delegar essa lógica.
Para obter exemplos, vá para a descrição de Table.Sort.
Critérios de contagem ou condição
Esses critérios geralmente são usados em operações de ordenação ou em operações de linhas. Ele determina o número de linhas retornadas na tabela e pode assumir duas formas: um número ou uma condição.
Um número indica quantos valores retornar embutidos na função apropriada.
Se uma condição for especificada, as linhas que contêm valores que inicialmente atendem à condição serão retornadas. Quando um valor falha na condição, nenhum valor adicional é considerado.
Mais informações: Table.FirstN, Table.MaxN
Manipulação de valores extras
Valores extras são usados para indicar como a função deve lidar com valores extras em uma linha. Esse parâmetro é especificado por um número, que corresponde às seguintes opções:
ExtraValues.List = 0
ExtraValues.Error = 1
ExtraValues.Ignore = 2
Mais informações: Table.FromList, ExtraValues.Type
Manipulação de coluna ausente
Esse parâmetro é usado para indicar como a função deve lidar com colunas ausentes. Esse parâmetro é especificado como um número, que corresponde às seguintes opções:
MissingField.Error = 0
MissingField.Ignore = 1
MissingField.UseNull = 2;
Esse parâmetro é usado em operações de coluna ou transformação, por exemplo, em Table.TransformColumns. Mais informações: MissingField.Type
Ordem de Classificação
A ordenação de classificação é usada para indicar como os resultados devem ser classificados. Esse parâmetro é especificado como um número, que corresponde às seguintes opções:
Order.Ascending = 0
Order.Descending = 1
Mais informações: Order.Type
Critérios de equação
Os critérios de equação para tabelas podem ser especificados como:
Um valor de função que é ou:
Um seletor de chave que determina a coluna na tabela para aplicar os critérios de igualdade.
Uma função de comparador usada para especificar o tipo de comparação a ser aplicada. As funções do comparador interno podem ser especificadas. Mais informações: Funções do comparador
Uma lista das colunas na tabela para aplicar os critérios de igualdade.
Para obter exemplos, vá para a descrição de Table.Distinct.