Skip to content

Presto

Not available until the next release main

Introduction

The Testcontainers module for Presto, a distributed SQL query engine for big data. Presto is designed to run interactive analytic queries against data sources of all sizes, from gigabytes to petabytes.

Adding this module to your project dependencies

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

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

Usage example

ctx := context.Background()

prestoContainer, err := presto.Run(ctx, "prestodb/presto:0.286")
defer func() {
    if err := testcontainers.TerminateContainer(prestoContainer); 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 Presto module exposes one entrypoint function to create the Presto 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(), "prestodb/presto:0.286").

Wait Strategy

The module waits for the Presto coordinator to finish starting up by polling the /v1/info HTTP endpoint on port 8080/tcp until the starting field in the JSON response is false. A startup timeout of 2 minutes is applied.

Container Ports

Here you can find the list with the default ports used by the Presto container.

httpPort = "8080/tcp"

Container Options

When starting the Presto 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 Presto container exposes the following methods:

ConnectionString

  • Not available until the next release main

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

connStr, err := prestoContainer.ConnectionString(ctx)