begriffs open source - ai-pg/blob - full-docs/txt/catalog-pg-subscription.txt

   1
   2 52.54. pg_subscription #
   3
   4    The catalog pg_subscription contains all existing logical replication
   5    subscriptions. For more information about logical replication see
   6    Chapter 29.
   7
   8    Unlike most system catalogs, pg_subscription is shared across all
   9    databases of a cluster: there is only one copy of pg_subscription per
  10    cluster, not one per database.
  11
  12    Access to the column subconninfo is revoked from normal users, because
  13    it could contain plain-text passwords.
  14
  15    Table 52.54. pg_subscription Columns
  16
  17    Column Type
  18
  19    Description
  20
  21    oid oid
  22
  23    Row identifier
  24
  25    subdbid oid (references pg_database.oid)
  26
  27    OID of the database that the subscription resides in
  28
  29    subskiplsn pg_lsn
  30
  31    Finish LSN of the transaction whose changes are to be skipped, if a
  32    valid LSN; otherwise 0/0.
  33
  34    subname name
  35
  36    Name of the subscription
  37
  38    subowner oid (references pg_authid.oid)
  39
  40    Owner of the subscription
  41
  42    subenabled bool
  43
  44    If true, the subscription is enabled and should be replicating
  45
  46    subbinary bool
  47
  48    If true, the subscription will request that the publisher send data in
  49    binary format
  50
  51    substream char
  52
  53    Controls how to handle the streaming of in-progress transactions: f =
  54    disallow streaming of in-progress transactions, t = spill the changes
  55    of in-progress transactions to disk and apply at once after the
  56    transaction is committed on the publisher and received by the
  57    subscriber, p = apply changes directly using a parallel apply worker if
  58    available (same as t if no worker is available)
  59
  60    subtwophasestate char
  61
  62    State codes for two-phase mode: d = disabled, p = pending enablement, e
  63    = enabled
  64
  65    subdisableonerr bool
  66
  67    If true, the subscription will be disabled if one of its workers
  68    detects an error
  69
  70    subpasswordrequired bool
  71
  72    If true, the subscription will be required to specify a password for
  73    authentication
  74
  75    subrunasowner bool
  76
  77    If true, the subscription will be run with the permissions of the
  78    subscription owner
  79
  80    subfailover bool
  81
  82    If true, the associated replication slots (i.e. the main slot and the
  83    table synchronization slots) in the upstream database are enabled to be
  84    synchronized to the standbys
  85
  86    subconninfo text
  87
  88    Connection string to the upstream database
  89
  90    subslotname name
  91
  92    Name of the replication slot in the upstream database (also used for
  93    the local replication origin name); null represents NONE
  94
  95    subsynccommit text
  96
  97    The synchronous_commit setting for the subscription's workers to use
  98
  99    subpublications text[]
 100
 101    Array of subscribed publication names. These reference publications
 102    defined in the upstream database. For more on publications see
 103    Section 29.1.
 104
 105    suborigin text
 106
 107    The origin value must be either none or any. The default is any. If
 108    none, the subscription will request the publisher to only send changes
 109    that don't have an origin. If any, the publisher sends changes
 110    regardless of their origin.