Extractの取得

get

/services/{version}/extracts/{extract}

必要なロール: ユーザー

Extractプロセスの詳細を取得します。

リクエスト

パス・パラメータ
  • 最小長: 1
    最大長: 8
    パターン: ^[A-Z_$][A-Z0-9_$]*$

    Extractの名前。Extract名は大文字で、先頭が英字、その後に英数字が最大で7文字続きます。

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

    指定できる値: [ "v2" ]
先頭に戻る

レスポンス

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

200レスポンス

Extractの詳細が正常に取得されました。

本文()
ルート・スキーマ: Oracle GoldenGate Extract
型: object
タイトル: Oracle GoldenGate Extract
ソースの表示
  • 指定できる値: [ "ogg:extract" ]
  • alias
  • begin
    データ処理の開始位置
  • config
    最小アイテム数: 0
    最大アイテム数: 32767
  • credentials
    ソース・データベースの資格証明
  • デフォルト値: false
    Extractがデプロイメントにとってクリティカルであることを示します
  • 最小長: 1
    最大長: 4095
    プロセスの説明
  • encryptionProfile
  • デフォルト値: Unidirectional
    指定できる値: [ "High Availability", "Disaster Recovery", "Unidirectional", "N-Way", "Sharding" ]
    データ取得ワークフローの目的
  • managedProcessSettings
    Administration ServerでERプロセスが管理される方法を制御します
  • miningCredentials
    ダウンストリーム・マイニング・データベースの資格証明
  • デフォルト値: false
    ターゲット上で別名によって制御されるパッシブExtract
  • registration
    ソース・データベースへの登録
  • 最小長: 18
    最大長: 25
    パターン: ^[A-Za-z_][A-Za-z0-9_]{0,7}_[0-9a-fA-F]{16}$
    PostgreSQLのMIGRATEコマンドに使用する必要があるレプリケーション・スロット
  • 指定できる値: [ true ]
    Extractの再起動時に、次の順序のトレイル・ファイルに切り替えさせます。
  • source
    処理するデータのソース
  • デフォルト値: stopped
    指定できる値: [ "starting", "running", "stopped", "killed", "abended" ]
    Oracle GoldenGateプロセスのステータス
  • targets
    最小アイテム数: 0
    最大アイテム数: 1024
    取得されるデータのターゲット
  • 指定できる値: [ "Alias", "Classic", "Change Data Capture", "Initial Load", "Integrated", "Passive", "Remote Task", "Source Extract" ]
    OGG Extractプロセス・タイプ(読取り専用)
ネストされたスキーマ: alias
型: object
ソースの表示
ネストされたスキーマ: begin
データ処理の開始位置
デフォルト値: now
1つに一致
ソースの表示
  • 指定できる値: [ "now" ]
  • 最小長: 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])$
  • begin-x-oneOf[2]
ネストされたスキーマ: config
型: array
最小アイテム数: 0
最大アイテム数: 32767
ソースの表示
ネストされたスキーマ: credentials
ソース・データベースの資格証明
デフォルト値: oracle.doceng.json.BetterJsonNull@4346808
1つに一致
ソースの表示
ネストされたスキーマ: encryptionProfile
1つに一致
ソースの表示
  • 最小長: 1
    最大長: 64
    パターン: ^[A-Za-z0-9][A-Za-z0-9_:-]*$
    'ogg:encryptionProfile'構成値の名前
ネストされたスキーマ: managedProcessSettings
Administration ServerでERプロセスが管理される方法を制御します
1つに一致
ソースの表示
ネストされたスキーマ: miningCredentials
ダウンストリーム・マイニング・データベースの資格証明
デフォルト値: oracle.doceng.json.BetterJsonNull@bf75b5c
1つに一致
ソースの表示
ネストされたスキーマ: registration
ソース・データベースへの登録
デフォルト値: none
1つに一致
ソースの表示
ネストされたスキーマ: source
処理するデータのソース
1つに一致
ソースの表示
  • 指定できる値: [ "tables" ]
    表を使用(初期ロード)
  • 指定できる値: [ "tranlogs" ]
    チェンジ・データ・キャプチャでのトランザクション・ログの使用
  • source-x-oneOf[2]
    サポートされていないOGG 19c構文
