Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Presto container #2196

Merged
merged 2 commits into from Feb 8, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/modules/databases/index.md
Expand Up @@ -69,6 +69,10 @@ Insert `tc:` after `jdbc:` as follows. Note that the hostname, port and database

`jdbc:tc:postgis:9.6:///databasename`

### Using Presto

`jdbc:tc:presto:329://localhost/memory/default`

## Using a classpath init script

Testcontainers can run an init script after the database container is started, but before your code is given a connection to it. The script must be on the classpath, and is referenced as follows:
Expand Down
88 changes: 88 additions & 0 deletions docs/modules/databases/presto.md
@@ -0,0 +1,88 @@
# Presto Module

!!! note
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

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](/contributing/#incubating-modules) for more information on our incubating modules policy.

See [Database containers](./index.md) for documentation and usage that is common to all database container types.

## Usage example

Running Presto as a stand-in for in a test:

```java
public class SomeTest {

@Rule
public PrestoContainer presto = new PrestoContainer();

@Test
public void someTestMethod() {
String url = presto.getJdbcUrl();

... create a connection and run test as normal
```

Presto comes with several catalogs preconfigured. Most useful ones for testing are

* `tpch` catalog using the [Presto TPCH Connector](https://prestosql.io/docs/current/connector/tpch.html).
This is a read-only catalog that defines standard TPCH schema, so is available for querying without a need
to create any tables.
* `memory` catalog using the [Presto Memory Connector](https://prestosql.io/docs/current/connector/memory.html).
This catalog can be used for creating schemas and tables and does not require any storage, as everything
is stored fully in-memory.

Example test using the `tpch` and `memory` catalogs:

```java
public class SomeTest {
@Rule
public PrestoContainer prestoSql = new PrestoContainer();

@Test
public void queryMemoryAndTpchConnectors() throws SQLException {
try (Connection connection = prestoSql.createConnection();
Statement statement = connection.createStatement()) {
// Prepare data
statement.execute("CREATE TABLE memory.default.table_with_array AS SELECT 1 id, ARRAY[1, 42, 2, 42, 4, 42] my_array");

// Query Presto using newly created table and a builtin connector
try (ResultSet resultSet = statement.executeQuery("" +
"SELECT nationkey, element " +
"FROM tpch.tiny.nation " +
"JOIN memory.default.table_with_array twa ON nationkey = twa.id " +
"LEFT JOIN UNNEST(my_array) a(element) ON true " +
"ORDER BY element OFFSET 1 FETCH NEXT 3 ROWS WITH TIES ")) {
List<Integer> actualElements = new ArrayList<>();
while (resultSet.next()) {
actualElements.add(resultSet.getInt("element"));
}
Assert.assertEquals(Arrays.asList(2, 4, 42, 42, 42), actualElements);
}
}
}
}
```

## Adding this module to your project dependencies

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

```groovy tab='Gradle'
testCompile "org.testcontainers:presto:{{latest_version}}"
```

```xml tab='Maven'
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>presto</artifactId>
<version>{{latest_version}}</version>
<scope>test</scope>
</dependency>
```

!!! hint
Adding this Testcontainers library JAR will not automatically add the Presto JDBC driver JAR to your project.
You should ensure that your project has the Presto JDBC driver as a dependency, if you plan on using it.
Refer to [Presto project download page](https://prestosql.io/download.html) for instructions.


1 change: 1 addition & 0 deletions mkdocs.yml
Expand Up @@ -53,6 +53,7 @@ nav:
- modules/databases/neo4j.md
- modules/databases/oraclexe.md
- modules/databases/postgres.md
- modules/databases/presto.md
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks. I squash this with the first commit

- modules/docker_compose.md
- modules/elasticsearch.md
- modules/kafka.md
Expand Down
2 changes: 2 additions & 0 deletions modules/jdbc-test/build.gradle
Expand Up @@ -7,6 +7,7 @@ repositories {
dependencies {
compile project(':mysql')
compile project(':postgresql')
compile project(':presto')
compile project(':cockroachdb')
compile project(':mariadb')
compile project(':oracle-xe')
Expand All @@ -16,6 +17,7 @@ dependencies {

testCompile 'com.google.guava:guava:18.0'
testCompile 'org.postgresql:postgresql:42.0.0'
testCompile 'io.prestosql:presto-jdbc:329'
testCompile 'mysql:mysql-connector-java:8.0.14'
testCompile 'org.mariadb.jdbc:mariadb-java-client:1.4.6'
testCompile 'com.oracle:ojdbc6:12.1.0.1-atlassian-hosted'
Expand Down
Expand Up @@ -53,6 +53,7 @@ public static Iterable<Object[]> data() {
{"jdbc:tc:postgresql:9.6.8://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
{"jdbc:tc:postgis://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
{"jdbc:tc:postgis:9.6://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
{"jdbc:tc:presto:329://hostname/", EnumSet.of(Options.PmdKnownBroken)},
{"jdbc:tc:mysql:5.6://hostname/databasename?TC_MY_CNF=somepath/mysql_conf_override", EnumSet.of(Options.CustomIniFile)},
{"jdbc:tc:mariadb://hostname/databasename", EnumSet.noneOf(Options.class)},
{"jdbc:tc:mariadb://hostname/databasename?user=someuser&TC_INITSCRIPT=somepath/init_mariadb.sql", EnumSet.of(Options.ScriptedSchema, Options.JDBCParams)},
Expand Down
8 changes: 8 additions & 0 deletions modules/presto/build.gradle
@@ -0,0 +1,8 @@
description = "Testcontainers :: JDBC :: Presto"

dependencies {
compile project(':jdbc')

testCompile 'io.prestosql:presto-jdbc:329'
testCompile 'commons-dbutils:commons-dbutils:1.7'
}
@@ -0,0 +1,104 @@
package org.testcontainers.containers;

import org.jetbrains.annotations.NotNull;
import org.testcontainers.containers.wait.strategy.LogMessageWaitStrategy;

import java.sql.Connection;
import java.sql.SQLException;
import java.time.Duration;
import java.util.HashSet;
import java.util.Set;

import static com.google.common.base.Strings.nullToEmpty;
import static java.lang.String.format;
import static java.time.temporal.ChronoUnit.SECONDS;

public class PrestoContainer<SELF extends PrestoContainer<SELF>> extends JdbcDatabaseContainer<SELF> {
public static final String NAME = "presto";
public static final String IMAGE = "prestosql/presto";
public static final String DEFAULT_TAG = "329";

public static final Integer PRESTO_PORT = 8080;

private String username = "test";
private String catalog = null;

public PrestoContainer() {
this(IMAGE + ":" + DEFAULT_TAG);
}

public PrestoContainer(final String dockerImageName) {
super(dockerImageName);
this.waitStrategy = new LogMessageWaitStrategy()
.withRegEx(".*io.prestosql.server.PrestoServer\\s+======== SERVER STARTED ========.*")
.withStartupTimeout(Duration.of(60, SECONDS));
}

@NotNull
@Override
protected Set<Integer> getLivenessCheckPorts() {
return new HashSet<>(getMappedPort(PRESTO_PORT));
}

@Override
protected void configure() {
addExposedPort(PRESTO_PORT);
}

@Override
public String getDriverClassName() {
return "io.prestosql.jdbc.PrestoDriver";
}

@Override
public String getJdbcUrl() {
return format("jdbc:presto://%s:%s/%s", getContainerIpAddress(), getMappedPort(PRESTO_PORT), nullToEmpty(catalog));
}

@Override
public String getUsername() {
return username;
}

@Override
public String getPassword() {
return "";
}

@Override
public String getDatabaseName() {
return catalog;
}

@Override
public String getTestQueryString() {
return "SELECT count(*) FROM tpch.tiny.nation";
}

@Override
public SELF withUsername(final String username) {
this.username = username;
return self();
}

/**
* @deprecated This operation is not supported.
*/
@Override
@Deprecated
public SELF withPassword(final String password) {
// ignored, Presto does not support password authentication without TLS
// TODO: make JDBCDriverTest not pass a password unconditionally and remove this method
return self();
}

@Override
public SELF withDatabaseName(String dbName) {
this.catalog = dbName;
return self();
}

public Connection createConnection() throws SQLException, NoDriverFoundException {
return createConnection("");
}
}
@@ -0,0 +1,35 @@
package org.testcontainers.containers;

import org.testcontainers.jdbc.ConnectionUrl;

import java.util.Objects;

/**
* Factory for Presto containers.
*/
public class PrestoContainerProvider extends JdbcDatabaseContainerProvider {

public static final String USER_PARAM = "user";
public static final String PASSWORD_PARAM = "password";

@Override
public boolean supports(String databaseType) {
return databaseType.equals(PrestoContainer.NAME);
}

@Override
public JdbcDatabaseContainer newInstance() {
return newInstance(PrestoContainer.DEFAULT_TAG);
}

@Override
public JdbcDatabaseContainer newInstance(String tag) {
return new PrestoContainer(PrestoContainer.IMAGE + ":" + tag);
}

@Override
public JdbcDatabaseContainer newInstance(ConnectionUrl connectionUrl) {
return newInstanceFromConnectionUrl(connectionUrl, USER_PARAM, PASSWORD_PARAM);
}

}
@@ -0,0 +1 @@
org.testcontainers.containers.PrestoContainerProvider