Versions Compared

Key

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

Executes a SQL script. This operation parses the SQL script and processes each statement in the database using JDBC. Property replacement is performed on the files before they are parsedexecuted.

Info
titleDelimiting 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.

...

Property Name

Property Code

Required

Description

JDBC URL

FDJDBC_URL

Yes

The JDBC URL of the database.

JDBC User

FDJDBC_USER

No

The username that will be used to connect with.

JDBC Password

FDJDBC_PASSWORD

No

The password of the username.

JDBC Driver Path

FDJDBC_DRIVER_PATH

Yes

Classpath for locating the JDBC Driver (e.g. for Weblogic - {ORACLE_HOME}. For example, 

/u01/oracle/fmw/oracle_common/modules/oracle.jdbc_11.2.0/ojdbc6.jar).

Project Properties

Property Name

Property Code

Required

Description





Inputs

Input Name

Input Code

Required

Description

User

FDJDBC_INP_USER

No

The username that will be used to connect with. for database connection. Required if Environment/Instance JDBC User property is not specified.

This input takes precedence over the environment instance scoped FDJDBC_USER property. This input is required if the FDJDBC_USER property is not specifiedEnvironment/Instance JDBC User property.

Password

FDJDBC_INP_PASSWORD

No

The password for FDJDBC_INP_USER. Password for User specified in plugin input. Required if Environment/Instance JDBC Password property is not specified.

This input takes precedence over the environment instance scoped FDJDBC_PASSWORD property. This input is required if the FDJDBC_PASSWORD property is not specified.Environment/Instance JDBC Password property.

Script File

FDJDBC_INP_FILE_NAME

YesThe

Fully qualified or relative path to

the

script

to execute

file. If

a

relative path is given,

the path

it will be assumed to be in the FD_ARTIFACTS_DIR.

Script file can be SQL file or Sequence file with one or more SQL file.

Sequence file is useful to run more than one SQL file in specific sequence. Sequence file must have !SEQ on first line. Each additional line should indicate SQL files as relative path to Sequence file.

Code Block
themeRDark
linenumberstrue
!SEQ
CreateHR.sql
GrantHR.sql
ADFStateMgt.sql

Statements in the SQL files must be delimited properly.

Run Destructive

FDJDBC_INP_RUN_DESTRUCTIVE

No

This option input allows destructive statements to be run. See Special Considerations belowa mechanism for disallowing certain destructive SQL commands.

If the input is set to true, DROP, DELETE, and TRUNCATE will be allowed within the script.

If the input is set to false, plugin operation will abort with a validation error prior to running any of the commands in the script.

This check cannot stop malicious actors, but instead helps to provide some security against accidental running of destructive commands. It is up to the customer to decide whether they want to allow such commands.

Ignore Compilation WarningsFDJDBC_INP_IGNORE_WARNINGNo

If checked, sql compilation warnings will be ignored. Otherwise, they will cause the execution to be marked as failed.

For Oracle database, plugin will print errors from USER_ERRORS or DBA_ERRORS for the object being deployed. (@since 5.1.0.1). This support was modified slightly in 5.1.0.3 to Plugin will read errors from USER_ERRORS first and then read from DBA_ERRORS if nothing found, previously it read from one or the other depending on if schema is coded in SQL statement

Show DBMS OutputFDJDBC_INP_SHOW_DBMS_OUTNoPrint DBMS Output in the log. Only supported for Oracle Database. 

Outputs

Output Name

Required

Description




Artifacts

This operation consumes one or more SQL files, and an optional sequence 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

...

Include Page
Appendix-JDBC
Appendix-JDBC