This Getting Started - Configuration page provides instructions for configuring the Bob Swift Atlassian app - SQL for Confluence version 10.0. It also lists the various configuration options with a detailed description, so that you can customize your app using the available options.
Configure SQL for Confluence
After upgrading or installing SQL for Confluence, follow the steps mentioned below to navigate to the Global configuration:
- Log in as a user with the system administrator's Global Permission.
- Select CONFLUENCE ADMINISTRATION > Manage apps from the Administration menu (cog icon: ) at the top right of your screen. Then scroll down to BOB SWIFT CONFIGURATION on the navigation bar to the left and choose SQL (Pro Edition).
This configuration page contains global settings that will control the behavior of data sources and data source profiles. Once saved, settings chosen on this page is applied to all macros across pages.
Table: configuration options explained
|Limit rows processed||No limit|
The maximum number of rows to be processed and displayed by SQL macros. This prevents queries that use excessive resources resulting in a large number of rows. Individual queries can use the limit parameter to override this value. The following options are available from a selection list:
- No limit
- 250 (Recommended)
|Limit query time||No limit|
The number of seconds that a query can take before a forced timeout. This prevents queries that take too long, from impacting other users. Individual users can use the queryTimeout parameter to override this value.
The following options are available from a selection list:
- No limit
- 120 (Recommended)
Note, this parameter:
- Requires that the target database and JDBC driver support the remote query timeout server configuration option (queryTimeout).
- Administrators can limit (or control) who can use this parameter through the use of our Macro Security for Confluence app.
|Transaction isolation level||Read committed|
Default level used if the macro parameter does not specify a specific level. The following options are available for selection:
- Read committed
- Read uncommitted
- Repeatable read
Note this parameter requires that the target database and JDBC driver support transaction isolation levels.
|Disable anti-XSS mode||Off|
Anti-XSS mode reduces exposure to XSS exploits related to SQL app macros. By default, the app respects Confluence's global Anti-XSS settings. This configuration allows an administrator to globally turn off anti-XSS mode only for the SQL Macro. An alternative method is to enable groups or individuals from using the disableAntiXss parameter to control this for individual Macros. This may be necessary for queries that require producing HTML constructs.
|Help us improve the product||ON||Enable this option to report usage data that helps us to improve the app continually. The app does not send any private user data or personally identifiable information. To learn more about what is shared, refer to Analytics data.|