Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

EPAS v16 release branch #4424

Merged
merged 116 commits into from
Nov 9, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
116 commits
Select commit Hold shift + click to select a range
fa2670a
Begin fork of EPAS 16 docs
josh-heyer Jul 25, 2023
6f01302
Updated TO_TIMESTAMP_TZ function as per DB-2314
nidhibhammar Jul 31, 2023
c0f586b
first draft of FETCH BULK COLLECT INTO added as per DB-2313
nidhibhammar Aug 1, 2023
1c0a999
Update product_docs/docs/epas/16/application_programming/epas_compat_…
nidhibhammar Aug 2, 2023
92ca293
minor edits done to FETCH BULK COLLECT INTO topic
nidhibhammar Aug 2, 2023
7e9fca1
Added an old example of Fetch Bulk Collect back as per feedback from …
nidhibhammar Aug 10, 2023
7f6e8b0
added Packages to list of Synonyms as per DB-2307
ccestes Aug 11, 2023
c49ed76
Initial draft of Multiset Intersect and Multiset Except as per DB-2315
nidhibhammar Aug 21, 2023
1a6cc63
added new UTL_FILE subprograms
ccestes Aug 16, 2023
28d6061
Update product_docs/docs/epas/16/reference/oracle_compatibility_refer…
nidhibhammar Aug 28, 2023
fa3b2c2
Edits done as per Betsy's comments
nidhibhammar Aug 28, 2023
4074b39
Added NANVL function as per DB-2317
nidhibhammar Aug 28, 2023
39de743
Added DBTIMEZONE and SESSIONTIMEZONE functions as per DB-2318 and DB-…
nidhibhammar Aug 29, 2023
99126db
edited typo
nidhibhammar Aug 29, 2023
cf7985a
Added DUMP function as per DB-2316
nidhibhammar Aug 30, 2023
ef3e10f
Added DBMS_PRIVILEGE_CAPTURE package as per DB-2427
nidhibhammar Aug 31, 2023
dbd330e
Added LLNVL function as per DB-2361
nidhibhammar Sep 1, 2023
107cf62
Added TDE content as per DB-2451
nidhibhammar Sep 1, 2023
4057b25
Added 3 NLS_CHAR.. functions as per DB-2435
nidhibhammar Sep 1, 2023
d1199ab
Edited DBMS_JOB and DBMS_SCHEDULER content as per DB-2403
nidhibhammar Sep 1, 2023
d28a4de
Fixed the typo
nidhibhammar Sep 4, 2023
f1ede69
Added content for OCI ORDER BY pushdown as per DB-2364
nidhibhammar Sep 5, 2023
7738873
Changes done as per feedback from Triveni
nidhibhammar Sep 5, 2023
ce299bc
Added initial draft of Capture Privilege Policy as per DB-2336
nidhibhammar Sep 6, 2023
1250f66
Update 18_dbms_utility.mdx
ccestes Sep 7, 2023
d440ac4
Fixed the typo as per comment from Neha for DB-2361
nidhibhammar Sep 11, 2023
92c4322
Early draft of VARIABLE_VALUE
dwicinas Aug 23, 2023
58eaf93
a few early edits for DEFINE_ARRAY
dwicinas Aug 23, 2023
d8d4892
added draft for BIND_ARRAY, deleted VARIABLE_VALUE, more work on DEFI…
dwicinas Aug 25, 2023
435717b
More interim checkins for DEFINE_ARRAY and BIND_ARRAY
dwicinas Aug 28, 2023
2cce989
More interim edits
dwicinas Aug 29, 2023
0b3a8d4
Removed RETURN_RESULT (not implemented) and updated two more based on…
dwicinas Aug 30, 2023
36f4a8e
Updated ins and outs
dwicinas Aug 30, 2023
280f733
Added example for DEFINE_COLUMN_ROWID and new topic for DESCRIBE_COLU…
dwicinas Aug 30, 2023
a0ba8ea
Added topics for DESCRIBE_COLUMNS3, TO_REFCURSOR, AND TO_CURSOR_NUMBER
dwicinas Aug 30, 2023
5b29e40
renamed column_value_rowid and define_column_rowid
dwicinas Aug 30, 2023
68fa717
Added topics for column_value_long and define_column_long and a coupl…
dwicinas Aug 30, 2023
c73af09
Added examples from developers and assorted cleanup throughout
dwicinas Aug 31, 2023
1537de9
added examples for three topics and some other minor fixes
dwicinas Sep 5, 2023
c9ac144
Renamed topic for sake of numeric ordering
dwicinas Sep 5, 2023
fb7cafa
EPAS: v16 rel notes
drothery-edb Sep 6, 2023
4a76c1a
first commit of epa16 release notes
ebgitelman Sep 6, 2023
b3031e0
cleanup to table
ebgitelman Sep 6, 2023
d5570c5
Fixed table issues
ebgitelman Sep 6, 2023
91cd488
Updated release notes with latest dev changes
ebgitelman Sep 7, 2023
0d73929
Update epas16_beta_rel_notes.mdx
ebgitelman Sep 7, 2023
fdb1918
Latest changes to epas beta release notes
ebgitelman Sep 8, 2023
df95c32
additional Job Scheduler content for dbms_job and dbms_scheduler
ccestes Sep 11, 2023
8effa16
Added content for Privilege analysis feature as per DB-2336
nidhibhammar Sep 12, 2023
12f6f3b
Restore lost heading
josh-heyer Sep 12, 2023
c084d78
Edited release notes
nidhibhammar Sep 12, 2023
c3ee0d8
fixed subheadings for PUT_NCHAR
ccestes Sep 12, 2023
f331dfb
Added components and incorporated Fran's suggestions on DB-2314
nidhibhammar Sep 13, 2023
b1cab76
Edited Multiset operators topic as per suggestions from Fran on DB-2315
nidhibhammar Sep 13, 2023
28b5479
Cleaned up the release notes
nidhibhammar Sep 14, 2023
d385d42
feedback on DB-2403
ccestes Sep 19, 2023
f257b1b
Added more content for DBMS_PRIVILEGE_CAPTURE package
nidhibhammar Sep 19, 2023
f4767ae
Update 20_utl_file.mdx
ebgitelman Sep 19, 2023
b280915
Update 20_utl_file.mdx
ebgitelman Sep 19, 2023
7f1e7c4
Update 20_utl_file.mdx
ebgitelman Sep 19, 2023
656b335
Update 20_utl_file.mdx
ebgitelman Sep 19, 2023
adb52c5
Added more content to DBMS_PRIVILEGE_CAPTURE topic as per DB-2427
nidhibhammar Sep 21, 2023
1ece7d2
Reviews of DB-2317, 2361, and DB-2316
ebgitelman Sep 21, 2023
ea5d0bc
Edits for DB-2318, DB-2319, and DB-2403
ebgitelman Sep 21, 2023
e697c47
Edits for DB-2435 and DB-2451
ebgitelman Sep 21, 2023
d6f196c
Shuffled the DBMS_JOB content
nidhibhammar Sep 25, 2023
0fe45c9
Deleted EPAS15_4_1_rel_notes file carried forward due to rebase
nidhibhammar Sep 27, 2023
48d57bc
Begin fork of EPAS 16 docs
josh-heyer Jul 25, 2023
2cdec4f
EPAS: v16 rel notes
drothery-edb Sep 6, 2023
7879215
Added new subprograms to table, and one minor fix to TO_CURSOR_NUMBER
dwicinas Sep 18, 2023
3aca17a
Implemented comments from Triveni and Mahendra
dwicinas Sep 19, 2023
5a49f97
fixes to define_array suggested by Mahendra, and one little typo in b…
dwicinas Sep 19, 2023
90b8345
several fixes suggested by Himanshu
dwicinas Sep 20, 2023
7b5175d
Begin fork of EPAS 16 docs
josh-heyer Jul 25, 2023
97667d1
EPAS: v16 rel notes
drothery-edb Sep 6, 2023
3370e23
Begin fork of EPAS 16 docs
josh-heyer Jul 25, 2023
aff4308
Edits for Working with Oracle Data section
francoughlin Aug 10, 2023
517a25a
Fixes for duplicate redirects
francoughlin Aug 15, 2023
432e55f
Additional redirect fixes
francoughlin Aug 15, 2023
d52007a
Redirect fix
francoughlin Aug 15, 2023
6227bde
Added 07_reference folder from v15 to v16
nidhibhammar Aug 22, 2023
9c850e3
EDB SPL Check content
ccestes Sep 7, 2023
8b734bc
edits to EDB SPL Check content
ebgitelman Sep 19, 2023
c3cf3d2
Update index.mdx
ebgitelman Sep 19, 2023
93e8144
Update configuring.mdx
ebgitelman Sep 19, 2023
85400bd
Update index.mdx
ebgitelman Sep 19, 2023
1df6e4d
Update index.mdx
ebgitelman Sep 19, 2023
c0d56aa
Update pragma.mdx
ebgitelman Sep 19, 2023
5e5a762
Update profiler.mdx
ebgitelman Sep 19, 2023
740e995
Update tracer.mdx
ebgitelman Sep 19, 2023
9558a85
triveni feedback
ccestes Sep 21, 2023
d4e7447
Betsy feedback
ccestes Sep 21, 2023
2644b96
Capitalised the keywords in the code block and formatted the output
nidhibhammar Sep 22, 2023
77c7c7b
code block fixes
ccestes Sep 22, 2023
101258a
fixed sentence on pragma page
ccestes Sep 25, 2023
2adbbec
updated pragma intro
ccestes Sep 26, 2023
3c8b005
Formatted the code blocks
nidhibhammar Sep 26, 2023
3adb79d
Update epas16_beta_rel_notes.mdx
theadamwright Sep 29, 2023
af82e16
added EDB Job Scheduler as an extension
nidhibhammar Oct 3, 2023
49f7290
Implementing comments from Neha Sharma
dwicinas Oct 3, 2023
84e980c
Implements more comments from Neha Sharma
dwicinas Oct 3, 2023
5b94718
Patch index.js
djw-m Oct 4, 2023
7ce85f0
Formatted outputs and incorporated Dj's comments
nidhibhammar Oct 4, 2023
1a07659
Changing 15 to 16
ebgitelman Oct 6, 2023
56a1c18
Edited EDB Job Scheduler
ebgitelman Oct 6, 2023
95715d8
added version 16 to config.yaml
dwicinas Oct 10, 2023
b32ed1f
Generated install files for EPAS version 16
dwicinas Oct 10, 2023
867cbe7
Cleaned up release notes
nidhibhammar Oct 11, 2023
2701de7
Added "Installed by default" column to available package list and rep…
nidhibhammar Oct 11, 2023
803b408
fixed broken links
nidhibhammar Oct 11, 2023
33f5030
Added categories to pg extensions navigation
nidhibhammar Oct 17, 2023
309fc6d
removed deprecated packages as per suggestion from Tushar
nidhibhammar Oct 26, 2023
8cf3402
fixed typo
nidhibhammar Nov 8, 2023
b2eaab9
Removed beta from release notes
nidhibhammar Nov 9, 2023
9fe92c8
fixed index file
nidhibhammar Nov 9, 2023
49f9a36
restore epas 15 docs
nidhibhammar Nov 9, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
38 changes: 38 additions & 0 deletions advocacy_docs/pg_extensions/edb_job_scheduler/configuring.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "Configuring EDB Job Scheduler"
---

