Description
This macro has all the same parameters as the SQL Macro and behaves similarly in most cases. There are two primary reasons for using sql-query:
Some databases/JDBC drivers support read-only SQL statements. The sql-query macro attempts to use this support, if available. Otherwise, it behaves exactly like the sql macro. Read-only support means the database can optimize for read only statements to improve performance. For some databases (PostgreSQL for instance), the read-only aspect is enforced while others it is only a performance suggestion.
Using Macro Security for Confluence, administrators can configure different restrictions for use of the sql and sql-query macros. This provides greater flexibility allowing more people access to query without having access for other SQL operations. For instance, administrators can create read-only data sources using database access controls and only grant access to those specific data sources.
Parameters
Examples
{sql-query:dataSource=readOnlyDS|output=wiki}
select * from test
{sql-query}