移動

• リクエスト
• レスポンス

エージェント接続の更新

patch

http://{host}:{port}/veridata/v1/services/configuration/connections/{Id}

必要なロール: Administrator、SuperUser、CommandLineOperator

エージェント接続を更新します。

リクエスト

パス・パラメータ

• Id(必須): integer(int64)
  更新する接続のID。

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

• application/json

リクエスト本文 - application/json ()

ルート・スキーマ: schema

タイプ: object

ソースの表示

• description: string
  接続の説明。
• host: string
  Veridataエージェントのホスト。
• password: string (password)
  暗号化されたデータベース接続パスワード。
• port: integer (int32)
  Veridataエージェントのポート。
• properties: array properties
• repairPassword: string (password)
  修復アクセス権を持つ暗号化されたDBパスワード。
• repairUsername: string
  修復アクセス権を持つDBユーザー。
• settings: object ConnectionSettings
• ssl: boolean
  デフォルト値: false

  サーバーへのSSL対応のエージェント接続。
• username: string
  データベース接続のユーザー名。

{
    "type":"object",
    "properties":{
        "description":{
            "type":"string",
            "description":"Connection Description."
        },
        "host":{
            "type":"string",
            "description":"Veridata Agent Host."
        },
        "port":{
            "type":"integer",
            "description":"Veridata Agent Port.",
            "format":"int32"
        },
        "ssl":{
            "type":"boolean",
            "description":"SSL enabled Agent connection to the Server.",
            "default":false
        },
        "username":{
            "type":"string",
            "description":"Database connection username."
        },
        "password":{
            "type":"string",
            "description":"Encrypted Database connection password.",
            "format":"password"
        },
        "repairUsername":{
            "type":"string",
            "description":"DB user having repair access."
        },
        "repairPassword":{
            "type":"string",
            "description":"Encrypted DB password having repair access.",
            "format":"password"
        },
        "properties":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UpdateConnectionProperty"
            }
        },
        "settings":{
            "$ref":"#/components/schemas/ConnectionSettings"
        }
    }
}

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

タイプ: array

ソースの表示

• 配列: object UpdateConnectionProperty

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UpdateConnectionProperty"
    }
}

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

タイプ: object

ソースの表示

• agentTimeout: integer (int32)
  デフォルト値: 3600

  エージェント・メッセージ・タイムアウト(秒)。
• fetchSize: integer (int32)
  デフォルト値: 1000

  初回比較フェッチ・バッチ・サイズ。
• ssl: boolean
  デフォルト値: false

  サーバー-エージェント通信にSecure Socket Layer (SSL)を使用します。
• trimTrailingSpaces: boolean
  デフォルト値: true

  値の比較時に末尾のスペースを切り捨てます。
• useAllColsAsKeys: boolean
  デフォルト値: true

  比較ペアの生成時にすべての列をキー列として使用します。
• useSourceTargetAsKeys: boolean
  デフォルト値: true

  比較の生成時に、ソース列またはターゲット列をキー列として使用します。ペア

{
    "type":"object",
    "properties":{
        "agentTimeout":{
            "type":"integer",
            "description":"Agent Message Timeout in seconds.",
            "format":"int32",
            "default":"3600"
        },
        "trimTrailingSpaces":{
            "type":"boolean",
            "description":"Truncate trailing spaces when comparing values.",
            "default":true
        },
        "fetchSize":{
            "type":"integer",
            "description":"Initial Compare Fetch Batch Size.",
            "format":"int32",
            "default":"1000"
        },
        "ssl":{
            "type":"boolean",
            "description":"Use Secure Socket Layer (SSL) for server-agent communication.",
            "default":false
        },
        "useSourceTargetAsKeys":{
            "type":"boolean",
            "description":"Use Source or Target Columns as Key columns when generating ompare. Pairs",
            "default":true
        },
        "useAllColsAsKeys":{
            "type":"boolean",
            "description":"Use all Columns as Key columns when generating Compare Pairs.",
            "default":true
        }
    }
}

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

タイプ: object

ソースの表示

• compareFormat: object UpdateCompareFormat
• dataType: string

{
    "type":"object",
    "properties":{
        "dataType":{
            "type":"string"
        },
        "compareFormat":{
            "$ref":"#/components/schemas/UpdateCompareFormat"
        }
    }
}

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

タイプ: object

ソースの表示

• formatName: string
  指定できる値: [ "string", "string_en", "binary", "timestamp", "timestamp_tz", "date", "time", "datetime", "smalldatetime", "clob", "blob", "Float", "dec_float", "interval", "number", "binary_timestamp", "string_nfc", "clob_nfc", "sybtime", "bit", "Double" ]

  比較形式。
• precision: integer (int32)
• scale: integer (int32)
• timezone: string

{
    "type":"object",
    "properties":{
        "formatName":{
            "$ref":"#/components/schemas/CompareFormat"
        },
        "precision":{
            "type":"integer",
            "format":"int32"
        },
        "scale":{
            "type":"integer",
            "format":"int32"
        },
        "timezone":{
            "type":"string"
        }
    }
}

先頭に戻る

レスポンス

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

• application/json

200 レスポンス

接続が更新されました。

本文()

ルート・スキーマ: Connection

タイプ: object

ソースの表示

• availableTimezones: object availableTimezones
  タイムゾーンのリスト。
• dbType: string
  指定できる値: [ "ORACLE", "TANDEMNSK", "SQLSERVER", "SYBASE", "DB2", "TERADATA", "INFORMIX", "HIVE", "MYSQL", "POSTGRESQL" ]

  データベース・タイプ。
