1
0
mirror of https://github.com/postgres/postgres.git synced 2025-07-28 23:42:10 +03:00

Sync commentary in transam.h and bki.sgml.

Commit a6417078c missed updating some comments in transam.h about
reservation of high OIDs for development purposes.  Also tamp down
an over-optimistic comment there about how easy it'd be to change
FirstNormalObjectId.

Earlier, commit 09568ec3d failed to update bki.sgml for the split
between genbki.pl-assigned OIDs and those assigned during initdb.

Also fix genbki.pl so that it will complain if it overruns
that split.  It's possible that doing so would have no very bad
consequences, but that's no excuse for not detecting it.
This commit is contained in:
Tom Lane
2019-03-14 00:23:33 -04:00
parent 364298be22
commit 401b87a24f
3 changed files with 33 additions and 16 deletions

View File

@ -422,19 +422,21 @@
</para>
<para>
The OID counter starts at 10000 at the beginning of a bootstrap run.
If a row from a source other than <filename>postgres.bki</filename>
is inserted into a table that requires OIDs, then it will receive an
OID of 10000 or above. For example, objects created while running
the <filename>information_schema.sql</filename> script receive such
OIDs.
If <filename>genbki.pl</filename> needs to assign an OID to a catalog
entry that does not have a manually-assigned OID, it will use a value in
the range 10000&mdash;11999. The server's OID counter is set to 12000
at the start of a bootstrap run. Thus objects created by regular SQL
commands during the later phases of bootstrap, such as objects created
while running the <filename>information_schema.sql</filename> script,
receive OIDs of 12000 or above.
</para>
<para>
OIDs assigned during normal database operation are constrained to be
16384 or higher. This leaves the range 10000&mdash;16383 available
for OIDs assigned automatically during bootstrap. These OIDs are not
considered stable, and may change from one installation to another.
16384 or higher. This ensures that the range 10000&mdash;16383 is free
for OIDs assigned automatically by <filename>genbki.pl</filename> or
during bootstrap. These automatically-assigned OIDs are not considered
stable, and may change from one installation to another.
</para>
</sect2>