A collection of reusable code, programs, and database objects that provides common functionality across all E-Business products.
Object Type Identification
- Files ending in file extensions added to the EBS SQL Extensions (
FDEBS_SQL_EXTENSIONS)
project property are also added.- EBS SQL Extensions property defaults to seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc.
- EBS SQL Extensions property defaults to seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc.
Files with .sql extension are identified as this type only AFTER excluding them as Concurrent Program SQLs (by source folder).
Files that start with "SCHEMA" will automatically update the user and password properties accordingly. See SQL File Considerations for more information.
File Extensions
Name | Description |
---|---|
.seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc | A file containing sql statements. Extensions may be customized using the SQL Extensions project property. |
Object Type
Name | Code |
---|---|
DB Objects (SQLs) | SQL |
Object Type Attributes
Name | Code | Description | Default Value | Supported Values |
---|---|---|---|---|
Source | SOURCE | Object Source Location Type | SCM | SCM |
Target Location | TARGET_LOCATION | Path to where the file should be deployed to. | $<PROD_TOP>/patch/115/sql/ | |
Type | TYPE | DB Object Type | Generic SQL | |
DB User Property | DB_USER | FlexDeploy property to use as the user to connect to the database with. |
You can use file name like SCHEMASCHEMANAME_FILENAME.sql. For example, SCHEMAPOS_registertrans.tbl. In this case this will default to | |
DB Password Property | DB_PASSWORD | FlexDeploy property to use as the password for the DB User Property. |
You can use file name like SCHEMASCHEMANAME_FILENAME.sql. For example, SCHEMAPOS_registertrans.tbl. In this case this will default to | |
Ignore Failure | IGNORE_FAILURE | Check if failure in file should be ignored. | If file contains WHENEVER SQLERROR CONTINUE case insensitively, this property will default to true. | |
Fix SQL Syntax | FIX_SQL_SYNTAX | If there is need to add / at the end of file, FlexDeploy will add it at deploy time. For example, if there is program block as last statement, we need / and new line after it. | True | |
Target File Permission | FILE_PERMISSIONS | Permissions to apply to the file after it is deployed | Defaults to the project property FDEBS_FILE_PERMISSIONS |
Related Project Properties
Name | Code | Description | Default Value |
---|---|---|---|
SQL Root Source Directory | FDEBS_SQL_ROOT_SOURCE_DIR | Source folder for sql and pls files (e.g. db). | sql |
SQL Root Destination Directory | FDEBS_SQL_ROOT_DESTINATION_DIR | Target directory for SQL and PLS files (e.g. XXHR_TOP/admin/sql). | $<PROD_TOP>/patch/115/sql |
SQL Extensions | FDEBS_SQL_EXTENSIONS | SQL file extensions in their order to process. | seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc See Database SQL file extensions and their order of process. |
SQL Ignore Compile Errors | FDEBS_SQL_IGNORE_COMPILE_ERRORS | Ignore SQL compilation errors for all files in the project | false |
SQL Retry Count | FDEBS_SQL_RETRY_COUNT | Retry count for SQLs and PL/SQLs. | 5 |
File Permissions | FDEBS_FILE_PERMISSIONS | Target File Permission. Will be set to target file after deployment using chmod. eg: 755 | |
Ignore Errors File List | FDEBS_IGNORE_ERRORS_FILE_LIST | List of files to ignore errors (e.g. DropHRTables.sql,*_ddl.sql). |
Sample Build Commands
N/A - Build commands not supported for this type.
Sample Deploy Commands
cp "$SOURCE_FILE" "$XXHR_TOP/patch/115/sql/"; cd "$XXHR_TOP/patch/115/sql/" sqlplus $FDEBS_DB_USER/$FDEBS_DB_PASSWORD <<EOF set define off @XXHR_BIPUB_REP_PKG.seq . SHOW ERRORS exit sql.sqlcode EOF
Special Considerations
- Make sure to end file with forward slash /, if last statement is FUNCTION, JAVA SOURCE, PACKAGE, PACKAGE BODY, PROCEDURE, TRIGGER, TYPE, TYPE BODY.
- FlexDeploy will automatically add / at the end of file if last statement is a program block.
- Simple statements can be delimited by ; at end of statement but FUNCTION, JAVA SOURCE, PACKAGE, PACKAGE BODY, PROCEDURE, TRIGGER, TYPE, TYPE BODY needs / after it no matter where it is added in SQL file.
- FlexDeploy will automatically add / at the end of file if last statement is View, Insert, Update, Delete and does not end with ;.
- Single or multiple line comments are also supported in input files.
Here are some considerations for SQL File format and deployment.
SQL File Format
Program blocks
Program blocks should be terminated by use of /. See examples below. For example, Package Specification, Package Body, Trigger etc. FlexDeploy will add / at the end of the file is last statement is program block.
BEGIN EXECUTE IMMEDIATE 'DROP TABLE XXHR.XXHR_WF1'; EXCEPTION WHEN OTHERS THEN NULL; END; / BEGIN EXECUTE IMMEDIATE 'DROP SYNONYM XXHR_WF1'; EXCEPTION WHEN OTHERS THEN NULL; END; / CREATE OR REPLACE PACKAGE xxhr_bipub_rep_pkg AS PROCEDURE generate_xml(p_errbuf OUT VARCHAR2 ,p_retcode OUT NUMBER); END xxhr_bipub_rep_pkg; /
Non program blocks
Statements that are not program blocks should be terminated using ;. For example create or replace view, insert etc.
CREATE SYNONYM apps.XXHR_WF1 FOR xxhr.XXHR_WF1; CREATE OR REPLACE FORCE VIEW "APPS"."DUMMY_V1" ("COUNT") AS (SELECT 1 from dual);
Comments
Comments in SQL file. See below for supported formats.
Good comment examples
--single line comment /* * Name : XXHR_WF1 * */
Following comment is not supported as it will cause SP2-0103: Nothing in SQL buffer to run.
Bad Comments
/*Added comment by chandresh to test flexdeploy*/
Recompiling invalids
Consider adding compileInvalidSqls operation in Deploy workflow if SQL files are being deployed. This operation can take longer if there are many invalid objects in Schema.
Custom objects in non apps schema
Custom objects in non APPS schema with grants to APPS user. It is recommended by Oracle to create custom objects in custom schema. You need to provide Grants to APPS user to these custom objects. You can achieve this in two different ways in FlexDeploy.
Give necessary rights to APPS user, so it can select on any other schema objects. For example, SELECT ANY TABLE privilege can be given to APPS and similarly other ANY type Grants can be given to APPS user.
Use custom schema user in FlexDeploy to create objects and grant to APPS.
Create custom user and password properties on Deploy workflow to be at Target Scope. For example,
Defined values for these user and password in various Target pages in Topology.
Use custom properties on Project Files tab for specific Files.
If you want the file to populate with the correct schema user and password property attached, create the filename like "SCHEMASCHEMANAME_FILENAME.sql"
e.g. SCHEMAPOS_registertrans.tbl
This will automatically try to use the properties FDEBS_DB_SCHEMAPOS_USER and FDEBS_DB_SCHEMAPOS_PASSWORD, so if using the filenames to link the schema users, follow this naming standard of the property codes.
Example File
DROP TABLE HR.DEPARTMENTS; CREATE TABLE HR.DEPARTMENTS ( DEPARTMENT_ID NUMBER (4) NOT NULL , DEPARTMENT_NAME VARCHAR2 (30 BYTE) NOT NULL , MANAGER_ID NUMBER (6) , LOCATION_ID NUMBER (4) ); DROP SEQUENCE HR.DEPARTMENTS_SEQ; CREATE SEQUENCE HR.DEPARTMENTS_SEQ INCREMENT BY 10 MAXVALUE 9990 MINVALUE 1 NOCACHE; CREATE OR REPLACE TRIGGER HR.ID_DEPARTMENTS BEFORE INSERT ON HR.DEPARTMENTS FOR EACH ROW BEGIN SELECT HR.DEPARTMENTS_SEQ.NEXTVAL INTO :new.DEPARTMENT_ID FROM dual; END ID_DEPARTMENTS; /