ネストされたスキーマ: targets
型: array
最小アイテム数: 0
最大アイテム数: 1024
取得されるデータのターゲット
ソースの表示
ネストされたスキーマ: manager
型: object
使用するマネージャ・サーバー
ソースの表示
ネストされたスキーマ: proxy
型: object
ソースの表示
ネストされたスキーマ: host
ホスト名またはIPアドレス
1つに一致
ソースの表示
  • 最小長: 1
    最大長: 4095
    パターン: ^(((([a-zA-Z0-9][-a-zA-Z0-9]{0,61})?[a-zA-Z0-9])[.])*([a-zA-Z][-a-zA-Z0-9]{0,61}[a-zA-Z0-9]|[a-zA-Z])[.]?)$
    ネットワーク・ホスト名
  • host-x-oneOf[1]
    ネットワークIPアドレス
ネストされたスキーマ: host-x-oneOf[1]
ネットワークIPアドレス
1つに一致
ソースの表示
  • 最小長: 7
    最大長: 15
    パターン: ^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.]){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
    ネットワークIPv4アドレス
  • 最小長: 1
    最大長: 256
    パターン: ^((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:)))(%.+)?$
    ネットワークIPv6アドレス
ネストされたスキーマ: credentials
プロキシ・サーバーの資格証明
デフォルト値: oracle.doceng.json.BetterJsonNull@79d3473e
1つに一致
ソースの表示
ネストされたスキーマ: host
プロキシ・サーバーのホスト名またはIPアドレス
1つに一致
ソースの表示
  • 最小長: 1
    最大長: 4095
    パターン: ^(((([a-zA-Z0-9][-a-zA-Z0-9]{0,61})?[a-zA-Z0-9])[.])*([a-zA-Z][-a-zA-Z0-9]{0,61}[a-zA-Z0-9]|[a-zA-Z])[.]?)$
    ネットワーク・ホスト名
  • host-x-oneOf[1]
    ネットワークIPアドレス
ネストされたスキーマ: credentials-x-oneOf[0]
型: object
ソースの表示
  • 指定できる値: [ "ogg:credentialsRef" ]
  • 最小長: 1
    最大長: 30
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
  • 最小長: 1
    最大長: 30
    デフォルト値: OracleGoldenGate
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
ネストされたスキーマ: host-x-oneOf[1]
ネットワークIPアドレス
1つに一致
ソースの表示
  • 最小長: 7
    最大長: 15
    パターン: ^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.]){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
    ネットワークIPv4アドレス
  • 最小長: 1
    最大長: 256
    パターン: ^((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}))|:)))(%.+)?$
    ネットワークIPv6アドレス
ネストされたスキーマ: begin-x-oneOf[2]
型: object
ソースの表示
ネストされたスキーマ: at
型: object
特定のSCNの位置(統合モード)
ソースの表示
ネストされたスキーマ: csn
1つに一致
ソースの表示
  • 最小値: 0
    最大値: 9223372036854776000
    Oracle Databaseの場合のシステム変更番号(標準形式)。
    例: 6488359
  • 最小長: 3
    最大長: 64
    パターン: [0-9]+[.][0-9]+
    Oracle Databaseの場合のシステム変更番号(代替形式)。
    例: 6488359.3456712
ネストされたスキーマ: credentials-x-oneOf[0]
型: object
ソースの表示
  • 指定できる値: [ "ogg:credentialsRef" ]
  • 最小長: 1
    最大長: 30
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
  • 最小長: 1
    最大長: 30
    デフォルト値: OracleGoldenGate
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
ネストされたスキーマ: managedProcessSettings-x-oneOf[0]
型: object
カスタム設定
ソースの表示
ネストされたスキーマ: autoRestart
型: object
ERプロセスが終了した場合に、Administration Serverによって再起動される方法を制御します
デフォルト値: { "enabled":false, "onSuccess":false, "delay":"0", "retries":"9", "window":"60", "disableOnFailure":true }
ソースの表示
  • 指定できる値: [ "ogg:taskRestart" ]
  • 最小値: 0
    最大値: 3600
    デフォルト値: 0
    異常終了したプロセスの検出からプロセスの再起動までの待機時間(秒)。
  • デフォルト値: true
    trueの場合、実行ウィンドウで実行試行がすべて失敗するとタスクが無効になります。
  • デフォルト値: false
    設定されると、タスクが終了した場合に再起動できます。
  • 最小値: 0
    最大値: 3600
    現在のウィンドウでタスクが失敗した回数。
  • デフォルト値: false
    falseの場合、タスクが失敗した場合のみ再起動されます。
  • 最小値: 0
    最大値: 3600
    デフォルト値: 9
    再試行操作が中止されるまでタスクを再起動する最大回数。
  • 最小値: 0
    最大値: 604800
    デフォルト値: 60
    再試行回数をカウントする時間枠(秒)。
