Funções de tabela

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

Table construction

Nome	Descrição
ItemExpression.From	Retorna a AST (árvore de sintaxe abstrata) 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 AST (árvore de sintaxe abstrata) que representa o acesso a uma coluna em uma expressão de linha.
RowExpression.From	Retorna a AST (árvore de sintaxe abstrata) 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	Retorna uma tabela de uma lista contendo listas aninhadas com os nomes e os valores de coluna.
Table.FromList	Converte uma lista em tabela aplicando a função de divisão especificada a cada item da lista.
Table.FromRecords	Retorna uma tabela de uma lista de registros.
Table.FromRows	Cria uma tabela da lista em que cada elemento da lista é uma lista que contém os valores de coluna para uma única linha.
Table.FromValue	Retorna uma tabela com uma coluna que contém o valor fornecido ou a lista de valores.
Table.FuzzyGroup	Agrupa as linhas de uma tabela pelos valores com correspondência difusa na coluna especificada para cada linha.
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 as tabelas nas colunas fornecidas e insere o resultado da junção em uma nova coluna.
Table.Split	Divide a tabela especificada em uma lista de tabelas usando o tamanho da página especificado.
Table.WithErrorContext	Esta função destina-se somente 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 registro de erro modificado que não vai disparar um fallback quando for gerado por um manipulador definido em uma exibição (por meio de Table.View).
Table.ViewFunction	Cria uma função que pode ser interceptada por um manipulador definido em uma exibição (por meio de Table.View).

Conversões

Nome	Descrição
Table.ToColumns	Retorna uma lista das listas aninhadas, cada uma representando uma coluna de valores na tabela de entrada.
Table.ToList	Retorna uma tabela em lista aplicando a função de combinação especificada a cada linha de valores em uma tabela.
Table.ToRecords	Retorna uma lista de registros de uma tabela de entrada.
Table.ToRows	Retorna uma lista aninhada de valores de linha de uma tabela de entrada.

Informações

Nome	Descrição
Table.ApproximateRowCount	Retorna o número de linhas aproximado na tabela.
Table.ColumnCount	Retorna o número de colunas em uma tabela.
Table.IsEmpty	Retornará true se a tabela não contiver nenhuma linha.
Table.Profile	Retorna um perfil das colunas de uma tabela.
Table.RowCount	Retorna o número de linhas em uma tabela.
Table.Schema	Retorna uma tabela contendo uma descrição das colunas (ou seja, o esquema) da tabela especificada.
Tables.GetRelationships	Retorna os relacionamentos entre um conjunto de tabelas.

Row operations

Nome	Descrição
Table.AlternateRows	Retorna uma tabela que contém um padrão alternado das linhas de uma tabela.
Table.Combine	Retorna uma tabela que é o resultado da mesclagem de uma lista de tabelas. Todas as tabelas devem ter a mesma estrutura de tipo de linha.
Table.FindText	Retorna uma tabela que contém apenas as linhas com o texto especificado dentro de uma de suas células ou de qualquer parte dela.
Table.First	Retorna a primeira linha de uma tabela.
Table.FirstN	Retorna as primeiras linhas de uma tabela, dependendo do parâmetro countOrCondition.
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 em novas colunas. O tipo da coluna pode, opcionalmente, ser especificado; o padrão é Qualquer.
Table.InsertRows	Retorna uma tabela com a lista de linhas inseridas na tabela em um índice. Cada linha a ser inserida deve corresponder ao tipo de linha da tabela.
Table.Last	Retorna a última linha de uma tabela.
Table.LastN	Retorna as últimas linhas de uma tabela, dependendo do parâmetro countOrCondition.
Table.MatchesAllRows	Retornará true se todas as linhas em uma tabela cumprirem uma condição.
Table.MatchesAnyRows	Retornará true se alguma das linhas em uma tabela cumprirem uma condição.
Table.Partition	Particiona a tabela em uma lista de grupos de número de tabelas com base no valor da coluna de cada linha e uma função de hash. A função de hash é aplicada ao valor da coluna de uma linha para obter um valor de hash para a linha. Os grupos de módulos de valor de hash determinam em quais tabelas retornadas a linha será colocada.
Table.PartitionValues	Retorna informações sobre como uma tabela é particionada.
Table.Range	Retorna o número especificado de linhas de uma tabela que começa em um deslocamento.
Table.RemoveFirstN	Retorna uma tabela com o número especificado de linhas removidas da tabela começando na primeira linha. O número de linhas removidas depende do parâmetro opcional countOrCondition.
Table.RemoveLastN	Retorna uma tabela com o número especificado de linhas removidas da tabela começando na última linha. O número de linhas removidas depende do parâmetro opcional countOrCondition.
Table.RemoveRows	Retorna uma tabela com o número especificado de linhas removidas da tabela começando em um deslocamento.
Table.RemoveRowsWithErrors	Retorna uma tabela com todas as linhas removidas da tabela que contêm um erro em pelo menos uma das células em uma linha.
Table.Repeat	Retorna uma tabela que contém as linhas da tabela repetidas o número de vezes da contagem.
Table.ReplaceRows	Retorna uma tabela na qual as linhas que começam em um deslocamento e continuam para a contagem são substituídas pelas linhas fornecidas.
Table.ReverseRows	Retorna uma tabela com as linhas na ordem inversa.
Table.SelectRows	Retorna uma tabela que contém apenas as linhas que correspondem a uma condição.
Table.SelectRowsWithErrors	Retorna uma tabela apenas com as linhas da tabela que contêm um erro em pelo menos uma das células em uma linha.
Table.SingleRow	Retorna uma única linha de uma tabela.
Table.Skip	Retorna uma tabela que não contém a primeira linha ou as primeiras linhas da tabela.
Table.SplitAt	Retorna uma lista contendo as primeiras linhas de contagem especificadas e as linhas restantes.

