Ler em inglês

Partilhar via


Funções de tabela

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

Construção de tabelas

Name Description
ItemExpression.De 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.De Retorna a árvore de sintaxe abstrata (AST) para o corpo de uma função.
RowExpression.Row Um nó de árvore de sintaxe abstrata (AST) que representa a linha em uma expressão de linha.
Table.FromColumns Retorna uma tabela de uma lista que contém listas aninhadas com os nomes e valores das colunas.
Table.FromList Converte uma lista em uma 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 a partir da lista onde 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 contendo o valor fornecido ou a lista de valores.
Table.FuzzyGroup Agrupa as linhas de uma tabela fazendo correspondência difusa de valores na coluna especificada para cada linha.
Table.FuzzyJoin Junta as linhas das duas tabelas que combinam com base nas teclas fornecidas.
Table.FuzzyNestedJoin Executa uma junção difusa entre tabelas nas colunas fornecidas e produz o resultado da junção em uma nova coluna.
Tabela.Split Divide a tabela especificada em uma lista de tabelas usando o tamanho de página especificado.
Table.WithErrorContext Esta função destina-se apenas a uso interno.
Tabela.Ver 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 acionará um fallback quando lançado por um manipulador definido em um modo de exibição (via Table.View).
Table.ViewFunction Cria uma função que pode ser intercetada por um manipulador definido em um modo de exibição (via Table.View).

Conversões

Name Description
Table.ToColumns Retorna uma lista de listas aninhadas, cada uma representando uma coluna de valores na tabela de entrada.
Table.ToList Retorna uma tabela em uma 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

Name Description
Table.ApproximateRowCount Devolve o número aproximado de linhas na tabela.
Table.ColumnCount Devolve o número de colunas numa tabela.
Table.IsEmpty Retorna true se a tabela não contiver linhas.
Tabela.Perfil Retorna um perfil das colunas de uma tabela.
Table.RowCount Devolve o número de linhas numa tabela.
Tabela.Esquema Retorna uma tabela contendo uma descrição das colunas (ou seja, o esquema) da tabela especificada.
Tables.GetRelationships Retorna as relações entre um conjunto de tabelas.

Operações de linha

Name Description
Table.AlternateRows Retorna uma tabela que contém um padrão alternativo das linhas de uma tabela.
Tabela.Combinar 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 contendo apenas as linhas que têm o texto especificado dentro de uma de suas células ou qualquer parte dela.
Tabela.Primeiro Devolve a primeira linha de uma tabela.
Tabela.FirstN Retorna a(s) primeira(s) linha(s) de uma tabela, dependendo do parâmetro countOrCondition.
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 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 inserir deve corresponder ao tipo de linha da tabela..
Tabela.Última Devolve a última linha de uma tabela.
Tabela.LastN Retorna a(s) última(s) linha(s) de uma tabela, dependendo do parâmetro countOrCondition.
Table.MatchesAllRows Retorna true se todas as linhas de uma tabela atenderem a uma condição.
Tabela.CorrespondênciasAnyRows Retorna true se qualquer uma das linhas de uma tabela atender a uma condição.
Tabela.Partição Particiona a tabela em uma lista de grupos, número de tabelas, com base no valor da coluna de cada linha e uma função hash. A função 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 qual das tabelas retornadas a linha será colocada.
Table.PartitionValues Retorna informações sobre como uma tabela é particionada.
Tabela.Intervalo Retorna o número especificado de linhas de uma tabela começando 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 countOrCondition opcional.
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 countOrCondition opcional.
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 de uma linha.
Table.Repeat Devolve uma tabela que contém as linhas da tabela repetiu o número de vezes a contagem.
Table.ReplaceRows Retorna uma tabela onde as linhas que começam em um deslocamento e continuam para contagem são substituídas pelas linhas fornecidas.
Table.ReverseRows Devolve uma tabela com as linhas em ordem inversa.
Table.SelectRows Retorna uma tabela contendo apenas as linhas que correspondem a uma condição.
Table.SelectRowsWithErrors Retorna uma tabela com apenas as linhas da tabela que contêm um erro em pelo menos uma das células de uma linha.
Table.SingleRow Retorna uma única linha de uma tabela.
Tabela.Pular Retorna uma tabela que não contém a primeira linha ou linhas da tabela.
Table.SplitAt Retorna uma lista contendo as primeiras linhas de contagem especificadas e as linhas restantes.

Operações de coluna