ネストされたスキーマ: autoStart
型: object
ERプロセスがAdministration Serverで起動される方法の説明
ソースの表示
  • 最小値: 0
    最大値: 3600
    デフォルト値: 0
    プロセスを起動するまでに待機する時間(秒)
  • デフォルト値: false
    設定した場合、プロセスはAdministration Serverが起動されると起動されます
ネストされたスキーマ: miningCredentials-x-oneOf[0]
型: object
ソースの表示
  • 指定できる値: [ "ogg:credentialsRef" ]
  • 最小長: 1
    最大長: 30
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
  • 最小長: 1
    最大長: 30
    デフォルト値: OracleGoldenGate
    パターン: ^[a-zA-Z][a-zA-Z0-9_#$]*$
ネストされたスキーマ: registration-x-oneOf[0]
1つに一致
ソースの表示
ネストされたスキーマ: registration-x-oneOf[0]-x-oneOf[0]
型: object
統合Extractの登録オプション
ソースの表示
いずれかに一致
ソースの表示
ネストされたスキーマ: containers
型: array
最小アイテム数: 0
最大アイテム数: 256
ソースの表示
ネストされたスキーマ: csn
1つに一致
ソースの表示
  • 最小値: 0
    最大値: 9223372036854776000
    Oracle Databaseの場合のシステム変更番号(標準形式)。
    例: 6488359
  • 最小長: 3
    最大長: 64
    パターン: [0-9]+[.][0-9]+
    Oracle Databaseの場合のシステム変更番号(代替形式)。
    例: 6488359.3456712
ネストされたスキーマ: share
LogMinerデータ・ディクショナリを共有する方法を示します
デフォルト値: false
1つに一致
ソースの表示
  • 最小長: 1
    最大長: 8
    パターン: ^[A-Z_$][A-Z0-9_$]*$
ネストされたスキーマ: items
1つに一致
ソースの表示
  • 最小長: 1
    最大長: 130
    パターン: ^([^.*?"]{1,128}|["].{1,128}["])$
ネストされたスキーマ: source-x-oneOf[2]
型: object
サポートされていないOGG 19c構文
ソースの表示
ネストされたスキーマ: items
1つに一致
ソースの表示
ネストされたスキーマ: items-x-oneOf[0]
型: object
ソースの表示
  • 指定できる値: [ "ogg:trail" ]
  • 最小長: 1
    最大長: 4095
    トレイルの説明
  • 最小長: 2
    最大長: 2
    パターン: ^[A-Za-z][A-Za-z0-9]$
    トレイルの2文字の名前
  • 最小値: 0
    最大値: 2147483647
    トレイル順序ファイルのオフセット
  • 最小長: 1
    最大長: 4096
    トレイル・データが格納されるパス
  • processRef
    最小アイテム数: 1
    最大アイテム数: 5000
    このトレイルに関連付けられているすべてのプロセスのリスト
  • デフォルト値: false
    トレイルがローカルかリモートかを示します
  • 最小値: 0
    最大値: 999999999
    デフォルト値: 0
    トレイルの開始順序番号
  • sequenceLastArchived
    最小アイテム数: 1
    最大アイテム数: 128
    アーカイブされた最後の順序番号(管理対象トレイルのみ)
  • デフォルト値: 9
    指定できる値: [ "6", "9" ]
    順序ファイル名の字数
  • デフォルト値: false
    順序番号の長さが変化することを示します
  • 最小値: 0
    最大値: 999999999
    デフォルト値: 0
    デプロイメントに存在する最大のトレイル順序番号
  • 最小値: 0
    最大値: 999999999
    デフォルト値: 0
    使用されている最大のトレイル順序番号
  • 最小値: 0
    最大値: 999999999
    デフォルト値: 0
    デプロイメントに存在する最小のトレイル順序番号
  • 最小値: 0
    最大値: 999999999
    デフォルト値: 0
    使用されている最小のトレイル順序番号
  • 最小値: 1
    最大値: 2000
    デフォルト値: 500
    トレイル内のファイルの最大サイズ(MB)。
  • 最小値: 0
    最大値: 18446744073709552000
    すべてのトレイル順序によって消費されたバイト数
  • 最小長: 3
    最大長: 512
    パターン: ^[a-zA-Z0-9_#$/-]*$
    トレイルのオプションのわかりやすい名前
ネストされたスキーマ: processRef
型: array
最小アイテム数: 1
最大アイテム数: 5000
このトレイルに関連付けられているすべてのプロセスのリスト
ソースの表示
  • items
    この管理対象トレイルに関連付けられているOGGプロセスへの参照
ネストされたスキーマ: sequenceLastArchived
型: array
最小アイテム数: 1
最大アイテム数: 128
アーカイブされた最後の順序番号(管理対象トレイルのみ)
ソースの表示
ネストされたスキーマ: items
型: object
この管理対象トレイルに関連付けられているOGGプロセスへの参照
ソースの表示
ネストされたスキーマ: processName
いずれかに一致
ソースの表示
  • 最小長: 1
    最大長: 8
    パターン: ^[A-Z_$][A-Z0-9_$]*$
  • 最小長: 1
    最大長: 32
    パターン: ^[A-Za-z][A-Za-z0-9-_.]*$
ネストされたスキーマ: items
型: object
ソースの表示
ネストされたスキーマ: archiveTarget
トレイル順序がアーカイブされた場所
1つに一致
ソースの表示
ネストされたスキーマ: archiveTarget-x-oneOf[1]
型: object
OCIオブジェクト・ストレージ・バケット
ソースの表示
ネストされたスキーマ: archiveTarget-x-oneOf[2]
型: object
S3互換のオブジェクト・ストレージ・バケット
ソースの表示
ネストされたスキーマ: authentication
1つに一致
ソースの表示
ネストされたスキーマ: authentication-x-oneOf[0]
型: object
デフォルトのプロファイル構成ファイルの名前付きプロファイルを使用した認証
ソースの表示
ネストされたスキーマ: authentication-x-oneOf[1]
型: object
インスタンス・プリンシパルを使用したOCIの認証
ソースの表示
  • 指定できる値: [ true ]
    認証にインスタンス・プリンシパルを使用する必要があることを示します
ネストされたスキーマ: authentication-x-oneOf[2]
型: object
ユーザーのAPI署名キーを使用したOCIの認証
ソースの表示
ネストされたスキーマ: authentication
1つに一致
ソースの表示
ネストされたスキーマ: authentication-x-oneOf[0]
型: object
デフォルトのプロファイル構成ファイルの名前付きプロファイルを使用した認証
ソースの表示
ネストされたスキーマ: authentication-x-oneOf[1]
型: object
シークレットを使用したS3の認証
ソースの表示
レスポンスの例(application/json)
{
    "$schema":"api:standardResponse",
    "links":[
        {
            "href":"http://localhost:9012/services/v2/extracts/EXTN",
            "mediaType":"application/json",
            "rel":"canonical"
        },
        {
            "href":"http://localhost:9012/services/v2/extracts/EXTN",
            "mediaType":"application/json",
            "rel":"self"
        },
        {
            "href":"http://localhost:9012/services/v2/metadata-catalog/extract",
            "mediaType":"application/schema+json",
            "rel":"describedby"
        }
    ],
    "messages":[
    ],
    "response":{
        "begin":"now",
        "config":[
            "EXTRACT extn",
            "EXTTRAIL north/ea",
            "USERIDALIAS ggnorth",
            "SOURCECATALOG dbnorth_pdb1",
            "TABLE hr.*;"
        ],
        "encryptionProfile":"LocalWallet",
        "$schema":"ogg:extract",
        "status":"running",
        "targets":[
            {
                "name":"ea",
                "offset":"6504",
                "path":"north",
                "remote":false,
                "sequence":"0",
                "sequenceLength":"9",
                "sequenceLengthFlip":false,
                "sizeMB":"500"
            }
        ],
        "registration":{
            "containers":[
                "DBNORTH_PDB1"
            ],
            "csn":"2065843",
            "optimized":false
        },
        "source":"tranlogs",
        "type":"Integrated",
        "credentials":{
            "alias":"ggnorth"
        },
        "description":"Region North"
    }
}
先頭に戻る