Skip to content

Commit c59d6f9

Browse files
committed
Improve documentation.
1 parent cc42422 commit c59d6f9

File tree

1 file changed

+21
-3
lines changed

1 file changed

+21
-3
lines changed

doc/sql.extensions/README.schemas.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -373,6 +373,14 @@ Select Expression
373373
`isc_dpb_search_path` is a string DPB parameter, similar to `isc_dpb_user_name`, used to set the initial schema search
374374
path for a session.
375375

376+
## New TPB items
377+
378+
### `isc_tpb_lock_table_schema`
379+
380+
`isc_tpb_lock_table_schema` could be used with `isc_tpb_lock_read` and `isc_tpb_lock_write`, after the table name and
381+
before `isc_tpb_shared`, `isc_tpb_protected` or `isc_tpb_exclusive`. The format of `isc_tpb_lock_table_schema` is
382+
a single byte length followed by the schema name.
383+
376384
## Array support
377385

378386
### `isc_sdl_schema`
@@ -570,10 +578,14 @@ The `RDB$ERROR(EXCEPTION)` expression now returns the fully qualified and quoted
570578

571579
### Object name parsing outside SQL
572580

573-
When working with object names in `isc_dpb_search_path`, `isc_sdl_schema`, and `MAKE_DBKEY`, the names follow the same
574-
rules as in SQL. This means that names containing special characters or lowercase letters must be enclosed in quotes.
581+
When working with object names in `isc_dpb_search_path`, `isc_dpb_lc_ctype`, `isc_dpb_set_db_charset` and `MAKE_DBKEY`,
582+
the names follow the same rules as in SQL.
583+
This means that names containing special characters or lowercase letters must be enclosed in quotes.
575584

576-
For `MAKE_DBKEY`, unqualified names are resolved using the current search path. In earlier versions, `MAKE_DBKEY`
585+
With `isc_dpb_lc_ctype` and `isc_dpb_set_db_charset`, names not qualified with a schema are resolved using the `SYSTEM`
586+
schema.
587+
588+
With `MAKE_DBKEY`, unqualified names are resolved using the current search path. In earlier versions, `MAKE_DBKEY`
577589
required an exact table name as its first parameter and did not support the use of double quotes for special
578590
characters.
579591

@@ -631,3 +643,9 @@ It should also be possible to downgrade databases with multiple user schemas, as
631643
the same name do not exist in multiple schemas.
632644

633645
This documentation will be updated once these changes are implemented.
646+
647+
## Limitations
648+
649+
DPB and TPB parameters cannot be greater than 255 bytes. That imposes a limit for usage of multiple schemas in
650+
`isc_dpb_search_path` or fully qualified names with multi-byte characters in `isc_dpb_lc_ctype` and
651+
`isc_dpb_set_db_charset`.

0 commit comments

Comments
 (0)