Column operations

Nome	Descrição
Table.Column	Retorna os valores de uma coluna em uma tabela.
Table.ColumnNames	Retorna os nomes das colunas de uma tabela.
Table.ColumnsOfType	Retorna uma lista com os nomes das colunas que correspondem aos tipos especificados.
Table.DemoteHeaders	Rebaixa a linha de cabeçalho para a primeira linha de uma tabela.
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 as colunas especificadas.
Table.Pivot	Dada uma tabela e uma coluna de atributo contendo pivotValues, cria novas colunas para cada um dos valores dinâmicos e atribui a eles valores de valueColumn. Uma aggregationFunction opcional pode ser fornecida para lidar com várias ocorrências do mesmo valor de chave na coluna de atributo.
Table.PrefixColumns	Retorna uma tabela em que todas as colunas sejam prefixadas um valor de texto.
Table.PromoteHeaders	Promove a primeira linha da tabela em seus nomes de cabeçalho ou coluna.
Table.RemoveColumns	Retorna uma tabela sem uma ou mais colunas específicas.
Table.ReorderColumns	Retorna uma tabela com colunas específicas em uma ordem relativa umas às outras.
Table.RenameColumns	Retorna uma tabela com as colunas renomeadas conforme especificado.
Table.SelectColumns	Retorna uma tabela que contém apenas colunas específicas.
Table.TransformColumnNames	Transforma nomes de colunas ao usar a função fornecida.
Table.Unpivot	Dada uma lista de colunas de tabela, transforma essas colunas em pares de atributo/valor.
Table.UnpivotOtherColumns	Converte todas as colunas que não sejam um conjunto especificado em pares de atributo/valor, combinados com o restante dos valores em cada linha.

Transformação

Nome	Descrição
Table.AddColumn	Adiciona uma coluna chamada newColumnName a uma tabela.
Table.AddFuzzyClusterColumn	Adiciona uma nova coluna com valores representativos obtidos pelo agrupamento difuso dos valores da coluna especificada na tabela.
Table.AddIndexColumn	Retorna uma tabela com uma nova coluna com um nome específico que, para cada linha, contém um índice da linha na tabela.
Table.AddJoinColumn	Executa uma junção aninhada entre table1 e table2 de colunas específicas e produz o resultado de junção como uma coluna newColumnName para cada linha da table1.
Table.AddKey	Adiciona uma chave à tabela.
Table.AggregateTableColumn	Agrega tabelas aninhadas em uma coluna específica em várias colunas que contêm valores de agregação para essas tabelas.
Table.CombineColumns	Table.CombineColumns mescla colunas usando uma função de combinação para produzir uma nova coluna. Table.CombineColumns é o inverso de Table.SplitColumns.
Table.CombineColumnsToRecord	Combina as colunas especificadas em uma nova coluna com valor de registro, na qual cada registro tem nomes e valores de campo correspondentes aos nomes e valores de coluna das colunas combinadas.
Table.ConformToPageReader	Esta função destina-se somente a uso interno.
Table.ExpandListColumn	Dada uma coluna de listas em uma tabela, crie a cópia de uma linha para cada valor na 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 na tabela que as contém.
Table.FillDown	Substitui valores nulos na coluna ou nas colunas especificadas da tabela com o valor não nulo mais recente na coluna.
Table.FillUp	Retorna uma tabela da tabela especificada em que o valor da próxima célula é propagado para as células de valor nulo acima na coluna especificada.
Table.FilterWithDataTable	Esta função destina-se somente a uso interno.
Table.Group	Agrupa linhas de tabela pelos valores de colunas de chave para cada linha.
Table.Join	Une as linhas da tabela1 com as linhas da tabela2 com base na igualdade dos valores das colunas de chave selecionadas por tabela1, chave1 e tabela2, chave2.
Table.Keys	Retorna as chaves da tabela especificada.
Table.NestedJoin	Une as linhas das tabelas com base na igualdade das chaves. Os resultados são inseridos em uma nova coluna.
Table.ReplaceErrorValues	Substitui os valores de erro nas colunas especificadas com o valor especificado correspondente.
Table.ReplaceKeys	Substitui as chaves da tabela especificada.
Table.ReplaceRelationshipIdentity	Esta função destina-se somente a uso interno.
Table.ReplaceValue	Substitui oldValue por newValue em colunas específicas de uma tabela, usando a função de substituto fornecida, como text.Replace ou Value.Replace.
Table.SplitColumn	Retorna um novo conjunto de colunas de uma única coluna aplicando uma função de divisor a cada valor.
Table.TransformColumns	Transforma os valores de uma ou mais colunas.
Table.TransformColumnTypes	Transforma os tipos de coluna de uma tabela usando um tipo.
Table.TransformRows	Transforma as linhas de uma tabela usando uma função de transformação.
Table.Transpose	Retorna uma tabela com colunas convertidas em linhas e linhas convertidas em colunas da tabela de entrada.

