Skip to main content

Configuring Model Settings

Model settings enable you to control the behavior of individual AtScale models.

Model settings are defined in the model_settings.yml file, which is stored at the root level of your catalog repository. You can have one model settings file per repository. Any settings defined in this file override their counterparts at the global level.

Note

Any model-scoped setting can also be scoped at the global level. If there is a model configuration setting you would like applied globally, you can set it as a global setting.

Model settings files can only be accessed, edited, and applied by users with either the admin or application_admin role in the Identity Broker. For more information on roles in AtScale, including instructions on assigning them, see Managing Users with the Identity Broker.

Creating a model settings file

To create a model settings file:

  1. Open the Workspace panel and switch to the repository you want to define model settings for.
  2. Click the new object icon and select Model_settings.yml.

The model_settings.yml file appears in the Workspace panel, at the root level of the repository.

Next, you can define the model settings and apply them.

Defining and applying model settings

note

Before performing this procedure, ensure that the catalog and models you are defining settings for are deployed.

To modify model settings:

  1. In Design Center, open the Workspace panel and select the repository that contains the model(s) you want to define settings for.

  2. Open the model_settings.yml file and add/edit settings as needed. For examples, see the model settings file reference below.

  3. Click Save File.

  4. Go to the Deployed Catalogs panel and open the catalog.

  5. Go to the Model Settings tab.

  6. To apply the updated settings, do one of the following:

    • To apply settings for a specific model, locate the model in the list, click Apply Settings, then click Apply Settings.
    • To apply settings for multiple models, click Apply All Settings at the bottom of the list. In the dialog that appears, select the models you want to update, then click Apply Settings.
note

Any invalid settings in the model_settings.yml file appear on the Model Settings tab highlighted in red. When you apply your changes, AtScale ignores these settings and only updates the valid ones.

The settings are applied. You can view the each model's current settings on the Model Settings tab.

Restoring a model's default settings

note

Before performing this procedure, ensure that the catalog and models you are defining settings for are deployed.

If you want to remove all setting overrides for a model and restore the default values:

  1. In Design Center, open the Workspace panel and select the repository that contains the model you want to modify.

  2. Open the model_settings.yml file.

  3. Remove the name of the model and all of its setting overrides from the file.

  4. Click Save File.

  5. Go to the Deployed Catalogs panel and open the catalog.

  6. Go to the Model Settings tab.

  7. To apply your changes and restore the model's default settings, do one of the following:

    • Loctate the model in the list, click Apply Defaults, then click Apply.
    • Click Apply All Settings at the bottom of the list. In the dialog that appears, ensure the model you are updating is selected, then click Apply Settings.

The model's default settings are restored.

Model settings file reference

The model settings file supports the following properties.

object_type

  • Type: const
  • Required: Y

The type of object defined by the file. For model settings files, the value of this property must be model_settings.

overrides

  • Type: array
  • Required: N

Defines the setting overrides to apply to the individual models in the catalog. Each setting must have the following syntax: “setting.name”: value. For example:

object_type: model_settings
overrides:
model1:
"query.factless.ignoreIncidentalFilter": false
"query.factless.useIncidentalFacts": false
model2:
"query.factless.ignoreIncidentalFilter": false
Note

Some settings can have a significant impact on down-stream systems. For example, increasing the number of aggregates for a model by overriding aggregates.systemGenerated.activeInstance.retentionLimit can increase the workload on a data warehouse. Before changing such settings, it is recommended that you check their values across all models that share the same data warehouse.