The EDB Job Scheduler has a scheduler process that starts when the database cluster starts. To start the scheduler process, load the EDB Job Scheduler extension using the `shared_preload_libraries` parameter.

After you load the extension, create the extension using the `CREATE EXTENSION` command. The database in which you're creating the extension must be listed in the `edb_job_scheduler.database_list` parameter.

The `CREATE EXTENSION` command also creates two tables in the `sys` schema: `jobs` and `job_run_details`.

In addition, the EDB Job Scheduler provides two more GUCs:

- `edb_job_scheduler.max_jobs_per_database` — Controls the maximum number of jobs per database level.
- `edb_job_scheduler.max_workers_per_database` — Controls the maximum number of worker processes per database level.

To apply your changes, reload the configuration using `pg_reload_conf()` or `pg_ctl reload`.

## Example

This example configures the EDB Job Scheduler extension.

1. Set the GUC parameter and the shared libraries parameter in `postgresql.conf`:

```ini
edb_job_scheduler.database_list = 'edb'
shared_preload_libraries='$libdir/edb_job_scheduler'
```

2. Restart the database server.

3. Create the extension:

```sql
# Using psql, connect to edb database as superuser
psql -d edb -U enterprisedb
# Create the extension
CREATE EXTENSION edb_job_scheduler;
```
50 changes: 50 additions & 0 deletions advocacy_docs/pg_extensions/edb_job_scheduler/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: 'EDB Job Scheduler'
directoryDefaults:
product: EDB Job Scheduler
---

