HackBase/plex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

again cleanup

Browse Source
This commit is contained in:
ogobrecht 2019-06-16 16:58:56 +02:00
parent 190bcb67ec
commit 51634535a9
8 changed files with 356 additions and 552 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
.editorconfig Normal file
View File

@ -0,0 +1,17 @@
# EditorConfig is awesome: https://EditorConfig.org
# top-most EditorConfig file
root = true
[*]
trim_trailing_whitespace = true
[*.{md}]
trim_trailing_whitespace = false
[*.{sql,pks,pkb,json}]
indent_style = space
indent_size = 2
[*.{sql,pks,pkb,json,md,txt,bat}]
charset = utf-8

2
.gitignore vendored
View File

@ -3,3 +3,5 @@ temp
demo.sql demo.sql
L_XE*.sql L_XE*.sql
*.zip *.zip
plex_install_SYS.bat
plex_install_APEX_190100.bat

420
PLEX.pkb
View File

File diff suppressed because it is too large Load Diff

136
PLEX.pks
View File

@ -29,7 +29,7 @@ The package itself is independend, but functionality varies on the following con
INSTALLATION INSTALLATION
- Download the [latest version](https://github.com/ogobrecht/plex/releases/latest) - Download the [latest version](https://github.com/ogobrecht/plex/releases/latest)
- Unzip it, open a shell and `cd` into the root directory - Unzip it, open a shell and go into the root directory
- Start SQL*Plus (or another tool which can run SQL scripts) - Start SQL*Plus (or another tool which can run SQL scripts)
- To install PLEX run the provided install script `plex_install.sql` (script provides compiler flags) - To install PLEX run the provided install script `plex_install.sql` (script provides compiler flags)
- To uninstall PLEX run the provided script `plex_uninstall.sql` or drop the package manually - To uninstall PLEX run the provided script `plex_uninstall.sql` or drop the package manually
@ -66,8 +66,7 @@ TYPE rec_error_log IS RECORD (
time_stamp TIMESTAMP, time_stamp TIMESTAMP,
file_name VARCHAR2(255), file_name VARCHAR2(255),
error_text VARCHAR2(200), error_text VARCHAR2(200),
call_stack VARCHAR2(500) call_stack VARCHAR2(500));
);
TYPE tab_error_log IS TABLE OF rec_error_log; TYPE tab_error_log IS TABLE OF rec_error_log;
TYPE rec_runtime_log IS RECORD ( TYPE rec_runtime_log IS RECORD (
@ -77,17 +76,16 @@ TYPE rec_runtime_log IS RECORD (
elapsed NUMBER, elapsed NUMBER,
execution NUMBER, execution NUMBER,
module app_info_text, module app_info_text,
action app_info_text action app_info_text);
);
TYPE tab_runtime_log IS TABLE OF rec_runtime_log; TYPE tab_runtime_log IS TABLE OF rec_runtime_log;
TYPE rec_export_file IS RECORD ( TYPE rec_export_file IS RECORD (
name VARCHAR2(255), name VARCHAR2(255),
contents CLOB contents CLOB);
);
TYPE tab_export_files IS TABLE OF rec_export_file; TYPE tab_export_files IS TABLE OF rec_export_file;
TYPE tab_varchar2 IS TABLE OF varchar2(32767); TYPE tab_vc32k IS TABLE OF varchar2(32767);
TYPE tab_vc1k IS TABLE OF VARCHAR2(1024) INDEX BY BINARY_INTEGER;
-------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
@ -95,7 +93,7 @@ TYPE tab_varchar2 IS TABLE OF varchar2(32767);
-------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
FUNCTION backapp ( FUNCTION backapp (
$if $$apex_installed $then $if $$apex_installed $then
-- App related options: -- App related options:
p_app_id IN NUMBER DEFAULT null, -- If null, we simply skip the APEX app export. p_app_id IN NUMBER DEFAULT null, -- If null, we simply skip the APEX app export.
p_app_date IN BOOLEAN DEFAULT true, -- If true, include export date and time in the result. p_app_date IN BOOLEAN DEFAULT true, -- If true, include export date and time in the result.
@ -110,7 +108,7 @@ $if $$apex_installed $then
p_app_supporting_objects IN VARCHAR2 DEFAULT null, -- If 'Y', export supporting objects. If 'I', automatically install on import. If 'N', do not export supporting objects. If null, the application's include in export deployment value is used. p_app_supporting_objects IN VARCHAR2 DEFAULT null, -- If 'Y', export supporting objects. If 'I', automatically install on import. If 'N', do not export supporting objects. If null, the application's include in export deployment value is used.
p_app_include_single_file IN BOOLEAN DEFAULT false, -- If true, the single sql install file is also included beside the splitted files. p_app_include_single_file IN BOOLEAN DEFAULT false, -- If true, the single sql install file is also included beside the splitted files.
p_app_build_status_run_only IN BOOLEAN DEFAULT false, -- If true, the build status of the app will be overwritten to RUN_ONLY. p_app_build_status_run_only IN BOOLEAN DEFAULT false, -- If true, the build status of the app will be overwritten to RUN_ONLY.
$end $end
-- Object related options: -- Object related options:
p_include_object_ddl IN BOOLEAN DEFAULT false, -- If true, include DDL of current user/schema and all its objects. p_include_object_ddl IN BOOLEAN DEFAULT false, -- If true, include DDL of current user/schema and all its objects.
p_object_type_like IN VARCHAR2 DEFAULT null, -- A comma separated list of like expressions to filter the objects - example: '%BODY,JAVA%' will be translated to: ... from user_objects where ... and (object_type like '%BODY' escape '\' or object_type like 'JAVA%' escape '\'). p_object_type_like IN VARCHAR2 DEFAULT null, -- A comma separated list of like expressions to filter the objects - example: '%BODY,JAVA%' will be translated to: ... from user_objects where ... and (object_type like '%BODY' escape '\' or object_type like 'JAVA%' escape '\').
@ -129,8 +127,8 @@ $end
p_include_error_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_error_log.md with detailed error messages. p_include_error_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_error_log.md with detailed error messages.
p_base_path_backend IN VARCHAR2 DEFAULT 'app_backend', -- The base path in the project root for the database DDL files. p_base_path_backend IN VARCHAR2 DEFAULT 'app_backend', -- The base path in the project root for the database DDL files.
p_base_path_frontend IN VARCHAR2 DEFAULT 'app_frontend', -- The base path in the project root for the APEX UI install files. p_base_path_frontend IN VARCHAR2 DEFAULT 'app_frontend', -- The base path in the project root for the APEX UI install files.
p_base_path_data IN VARCHAR2 DEFAULT 'app_data' -- The base path in the project root for the data files. p_base_path_data IN VARCHAR2 DEFAULT 'app_data') -- The base path in the project root for the data files.
) RETURN tab_export_files; RETURN tab_export_files;
/** /**
Get a file collection of an APEX application (or the current user/schema only) including: Get a file collection of an APEX application (or the current user/schema only) including:
@ -170,7 +168,6 @@ BEGIN
p_app_id => 100, -- parameter only available when APEX installed p_app_id => 100, -- parameter only available when APEX installed
p_include_object_ddl => true, p_include_object_ddl => true,
p_include_data => false)); p_include_data => false));
-- do something with the zip file -- do something with the zip file
-- Your code here... -- Your code here...
END; END;
@ -231,8 +228,7 @@ SELECT backapp FROM dual;
PROCEDURE add_query ( PROCEDURE add_query (
p_query IN VARCHAR2, -- The query itself p_query IN VARCHAR2, -- The query itself
p_file_name IN VARCHAR2, -- File name like 'Path/to/your/file-without-extension'. p_file_name IN VARCHAR2, -- File name like 'Path/to/your/file-without-extension'.
p_max_rows IN NUMBER DEFAULT 1000 -- The maximum number of rows to be included in your file. p_max_rows IN NUMBER DEFAULT 1000); -- The maximum number of rows to be included in your file.
);
/** /**
Add a query to be processed by the method queries_to_csv. You can add as many queries as you like. Add a query to be processed by the method queries_to_csv. You can add as many queries as you like.
@ -255,8 +251,8 @@ FUNCTION queries_to_csv (
p_quote_mark IN VARCHAR2 DEFAULT '"', -- Used when the data contains the delimiter character. p_quote_mark IN VARCHAR2 DEFAULT '"', -- Used when the data contains the delimiter character.
p_header_prefix IN VARCHAR2 DEFAULT NULL, -- Prefix the header line with this text. p_header_prefix IN VARCHAR2 DEFAULT NULL, -- Prefix the header line with this text.
p_include_runtime_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_runtime_log.md with runtime statistics. p_include_runtime_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_runtime_log.md with runtime statistics.
p_include_error_log IN BOOLEAN DEFAULT true -- If true, generate file plex_error_log.md with detailed error messages. p_include_error_log IN BOOLEAN DEFAULT true) -- If true, generate file plex_error_log.md with detailed error messages.
) RETURN tab_export_files; RETURN tab_export_files;
/** /**
Export one or more queries as CSV data within a file collection. Export one or more queries as CSV data within a file collection.
@ -266,7 +262,6 @@ EXAMPLE BASIC USAGE
DECLARE DECLARE
l_file_collection plex.tab_export_files; l_file_collection plex.tab_export_files;
BEGIN BEGIN
--fill the queries array --fill the queries array
plex.add_query( plex.add_query(
p_query => 'select * from user_tables', p_query => 'select * from user_tables',
@ -275,10 +270,8 @@ BEGIN
p_query => 'select * from user_tab_columns', p_query => 'select * from user_tab_columns',
p_file_name => 'user_tab_columns', p_file_name => 'user_tab_columns',
p_max_rows => 10000); p_max_rows => 10000);
-- process the queries -- process the queries
l_file_collection := plex.queries_to_csv; l_file_collection := plex.queries_to_csv;
-- do something with the file collection -- do something with the file collection
FOR i IN 1..l_file_collection.count LOOP FOR i IN 1..l_file_collection.count LOOP
dbms_output.put_line(i || ' | ' dbms_output.put_line(i || ' | '
@ -295,7 +288,6 @@ EXPORT EXPORT ZIP FILE PL/SQL
DECLARE DECLARE
l_zip_file BLOB; l_zip_file BLOB;
BEGIN BEGIN
--fill the queries array --fill the queries array
plex.add_query( plex.add_query(
p_query => 'select * from user_tables', p_query => 'select * from user_tables',
@ -304,10 +296,8 @@ BEGIN
p_query => 'select * from user_tab_columns', p_query => 'select * from user_tab_columns',
p_file_name => 'user_tab_columns', p_file_name => 'user_tab_columns',
p_max_rows => 10000); p_max_rows => 10000);
-- process the queries -- process the queries
l_zip_file := plex.to_zip(plex.queries_to_csv); l_zip_file := plex.to_zip(plex.queries_to_csv);
-- do something with the zip file -- do something with the zip file
-- Your code here... -- Your code here...
END; END;
@ -338,8 +328,8 @@ SELECT queries_to_csv_zip FROM dual;
FUNCTION to_zip ( FUNCTION to_zip (
p_file_collection IN tab_export_files -- The file collection to zip. p_file_collection IN tab_export_files) -- The file collection to zip.
) RETURN BLOB; RETURN BLOB;
/** /**
Convert a file collection to a zip file. Convert a file collection to a zip file.
@ -352,7 +342,6 @@ BEGIN
l_zip := plex.to_zip(plex.backapp( l_zip := plex.to_zip(plex.backapp(
p_app_id => 100, p_app_id => 100,
p_include_object_ddl => true)); p_include_object_ddl => true));
-- do something with the zip file... -- do something with the zip file...
END; END;
``` ```
@ -387,28 +376,24 @@ SELECT * FROM TABLE(plex.view_runtime_log);
$if $$utils_public $then $if $$utils_public $then
FUNCTION util_bool_to_string ( FUNCTION util_bool_to_string (p_bool IN BOOLEAN) RETURN VARCHAR2;
p_bool IN BOOLEAN
) RETURN VARCHAR2;
FUNCTION util_string_to_bool ( FUNCTION util_string_to_bool (
p_bool_string IN VARCHAR2, p_bool_string IN VARCHAR2,
p_default IN BOOLEAN p_default IN BOOLEAN)
) RETURN BOOLEAN; RETURN BOOLEAN;
FUNCTION util_split ( FUNCTION util_split (
p_string IN VARCHAR2, p_string IN VARCHAR2,
p_delimiter IN VARCHAR2 DEFAULT ',' p_delimiter IN VARCHAR2 DEFAULT ',')
) RETURN tab_varchar2; RETURN tab_vc32k;
FUNCTION util_join ( FUNCTION util_join (
p_array IN tab_varchar2, p_array IN tab_vc32k,
p_delimiter IN VARCHAR2 DEFAULT ',' p_delimiter IN VARCHAR2 DEFAULT ',')
) RETURN VARCHAR2; RETURN VARCHAR2;
FUNCTION util_clob_to_blob ( FUNCTION util_clob_to_blob (p_clob CLOB) RETURN BLOB;
p_clob CLOB
) RETURN BLOB;
/* /*
ZIP UTILS ZIP UTILS
@ -421,20 +406,18 @@ ZIP UTILS
FUNCTION util_zip_blob_to_num ( FUNCTION util_zip_blob_to_num (
p_blob IN BLOB, p_blob IN BLOB,
p_len IN INTEGER, p_len IN INTEGER,
p_pos IN INTEGER p_pos IN INTEGER)
) RETURN NUMBER; RETURN NUMBER;
FUNCTION util_zip_little_endian ( FUNCTION util_zip_little_endian (
p_big IN NUMBER, p_big IN NUMBER,
p_bytes IN PLS_INTEGER := 4 p_bytes IN PLS_INTEGER := 4)
) RETURN RAW; RETURN RAW;
PROCEDURE util_zip_add_file ( PROCEDURE util_zip_add_file (
p_zipped_blob IN OUT BLOB, p_zipped_blob IN OUT BLOB,
p_name IN VARCHAR2, p_name IN VARCHAR2,
p_content IN BLOB p_content IN BLOB);
);
PROCEDURE util_zip_finish ( PROCEDURE util_zip_finish (p_zipped_blob IN OUT BLOB);
p_zipped_blob IN OUT BLOB
);
FUNCTION util_multi_replace ( FUNCTION util_multi_replace (
p_source_string VARCHAR2, p_source_string VARCHAR2,
@ -449,16 +432,12 @@ FUNCTION util_multi_replace (
p_09_find VARCHAR2 DEFAULT NULL, p_09_replace VARCHAR2 DEFAULT NULL, p_09_find VARCHAR2 DEFAULT NULL, p_09_replace VARCHAR2 DEFAULT NULL,
p_10_find VARCHAR2 DEFAULT NULL, p_10_replace VARCHAR2 DEFAULT NULL, p_10_find VARCHAR2 DEFAULT NULL, p_10_replace VARCHAR2 DEFAULT NULL,
p_11_find VARCHAR2 DEFAULT NULL, p_11_replace VARCHAR2 DEFAULT NULL, p_11_find VARCHAR2 DEFAULT NULL, p_11_replace VARCHAR2 DEFAULT NULL,
p_12_find VARCHAR2 DEFAULT NULL, p_12_replace VARCHAR2 DEFAULT NULL p_12_find VARCHAR2 DEFAULT NULL, p_12_replace VARCHAR2 DEFAULT NULL)
) RETURN VARCHAR2; RETURN VARCHAR2;
FUNCTION util_set_build_status_run_only ( FUNCTION util_set_build_status_run_only (p_app_export_sql IN CLOB) RETURN CLOB;
p_app_export_sql IN CLOB
) RETURN CLOB;
FUNCTION util_calc_data_timestamp ( FUNCTION util_calc_data_timestamp (p_as_of_minutes_ago IN NUMBER) RETURN TIMESTAMP;
p_as_of_minutes_ago IN NUMBER
) RETURN TIMESTAMP;
PROCEDURE util_setup_dbms_metadata ( PROCEDURE util_setup_dbms_metadata (
p_pretty IN BOOLEAN DEFAULT true, p_pretty IN BOOLEAN DEFAULT true,
@ -470,68 +449,49 @@ PROCEDURE util_setup_dbms_metadata (
p_segment_attributes IN BOOLEAN DEFAULT false, p_segment_attributes IN BOOLEAN DEFAULT false,
p_sqlterminator IN BOOLEAN DEFAULT true, p_sqlterminator IN BOOLEAN DEFAULT true,
p_constraints_as_alter IN BOOLEAN DEFAULT false, p_constraints_as_alter IN BOOLEAN DEFAULT false,
p_emit_schema IN BOOLEAN DEFAULT false p_emit_schema IN BOOLEAN DEFAULT false);
);
PROCEDURE util_ensure_unique_file_names ( PROCEDURE util_ensure_unique_file_names (p_export_files IN OUT tab_export_files);
p_export_files IN OUT tab_export_files
);
-------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
-- The following tools are working on global private package variables -- The following tools are working on global private package variables
-------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
PROCEDURE util_log_init ( PROCEDURE util_log_init (p_module IN VARCHAR2);
p_module IN VARCHAR2
);
PROCEDURE util_log_start ( PROCEDURE util_log_start (p_action IN VARCHAR2);
p_action IN VARCHAR2
);
PROCEDURE util_log_error ( PROCEDURE util_log_error (p_name VARCHAR2);
p_name VARCHAR2
);
PROCEDURE util_log_stop; PROCEDURE util_log_stop;
FUNCTION util_log_get_runtime ( FUNCTION util_log_get_runtime (
p_start IN TIMESTAMP, p_start IN TIMESTAMP,
p_stop IN TIMESTAMP p_stop IN TIMESTAMP)
) RETURN NUMBER; RETURN NUMBER;
PROCEDURE util_log_calc_runtimes; PROCEDURE util_log_calc_runtimes;
PROCEDURE util_clob_append ( PROCEDURE util_clob_append (p_content IN VARCHAR2);
p_content IN VARCHAR2
);
PROCEDURE util_clob_append ( PROCEDURE util_clob_append (p_content IN CLOB);
p_content IN CLOB
);
PROCEDURE util_clob_flush_cache; PROCEDURE util_clob_flush_cache;
PROCEDURE util_clob_add_to_export_files ( PROCEDURE util_clob_add_to_export_files (
p_export_files IN OUT NOCOPY tab_export_files, p_export_files IN OUT NOCOPY tab_export_files,
p_name IN VARCHAR2 p_name IN VARCHAR2);
);
PROCEDURE util_clob_query_to_csv ( PROCEDURE util_clob_query_to_csv (
p_query IN VARCHAR2, p_query IN VARCHAR2,
p_max_rows IN NUMBER DEFAULT 1000, p_max_rows IN NUMBER DEFAULT 1000,
p_delimiter IN VARCHAR2 DEFAULT ',', p_delimiter IN VARCHAR2 DEFAULT ',',
p_quote_mark IN VARCHAR2 DEFAULT '"', p_quote_mark IN VARCHAR2 DEFAULT '"',
p_header_prefix IN VARCHAR2 DEFAULT NULL p_header_prefix IN VARCHAR2 DEFAULT NULL);
);
PROCEDURE util_clob_create_error_log ( PROCEDURE util_clob_create_error_log (p_export_files IN OUT NOCOPY tab_export_files);
p_export_files IN OUT NOCOPY tab_export_files
);
PROCEDURE util_clob_create_runtime_log ( PROCEDURE util_clob_create_runtime_log (p_export_files IN OUT NOCOPY tab_export_files);
p_export_files IN OUT NOCOPY tab_export_files
);
$end $end

29
README.md
View File

@ -36,7 +36,7 @@ The package itself is independend, but functionality varies on the following con
INSTALLATION INSTALLATION
- Download the [latest version](https://github.com/ogobrecht/plex/releases/latest) - Download the [latest version](https://github.com/ogobrecht/plex/releases/latest)
- Unzip it, open a shell and `cd` into the root directory - Unzip it, open a shell and go into the root directory
- Start SQL*Plus (or another tool which can run SQL scripts) - Start SQL*Plus (or another tool which can run SQL scripts)
- To install PLEX run the provided install script `plex_install.sql` (script provides compiler flags) - To install PLEX run the provided install script `plex_install.sql` (script provides compiler flags)
- To uninstall PLEX run the provided script `plex_uninstall.sql` or drop the package manually - To uninstall PLEX run the provided script `plex_uninstall.sql` or drop the package manually
@ -114,7 +114,6 @@ BEGIN
p_app_id => 100, -- parameter only available when APEX installed p_app_id => 100, -- parameter only available when APEX installed
p_include_object_ddl => true, p_include_object_ddl => true,
p_include_data => false)); p_include_data => false));
-- do something with the zip file -- do something with the zip file
-- Your code here... -- Your code here...
END; END;
@ -173,7 +172,7 @@ SIGNATURE
```sql ```sql
FUNCTION backapp ( FUNCTION backapp (
$if $$apex_installed $then $if $$apex_installed $then
-- App related options: -- App related options:
p_app_id IN NUMBER DEFAULT null, -- If null, we simply skip the APEX app export. p_app_id IN NUMBER DEFAULT null, -- If null, we simply skip the APEX app export.
p_app_date IN BOOLEAN DEFAULT true, -- If true, include export date and time in the result. p_app_date IN BOOLEAN DEFAULT true, -- If true, include export date and time in the result.
@ -188,7 +187,7 @@ $if $$apex_installed $then
p_app_supporting_objects IN VARCHAR2 DEFAULT null, -- If 'Y', export supporting objects. If 'I', automatically install on import. If 'N', do not export supporting objects. If null, the application's include in export deployment value is used. p_app_supporting_objects IN VARCHAR2 DEFAULT null, -- If 'Y', export supporting objects. If 'I', automatically install on import. If 'N', do not export supporting objects. If null, the application's include in export deployment value is used.
p_app_include_single_file IN BOOLEAN DEFAULT false, -- If true, the single sql install file is also included beside the splitted files. p_app_include_single_file IN BOOLEAN DEFAULT false, -- If true, the single sql install file is also included beside the splitted files.
p_app_build_status_run_only IN BOOLEAN DEFAULT false, -- If true, the build status of the app will be overwritten to RUN_ONLY. p_app_build_status_run_only IN BOOLEAN DEFAULT false, -- If true, the build status of the app will be overwritten to RUN_ONLY.
$end $end
-- Object related options: -- Object related options:
p_include_object_ddl IN BOOLEAN DEFAULT false, -- If true, include DDL of current user/schema and all its objects. p_include_object_ddl IN BOOLEAN DEFAULT false, -- If true, include DDL of current user/schema and all its objects.
p_object_type_like IN VARCHAR2 DEFAULT null, -- A comma separated list of like expressions to filter the objects - example: '%BODY,JAVA%' will be translated to: ... from user_objects where ... and (object_type like '%BODY' escape '\' or object_type like 'JAVA%' escape '\'). p_object_type_like IN VARCHAR2 DEFAULT null, -- A comma separated list of like expressions to filter the objects - example: '%BODY,JAVA%' will be translated to: ... from user_objects where ... and (object_type like '%BODY' escape '\' or object_type like 'JAVA%' escape '\').
@ -207,8 +206,8 @@ $end
p_include_error_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_error_log.md with detailed error messages. p_include_error_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_error_log.md with detailed error messages.
p_base_path_backend IN VARCHAR2 DEFAULT 'app_backend', -- The base path in the project root for the database DDL files. p_base_path_backend IN VARCHAR2 DEFAULT 'app_backend', -- The base path in the project root for the database DDL files.
p_base_path_frontend IN VARCHAR2 DEFAULT 'app_frontend', -- The base path in the project root for the APEX UI install files. p_base_path_frontend IN VARCHAR2 DEFAULT 'app_frontend', -- The base path in the project root for the APEX UI install files.
p_base_path_data IN VARCHAR2 DEFAULT 'app_data' -- The base path in the project root for the data files. p_base_path_data IN VARCHAR2 DEFAULT 'app_data') -- The base path in the project root for the data files.
) RETURN tab_export_files; RETURN tab_export_files;
``` ```
@ -234,8 +233,7 @@ SIGNATURE
PROCEDURE add_query ( PROCEDURE add_query (
p_query IN VARCHAR2, -- The query itself p_query IN VARCHAR2, -- The query itself
p_file_name IN VARCHAR2, -- File name like 'Path/to/your/file-without-extension'. p_file_name IN VARCHAR2, -- File name like 'Path/to/your/file-without-extension'.
p_max_rows IN NUMBER DEFAULT 1000 -- The maximum number of rows to be included in your file. p_max_rows IN NUMBER DEFAULT 1000); -- The maximum number of rows to be included in your file.
);
``` ```
@ -250,7 +248,6 @@ EXAMPLE BASIC USAGE
DECLARE DECLARE
l_file_collection plex.tab_export_files; l_file_collection plex.tab_export_files;
BEGIN BEGIN
--fill the queries array --fill the queries array
plex.add_query( plex.add_query(
p_query => 'select * from user_tables', p_query => 'select * from user_tables',
@ -259,10 +256,8 @@ BEGIN
p_query => 'select * from user_tab_columns', p_query => 'select * from user_tab_columns',
p_file_name => 'user_tab_columns', p_file_name => 'user_tab_columns',
p_max_rows => 10000); p_max_rows => 10000);
-- process the queries -- process the queries
l_file_collection := plex.queries_to_csv; l_file_collection := plex.queries_to_csv;
-- do something with the file collection -- do something with the file collection
FOR i IN 1..l_file_collection.count LOOP FOR i IN 1..l_file_collection.count LOOP
dbms_output.put_line(i || ' | ' dbms_output.put_line(i || ' | '
@ -279,7 +274,6 @@ EXPORT EXPORT ZIP FILE PL/SQL
DECLARE DECLARE
l_zip_file BLOB; l_zip_file BLOB;
BEGIN BEGIN
--fill the queries array --fill the queries array
plex.add_query( plex.add_query(
p_query => 'select * from user_tables', p_query => 'select * from user_tables',
@ -288,10 +282,8 @@ BEGIN
p_query => 'select * from user_tab_columns', p_query => 'select * from user_tab_columns',
p_file_name => 'user_tab_columns', p_file_name => 'user_tab_columns',
p_max_rows => 10000); p_max_rows => 10000);
-- process the queries -- process the queries
l_zip_file := plex.to_zip(plex.queries_to_csv); l_zip_file := plex.to_zip(plex.queries_to_csv);
-- do something with the zip file -- do something with the zip file
-- Your code here... -- Your code here...
END; END;
@ -326,8 +318,8 @@ FUNCTION queries_to_csv (
p_quote_mark IN VARCHAR2 DEFAULT '"', -- Used when the data contains the delimiter character. p_quote_mark IN VARCHAR2 DEFAULT '"', -- Used when the data contains the delimiter character.
p_header_prefix IN VARCHAR2 DEFAULT NULL, -- Prefix the header line with this text. p_header_prefix IN VARCHAR2 DEFAULT NULL, -- Prefix the header line with this text.
p_include_runtime_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_runtime_log.md with runtime statistics. p_include_runtime_log IN BOOLEAN DEFAULT true, -- If true, generate file plex_runtime_log.md with runtime statistics.
p_include_error_log IN BOOLEAN DEFAULT true -- If true, generate file plex_error_log.md with detailed error messages. p_include_error_log IN BOOLEAN DEFAULT true) -- If true, generate file plex_error_log.md with detailed error messages.
) RETURN tab_export_files; RETURN tab_export_files;
``` ```
@ -345,7 +337,6 @@ BEGIN
l_zip := plex.to_zip(plex.backapp( l_zip := plex.to_zip(plex.backapp(
p_app_id => 100, p_app_id => 100,
p_include_object_ddl => true)); p_include_object_ddl => true));
-- do something with the zip file... -- do something with the zip file...
END; END;
``` ```
@ -354,8 +345,8 @@ SIGNATURE
```sql ```sql
FUNCTION to_zip ( FUNCTION to_zip (
p_file_collection IN tab_export_files -- The file collection to zip. p_file_collection IN tab_export_files) -- The file collection to zip.
) RETURN BLOB; RETURN BLOB;
``` ```

42
formatter_styles_sql_developer.xml
View File

@ -1,42 +0,0 @@
<options><adjustCaseOnly>false</adjustCaseOnly>
<alignTabColAliases>true</alignTabColAliases>
<breakOnSubqueries>true</breakOnSubqueries>
<alignEquality>false</alignEquality>
<breakAfterElsif>false</breakAfterElsif>
<singleLineComments>oracle.dbtools.app.Format.InlineComments.CommentsUnchanged</singleLineComments>
<breakAnsiiJoin>false</breakAnsiiJoin>
<maxCharLineSize>128</maxCharLineSize>
<alignAssignments>true</alignAssignments>
<brkCtrIndentedConditionsActions>false</brkCtrIndentedConditionsActions>
<breaksProcArgs>true</breaksProcArgs>
<alignRight>true</alignRight>
<breaksComma>oracle.dbtools.app.Format.Breaks.After</breaksComma>
<breaksAroundLogicalConjunctions>oracle.dbtools.app.Format.Breaks.Before</breaksAroundLogicalConjunctions>
<breakAfterWhen>false</breakAfterWhen>
<brkCtrlIndentedActions>true</brkCtrlIndentedActions>
<alignNamedArgs>true</alignNamedArgs>
<formatProgramURL>default</formatProgramURL>
<formatThreshold>1</formatThreshold>
<spaceAroundOperators>true</spaceAroundOperators>
<useTab>false</useTab>
<idCase>oracle.dbtools.app.Format.Case.lower</idCase>
<extraLinesAfterSignificantStatements>oracle.dbtools.app.Format.BreaksX2.X2</extraLinesAfterSignificantStatements>
<breaksConcat>oracle.dbtools.app.Format.Breaks.None</breaksConcat>
<breakAfterIf>false</breakAfterIf>
<brkCtrlSeparateConditionsActions>false</brkCtrlSeparateConditionsActions>
<breakAfterElse>false</breakAfterElse>
<spaceAroundBrackets>oracle.dbtools.app.Format.Space.Default</spaceAroundBrackets>
<flowControl>oracle.dbtools.app.Format.FlowControl.IndentedActions</flowControl>
<commasPerLine>1</commasPerLine>
<brkCtrlTerse>false</brkCtrlTerse>
<forceLinebreaksBeforeComment>false</forceLinebreaksBeforeComment>
<breakAfterWhile>false</breakAfterWhile>
<alignTypeDecl>true</alignTypeDecl>
<breakParenCondition>false</breakParenCondition>
<identSpaces>2</identSpaces>
<breakAfterCase>false</breakAfterCase>
<breakAfterThen>false</breakAfterThen>
<breaksAfterSelect>false</breaksAfterSelect>
<spaceAfterCommas>true</spaceAfterCommas>
<kwCase>oracle.dbtools.app.Format.Case.UPPER</kwCase>
</options>

26
plex_install.sql
View File

@ -10,30 +10,26 @@ DECLARE
v_utils_public VARCHAR2(5) := 'FALSE'; -- Make utilities public available (for testing or other usages). v_utils_public VARCHAR2(5) := 'FALSE'; -- Make utilities public available (for testing or other usages).
v_debug_on VARCHAR2(5) := 'FALSE'; -- Object DDL: extract only one object per type to find problematic ones and save time in big schemas like APEX_XXX. v_debug_on VARCHAR2(5) := 'FALSE'; -- Object DDL: extract only one object per type to find problematic ones and save time in big schemas like APEX_XXX.
BEGIN BEGIN
FOR i IN ( FOR i IN (SELECT *
SELECT *
FROM all_objects FROM all_objects
WHERE object_type = 'SYNONYM' WHERE object_type = 'SYNONYM'
AND object_name = 'APEX_EXPORT' AND object_name = 'APEX_EXPORT') LOOP
) LOOP v_apex_installed := 'TRUE'; v_apex_installed := 'TRUE';
END LOOP; END LOOP;
FOR i IN (SELECT *
FOR i IN (
SELECT *
FROM all_objects FROM all_objects
WHERE object_type = 'SYNONYM' WHERE object_type = 'SYNONYM'
AND object_name = 'ORDS_EXPORT' AND object_name = 'ORDS_EXPORT') LOOP
) LOOP v_ords_installed := 'TRUE'; v_ords_installed := 'TRUE';
END LOOP; END LOOP;
-- Show unset compiler flags as errors (results for example in errors like "PLW-06003: unknown inquiry directive '$$UTILS_PUBLIC'") -- Show unset compiler flags as errors (results for example in errors like "PLW-06003: unknown inquiry directive '$$UTILS_PUBLIC'")
EXECUTE IMMEDIATE 'ALTER SESSION SET plsql_warnings = ''ENABLE:6003'''; EXECUTE IMMEDIATE 'ALTER SESSION SET plsql_warnings = ''ENABLE:6003''';
-- Finally set compiler flags -- Finally set compiler flags
EXECUTE IMMEDIATE 'ALTER SESSION SET plsql_ccflags = ''' || EXECUTE IMMEDIATE 'ALTER SESSION SET plsql_ccflags = '''
'apex_installed:' || v_apex_installed || ',' || || 'apex_installed:' || v_apex_installed || ','
'ords_installed:' || v_ords_installed || ',' || || 'ords_installed:' || v_ords_installed || ','
'utils_public:' || v_utils_public || ',' || || 'utils_public:' || v_utils_public || ','
'debug_on:' || v_debug_on || ''''; || 'debug_on:' || v_debug_on || '''';
END; END;
/ /
prompt Compile package plex (spec) prompt Compile package plex (spec)

14
plex_uninstall.sql
View File

@ -5,25 +5,23 @@ prompt Uninstalling PL/SQL Export Utilities
prompt ==================================== prompt ====================================
prompt Drop package plex if exists (body) prompt Drop package plex if exists (body)
BEGIN BEGIN
FOR i IN ( FOR i IN (SELECT object_type,
SELECT object_type,
object_name object_name
FROM user_objects FROM user_objects
WHERE object_type = 'PACKAGE BODY' WHERE object_type = 'PACKAGE BODY'
AND object_name = 'PLEX' AND object_name = 'PLEX') LOOP
) LOOP EXECUTE IMMEDIATE 'DROP ' || i.object_type || ' ' || i.object_name; EXECUTE IMMEDIATE 'DROP ' || i.object_type || ' ' || i.object_name;
END LOOP; END LOOP;
END; END;
/ /
prompt Drop package plex if exists (spec) prompt Drop package plex if exists (spec)
BEGIN BEGIN
FOR i IN ( FOR i IN (SELECT object_type,
SELECT object_type,
object_name object_name
FROM user_objects FROM user_objects
WHERE object_type = 'PACKAGE' WHERE object_type = 'PACKAGE'
AND object_name = 'PLEX' AND object_name = 'PLEX') LOOP
) LOOP EXECUTE IMMEDIATE 'DROP ' || i.object_type || ' ' || i.object_name; EXECUTE IMMEDIATE 'DROP ' || i.object_type || ' ' || i.object_name;
END LOOP; END LOOP;
END; END;
/ /