Ler em inglês

Partilhar via


TABELA DE DADOS

Aplica-se a: Coluna calculada Tabela calculada Medida Cá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

Termo 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, TIME e 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 devolvido

Uma tabela que declara um conjunto embutido de valores.

Observações

  • Ao contrário de 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"}  
                }  
           )