Translations in tabular models
Applies to: SQL Server 2017 and later Analysis Services Azure Analysis Services Power BI Premium
In tabular models, an object can have multiple translations of a name or description, making it possible to support multi-language versions within the model definition.
Translated strings are for object metadata only (names and descriptions of tables and columns) that appear in a client tool like an Excel PivotTable list. To use translated strings, the client connection specifies the culture. In the Analysis in Excel feature, you can choose the language from a drop-down list. For other tools, you might need to specify the culture in the connection string.
This feature is not intended loading translated data into a model. If you want to load translated data values, you should develop a processing strategy that includes extracting translated strings from a data source that provides them.
A typical workflow for adding translated metadata looks like this:
Generate an empty translation JSON file that contains placeholders for each string translation
Add string translations to the JSON file
Import the translations back into the model
Build, process, or deploy the model
Connect to the model using a client application that allows an LCID on the connection string
Create an empty translation file
Use Visual Studio to add translations to the model project.
Click Extensions > Model > Translations > Manage Translations.
Select the languages for which you are providing translations and then click Add.
Choose one or more languages from the list, depending on how you want to import the strings later.
Your translation file can include multiple languages, but you might find translation management easier if you create one translation file per language. The translation file you're creating now will be imported in its entirety later. To vary import options by language, each language needs to be in its own file.
Click Export Language File. Provide a file name and location.
An empty JSON translation file includes metadata for a specific language translations. Translation placeholders for object names and descriptions are specified in the Culture section at the end of the model definition. Translations can be added for the following:
|translatedCaption||Table or column title that appears in any client application supporting visualizations of a Tabular model.|
|translatedDescription||Less common than captions, a description appears as model information in a modeling tool like SSDT.|
Don't delete any unspecified metadata from the file. It should match the file upon which it is based. Just add the strings you want, and then save the file.
Although it might look like something you should modify, the referenceCulture section contains the metadata in the default culture of the model. Any changes made to the referenceCulture section will not be read in during import and will be ignored.
The following example shows translated captions and description for the DimProduct and DimCustomer tables.
You can use any JSON editor to open the file, but we recommend using the JSON editor in Visual Studio. Use the View Code command in Solution explorer to view the tabular model definition.
Import a translation file
Translation strings that you import become a permanent part of the model definition. Once the strings are imported, the translation file is no longer referenced.
Click Extensions > Model > Translations > Import Translations.
Find the translation file and then click Open.
Optionally, specify import options.
Import option Description Overwrite existing translations Replaces all existing captions or descriptions of the same language as the file being imported. Ignore invalid objects Specifies whether metadata discrepancies should be ignored or flagged as an error. Write import results to a log file Log files are saved to the project folder by default. The exact path to the file is provided after import concludes. The log file name is SSDT_Translations_Log_<timestamp>. Back up translations to a JSON file before importing Backs up an existing translation that matches the culture of the strings being imported. If the culture being imported is not present in the model, then the backup will be empty.
If you need to restore this file later, you can replace the contents of the model.bim with this JSON file.
Optionally, if you generated a log file or backup, you can find the files in the project folder.
To verify the import, follow these steps:
Right-click the model.bim file in Solution Explorer and choose View Code. Click Yes to close the design view and reopen model.bim in code view. If you installed a full version of Visual Studio, such as the free Community edition, the file opens in the built-in JSON editor.
Search for Culture or for a specific translated string to verify the strings you expect to see are actually there.
Connect using a locale identifier
This section describes an approach for validating the correct strings are returned from the model.
In Excel, connect to the Tabular model. This step assumes the model has been deployed. If the model only exists in the workspace, deploy it to an Analysis Services instance to complete the validation check.
Alternatively, you can use the Analyze in Excel feature to connect to the model
In the Excel connection dialog box, choose the culture for which string translations exist in your model. Excel detects cultures defined in the model and populates the drop-down list accordingly.
When you create a PivotTable, you should see the translated table and column names.