• properties: array properties
• repairUsername: string
  修復アクセス権を持つDBユーザー。
• settings: object ConnectionSettings
• username: string
  データベース接続のユーザー名。

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/BaseConnection"
        }
    ],
    "properties":{
        "dbType":{
            "$ref":"#/components/schemas/DatabaseType"
        },
        "username":{
            "type":"string",
            "description":"Database connection username."
        },
        "repairUsername":{
            "type":"string",
            "description":"DB user having repair access."
        },
        "properties":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ConnectionProperty"
            }
        },
        "settings":{
            "$ref":"#/components/schemas/ConnectionSettings"
        },
        "availableTimezones":{
            "type":"object",
            "description":"List of timezones."
        }
    }
}

すべて一致

ソースの表示

• object BaseConnection

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/BaseConnection"
        }
    ],
    "properties":{
        "dbType":{
            "$ref":"#/components/schemas/DatabaseType"
        },
        "username":{
            "type":"string",
            "description":"Database connection username."
        },
        "repairUsername":{
            "type":"string",
            "description":"DB user having repair access."
        },
        "properties":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ConnectionProperty"
            }
        },
        "settings":{
            "$ref":"#/components/schemas/ConnectionSettings"
        },
        "availableTimezones":{
            "type":"object",
            "description":"List of timezones."
        }
    }
}

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

タイプ: object

タイムゾーンのリスト。

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

タイプ: array

ソースの表示

• 配列: object ConnectionProperty

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ConnectionProperty"
    }
}

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

タイプ: object

ソースの表示

• agentTimeout: integer (int32)
  デフォルト値: 3600

  エージェント・メッセージ・タイムアウト(秒)。
• fetchSize: integer (int32)
  デフォルト値: 1000

  初回比較フェッチ・バッチ・サイズ。
• ssl: boolean
  デフォルト値: false

  サーバー-エージェント通信にSecure Socket Layer (SSL)を使用します。
• trimTrailingSpaces: boolean
  デフォルト値: true

  値の比較時に末尾のスペースを切り捨てます。
• useAllColsAsKeys: boolean
  デフォルト値: true

  比較ペアの生成時にすべての列をキー列として使用します。
• useSourceTargetAsKeys: boolean
  デフォルト値: true

  比較の生成時に、ソース列またはターゲット列をキー列として使用します。ペア

{
    "type":"object",
    "properties":{
        "agentTimeout":{
            "type":"integer",
            "description":"Agent Message Timeout in seconds.",
            "format":"int32",
            "default":"3600"
        },
        "trimTrailingSpaces":{
            "type":"boolean",
            "description":"Truncate trailing spaces when comparing values.",
            "default":true
        },
        "fetchSize":{
            "type":"integer",
            "description":"Initial Compare Fetch Batch Size.",
            "format":"int32",
            "default":"1000"
        },
        "ssl":{
            "type":"boolean",
            "description":"Use Secure Socket Layer (SSL) for server-agent communication.",
            "default":false
        },
        "useSourceTargetAsKeys":{
            "type":"boolean",
            "description":"Use Source or Target Columns as Key columns when generating ompare. Pairs",
            "default":true
        },
        "useAllColsAsKeys":{
            "type":"boolean",
            "description":"Use all Columns as Key columns when generating Compare Pairs.",
            "default":true
        }
    }
}

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

タイプ: object

ソースの表示

• createdOn: string (date-time)
  パターン: YYYY-MM-DDTHH:mm:ss.sssZ

  例: 2024-02-03T10:15:30Z
• description: string
  接続の説明。
• host: string
  Veridataエージェントのホスト。
• id: integer (int64)
  接続ID。
• name: string
  接続名。
• port: integer (int32)
  Veridataエージェントのポート。
• updatedOn: string (date-time)
  パターン: YYYY-MM-DDTHH:mm:ss.sssZ

  例: 2024-02-03T10:15:30Z

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "description":"Connection Id.",
            "format":"int64"
        },
        "name":{
            "type":"string",
            "description":"Connection Name."
        },
        "description":{
            "type":"string",
            "description":"Connection Description."
        },
        "host":{
            "type":"string",
            "description":"Veridata Agent Host."
        },
        "port":{
            "type":"integer",
            "description":"Veridata Agent Port.",
            "format":"int32"
        },
        "createdOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        },
        "updatedOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        }
    }
}

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

タイプ: object

ソースの表示

• compareFormat: string
  指定できる値: [ "string", "string_en", "binary", "timestamp", "timestamp_tz", "date", "time", "datetime", "smalldatetime", "clob", "blob", "Float", "dec_float", "interval", "number", "binary_timestamp", "string_nfc", "clob_nfc", "sybtime", "bit", "Double" ]

  比較形式。
• dataType: string
• isDefault: boolean
  デフォルト値: true

  デフォルト・プロパティを使用するかどうかを定義します。
• precision: integer (int32)
• scale: integer (int32)
• timezone: string

{
    "type":"object",
    "properties":{
        "dataType":{
            "type":"string"
        },
        "compareFormat":{
            "$ref":"#/components/schemas/CompareFormat"
        },
        "precision":{
            "type":"integer",
            "format":"int32"
        },
        "scale":{
            "type":"integer",
            "format":"int32"
        },
        "timezone":{
            "type":"string"
        },
        "isDefault":{
            "type":"boolean",
            "description":"Defines if default property is used or not.",
            "default":true
        }
    }
}

400 レスポンス

不正なリクエスト。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    }
}

401 レスポンス

権限がありません。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    }
}

404 レスポンス

見つかりません。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    }
}

500 レスポンス

サーバー・エラー。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    }
}

先頭に戻る