Associação

Nome	Descrição
Table.Contains	Determina se o registro a aparece como uma linha na tabela.
Table.ContainsAll	Determina se todos os registros especificados serão exibidos como linhas na tabela.
Table.ContainsAny	Determina se algum dos registros especificados será exibido como linhas na tabela.
Table.Distinct	Remove linhas duplicadas de uma tabela, garantindo que todas as linhas restantes sejam distintas.
Table.IsDistinct	Determina se uma tabela contém apenas linhas distintas.
Table.PositionOf	Determina a posição ou as posições de uma linha em uma tabela.
Table.PositionOfAny	Determina uma ou mais posições de qualquer linha especificada na tabela.
Table.RemoveMatchingRows	Remove todas as ocorrências de linhas de uma tabela.
Table.ReplaceMatchingRows	Substitui linhas específicas de uma tabela pelas novas linhas.

Ordenando

Nome	Descrição
Table.Max	Retorna a maior linha ou as maiores linhas de uma tabela usando um comparisonCriteria.
Table.MaxN	Retorna as N maiores linhas de uma tabela. Depois que as linhas são classificadas, o parâmetro countOrCondition deve ser especificado para filtrar melhor o resultado.
Table.Min	Retorna a menor linha ou as menores linhas de uma tabela usando um comparisonCriteria.
Table.MinN	Retorna as N menores linhas na tabela especificada. Depois que as linhas são classificadas, o parâmetro countOrCondition deve ser especificado para filtrar melhor o resultado.
Table.AddRankColumn	Acrescenta uma coluna com a classificação de uma ou mais colunas.
Table.Sort	Classifica as linhas em uma tabela usando um comparisonCriteria ou uma ordenação padrão se uma não foi especificada.

Outro

Nome	Descrição
Table.Buffer	Armazena uma tabela em buffer na memória, isentando-a de alterações externas durante a avaliação.

Valores dos parâmetros

Como dar nome a colunas de saída

Esse parâmetro é uma lista de valores de texto especificando os nomes de coluna da tabela resultante. Este parâmetro geralmente é usado 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 ordem de chave e de controle, o critério de comparação pode ser uma lista que contém a chave e a ordem.

• Para controlar por completo a comparação, é possível usar uma função de dois argumentos que retorna -1, 0 ou 1 considerando a relação entre as entradas à esquerda e à direita. Value.Compare pode ser usado para delegar essa lógica.

Para obter exemplos, acesse a descrição de Table.Sort.

Critérios de contagem ou condição

Geralmente, esses critérios são usados em operações de ordenação ou de linha. Eles determinam o número de linhas retornadas na tabela e podem ter 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 atendem inicialmente à condição serão retornadas. Quando um valor falha na condição, não são considerados outros valores.

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

Manipulação de valores extras

Os valores extra são usados para indicar como a função deve gerenciar valores adicionais em uma linha. Esse parâmetro é especificado como um número, que é mapeado para as 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 gerenciar colunas ausentes. Esse parâmetro é especificado como um número, que é mapeado para as 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 é mapeado para as 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 seletor de chave que determina a coluna na tabela a aplicar os critérios de igualdade.

  • Uma função de comparador que é usada para especificar o tipo de comparação a ser aplicado. Funções do comparador internas podem ser especificadas. Mais informações: Funções do comparador

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

Para obter exemplos, acesse a descrição de Table.Distinct.