Skip to content

TiDB Module

Testcontainers module for TiDB

Usage example

You can start a TiDB container instance from any Java application by using:

TiDBContainer tidb = new TiDBContainer("pingcap/tidb:v6.1.0")

See Database containers for documentation and usage that is common to all relational database container types.

Testcontainers JDBC URL

jdbc:tc:tidb:v6.1.0:///databasename

See JDBC for documentation.

Adding this module to your project dependencies

Add the following dependency to your pom.xml/build.gradle file:

testImplementation "org.testcontainers:tidb:1.21.3"
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>tidb</artifactId>
    <version>1.21.3</version>
    <scope>test</scope>
</dependency>

Hint

Adding this Testcontainers library JAR will not automatically add a database driver JAR to your project. You should ensure that your project also has a suitable database driver as a dependency.