Compartilhar via

DATATABLE

  • Artigo

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Fornece um mecanismo para declarar um conjunto embutido de valores de dados.

Sintaxe

DATATABLE (ColumnName1, DataType1, ColumnName2, DataType2..., {{Value1, Value2...}, {ValueN, ValueN+1...}...})

Parâmetros

Prazo Definição
ColumnName Qualquer expressão DAX que retorna uma tabela.
DataType Uma enumeração que inclui: INTEGER, DOUBLE, STRING, BOOLEAN, CURRENCY, DATETIME
value Um único argumento usando a sintaxe do Excel para uma constante de matriz unidimensional, aninhada para fornecer uma matriz de matrizes. Esse argumento representa o conjunto de valores de dados que estarão na tabela

Por exemplo
{ {valores na linha1}, {valores na linha2}, {valores na linha3}, etc. }
Em que {valores na linha1} é um conjunto delimitado por vírgulas de expressões constantes, ou seja, uma combinação de constantes, combinadas com um punhado de funções básicas, incluindo DATE, TIMEe BLANK, bem como um operador de adição entre DATE e TIME e um operador unary minus para que os valores negativos possam ser expressos.

Veja a seguir todos os valores válidos: 3, -5, BLANK(), "2009-04-15 02:45:21". Os valores podem não se referir a nada fora da expressão imediata e não podem se referir a colunas, tabelas, relações ou qualquer outra coisa.

Um valor ausente será tratado de forma idêntica a BLANK(). Por exemplo, os seguintes são os mesmos: {1,2,BLANK(),4} {1,2,,4}

Valor de retorno

Uma tabela declarando um conjunto embutido de valores.

Observações

  • Ao contrário de DATATABLE, o Construtor de Tabelas permite expressões escalares como valores de entrada.

  • Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

Exemplo

= DataTable("Name", STRING,
               "Region", STRING
               ,{
                        {" User1","East"},
                        {" User2","East"},
                        {" User3","West"},
                        {" User4","West"},
                        {" User4","East"}
                }
           )