Name Description
Tabela.Coluna Devolve os valores de uma coluna numa 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 a(s) coluna(s) especificada(s).
Tabela.Pivô Dada uma tabela e coluna de atributo contendo pivotValues, cria novas colunas para cada um dos valores de pivô e atribui-lhes valores a partir de valueColumn. Uma agregationFunction 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 onde as colunas foram todas prefixadas com 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 coluna ou colunas específicas.
Table.ReorderColumns Retorna uma tabela com colunas específicas em uma ordem relativa uma à outra.
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 usando a função fornecida.
Table.Unpivot Dada uma lista de colunas de tabela, transforma essas colunas em pares atributo-valor.
Table.UnpivotOtherColumns Traduz todas as colunas que não sejam um conjunto especificado em pares atributo-valor, combinados com o restante dos valores em cada linha.

Transformação

Name Description
Table.AddColumn Adiciona uma coluna chamada newColumnName a uma tabela.
Table.AddFuzzyClusterColumn Adiciona uma nova coluna com valores representativos obtidos por valores de agrupamento difusos da coluna especificada na tabela.
Table.AddIndexColumn Devolve 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 a partir de colunas específicas e produz o resultado da junção como uma coluna newColumnName para cada linha da tabela1.
Tabela.AddKey Adiciona uma chave à tabela.
Table.AggregateTableColumn Agrega tabelas aninhadas em uma coluna específica em várias colunas contendo valores agregados para essas tabelas.
Table.CombineColumns Table.CombineColumns mescla colunas usando uma função combinadora 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 onde cada registro tem nomes de campo e valores correspondentes aos nomes de coluna e valores das colunas que foram 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 várias colunas na tabela que contém.
Tabela.FillDown Substitui valores nulos na coluna ou colunas especificadas da tabela pelo valor não nulo mais recente na coluna.
Table.FillUp Retorna uma tabela da tabela especificada onde o valor da próxima célula é propagado para as células de valores nulos acima na coluna especificada.
Table.FilterWithDataTable Esta função destina-se apenas a uso interno.
Tabela.Grupo Agrupa as linhas da tabela pelos valores das colunas de chave para cada linha.
Table.Join Junta 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 Junta 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 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 oldValue por newValue em colunas específicas de uma tabela, usando a função de substituição fornecida, como texto. Substitua ou Value.Replace.
Table.SplitColumn Retorna um novo conjunto de colunas de uma única coluna aplicando uma função divisória 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.
Tabela.Transpor Retorna uma tabela com colunas convertidas em linhas e linhas convertidas em colunas da tabela de entrada.

Associação

Name Description
Tabela.Contém Determina se o registro a aparece como uma linha na tabela.
Table.ContainsAll Determina se todos os registros especificados aparecem como linhas na tabela.
Tabela.ContémQualquer Determina se algum dos registros especificados aparece como linhas na tabela.
Tabela.Distinto 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.
Tabela.PosiçãoDe Determina a posição ou posições de uma linha dentro de uma tabela.
Tabela.PosiçãodeQualquer Determina a posição ou posições de qualquer uma das linhas especificadas 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.

Ordenação

Name Description
Tabela.Max Retorna a maior linha ou linhas de uma tabela usando um comparisonCriteria.
Tabela.MaxN Devolve as maiores N linhas de uma tabela. Depois que as linhas são classificadas, o parâmetro countOrCondition deve ser especificado para filtrar ainda mais o resultado.
Tabela.Min Retorna a menor linha ou linhas de uma tabela usando um comparisonCriteria.
Tabela.MinN Devolve as menores linhas N na tabela fornecida. Depois que as linhas são classificadas, o parâmetro countOrCondition deve ser especificado para filtrar ainda mais o resultado.
Table.AddRankColumn Acrescenta uma coluna com a classificação de uma ou mais colunas.
Tabela.Ordenar Classifica as linhas em uma tabela usando um comparisonCriteria ou uma ordem padrão se uma não for especificada.

Outro

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

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 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. Para obter 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 obter exemplos, vá para a descrição de Table.Sort.

Critérios de contagem ou condição

Este critério é geralmente usado em operações de ordenação ou linha. 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

Manuseamento de valores extra

Os 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 mapeia para as seguintes opções:

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

Para obter mais informações: Table.FromList, ExtraValues.Type

Manuseamento 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;

Esse parâmetro é usado em operações de coluna ou transformação, por exemplo, em Table.TransformColumns. Para obter mais informações: MissingField.Type

Sequência de Ordenaçã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 mapeia 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 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. Built-in funções de comparação podem ser especificadas. Para obter 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.