Repository navigation
Conversation
…nctions
7.8 Built-in data types lists only 14 types although src/include/catalog/pg_type.dat
defines sys.blob (domain over bytea), sys.clob and sys.nclob (domains over text) and
sys.long_raw (domain over bytea). The built-in function list is missing six functions
declared in contrib/ivorysql_ora/src/builtin_functions/builtin_functions--1.0.sql:
bitand (both overloads), lpad, rpad, regexp_count, to_clob and to_blob. The same list
also contains rawtohex, which does not exist on this branch (grep over the 5.6 tree
finds nothing and select rawtohex('abc'::bytea) fails; the function is master-only),
so that row is dropped.
Add the four types to the type table, the six functions to the function table, and a
short section per function (syntax / parameters / return value / example) in both the
CN and EN trees. Every example output was captured from an IvorySQL 5.6 instance built
from tag IvorySQL_5.6 (initdb -m oracle), including to_clob and to_blob.
Closes #<ISSUE_NUMBER>
Signed-off-by: 王诗焱 <3372848903@qq.com>
|
🚀 IvorySQL-Docs Preview Ready
|
Author
|
CLA: the Individual Contributor License Agreement for 王诗焱 (GitHub: qwer381) was signed and emailed to cla@ivorysql.org on 2026-11-10 (delivery confirmed by the mail provider). If the community needs it re-sent to another address, or needs a scanned wet signature instead of the typed one, say the word and I will send it again. |
qwer381
force-pushed
the
docs/fix-v5.6-7.8-builtin-types-functions
branch
2 times, most recently
from
November 13, 2026 05:54
785cf70 to
d43afc6
Compare
|
🚀 IvorySQL-Docs Preview Ready
|
|
🚀 IvorySQL-Docs Preview Ready
|
This branch was previously deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Complete the 7.8 reference for v5.6: four missing Oracle types, six missing built-in functions, and a
rawtohexrow that 5.6 never hadCloses #374
What
7.8 Built-in data types / Built-in functions, bothCNandEN:blob,clob,nclob,long_raw(sys-schema domain types overbytea/text, defined insrc/include/catalog/pg_type.dat).bitand,lpad,rpad,regexp_count,to_clob,to_blob, each with a===section (function, syntax, parameters, return value, example), taking the page from 47 to 53 sections.rawtohexrow (line 50 in both languages): 5.6 has no such function (grep -ril rawtohexover the 5.6 tree → 0 hits;select rawtohex('abc'::bytea)→ERROR: function rawtohex(bytea) does not exist). It only exists onmaster, so thev5.6page should not list it as a current function.Diffstat:
Why
The page is the reference for what a 5.6 user may write, and right now it is wrong in both directions: four implemented types and six implemented functions are undiscoverable (Oracle users look for exactly these), while one listed function does not exist.
Type definitions were cross-checked against
src/include/catalog/pg_type.dat, function definitions againstcontrib/ivorysql_ora/src/builtin_functions/builtin_functions--1.0.sql(line numbers are in the issue), and every output block below was captured from a 5.6 instance.Testing
1. Applies to
v5.6The single commit sits on top of
v5.6@7c3f4a6; the diff againstv5.6is2. Builds with the repo's generator (Antora 3, same as
.github/workflows/pr-preview.yml;start_path: CN/EN):npx antora antora-playbook.yml # exit 0<tr><h3>7.8.html7.8.html+9rows = 4 types + 6 functions − 1 removedrawtohex;+6headings = the six new sections. No warning is attributed to7.8.adocin either build (the warnings present come from4.6.2.adoc/6.3.2.adoc/7.15.adoc, before and after this change).3. Every documented example was executed on a 5.6 instance built from tag
IvorySQL_5.6(initdb -m oracle;select version()→PostgreSQL 18.6 (IvorySQL 5.6) ... gcc 13.3.0):The
to_clob/to_blobexamples were the open question in the issue — both work on 5.6, so the sections now carry real output instead of a bare signature.Checklist
v5.6)Closes #374in the first lineSigned-off-bypresent in the commit