Refer to replication origin roident as "ID" in user facing messages and docs
authorJohn Naylor <[email protected]>
Thu, 18 Aug 2022 01:57:13 +0000 (08:57 +0700)
committerJohn Naylor <[email protected]>
Thu, 18 Aug 2022 01:57:13 +0000 (08:57 +0700)
The table column that stores this is of type oid, but is actually limited
to uint16 and has a different path for creating new values. Some of
the documentation already referred to it as an ID, so let's standardize
on that.

While at it, most format strings already use %u, so for consintency
change the remaining stragglers using %d.

Per suggestions from Tom Lane and Justin Pryzby
Discussion: https://www.postgresql.org/message-id/3437166.1659620465%40sss.pgh.pa.us
Backpatch to v15

doc/src/sgml/replication-origins.sgml
src/backend/replication/logical/origin.c

index 7e02c4605b25f33a843f77290c2b08333e957777..bb0fb624d25ce542c45ce356ffaae3e25f5249c7 100644 (file)
  </para>
 
  <para>
-  Replication origins have just two properties, a name and an OID. The name,
+  Replication origins have just two properties, a name and an ID. The name,
   which is what should be used to refer to the origin across systems, is
   free-form <type>text</type>. It should be used in a way that makes conflicts
   between replication origins created by different replication solutions
   unlikely; e.g., by prefixing the replication solution's name to it.
-  The OID is used only to avoid having to store the long version
+  The ID is used only to avoid having to store the long version
   in situations where space efficiency is important. It should never be shared
   across systems.
  </para>
index c72ad6b93de8770fbbda36cb37d452101b0a55ac..9eb97fac582fc449cba7eab7c46f4e131331b2b6 100644 (file)
@@ -328,7 +328,7 @@ replorigin_create(const char *roname)
    if (tuple == NULL)
        ereport(ERROR,
                (errcode(ERRCODE_PROGRAM_LIMIT_EXCEEDED),
-                errmsg("could not find free replication origin OID")));
+                errmsg("could not find free replication origin ID")));
 
    heap_freetuple(tuple);
    return roident;
@@ -364,7 +364,7 @@ restart:
                if (nowait)
                    ereport(ERROR,
                            (errcode(ERRCODE_OBJECT_IN_USE),
-                            errmsg("could not drop replication origin with OID %d, in use by PID %d",
+                            errmsg("could not drop replication origin with ID %u, in use by PID %d",
                                    state->roident,
                                    state->acquired_by)));
 
@@ -408,7 +408,7 @@ restart:
     */
    tuple = SearchSysCache1(REPLORIGIDENT, ObjectIdGetDatum(roident));
    if (!HeapTupleIsValid(tuple))
-       elog(ERROR, "cache lookup failed for replication origin with oid %u",
+       elog(ERROR, "cache lookup failed for replication origin with ID %u",
             roident);
 
    CatalogTupleDelete(rel, &tuple->t_self);
@@ -485,7 +485,7 @@ replorigin_by_oid(RepOriginId roident, bool missing_ok, char **roname)
        if (!missing_ok)
            ereport(ERROR,
                    (errcode(ERRCODE_UNDEFINED_OBJECT),
-                    errmsg("replication origin with OID %u does not exist",
+                    errmsg("replication origin with ID %u does not exist",
                            roident)));
 
        return false;
@@ -937,7 +937,7 @@ replorigin_advance(RepOriginId node,
        {
            ereport(ERROR,
                    (errcode(ERRCODE_OBJECT_IN_USE),
-                    errmsg("replication origin with OID %d is already active for PID %d",
+                    errmsg("replication origin with ID %u is already active for PID %d",
                            replication_state->roident,
                            replication_state->acquired_by)));
        }
@@ -948,7 +948,7 @@ replorigin_advance(RepOriginId node,
    if (replication_state == NULL && free_state == NULL)
        ereport(ERROR,
                (errcode(ERRCODE_CONFIGURATION_LIMIT_EXCEEDED),
-                errmsg("could not find free replication state slot for replication origin with OID %u",
+                errmsg("could not find free replication state slot for replication origin with ID %u",
                        node),
                 errhint("Increase max_replication_slots and try again.")));
 
@@ -1126,7 +1126,7 @@ replorigin_session_setup(RepOriginId node)
        {
            ereport(ERROR,
                    (errcode(ERRCODE_OBJECT_IN_USE),
-                    errmsg("replication origin with OID %d is already active for PID %d",
+                    errmsg("replication origin with ID %u is already active for PID %d",
                            curstate->roident, curstate->acquired_by)));
        }
 
@@ -1138,7 +1138,7 @@ replorigin_session_setup(RepOriginId node)
    if (session_replication_state == NULL && free_slot == -1)
        ereport(ERROR,
                (errcode(ERRCODE_CONFIGURATION_LIMIT_EXCEEDED),
-                errmsg("could not find free replication state slot for replication origin with OID %u",
+                errmsg("could not find free replication state slot for replication origin with ID %u",
                        node),
                 errhint("Increase max_replication_slots and try again.")));
    else if (session_replication_state == NULL)