Introduction

SQL for Confluence is a powerful app that provides unlimited potential by allowing users to bring external data into Confluence pages. To make the most of our product, we've prepared this page containing the key concepts and helpful background information. 

Data Sources

SQL Macrosmacrosuse Data Sources data sources to access databases. A Data Source data source defines the access parameters including credentials (e.g, UN/PW). To begin using SQL Macros  macros and including external data within Confluence pages, your Confluence administrator must first create a Data Source data source and/or Data Source Profiledata source profile. Once created, it is important that your Confluence administrator share the name of the Data Source data source with you. Each time you embed a SQL Macro  macro on a Confluence page, you will be are prompted to provide the name of the Data Sourcedata source. 

Data Sources sources come in two flavors and as the downstream consumer of them, it's important that you understand their differences.

Table describing Data Source types:

Data Source Type	Primary Benefit	Key Attributes	Express Edition	Pro Edition
Data Source Profilessource profiles	Convenience	SQL for Confluence specific configuration Convenience: Configuration change in affect immediately File system access not needed Can reference application server defined Data Sourcesdata sources Recommended for evaluation, testing, or short term scenarios Medium or heavier use scenarios should also employ Cache for Confluence to  to improve page performance
Application server defined Data Sourcedata source	Performance	Application server based configuration Best performance via connection pooling/reuse Requires Confluence restart after configuration change Recommended for long term or heavy use scenarios

Tables

SQL for Confluence comes pre-packaged with many of the capabilities of Advanced Tables — another  — another popular Bob Swift Marketplace app. Among many other things, this app allows you to send the output of external data that has been retrieved by one or more of our SQL Macrosmacros to a table. Tables can be pretty powerful on their own when displaying results from your queries, but our team didn't stop there. Included within SQL for Confluence, you will find 25 of our most popular table parameters to help you format, style, organize, and summarize your data. We make it easy for you to interact with table parameters from each of our SQL Macro macro editors. So, what are you waiting for? Go make your spurious tuples in tables look amazing! Try saying that three times fast.  

Charting

Confluence provides native charting capability via its its Chart Macromacro. SQL for Confluence not only supports this Macromacro, but has been tightly integrated. So, in a sense, our app knows how to speak chart. By simply wrapping one of our SQL Macros  macros with the native Chart Macro macro, you can instantly send SQL output containing your external data to a beautiful chart. Pretty amazing stuff!

SQL Parameters

Over the years, we've grown the number of parameter and parameter options that you can flex within our SQL Macros macros. Ideally, we want to provide our users with all the built-in capabilities from the database vendor their Data Sources data sources are accessing. Understanding that some of these parameters can be sensitive, we also provide the ability for your administrator to control their usage. 

Next Up

With key concepts under your belt, we recommend you explore and familiarize yourself with the Macros macros that are shipped with SQL for Confluence.