Retrieve Heartbeat Table
get
/services/{version}/connections/{connection}/tables/heartbeat
Required Role: User
Retrieve details of the heartbeat table for a database connection.
Request
Path Parameters
-
connection(required): string
Minimum Length:
1
Maximum Length:61
Pattern:^[a-zA-Z][a-zA-Z0-9_#$]{1,29}([.][a-zA-Z][a-zA-Z0-9_#$]{1,29})?$
Connection name. For each alias in the credential store, a connection with the name 'domain.alias' exists.
-
version(required): string
Oracle GoldenGate Service API version.
Allowed Values:[ "v2" ]
Response
Supported Media Types
- application/json
200 Response
Heartbeat table details retrieved.
Root Schema : Oracle GoldenGate Heartbeat Table
Type:
object
Title:
Show Source
Oracle GoldenGate Heartbeat Table
-
$schema:
Allowed Values:
[ "ogg:tablesHeartbeat" ]
-
dbUniqueName:
boolean
Default Value:
false
Whether current heartbeat table setup has db_unique_name column or not. -
frequency:
integer
Minimum Value:
0
Maximum Value:7999
Default Value:60
Interval, in seconds, at which the heartbeat table is updated. -
partitioned:
boolean
Default Value:
false
Whether the heartbeat history table is partitioned or not. -
purgeFrequency:
integer
Minimum Value:
1
Maximum Value:199
Default Value:1
Interval, in days, at which the heartbeat history table is purged. -
retentionTime:
integer
Minimum Value:
1
Maximum Value:2147483646
Default Value:30
Heartbeats older than this retention time (in days) will be deleted from the heartbeat table. -
targetOnly:
boolean
Default Value:
false
Boolean value to enable or disable supplemental logging and the scheduler job for updating heartbeat seed and heartbeat tables. -
trackingExtractRestart:
boolean
Default Value:
true
Whether current heartbeat table setup is tracking extract restart position or not. -
upgrade:
boolean
Default Value:
false
Boolean value to detect when to upgrade the heartbeat tables.
Example Response (application/json)
{
"$schema":"api:standardResponse",
"links":[
{
"href":"http://localhost:11001/services/v2/connections/OracleGoldenGate.oggadmin/tables/heartbeat",
"mediaType":"application/json",
"rel":"canonical"
},
{
"href":"http://localhost:11001/services/v2/connections/OracleGoldenGate.oggadmin/tables/heartbeat",
"mediaType":"application/json",
"rel":"self"
},
{
"href":"http://localhost:11001/services/v2/metadata-catalog/heartbeat",
"mediaType":"application/schema+json",
"rel":"describedby"
}
],
"messages":[
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat exists.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat_seed exists.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat_history exists.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat supplemental logging ENABLED.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat_seed supplemental logging ENABLED.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"HEARTBEAT table oggadmin.gg_heartbeat_history partitioning DISABLED.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"Frequency interval: 60 seconds.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"Purge frequency interval: 2 days.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
},
{
"$schema":"ogg:message",
"code":"OGG-08100",
"issued":"2021-07-13T16:37:00Z",
"severity":"INFO",
"title":"Retention time: 30 days.",
"type":"http://docs.oracle.com/goldengate/c2130/gg-winux/GMESG/oggus.htm#OGG-08100"
}
],
"response":{
"$schema":"ogg:tablesHeartbeat",
"dbUniqueName":false,
"frequency":"60",
"partitioned":false,
"purgeFrequency":"2",
"retentionTime":"30",
"targetOnly":false,
"trackingExtractRestart":true
}
}