Skip to content

Trino

Not available until the next release main

Introduction

The Testcontainers module for Trino.

Trino is an open-source distributed SQL query engine designed to run interactive analytic queries against data sources of all sizes, from gigabytes to petabytes. It is the community continuation of PrestoSQL.

Adding this module to your project dependencies

Please run the following command to add the Trino module to your Go dependencies:

go get github.com/testcontainers/testcontainers-go/modules/trino

Usage example

ctx := context.Background()

trinoContainer, err := trino.Run(ctx, "trinodb/trino:435")
defer func() {
    if err := testcontainers.TerminateContainer(trinoContainer); err != nil {
        log.Printf("failed to terminate container: %s", err)
    }
}()
if err != nil {
    log.Printf("failed to start container: %s", err)
    return
}

Module Reference

Run function

  • Not available until the next release main

The Trino module exposes one entrypoint function to create the Trino container, and this function receives three parameters:

func Run(ctx context.Context, img string, opts ...testcontainers.ContainerCustomizer) (*Container, error)
  • context.Context, the Go context.
  • string, the Docker image to use.
  • testcontainers.ContainerCustomizer, a variadic argument for passing options.

Image

Use the second argument in the Run function to set a valid Docker image. In example: Run(context.Background(), "trinodb/trino:435").

Wait strategy

The module waits for the Trino coordinator to be ready by polling the /v1/info HTTP endpoint on port 8080/tcp. It checks that the JSON field starting is false, which indicates the coordinator has finished its initialisation. The default startup timeout is 2 minutes.

Container Options

When starting the Trino container, you can pass options in a variadic way to configure it.

The following options are exposed by the testcontainers package.

Basic Options

Lifecycle Options

Files & Mounts Options

Build Options

Logging Options

Image Options

Networking Options

Advanced Options

Experimental Options

Container Methods

The Trino container exposes the following methods:

ConnectionString

  • Not available until the next release main

This method returns the HTTP connection string for the Trino coordinator, e.g. http://localhost:8080.

connStr, err := trinoContainer.ConnectionString(ctx)