Automation Guide Action-based testing language Built-in actions System actions Database

 use database

use database

Description

Specify a database against which the ensuing SQL action lines are to be applied.

Arguments

• name

  Name of the database connection (previously established via the connect database action).

Notes

• This action is generally invoked as part of a sequence of actions to allow the test to access a data source. (See Testing with databases for more information.)
• This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: remove double quotes from cell.

Applicable Controls

This action is applicable to the following controls: none.

Example:

The following example illustrates the process of connecting to, and using, a database from within a test. After creating a named connection string and using it to connect to the database, invoke use database to specify the active database to be used by the test.

Action Lines \

Result

Related concepts
Testing with databases