Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This command is used to execute directly requests to specified in parameters database table. Command allows executing insert, update, any stored procedures, any SQL statement.

General Syntax

Here is general command statement syntax:

Code Block
cmdmgr.exe dbrequest [--section=section_name] --sqlstatement=<"SQL text"> | statement<select|insert|update|sp> [additional paramters]

There two general types of statements:

  • any SQL statement. This statement required «sqlstatement» parameter that must contain SQL query;
  • standard statements. This is select\insert\update or stored procedure statements. «statement» parameter must contain statement type. Command manager support such statements: select, update, insert, sp.

Here are syntaxes for every statement type

...

.

1. «select» statement

...

Code Block
cmdmgr.exe dbrequest [--section=section_name] --statement=select --table=PREFIX.TABLE_NAME --columns="Col1,Col2,ColN" --conditions="Cond1>1,Cond2!=2,Cond3=3" [--df | disableformatting] [--maxrows=25] [--asis] [--xml]

Parameters

After execution result will be in output stream. Here are parameters that use this statement:

  • table – this is database table for which statement is executing. This must be table name with prefix;
  • columns – columns of specified table that will be selected. To select all columns, pass «*» as value;
  • conditions – conditions for statement execution. Can be empty.

Example

...

Code Block
cmdmgr.exe dbrequest statement=select --table=eaglemgr.dbo.cmdmgr_test_table --columns="*" --conditions="ID<3" --df -asis


Select exampleImage Modified

...

2. «update» statement

...

Code Block
cmdmgr.exe dbrequest [--section=section_name] --statement=update --table=PREFIX.TABLE_NAME --values="Col1=1,Col2=2" --conditions="Cond1>1,Cond2!=2,Cond3=3" [--df | disableformatting] [--xml]

Parameters

Execution of this statement will only print error or success message. Here are statement parameters:

  • table – as with «select» statement this is database table for which statement is executing. This must be table name with prefix;
  • values – this is «column=value» list of columns that statement will update;
  • conditions – conditions for statement execution. This parameter cannot be empty.

Example

...

Code Block
cmdmgr.exe dbrequest statement=update --table=eaglemgr.dbo.cmdmgr_test_table --values="Name=1,Value =2" conditions="ID=2"


Update exampleImage Modified

...

3. «insert» statement

...

Code Block
cmdmgr.exe dbrequest [--section=section_name] --statement=insert --table=PREFIX.TABLE_NAME --values="Col1=1,Col2=2" [--xml]

Parameters

Execution of this statement will print only success or error message and rows count affected. Here are statement parameters:

  • table – this is database table for which statement is executing. This must be table name with prefix;
  • values – list of «column=value» parameters that statement will insert to table.

Example

...

Code Block
cmdmgr.exe dbrequest statement=insert --table=eaglemgr.dbo.cmdmgr_test_table --values="ID=4,Name=filo,Value=test"


Insert statement exampleImage Modified

...

4. stored procedure («sp») statement

...

Code Block
cmdmgr.exe dbrequest [--section=section_name] --statement=sp --sp=Schema.SpName --arguments="Arg1=1,Arg2=2" [--df | disableformatting] [--maxrows=25] [--asis] [--xml]

Parameters

Based on stored procedure type, this statement execution can print data as in «select» statement to output stream. Here are statement parameters:

  • sp – name of stored procedure in database. Format is Schema.SpName;
  • arguments – this is «arg_name=value» list of stored procedure arguments.

Example

...

Code Block
cmdmgr.exe dbrequest --statement=sp --sp="EAGLEMGR.DBO.TEST_CALC" --arguments="in_value_1=1,in_value_2=1,in_action=+" -asis


Stored procedure exampleImage Modified

...

5. any SQL statement

...

Code Block
cmdmgr.exe dbrequest [--section=section_name] --sqlstatement="SQL text" [--df | disableformatting] [--maxrows=25] [--asis] [--xml]

Parameter

This statement allows to execute any user defined SQL query. Statement has only one parameter that must be specified:

  • sqlstatement – this is user defined SQL query that will be executed. As in «select» statement, if user defined SQL query, returns any result data, it will be printed to output stream;

Example

...

Code Block
cmdmgr.exe dbrequest --sqlstatement="select * from eaglemgr.dbo.cmdmgr_test_table " -df --maxrows=25 –asis

SQL statement exampleImage Modified

...


Info

Most statements have optional parameters that are the same in any context. Here are these parameters and their descriptions:

  • section – this is section from db_connection.ini. By default, primary section used;
  • df(disableformatting) – switches off advanced output formatting;
  • maxrows – maximum rows count to output;
  • asis – print output data, without replacing data to columns type (<BLOB>, <CLOB>, <XML> .etc);
  • xml – output will be formatted in XML. If this parameter is specified, --asis and --disableformatting will be ignored.


On this page

Table of Contents
maxLevel2