Retrieve Active Transaction Details
get
/services/{version}/connections/{connection}/activeTransactions
Required Role: User
Retrieve details of the active transactions 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
Active transaction details retrieved.
Root Schema : Oracle GoldenGate Database Active Transaction Details
Type:
object
Title:
Show Source
Oracle GoldenGate Database Active Transaction Details
-
$schema:
Allowed Values:
[ "ogg:activeTransactions" ]
-
activeTransactions:
array activeTransactions
Minimum Number of Items:
0
Maximum Number of Items:32767
List of all active transactions -
currentScn(required):
object currentScn
Current database SCN details
Nested Schema : activeTransactions
Type:
array
Minimum Number of Items:
0
Maximum Number of Items:
32767
List of all active transactions
Show Source
Nested Schema : currentScn
Type:
object
Current database SCN details
Show Source
-
csn:
csn
Transaction start SCN
-
currentDate:
string
Minimum Length:
20
Maximum Length:32
Pattern:^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$
Start time of the transaction -
userName:
string
Minimum Length:
1
Maximum Length:4096
Database username
Nested Schema : items
Type:
Show Source
object
-
instanceId(required):
integer
Minimum Value:
0
Maximum Value:4294967295
Instance identifier -
logonTime(required):
string
Minimum Length:
20
Maximum Length:32
Pattern:^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$
Time of logon to the session -
osUser(required):
string
Minimum Length:
1
Maximum Length:30
Operating System client username -
serialNum(required):
integer
Minimum Value:
0
Maximum Value:4294967295
Session Serial Number -
sessionStatus(required):
Allowed Values:
[ "ACTIVE", "IDLE", "INACTIVE", "KILLED", "CACHED", "SNIPED" ]
Status of transaction or a session -
sid(required):
integer
Minimum Value:
0
Maximum Value:4294967295
Session identifier -
txnStartDate(required):
string
Minimum Length:
20
Maximum Length:32
Pattern:^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$
Start time of the transaction -
txnStartScn(required):
txnStartScn
Transaction start SCN
-
txnStatus(required):
Allowed Values:
[ "ACTIVE", "IDLE", "INACTIVE", "KILLED", "CACHED", "SNIPED" ]
Status of transaction or a session -
userName(required):
string
Minimum Length:
1
Maximum Length:4096
Oracle username
Example Response (application/json)
{
"$schema":"api:standardResponse",
"links":[
{
"href":"http://localhost:11001/services/v2/connections/LocalDBMS/activeTransactions",
"mediaType":"application/json",
"rel":"canonical"
},
{
"href":"http://localhost:11001/services/v2/connections/LocalDBMS/activeTransactions",
"mediaType":"application/json",
"rel":"self"
},
{
"href":"http://localhost:11001/services/v2/metadata-catalog/activeTransactions",
"mediaType":"application/schema+json",
"rel":"describedby"
}
],
"messages":[
],
"response":{
"$schema":"ogg:activeTransactions",
"activeTransactions":[
],
"currentScn":{
"csn":"1542864",
"currentDate":"2021-07-13T16:39:43.000Z",
"userName":"SYS"
}
}
}