EDB Job Scheduler is an extension that runs the job scheduler as a background process for the `DBMS_SCHEDULER` and `DBMS_JOB` packages.

By default, the `edb_job_scheduler` extension resides in the `contrib/dbms_scheduler_ext` subdirectory under the EDB Postgres Advanced Server installation.

The extension has a main background process called the *launcher*. The launcher process starts when the database cluster loads. It forks the scheduler processes, creating one for each configured database. The databases are configured by the GUC `edb_job_scheduler.database_list`.

If a database doesn't have any jobs to schedule or is done with all the schedules, after waiting for a minute, the scheduler process shuts down. Whenever a new job is added or there is any update to the existing jobs in `sys.jobs`, the launcher process starts again.

EDB Job Schedule schedules the job only once based on the job runtime. If the same job needs to be rerun, then you need to feed the next job runtime.

All the recurring job scheduling is done through the `DBMS_SCHEDULER` and `DBMS_JOB` packages. For a recurring job, the next job runtime is added by these packages and not by `edb_job_scheduler`.

`edb_job_scheduler` holds its meta data in two tables under the `sys` schema:

- `jobs` — Holds information about the jobs to run.
- `job_run_details` — Holds information about the job status. The status can be `'r' - running`, `'s' - success`, or `'f' - failure` for the respective `jobid`.


