Oracle GoldenGate 19c Microservices Architecture REST API

ハートビート表の作成

post

/services/{version}/connections/{connection}/tables/heartbeat

データベース接続のハートビート表を作成します。

リクエスト

サポートされるメディア・タイプ

application/json

パス・パラメータ

connection: string

最小長: 1

最大長: 61

パターン: ^[a-zA-Z][a-zA-Z0-9_#$]{1,29}([.][a-zA-Z][a-zA-Z0-9_#$]{1,29})?$

接続名。資格証明ストアの別名ごとに、domain.aliasという名前の接続が存在しています。
version: string

Oracle GoldenGateサービスのAPIバージョン。

指定できる値: [ "v2" ]

ルート・スキーマ: Oracle GoldenGate Heartbeat Table

型: object

タイトル: Oracle GoldenGate Heartbeat Table

ソースの表示

$schema(optional):

指定できる値: [ "ogg:tablesHeartbeat" ]
frequency(optional): integer

最小値: 0

最大値: 7999

デフォルト値: 60

ハートビート表が更新される間隔(秒)。
partitioned(optional): boolean

デフォルト値: false

ハートビート履歴表がパーティション化されているかどうか。
purgeFrequency(optional): integer

最小値: 1

最大値: 199

デフォルト値: 1

ハートビート履歴表がパージされる間隔(日)。
retentionTime(optional): integer

最小値: 1

最大値: 2147483646

デフォルト値: 30

この保持期間(日)よりも古いハートビートはハートビート表から削除されます。
targetOnly(optional): boolean

デフォルト値: false

サプリメンタル・ロギングと、ハートビート・シード表およびハートビート表を更新するスケジューラ・ジョブを有効または無効にするブール値。
trackingExtractRestart(optional): boolean

デフォルト値: true

現在のハートビート表の設定で、Extractの再起動位置が追跡されているかどうか。
upgrade(optional): boolean

デフォルト値: false

ハートビート表をいつアップグレードするかを検出するためのブール値。

{
    "title":"Oracle GoldenGate Heartbeat Table",
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:tablesHeartbeat"
            ]
        },
        "frequency":{
            "description":"Interval, in seconds, at which the heartbeat table is updated.",
            "type":"integer",
            "default":60,
            "minimum":0,
            "maximum":7999
        },
        "retentionTime":{
            "description":"Heartbeats older than this retention time (in days) will be deleted from the heartbeat table.",
            "type":"integer",
            "default":30,
            "minimum":1,
            "maximum":2147483646
        },
        "purgeFrequency":{
            "description":"Interval, in days, at which the heartbeat history table is purged.",
            "type":"integer",
            "minimum":1,
            "default":1,
            "maximum":199
        },
        "partitioned":{
            "description":"Whether the heartbeat history table is partitioned or not.",
            "type":"boolean",
            "default":false
        },
        "targetOnly":{
            "description":"Boolean value to enable or disable supplemental logging and the scheduler job for updating heartbeat seed and heartbeat tables.",
            "type":"boolean",
            "default":false
        },
        "trackingExtractRestart":{
            "description":"Whether current heartbeat table setup is tracking extract restart position or not.",
            "type":"boolean",
            "default":true
        },
        "upgrade":{
            "description":"Boolean value to detect when to upgrade the heartbeat tables. ",
            "type":"boolean",
            "default":false
        }
    },
    "additionalProperties":false
}

リクエストの例(application/json)

{
    "frequency":60
}

先頭に戻る

レスポンス

サポートされるメディア・タイプ

application/json

201レスポンス

ハートビート表リソースが正常に作成されました。

ルート・スキーマ: RESTful API Standard Response

型: object

タイトル: RESTful API Standard Response

すべてのOracle GoldenGate RESTful APIコールの標準レスポンス

ソースの表示

$schema(optional):

指定できる値: [ "api:standardResponse" ]
links: array links

最小アイテム数: 0

最大アイテム数: 16

リクエストのOracle GoldenGateリンク
messages: array messages

最小アイテム数: 0

最大アイテム数: 65535

リクエストの間に発行されるGoldenGateメッセージ
response(optional): object response

リクエストのOracle GoldenGateドキュメント

