Compatibility level for tabular models

APPLIES TO: yesSQL Server Analysis Services yesAzure Analysis Services noPower BI Premium

The compatibility level refers to release-specific behaviors in the Analysis Services engine. For example, DirectQuery and tabular object metadata have different implementations depending on the compatibility level. In-general, you should choose the latest compatibility level supported by your servers.

The latest supported compatibility level is 1500

Major features in the 1500 compatibility level include:

Supported compatibility levels by version

Compatibility level Server version
1500 Azure Analysis Services, SQL Server 2019 (RC1 and later)
1400 Azure Analysis Services, SQL Server 2019, SQL Server 2017
1200 Azure Analysis Services, SQL Server 2019, SQL Server 2017, SQL Server 2016
1103 SQL Server 2017*, SQL Server 2016, SQL Server 2014, SQL Server 2012 SP1
1100 SQL Server 2017*, SQL Server 2016, SQL Server 2014, SQL Server 2012 SP1, SQL Server 2012

* 1100 and 1103 compatibility levels are deprecated in SQL Server 2017.

Set compatibility level

Note

Setting the 1500 compatibility level is not yet supported in SSDT.

When creating a new tabular model project in SQL Server Data Tools (SSDT), you can specify the compatibility level on the Tabular model designer dialog.

ssas_tabularproject_compat1200

If you select the Do not show this message again option, all subsequent projects will use the compatibility level you specified as the default. You can change the default compatibility level in SSDT in Tools > Options.

To upgrade a tabular model project in SSDT, set the Compatibility Level property in the model Properties window. Keep in-mind, upgrading the compatibility level is irreversible.

Check compatibility level for a tabular database in SSMS

In SSMS, right-click the database name > Properties > Compatibility Level.

Check supported compatibility level for a server in SSMS

In SSMS, right-click the server name> Properties > Supported Compatibility Level.

This property specifies the highest compatibility level of a database that will run on the server. The supported compatibility level is read-only cannot be changed.

Note

In SSMS, when connected to a SQL Server Analysis Services server, Azure Analysis Services server, or Power BI Premium workspace, the Supported Compatibility Level property will show 1200. This is a known issue and will be resolved in an upcoming SSMS update. When resolved, this property will show the highest supported compatibility level.

See also

Compatibility Level of a multidimensional database
Create a new tabular model project