AI features in Aqua Data Studio are enabled by default. However, organizations can disable or customize these features based on their specific requirements.
As an Administrator, you have the ability to configure AI options globally for all users by using a master ai-config.properties file. This configuration will override any user-specific settings, ensuring consistency across the application. Users will not be able to modify these settings through the File > Options > AI Configuration menu.
Configure AI Options:
- Prepare the
ai-config.propertiesFile:- Create or obtain the
ai-config.propertiesfile with the desired AI configuration settings.
- Create or obtain the
- Locate the ADS Installation Directory:
The location where you need to place theai-config.propertiesfile depends on the operating system:- Linux/Windows: Place the file in the
<ADS_INSTALL_DIR>(the directory where ADS is installed). - macOS: Place the file in the
$APP_ROOT/Contents/(the directory where ADS is installed).
- Linux/Windows: Place the file in the
- Copy the
ai-config.propertiesfile to the appropriate directory as specified above. - Enable or Disable AI Configuration:
- The AI configuration will be automatically enabled or disabled based on the settings in the
ai-config.propertiesfile. - Once the master configuration is detected, ADS will disable users from modifying AI settings through the File > Options > AI Configuration menu.
- The AI configuration will be automatically enabled or disabled based on the settings in the
- Verify the COnfiguration:
- Launch ADS and ensure that the AI options are applied as expected.
- Confirm that users cannot override these settings by attempting to access File > Options > AI Configuration.
Here is an example for Admin configuration of AI on MacOS application (.app)
Steps to Modify Info.plist for configuring ADS v25 > AI master configuration:
- Locate
Aqua Data Studio.App/Contentsfolder:- Navigate to the location of your
.appfile. - Right-click the
.appfile and select Show Package Contents. - Inside the package, find the
Contentsfolder and open it.
- Navigate to the location of your
- Copy
ai.config.propertiesinto theContentsfolder. - Locate
Info.plistin the Contents folder. TheInfo.plistfile is a core configuration file for macOS applications. It contains essential metadata about your app, such as the bundle identifier, version, and JVM-related configurations. - Open
Info.plistfor Editing: Open theInfo.plistfile with a text editor such as TextEdit, or any other preferred editor.
Modify JVM Options: You need to modify JVM options in theInfo.plistfile. Insert the following section inside theInfo.plist, under the<key>JVMOptions</key>section after defining JVM parameters.<key>JVMOptions</key><array><!-- Other JVM arguments go here →<string>-Dai.config.properties=$APP_ROOT/Contents/ai-config.properties</string></array>
This configuration ensures that the master configurationai-config.propertiesis loaded and the user will be disallowed with any AI configuration from File > Options. - Save Changes: Once you’ve added the JVM options, save the
Info.plistfile and close the editor. - Run the Application: After modifying the
Info.plist, relaunchAqua Data Studio.Appto apply the changes.