Configuring Global Settings
Global settings enable you to control the behavior of the AtScale engine.
Global settings were previously called engine settings.
Global settings are defined in a file called global_settings.yml
. Any settings defined in this file override AtScale’s default global settings.
The global settings file is managed in a dedicated Git repository. You can only have one global settings repository for your AtScale instance. This repository must only contain the global_settings.yml
file and (optionally) a readme.
The global settings repository and file can only be accessed by users with the superuser_user
role in the Identity Broker, which is automatically granted to admin
and application_admin
users. For more information on managing roles in AtScale, see Managing Users with the Identity Broker.
The following sections describe how to set up a global settings repository and manage your global settings.
Create a global settings repository and file
To create a global settings repository:
-
Create a new repository in Git.
-
Link the repository to AtScale:
-
In Design Center, click Settings in the main navigation bar. The Settings page opens.
-
In the Settings Repo field, click the pencil icon.
-
Enter the URL for the global settings repository, then click Save.
noteUnlike other repositories in AtScale, you cannot define a name for the global settings repository. It always appears in the Workspace panel as Global Settings.
-
-
Open the Workspace panel and switch to the Global Settings repository.
-
Click the new object icon at the top of the panel and select global_settings.yml. A
global_settings.yml
file is added to the repository.
You can now edit the file to define your global settings and apply them as needed. For instructions, see the following procedure.
Modify and apply global settings
To modify global settings:
-
In Design Center, open the Workspace panel and switch to the Global Settings repository.
-
Open
global_settings.yml
and define overrides as needed. For more information, see the global settings file reference below. -
Click Save File.
-
Go to the Source Control panel and commit and sync your changes.
noteYou can optionally skip this step and apply the settings locally first to test them.
-
To apply the settings, return to the Workspace panel, click the context menu for the
global_settings.yml
file, and select Apply Global Settings.
You may need to restart the AtScale engine for your changes to take effect. You can do this through your cluster.
Once you have committed and applied your changes, you can view your overrides on the Settings page.
Global settings file reference
The global settings file supports the following properties.
object_type
- Type: const
- Required: Y
The type of object defined by the file. For global settings files, the value of this property must be global_settings
.
overrides
- Type: array
- Required: N
A list of the global setting overrides you want to define. Each override must have the following syntax: “setting.name”: value
. For example:
object_type: global_settings
overrides:
"aggregate.snowflake.table.names.uppercase": true
"query.drillthrough.max_rows": 1000