description | title |
---|---|
Learn more about: DATATABLE |
DATATABLE function | Microsoft Docs |
[!INCLUDEapplies-to-measures-columns-tables-visual-calculations]
Provides a mechanism for declaring an inline set of data values.
DATATABLE (ColumnName1, DataType1, ColumnName2, DataType2..., {{Value1, Value2...}, {ValueN, ValueN+1...}...})
Term | Definition |
---|---|
ColumnName | Any DAX expression that returns a table. |
DataType | An enumeration that includes: INTEGER, DOUBLE, STRING, BOOLEAN, CURRENCY, DATETIME |
Value | A single argument using Excel syntax for a one dimensional array constant, nested to provide an array of arrays. This argument represents the set of data values that will be in the table For example, { {values in row1}, {values in row2}, {values in row3}, etc. } Where {values in row1} is a comma delimited set of constant expressions, namely a combination of constants, combined with a handful of basic functions including DATE, TIME, and BLANK, as well as a plus operator between DATE and TIME and a unary minus operator so that negative values can be expressed. The following are all valid values: 3, -5, BLANK(), "2009-04-15 02:45:21". Values may not refer to anything outside the immediate expression, and cannot refer to columns, tables, relationships, or anything else. A missing value will be treated identically to BLANK(). For example, the following are the same: {1,2,BLANK(),4} {1,2,,4} |
A table declaring an inline set of values.
-
Unlike DATATABLE, Table Constructor allows any scalar expressions as input values.
-
[!INCLUDE function-not-supported-in-directquery-mode]
= DataTable("Name", STRING,
"Region", STRING
,{
{" User1","East"},
{" User2","East"},
{" User3","West"},
{" User4","West"},
{" User4","East"}
}
)