Executes a SQL script file.Property replacement is performed on the files before they are executed.

Delimiting Sql files

Please note that the statements in the Sql files must be delimited properly.

Use ; to delimit individual statements.
Use / on new line to delimit program blocks.
Use /* or -- (two dashes) for comments.

Target Properties

Property Name	Property Code	Required	Description
Oracle Database User	`FDORA_USER`	Yes	The username that will be used to connect to the target Oracle Database.
Oracle Database Password	`FDORA_PASSWORD`	Yes	The password for Oracle Database User.
SQLPlus Path	`FDSQLPLUS_PATH`	No	Provide the sqlplus path (Required if sqlplus is not on PATH environment). ( Ex: `/u01/install/APPS/apps/tech_st/10.1.2/bin/sqlplus`)
SQLPlus Source Script	`FDSQLPLUS_ENVIRONMENT_SCRIPT`	No	Source Script with full path. (Ex: `/u01/install/APPS/apps/apps_st/appl/oracle_config.env`)
Oracle SID	`FDSQLPLUS_ORACLE_SID`	No	Provide the Oracle SID (optional if it is already set in the source script).

Inputs

Input Name	Input Code	Required	Description
User	`FDSQLPLUS_INP_ORA_USER`	No	The username that will be used to connect with. This input takes precedence over the target scoped `FDORA_USER`property. This input is required if the `FDORA_USER`property is not specified.
Password	`FDSQLPLUS_INP_ORA_PASSWORD`	No	The password for `FDSQLPLUS_INP_ORA_PASSWORD`. This input takes precedence over the target scoped `FDORA_PASSWORD` property. This input is required if the `FDORA_PASSWORD` property is not specified.
Script File	`FDSQLPLUS_INP_FILE_PATH`	Yes	Fully qualified or relative path to script file. If relative path is given, it will be assumed to be in the `FD_ARTIFACTS_DIR`.
User Profile (login.sql)	`FDSQLPLUS_INP_LOGIN_SQL_FILE`	No	User Profile (login.sql) is intended to allow users to specifically customize their session. (see the Special Considerations section for examples)
Generate SQL Spool File	`FDSQLPLUS_INP_GENERATE_SPOOL_FILE`	No	Check to generate report (Spool file) of SQL statement executions.
Show DBMS Output	`FDSQLPLUS_INP_SHOW_DBMS_OUT`	No	Print DBMS output in the log.
Fix SQL Syntax	`FDSQLPLUS_INP_FIX_SQL_SYNTAX`	No	Check to fix common SQL syntax issues.
Ignore Compilation Warnings	`FDSQLPLUS_INP_IGNORE_WARNING`	No	If checked, sql compilation warnings will be ignored. Otherwise, they will cause the execution to be marked as fail.

Artifacts

This operation consumes one Sql file from the artifacts repository.

Endpoint Selection

This operation delegates the selection to the workflow developer to determine.

Endpoint Execution

This operation will randomly execute on one of the endpoint identified during selection.

Special Considerations

The script provided in the input FDSQLPLUS_INP_LOGIN_SQL_FILE will be created as the login.sql file in the current working directory and will be deleted after execution. The login.sql script in SqlPlus is automatically executed whenever you start SqlPlus. It can be used to set up your SQL*Plus environment, including formatting options, environment variables, and other session settings.

Below is an example script that can be customized based on requirements.

-- Set the SQL*Plus environment settings
SET ECHO OFF
SET FEEDBACK ON
SET HEADING ON
SET LINESIZE 200
SET PAGESIZE 9999
SET SERVEROUTPUT ON
SET TERMOUT ON
SET TIMING ON
SET VERIFY OFF

-- Set default schema
ALTER SESSION SET CURRENT_SCHEMA=YOUR_SCHEMA_NAME;

-- Define common substitution variables
DEFINE my_variable = 'default_value'

-- Custom SQL*Plus prompt
SET SQLPROMPT "SQL> "

-- Display a welcome message
PROMPT Welcome to SQL*Plus

runScript(SqlPlus)