Skip to content

kingbasewriter.md

Latest commit

 

History

History
309 lines (287 loc) · 6.64 KB

kingbasewriter.md

File metadata and controls

309 lines (287 loc) · 6.64 KB
Raw

KingBase Writer

一、插件名称

名称：kingbasewriter

二、支持的数据源版本

KingBase 8.2及8.3

三、参数说明

  • jdbcUrl
    • 描述：针对KingBase数据库的jdbc连接字符串
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • username
    • 描述：数据源的用户名
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • password
    • 描述：数据源指定用户名的密码
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • schema
    • 描述：写入数据库所在schema
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • column
    • 描述：目的表需要写入数据的字段,字段之间用英文逗号分隔。例如: "column": ["id","name","age"]
    • 必选：是
    • 默认值：否
    • 字段类型：List
    • 默认值：无

  • preSql
    • 描述：写入数据到目的表前，会先执行这里的一组标准语句
    • 必选：否
    • 字段类型：List
    • 默认值：无

  • postSql
    • 描述：写入数据到目的表后，会执行这里的一组标准语句
    • 必选：否
    • 字段类型：List
    • 默认值：无

  • table
    • 描述：目的表的表名称。目前只支持配置单个表，后续会支持多表
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • writeMode
    • 描述：仅支持insert、update操作，可以搭配insertSqlMode使用
    • 必选：是
    • 字段类型：String
    • 默认值：无

  • insertSqlMode
    • 描述：控制写入数据到目标表采用 COPY table_name [ ( column_name [, ...] ) ] FROM STDIN DELIMITER 'delimiter_character'语句，提高数据的插入效率
    • 注意: 目前该参数值固定传入 copy，否则抛出提示为not support insertSqlMode的RuntimeException。当指定此参数时，writeMode的值必须为 insert，否则设置无效
    • 必选：否
    • 字段类型：String
    • 默认值：无

  • batchSize
    • 描述：一次性批量提交的记录数大小，该值可以极大减少FlinkX与数据库的网络交互次数，并提升整体吞吐量。但是该值设置过大可能会造成FlinkX运行进程OOM情况
    • 必选：否
    • 字段类型：int
    • 默认值：1024

四、配置示例

1、insert

{
  "job": {
    "content": [{
      "reader": {
        "parameter": {
          "sliceRecordCount": ["100"],
          "column": [
            {
              "name": "id",
              "type": "int"
            },
            {
              "name": "user_id",
              "type": "int"
            },
            {
              "name":"name",
              "type":"string"
            }
          ]
        },
        "name": "streamreader"
      },
      "writer": {
        "name": "kingbasewriter",
        "parameter": {
          "connection": [{
            "jdbcUrl": "jdbc:kingbase8://localhost:54321/test",
            "table": [
              "tableTest"
            ],
            "schema":"test"
          }],
          "username": "username",
          "password": "password",
          "column": [
            {
            "name": "id",
            "type": "BIGINT"
          },
            {
              "name": "user_id",
              "type": "BIGINT"
            },
            {
              "name": "name",
              "type": "varchar"
            }],
          "writeMode": "insert",
          "batchSize": 1024,
          "preSql": [],
          "postSql": []
        }
      }
    }],
    "setting": {
      "speed": {
        "channel": 1,
        "bytes": 0
      },
      "errorLimit": {
        "record": 100
      }
    }
  }
}

2、 insert with copy mode

{
  "job": {
    "content": [{
      "reader": {
        "parameter": {
          "sliceRecordCount": ["100"],
          "column": [
            {
              "name": "id",
              "type": "int"
            },
            {
              "name": "user_id",
              "type": "int"
            },
            {
              "name":"name",
              "type":"string"
            }
          ]
        },
        "name": "streamreader"
      },
      "writer": {
        "name": "kingbasewriter",
        "parameter": {
          "connection": [{
            "jdbcUrl": "jdbc:kingbase8://localhost:54321/ide",
            "table": [
              "tableTest"
            ],
            "schema":"test"
          }],
          "username": "username",
          "password": "password",
          "column": [
            {
            "name": "id",
            "type": "BIGINT"
          },
            {
              "name": "user_id",
              "type": "BIGINT"
            },
            {
              "name": "name",
              "type": "varchar"
            }],
          "writeMode": "insert",
          "batchSize": 1024,
          "preSql": [],
          "postSql": [],
          "insertSqlMode": "copy"
        }
      }
    }],
    "setting": {
      "speed": {
        "channel": 1,
        "bytes": 0
      },
      "errorLimit": {
        "record": 100
      }
    }
  }
}

3、 update

{
  "job": {
    "content": [{
      "reader": {
        "parameter": {
          "sliceRecordCount": ["100"],
          "column": [
            {
              "name": "id",
              "type": "int"
            },
            {
              "name": "user_id",
              "type": "int"
            },
            {
              "name":"name",
              "type":"string"
            }
          ]
        },
        "name": "streamreader"
      },
      "writer": {
        "name": "kingbasewriter",
        "parameter": {
          "connection": [{
            "jdbcUrl": "jdbc:kingbase8://localhost:54321/ide",
            "table": [
              "tableTest"
            ],
            "schema":"test"
          }],
          "username": "username",
          "password": "password",
          "column": [
            {
            "name": "id",
            "type": "BIGINT"
          },
            {
              "name": "user_id",
              "type": "BIGINT"
            },
            {
              "name": "name",
              "type": "varchar"
            }],
          "writeMode": "update",
          "updateKey": {"key": ["id"]},
          "column": ["id","user_id","name"],
          "batchSize": 1024,
          "preSql": [],
          "postSql": []
        }
      }
    }],
    "setting": {
      "speed": {
        "channel": 1,
        "bytes": 0
      },
      "errorLimit": {
        "record": 100
      }
    }
  }
}