{
    "title":"RESTful API Standard Response",
    "description":"Standard Response for all Oracle GoldenGate RESTful API calls",
    "required":[
        "messages",
        "links"
    ],
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "api:standardResponse"
            ]
        },
        "response":{
            "description":"Oracle GoldenGate document from the request",
            "type":"object"
        },
        "messages":{
            "description":"Oracle GoldenGate messages issued during the request",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "$schema":{
                        "enum":[
                            "ogg:message"
                        ]
                    },
                    "type":{
                        "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
                        "type":"string",
                        "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                        "minLength":2,
                        "maxLength":4095
                    },
                    "title":{
                        "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
                        "type":"string",
                        "minLength":1,
                        "maxLength":4095
                    },
                    "code":{
                        "description":"The Oracle GoldenGate message code",
                        "type":"string",
                        "pattern":"^OGG[-][0-9]{5}$",
                        "minLength":9,
                        "maxLength":9
                    },
                    "severity":{
                        "description":"The severity of the message",
                        "enum":[
                            "INFO",
                            "WARNING",
                            "ERROR"
                        ]
                    },
                    "issued":{
                        "description":"The date and time that the message was issued",
                        "type":"string",
                        "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])$",
                        "minLength":20,
                        "maxLength":32
                    }
                },
                "required":[
                    "type",
                    "title",
                    "code",
                    "severity",
                    "issued"
                ],
                "additionalProperties":false
            },
            "minItems":0,
            "maxItems":65535
        },
        "links":{
            "description":"Oracle GoldenGate links for the request",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "$schema":{
                        "enum":[
                            "ogg:link"
                        ]
                    },
                    "rel":{
                        "description":"Relationship of href to the requested link",
                        "enum":[
                            "alternate",
                            "canonical",
                            "current",
                            "describedby",
                            "describes",
                            "enclosure",
                            "parent",
                            "related",
                            "self",
                            "first",
                            "last",
                            "next",
                            "previous"
                        ]
                    },
                    "href":{
                        "description":"An absolute URI for the link",
                        "type":"string",
                        "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                        "minLength":2,
                        "maxLength":4095
                    },
                    "mediaType":{
                        "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
                        "type":"string",
                        "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
                        "minLength":6,
                        "maxLength":255
                    },
                    "description":{
                        "description":"A human-readable description that provides information and detail specific to this link.",
                        "type":"string",
                        "minLength":1,
                        "maxLength":4095
                    }
                },
                "required":[
                    "rel",
                    "href"
                ],
                "additionalProperties":false
            },
            "minItems":0,
            "maxItems":16
        }
    },
    "additionalProperties":false
}

ネストされたスキーマ: links

型: array

最小アイテム数: 0

最大アイテム数: 16

リクエストのOracle GoldenGateリンク

ソースの表示

配列: object items

{
    "description":"Oracle GoldenGate links for the request",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "$schema":{
                "enum":[
                    "ogg:link"
                ]
            },
            "rel":{
                "description":"Relationship of href to the requested link",
                "enum":[
                    "alternate",
                    "canonical",
                    "current",
                    "describedby",
                    "describes",
                    "enclosure",
                    "parent",
                    "related",
                    "self",
                    "first",
                    "last",
                    "next",
                    "previous"
                ]
            },
            "href":{
                "description":"An absolute URI for the link",
                "type":"string",
                "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                "minLength":2,
                "maxLength":4095
            },
            "mediaType":{
                "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
                "type":"string",
                "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
                "minLength":6,
                "maxLength":255
            },
            "description":{
                "description":"A human-readable description that provides information and detail specific to this link.",
                "type":"string",
                "minLength":1,
                "maxLength":4095
            }
        },
        "required":[
            "rel",
            "href"
        ],
        "additionalProperties":false
    },
    "minItems":0,
    "maxItems":16
}

ネストされたスキーマ: messages

型: array

最小アイテム数: 0

最大アイテム数: 65535

リクエストの間に発行されるGoldenGateメッセージ

ソースの表示

配列: object items

{
    "description":"Oracle GoldenGate messages issued during the request",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "$schema":{
                "enum":[
                    "ogg:message"
                ]
            },
            "type":{
                "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
                "type":"string",
                "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                "minLength":2,
                "maxLength":4095
            },
            "title":{
                "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
                "type":"string",
                "minLength":1,
                "maxLength":4095
            },
            "code":{
                "description":"The Oracle GoldenGate message code",
                "type":"string",
                "pattern":"^OGG[-][0-9]{5}$",
                "minLength":9,
                "maxLength":9
            },
            "severity":{
                "description":"The severity of the message",
                "enum":[
                    "INFO",
                    "WARNING",
                    "ERROR"
                ]
            },
            "issued":{
                "description":"The date and time that the message was issued",
                "type":"string",
                "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])$",
                "minLength":20,
                "maxLength":32
            }
        },
        "required":[
            "type",
            "title",
            "code",
            "severity",
            "issued"
        ],
        "additionalProperties":false
    },
    "minItems":0,
    "maxItems":65535
}

ネストされたスキーマ: response

型: object

リクエストのOracle GoldenGateドキュメント

ネストされたスキーマ: items

型: object

ソースの表示

$schema(optional):

指定できる値: [ "ogg:link" ]
description(optional): string

最小長: 1

最大長: 4095

このリンク固有の情報と詳細を提供する、人が読むための説明。
href: string

最小長: 2

最大長: 4095

パターン: ^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$

リンクの絶対URI
mediaType(optional): string

最小長: 6

最大長: 255

パターン: ^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$

