Aqua Commands (Revision #0)

Query analyzer scripts have support for 9 client side commands which allow you to execute a stored procedure with local variables bound to the parameters.

 See the AquaScripts and AquaProjects Section for much more complex scripting capabilities.

This allows for the execution of procedures with OUT parameters. The commands include print, println, variable, executeCallableQuery, sendMail, saveResults, saveLastResult, setResultSettings and setPivotResultSettings.

Client side commands are identified by a dot at the beginning of the command line, and multiple commands can be executed within one batch statement. The schema browser contains object scripting for procedures and functions that include "EXECUTE" and "EXECUTE BIND". The script EXECUTE will generate the appropriate code needed to execute the object according to the database procedural language (ie. PL/SQL, T-SQL). The EXECUTE BIND will generate the appropriate Aqua Data Studio client side commands to execute the object. To easily generate the needed client commands to execute a procedure or function, you may browse in the schema browser to locate the procedure or function and right-click on the object to select "EXECUTE BIND" from the Script Object menus.

Command support

Query Analyzer scripts have support for client side commands ".sendMail", ".saveResults", ".saveLastResult", "setResultSettings", "setPivotResultSettings" which allow users to either save query results in an EXCEL, HTML, XML, or CSV document, or insert them into a table.

The 'sendMail' command sends emails using the settings you specify and allows attachments.

The 'saveResults' command saves the results of all of the queries in the window, while the 'saveLastResult' command only saves the result for the last query.

The 'setResultSettings' command lays out how grid data will be presented.

The 'setPivotResultSettings' command lays out how pivot grid data will be presented.

Here is a combination example script using .setPivotResultSettings, .saveResults and .sendMail which runs a query, takes data from that query, lays out and generates a pivot grid result, saves the pivot grid results to two different Excel files, then emails a message with both Excel files as attachments.

.println [.print]

Syntax:
.println { | 'text value' }[, ... n]

Example:
.println myvar
.println ' Results:', OUTVAR

.variable

Syntax:
.variable , datatype [, value]

Example:
.variable myvar, varchar, 'this is a test'
.variable INVAR, NUMBER, 0
.variable OUTVAR, NUMBER, 0
.variable INOUTVAR, DATE, '2005-01-01 12:00:00 AM'

.executeCallableQuery

Syntax:
.executeCallableQuery 'parameter_name[, ... n]',
{ CALL ( ? { , ? ... } ) }
or ...
{ ? = CALL ( ? { , ? ... } ) }

Example:
.executeCallableQuery 'INVAR,OUTVAR,INOUTVAR',
BEGIN
    SCOTT.FULL_PROCEDURE(?, ?, ?);
END;
 

.sendMail

Syntax:
.sendMail 'host=mail.aquafold.com,
port=25,
ssl=TRUE,
authentication=TRUE,
user=myuser,
password=mypass,
[email protected],
to="[email protected],[email protected], [email protected]",
cc="[email protected],[email protected]",
bcc="[email protected],[email protected]",
subject="New Software Release",
message="Get the latest version of ADS!\nReady for download at www.aquafold.com",
attachments="c:/my directory/abc.xls, D:/another/def.txt"'

.saveResults and .saveLastResult
(all of the .saveResults commands work for both .saveResults and .saveLastResult)

.saveResults

Syntax:
.saveResults 'Format=CSV,
File="",
Delimiter=,
QuoteIdentifier=,
IncludeHeader=,
IncludeRowCount=,
IncludeNullText=,
NewLine=,
Encoding=,
Overwrite='

Syntax:
.saveResults 'Format=XML,
File="",
QuoteIdentifier=,
IncludeHeader=,
IncludeRowCount=,
IncludeNullText=,
NewLine=,
Encoding=,
Overwrite='

Syntax:
.saveResults 'Format=HTML,
File="",
IncludeSQL=,
QuoteIdentifier=,
IncludeHeader=,
IncludeRowCount=,
IncludeNullText=,
NewLine=,
Encoding=,
AlternateRow=,
AlternateRowForeground=,
AlternateRowBackground=,
Overwrite='

Syntax:
.saveResults 'Format=INSERT,
File="",
QuoteIdentifier=,
IncludeHeader=,
IncludeRowCount=,
IncludeNullText=,
NewLine=,
Encoding=,
Overwrite='

Syntax:
.saveResults 'Format=EXCEL,
Source=,
File="",
IncludeSQL=,
IncludeHeader=,
IncludeRowCount=,
IncludeNullText=,
AlternateRow=,
AlternateRowForeground=,
AlternateRowBackground=,
Overwrite='

Example:
.saveResults 'format=excel,
source=pivot,
file=C:/abc.xls,
overwrite=true'

.setResultSettings

Syntax:

"CategoryFields" is now synonymous with "RowFields"
and
"SeriesFields" is now synonymous with "ColFields"

The List of Aggregate Functions can contain one or more of the following:
Sum, Max, Min, Mean, Var, Stddev, Count

.setResultSettings 'Index=,
Title=,
CategoryFields=,where a field looks like "[Field Name] {List of Aggregate Functions}
SeriesFields=,
SortBy=,
SortOrder=,
ShowTitle=,
TopCount=,
ShowTopCount=,
ShowLegend=,
ShowChart=,
Chart=,
ScaleData=,
RotX=,
RotY=,
RotZ=,
Zoom=,
Split=,
Paging=,
Paging='

Example:
.setResultSettings 'Index=1,
Chart=column,
RotX=325,
RotY=53,
RotZ=0,
Zoom=50.0,
ScaleData=true,
ShowChart=true,
ShowLegend=true,
ShowTitle=false,
ColFields="[ShipCountry]",
DataFields="[Freight]",
Paging=true,
ShowTopCount=false,
Split=0.35460994'

.setPivotResultSettings

Syntax:

"CategoryFields" is now synonymous with "RowFields"
and
"SeriesFields" is now synonymous with "ColFields"

The List of Aggregate Functions can contain one or more of the following:
Sum, Max, Min, Mean, Var, Stddev, Count

.setPivotResultSettings 'Index=,
ShowFields=,
ShowTotal=,
ShowSubTotal=,
Title=,
RowFields=,where a field looks like "[Field Name] {List of Aggregate Functions}
ColFields=,
DataFields=,
SortBy=,
SortOrder=,
ShowTitle=,
TopCount=,
ShowTopCount=,
ShowLegend=,
ShowChart=,
Chart=,
ScaleData=,
RotX=,
RotY=,
RotZ=,
Zoom=,
Split=,
Paging=,
Paging='

Example:
.setPivotResultSettings 'Index=1,
Chart=column,
RotX=324,
RotY=12,
RotZ=0,
Zoom=50.0,
ScaleData=true,
ShowChart=false,
ShowLegend=true,
ShowTitle=false,
RowFields="ShipCountry",
ColFields="ShipVia",
DataFields="Freight",
Paging=true,
ShowTopCount=false,
Split= 0.5,
ShowFields=true,
ShowTotal=true,
ShowSubTotal=true'

COMBINATION EXAMPLE SCRIPT

select * from orders

GO

.setPivotResultSettings 'Index=1,
Chart=column,
RotX=324,
RotY=12,
RotZ=0,
Zoom=50.0,
ScaleData=true,
ShowChart=false,
ShowLegend=true,
ShowTitle=false,
RowFields="ShipCountry",
ColFields="ShipVia",
DataFields="Freight",
Paging=true,
ShowTopCount=false,
Split= 0.5,
ShowFields=true,
ShowTotal=true,
ShowSubTotal=true'

GO

.saveResults 'format=excel,
source=pivot,
file=C:/abc.xls,
overwrite=true'

GO

.saveResults 'format=excel,
source=pivot,
file=C:/abc2.xls,
overwrite=true'

GO

.sendMail 'host=smtp.gmail.com,
port=465,
ssl=true,
authentication=true,
user=,
password=,
[email protected],
[email protected],
subject="Nice document attached",
message="This will blow your sockets off\ncheck it out!",
attachments="c:/abc.xls,c:/abc2.xls"'