The following are the columns in the `sys.job` table:

```
Column | Type
------------+--------------------------
jobid | bigint
jobnextrun | timestamp with time zone
jobcommand | text
jobuser | text
```

The following are the columns in the `sys.job_run_details` table:

```
Column | Type
--------------+--------------------------
jobid | bigint
runid | bigint
username | text
workerpid | integer
status | character(1)
error | text
scheduletime | timestamp with time zone
starttime | timestamp with time zone
endtime | timestamp with time zone
```
12 changes: 12 additions & 0 deletions advocacy_docs/pg_extensions/edb_job_scheduler/user_api.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: "User API"
---

The EDB Job Scheduler extension offers these API functions:

- `sys.reload_all_jobs` — Reloads all the unscheduled jobs from the current database.

!!! Note
This function requests only the scheduler process. So, if the local storage of the scheduler limit meets the maximum set by `edb_job_scheduler.max_jobs_per_database`, loading fails.

- `sys.dump_schedule()` — Displays the current job schedule from the scheduler's local memory. The scheduler's local memory dumps all the jobs that weren't executed yet into the server log in JSON format.
4 changes: 4 additions & 0 deletions advocacy_docs/pg_extensions/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,16 @@ title: "Postgres extensions available by deployment"
navTitle: "Postgres extensions"
hideToC: true
navigation:
- "#All Postgres"
- advanced_storage_pack
- ldap_sync
- pg_tuner
- query_advisor
- wait_states
- pg_failover_slots
- "#EDB Postgres Advanced Server only"
- spl_check
- edb_job_scheduler
---

Categories of extensions:
Expand Down
4 changes: 4 additions & 0 deletions advocacy_docs/pg_extensions/index.mdx.in
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,16 @@ title: "Postgres extensions available by deployment"
navTitle: "Postgres extensions"
hideToC: true
navigation:
- "#All Postgres"
- advanced_storage_pack
- ldap_sync
- pg_tuner
- query_advisor
- wait_states
- pg_failover_slots
- "#EDB Postgres Advanced Server only"
- spl_check
- edb_job_scheduler
---

Categories of extensions:
Expand Down
Loading
Loading