Funções de tabela

Essas funções criam e manipulam valores de tabela.

Construção de tabelas

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 árvore de sintaxe abstrata (AST) 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 dentro de 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ó da árvore de sintaxe abstrata (AST) que representa uma linha numa expressão de linhas.
Table.FromColumns	Cria uma tabela a partir de 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 da lista.
Table.FromRecords	Converte uma lista de registros em uma tabela.
Table.FromRows	Cria uma tabela a partir de uma lista de valores de linha e colunas opcionais.
Table.FromValue	Cria uma tabela com uma coluna a partir do(s) valor(es) fornecido(s).
Table.WithErrorContext	Esta função destina-se apenas a 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 registo de erro modificado que não acionará um fallback quando lançado por um controlador definido em uma visualização (via Table.View).
Table.ViewFunction	Cria uma função que pode ser intercetada por um manipulador definido numa vista (via Table.View).

Conversões

Nome	Descrição
Table.ToColumns	Cria uma lista de listas aninhadas de valores de coluna 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	Devolve o número aproximado de linhas na tabela.
Table.ColumnCount	Devolve 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	Devolve o número de linhas na tabela.
Table.Schema	Retorna uma tabela contendo uma descrição das colunas (ou seja, o esquema) da tabela especificada.
Tables.GetRelationships	Obtém as relações entre um conjunto de tabelas.

Operações de linha

Nome	Descrição
Table.AlternateRows	Mantém o deslocamento inicial e depois alterna entre selecionar e pular as linhas seguintes.
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 fornecido 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	Devolve a primeira coluna da primeira linha da tabela ou um valor predefinido 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	Devolve o último número especificado de linhas.
Table.MatchesAllRows	Indica se todas as linhas da tabela atendem à condição fornecida.
Table.MatchesAnyRows	Indica se alguma das linhas na tabela atende à condição fornecida.
Table.Partition	Particiona a tabela em uma lista de tabelas com base no número de grupos e colunas especificadas.
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 em busca de erros.
Table.Repeat	Repete as linhas das tabelas um número especificado de vezes.
Table.ReplaceRows	Substitui o intervalo especificado de linhas pela linha ou linhas fornecidas.
Table.ReverseRows	Devolve uma tabela com as linhas em ordem inversa.
Table.SelectRows	Seleciona as linhas que atendem à função de condição.
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 em busca de erros.
Table.SingleRow	Devolve uma única linha da tabela.
Table.Skip	Retorna uma tabela com o primeiro número especificado de linhas ignoradas.
Table.SplitAt	Retorna uma lista contendo as primeiras linhas de contagem especificadas e as linhas restantes.

Operações de coluna

Nome	Descrição
Table.Column	Retorna uma coluna especificada de dados da tabela como uma lista.
Table.ColumnNames	Retorna os nomes das colunas como uma lista.
Table.ColumnsOfType	Retorna uma lista com os nomes das colunas que correspondem aos tipos especificados.
Table.DemoteHeaders	Rebaixa os cabeçalhos das colunas 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 atributo-valor, transforma os dados da coluna de atributo em cabeçalhos de coluna.
Table.PrefixColumns	Retorna uma tabela onde as colunas foram todas prefixadas com o texto fornecido.
Table.PromoteHeaders	Promove a primeira linha de valores como os novos cabeçalhos de coluna (ou seja, como nomes de coluna).
Table.RemoveColumns	Remova 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 nomes de colunas usando a função fornecida.
Table.Unpivot	Traduz um conjunto de colunas em uma tabela em pares atributo-valor.
Table.UnpivotOtherColumns	Traduz todas as colunas que não sejam um conjunto especificado em pares 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 tomada como uma 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 na tabela que contém.
Table.CombineColumns	Combina as colunas especificadas em uma nova coluna usando a função combinadora especificada.
Table.CombineColumnsToRecord	Combina as colunas especificadas convertendo-as numa nova coluna de valor de registo, onde cada registo tem campos e valores que correspondem aos nomes e valores das colunas combinadas.
Table.ConformToPageReader	Esta função destina-se apenas a 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 múltiplas colunas na tabela que as contém.
Table.FillDown	Propaga o valor de uma célula anterior para as células de valor nulo abaixo na coluna.
Table.FillUp	Propaga o valor de uma célula para as células de valor nulo acima na coluna.
Table.FilterWithDataTable	Esta função destina-se apenas a uso interno.
Table.FuzzyGroup	Agrupa linhas na tabela com base na correspondência difusa de chaves.
Table.FuzzyJoin	Junta as linhas das duas tabelas que correspondem de forma aproximada com base nas chaves fornecidas.
Table.FuzzyNestedJoin	Executa uma junção difusa entre tabelas em colunas fornecidas e produz o resultado da junção em uma nova coluna.
Table.Group	Agrupa linhas na tabela que têm a mesma chave.
Table.Join	Junta as linhas das duas tabelas que correspondem com base nas teclas 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	Esta função destina-se apenas a 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 de 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 a(s) transformação(ões) de tipo do formulário { coluna, tipo } 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.

Adesã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	Devolve a posição ou posições da linha dentro da tabela.
Table.PositionOfAny	Devolve a posição ou posições de qualquer uma das linhas especificadas na 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.

Encomendar

Nome	Descrição
Table.AddRankColumn	Acrescenta uma coluna com o ordenamento de uma ou mais outras colunas.
Table.Max	Retorna a maior linha ou o valor padrão usando os critérios fornecidos.
Table.MaxN	Devolve a(s) linha(s) maior(es) utilizando os critérios fornecidos.
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 fornecidos.
Table.Sort	Classifica a tabela usando um ou mais nomes de coluna e critérios de comparação.

Outros

Nome	Descrição
Table.Buffer	Armazena uma tabela em buffer na memória, isolando-a de alterações externas durante a avaliação.
Table.StopFolding	Impede que quaisquer operações downstream sejam executadas em relação à fonte original dos dados.

Valores dos parâmetros

Nomeando colunas de saída

Este parâmetro é uma lista de valores de texto que especifica os nomes das colunas da tabela resultante. Este parâmetro é geralmente usado nas funções de construção da 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 contendo 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 exemplos, consulte a descrição de Table.Sort.

Critérios de contagem ou de condição

Este critério é geralmente usado em operações de ordenação ou em operações de filas. 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 devem retornar em linha com a função apropriada.

• Se uma condição for especificada, as linhas contendo valores que inicialmente atendem à condição serão retornadas. Quando um valor falha na condição, nenhum outro valor é considerado.

Mais informações: Table.FirstN, Table.MaxN

Gestão de valores extra

Valores extras são usados para indicar como a função deve lidar com valores extras em uma linha. Este parâmetro é especificado como 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

Gestão de colunas em falta

Este parâmetro é usado para indicar como a função deve lidar com colunas ausentes. Este parâmetro é especificado como um número, que mapeia para as seguintes opções:

MissingField.Error = 0
MissingField.Ignore = 1
MissingField.UseNull = 2;

Este 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. Este 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 é um dos seguintes:

  • Um seletor de chave que determina a coluna na tabela para aplicar os critérios de igualdade.

  • Uma função de comparação que é usada para especificar o tipo de comparação a ser aplicada. Funções de comparação integradas podem ser especificadas. Para obter mais informações: Funções de comparação

• Uma lista das colunas na tabela para aplicar os critérios de igualdade.

Para exemplos, vá para a descrição de Table.Distinct.