Scenario
Div | ||
---|---|---|
| ||
Estimated Time: 10 min |
In this scenario, we will add the SQL-file macro to a Confluence page by inserting Markup from the menu. The SQL-file macro references a file located within the <confluence-home>/script (default) directory on the Confluence server.
Background
In this scenario will use a data source profile "BookWarehouse," to query a database table "BOOKS". The table contains the following columns and rows:
Code Block | ||
---|---|---|
| ||
SQL > select * from books;
+----+----------------------------+---------------------+-------+
| id | title | author | price |
+----+----------------------------+---------------------+-------+
| 1 | The Grapes of Wrath | John Steinbeck | 12.99 |
| 2 | Nineteen Eighty-Four | George Orwell | 8.99 |
| 3 | The Wind-Up Bird Chronicle | Haruki Murakami | 7.99 |
| 4 | Don Quixote | Miguel De Cervantes | 29.99 |
| 5 | Pilgrims Progress | John Bunyan | 17.99 |
| 6 | Robinson Crusoe | Daniel Defoe | 29.05 |
| 7 | Gullivers Travels | Jonathan Swift | 15.98 |
| 8 | Tom Jones | Henry Fielding | 13.59 |
| 9 | Clarissa | Samuel Richardson | 13.59 |
| 10 | Tristram Shandy | Laurence Sterne | 7.59 |
+----+----------------------------+---------------------+-------+ |
The statement is present in the "books.sql" file and is located within the <confluence-home>/script (default) directory on the Confluence server. The statement is as follows:
Code Block | ||
---|---|---|
| ||
SELECT title as "Title", author as "Author", price as "Retail Price" FROM books WHERE price < 30 ORDER BY title; |
Steps
The following steps demonstrate the steps involved in inserting a SQL-file macro on a Confluence page.
...
border | 0 |
---|---|
heading | 0 |
multiple | false |
enableHeadingAttributes | false |
columnAttributes | style="border:0;width=5%;",style="border:0;width=65%;",style="border:0;width=30%;max-width=30% !important;" |
id | steps_table |
enableSorting | false |
enableHighlighting | false |
...
Create Confluence page
Create a Confluence page that contains a SQL-file macro.
- Create a page named Classic Books in a space accessible to the desired audience.
- Click Save to save the new page.
...
Insert SQL-file macro using the Insert markup menu
Edit the Classic Books page and:
...
Type the following into the editor window. Note the dataSource name and file name referenced.
Code Block |
---|
{sql-file:dataSource=BookWarehouse|file=books.sql} |
...
Alternative method:
...
Edit the Classic Books page and:
- On the page, begin typing "{" (open parenthesis) and then type "sql-"
- Select "sql-file" from the available list of macros.
- The macro editor dialog will appear.
- Select "BookWarehouse" as the data source name.
- Type "books.sql" into the required "File" field.
Click Save settings to insert your Markup within the page.
- Click Save to save your page and view your results.
...
How to Insert markup from the menu
Alternative method
Explore Tutorials
We've prepared a number of tutorials which demonstrate how to use our SQL macros with the native Chart macro.
Include Page | ||||
---|---|---|---|---|
|