插入数据

// ds 是 com.mysql.cj.jdbc.MysqlDataSource 的实体
try (Connection connection = ds.getConnection()) {
    connection.setAutoCommit(false);

    PreparedStatement pstmt = connection.prepareStatement("INSERT INTO player (id, coins, goods) VALUES (?, ?, ?)");

    // 第一个玩家
    pstmt.setInt(1, 1);
    pstmt.setInt(2, 1000);
    pstmt.setInt(3, 1);
    pstmt.addBatch();

    // 第二个玩家
    pstmt.setInt(1, 2);
    pstmt.setInt(2, 230);
    pstmt.setInt(3, 2);
    pstmt.addBatch();

    pstmt.executeBatch();
    connection.commit();
} catch (SQLException e) {
    e.printStackTrace();
}

由于默认的 MySQL JDBC 驱动设置，需调整一些参数以获得更好的批量插入性能。

MySQL JDBC 驱动还提供了集成配置：useConfigs。当配置为 maxPerformance 时，相当于配置了一组参数。以 mysql:mysql-connector-java:8.0.28 为例，useConfigs=maxPerformance 包含：

cachePrepStmts=true
cacheCallableStmts=true
cacheServerConfiguration=true
useLocalSessionState=true
elideSetAutoCommits=true
alwaysSendSetIsolation=false
enableQueryTimeouts=false
connectionAttributes=none
useInformationSchema=true

你可以查看 mysql-connector-java-{version}.jar!/com/mysql/cj/configurations/maxPerformance.properties，获取对应版本 MySQL JDBC 驱动中 useConfigs=maxPerformance 所包含的配置。

以下是 JDBC 连接字符串配置的典型场景示例。假设 Host 为 127.0.0.1，端口为 4000，用户名为 root，密码为空，默认数据库为 test：

jdbc:mysql://127.0.0.1:4000/test?user=root&useConfigs=maxPerformance&useServerPrepStmts=true&prepStmtCacheSqlLimit=2048&prepStmtCacheSize=256&rewriteBatchedStatements=true&allowMultiQueries=true

完整的 Java 示例请参见：

• 使用 JDBC 连接 TiDB
• 使用 Hibernate 连接 TiDB
• 使用 Spring Boot 连接 TiDB

package main

import (
    "database/sql"
    "strings"

    _ "github.com/go-sql-driver/mysql"
)

type Player struct {
    ID    string
    Coins int
    Goods int
}

func bulkInsertPlayers(db *sql.DB, players []Player, batchSize int) error {
    tx, err := db.Begin()
    if err != nil {
        return err
    }

    stmt, err := tx.Prepare(buildBulkInsertSQL(batchSize))
    if err != nil {
        return err
    }

    defer stmt.Close()

    for len(players) > batchSize {
        if _, err := stmt.Exec(playerToArgs(players[:batchSize])...); err != nil {
            tx.Rollback()
            return err
        }

        players = players[batchSize:]
    }

    if len(players) != 0 {
        if _, err := tx.Exec(buildBulkInsertSQL(len(players)), playerToArgs(players)...); err != nil {
            tx.Rollback()
            return err
        }
    }

    if err := tx.Commit(); err != nil {
        tx.Rollback()
        return err
    }

    return nil
}

func playerToArgs(players []Player) []interface{} {
    var args []interface{}
    for _, player := range players {
        args = append(args, player.ID, player.Coins, player.Goods)
    }
    return args
}

func buildBulkInsertSQL(amount int) string {
    return "INSERT INTO player (id, coins, goods) VALUES (?, ?, ?)" + strings.Repeat(",(?,?,?)", amount-1)
}

关于完整的 Golang 示例，请参见：

• 使用 Go-MySQL-Driver 连接 TiDB
• 使用 GORM 连接 TiDB

import MySQLdb
connection = MySQLdb.connect(
    host="127.0.0.1",
    port=4000,
    user="root",
    password="",
    database="bookshop",
    autocommit=True
)

with get_connection(autocommit=True) as connection:
    with connection.cursor() as cur:
        player_list = random_player(1919)
        for idx in range(0, len(player_list), 114):
            cur.executemany("INSERT INTO player (id, coins, goods) VALUES (%s, %s, %s)", player_list[idx:idx + 114])

关于完整的 Python 示例，请参见：

• 使用 PyMySQL 连接 TiDB
• 使用 mysqlclient 连接 TiDB
• 使用 MySQL Connector/Python 连接 TiDB
• 使用 SQLAlchemy 连接 TiDB
• 使用 peewee 连接 TiDB