Get Started - Configuration - 10.x

On this page


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:

  1. Log in as a user with the system administrator's Global Permission.
  2. 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)
    (See: )

Global Configuration

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 processedNo 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)
  • 500
  • 1,000
  • 2,500
  • 5,000
  • 10,000
  • 15,000
  • 20,000
  • 25,000
Limit query timeNo 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
  • 1
  • 5
  • 10
  • 30
  • 60
  • 120 (Recommended)
  • 300
  • 600

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 levelRead 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
  • Serializable
  • None

Note this parameter requires that the target database and JDBC driver support transaction isolation levels.

Disable anti-XSS modeOff

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. 

Note that disableAntiXss parameter use can be controlled by the Macro Security for Confluence app.

Help us improve the productONEnable 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.