メディア・タイプ - RFC 4288 (https://tools.ietf.org/html/rfc4288)を参照
rel:

指定できる値: [ "alternate", "canonical", "current", "describedby", "describes", "enclosure", "parent", "related", "self", "first", "last", "next", "previous" ]

hrefとリクエスト対象のリンクlinkの関係

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:link"
            ]
        },
        "rel":{
            "description":"Relationship of href to the requested link",
            "enum":[
                "alternate",
                "canonical",
                "current",
                "describedby",
                "describes",
                "enclosure",
                "parent",
                "related",
                "self",
                "first",
                "last",
                "next",
                "previous"
            ]
        },
        "href":{
            "description":"An absolute URI for the link",
            "type":"string",
            "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
            "minLength":2,
            "maxLength":4095
        },
        "mediaType":{
            "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
            "type":"string",
            "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
            "minLength":6,
            "maxLength":255
        },
        "description":{
            "description":"A human-readable description that provides information and detail specific to this link.",
            "type":"string",
            "minLength":1,
            "maxLength":4095
        }
    },
    "required":[
        "rel",
        "href"
    ],
    "additionalProperties":false
}

ネストされたスキーマ: items

型: object

ソースの表示

$schema(optional):

指定できる値: [ "ogg:message" ]
code: string

最小長: 9

最大長: 9

パターン: ^OGG[-][0-9]{5}$

Oracle GoldenGateメッセージ・コード
issued: string

最小長: 20

最大長: 32

パターン: ^[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])$

メッセージが発行された日時
severity:

指定できる値: [ "INFO", "WARNING", "ERROR" ]

メッセージの重大度
title: string

最小長: 1

最大長: 4095

この情報、警告またはエラーに固有の情報と詳細を提供する、人が読むための説明。
type: string

最小長: 2

最大長: 4095

パターン: ^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$

情報、警告またはエラーのタイプを説明するページの絶対URI [RFC3986]。

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:message"
            ]
        },
        "type":{
            "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
            "type":"string",
            "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
            "minLength":2,
            "maxLength":4095
        },
        "title":{
            "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
            "type":"string",
            "minLength":1,
            "maxLength":4095
        },
        "code":{
            "description":"The Oracle GoldenGate message code",
            "type":"string",
            "pattern":"^OGG[-][0-9]{5}$",
            "minLength":9,
            "maxLength":9
        },
        "severity":{
            "description":"The severity of the message",
            "enum":[
                "INFO",
                "WARNING",
                "ERROR"
            ]
        },
        "issued":{
            "description":"The date and time that the message was issued",
            "type":"string",
            "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])$",
            "minLength":20,
            "maxLength":32
        }
    },
    "required":[
        "type",
        "title",
        "code",
        "severity",
        "issued"
    ],
    "additionalProperties":false
}

レスポンスの例(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"
        }
    ],
    "messages":[
        {
            "$schema":"ogg:message",
            "code":"OGG-14001",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created heartbeat seed table \"\"oggadmin\".\"GG_HEARTBEAT_SEED\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14001"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14089",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully tracking extract restart position with heartbeat table \"\"oggadmin\".\"GG_HEARTBEAT_SEED\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14089"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14032",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully added supplemental logging for heartbeat seed table \"\"oggadmin\".\"GG_HEARTBEAT_SEED\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14032"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14000",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created heartbeat table \"\"oggadmin\".\"GG_HEARTBEAT\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14000"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14089",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully tracking extract restart position with heartbeat table \"\"oggadmin\".\"GG_HEARTBEAT\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14089"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14033",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully added supplemental logging for heartbeat table \"\"oggadmin\".\"GG_HEARTBEAT\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14033"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14016",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created heartbeat history table \"\"oggadmin\".\"GG_HEARTBEAT_HISTORY\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14016"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14089",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully tracking extract restart position with heartbeat table \"\"oggadmin\".\"GG_HEARTBEAT_HISTORY\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14089"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14086",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully disabled partitioning for heartbeat history table \"\"oggadmin\".\"GG_HEARTBEAT_HISTORY\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14086"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14023",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created heartbeat lag view \"\"oggadmin\".\"GG_LAG\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14023"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14024",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created heartbeat lag history view \"\"oggadmin\".\"GG_LAG_HISTORY\"\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14024"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14003",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully populated heartbeat seed table with \"ORCL\".",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14003"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14004",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created procedure \"\"oggadmin\".\"GG_UPDATE_HB_TAB\"\" to update the heartbeat tables.",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14004"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14017",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created procedure \"\"oggadmin\".\"GG_PURGE_HB_TAB\"\" to purge the heartbeat history table.",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14017"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14005",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created scheduler job \"\"oggadmin\".\"GG_UPDATE_HEARTBEATS\"\" to update the heartbeat tables.",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14005"
        },
        {
            "$schema":"ogg:message",
            "code":"OGG-14018",
            "issued":"2019-03-15T14:40:44Z",
            "severity":"INFO",
            "title":"Successfully created scheduler job \"\"oggadmin\".\"GG_PURGE_HEARTBEATS\"\" to purge the heartbeat history table.",
            "type":"http://docs.oracle.com/goldengate/c1910/gg-winux/GMESG/oggus.htm#OGG-14018"
        }
    ]
}

先頭に戻る