Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 2.5 KB

yugabytedb.md

File metadata and controls

59 lines (41 loc) · 2.5 KB

YugabyteDB Module

!!! note This module is INCUBATING. While it is ready for use and operational in the current version of Testcontainers, it is possible that it may receive breaking changes in the future. See our contributing guidelines for more information on our incubating modules policy.

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

YugabyteDB supports two APIs.

  • Yugabyte Structured Query Language YSQL is a fully-relational API that is built by the PostgreSQL code
  • Yugabyte Cloud Query Language YCQL is a semi-relational SQL API that has its roots in the Cassandra Query Language

Usage example

YSQL API

Creating a YSQL container inside_block:creatingYSQLContainer

Starting a YSQL container inside_block:startingYSQLContainer

YCQL API

Creating a YCQL container inside_block:creatingYCQLContainer

Starting a YCQL container inside_block:startingYCQLContainer

Adding this module to your project dependencies

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

=== "Gradle" groovy testImplementation "org.testcontainers:yugabytedb:{{latest_version}}" === "Maven" xml <dependency> <groupId>org.testcontainers</groupId> <artifactId>yugabytedb</artifactId> <version>{{latest_version}}</version> <scope>test</scope> </dependency>

!!! hint Adding this Testcontainers library JAR will not automatically add the Yugabytedb driver JAR to your project. You should ensure that your project has the Yugabytedb driver as a dependency, if you plan on using it. Refer to the driver page YSQL and YCQL for instructions.