Partilhar via


DATATABLE

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

Vigência 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. Este 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. }
Onde {valores na linha1} é um conjunto delimitado por vírgulas de expressões constantes, ou seja, uma combinação de constantes, combinada com um punhado de funções básicas, incluindo DATE, TIMEe BLANK, bem como um operador plus entre DATE e TIME e um operador menos unário para que valores negativos possam ser expressos.

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

Um valor em falta 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 que declara um conjunto embutido de valores.

Comentários

  • Ao contrário DATATABLE, Table Constructor permite quaisquer expressões escalares como valores de entrada.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

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