From 621ad63a5c741ff9bdfe88204c48a0a727813977 Mon Sep 17 00:00:00 2001 From: yuuteng Date: Tue, 5 Dec 2023 21:22:20 +0100 Subject: [PATCH] Add Snowflake JDBC Connector (#11) Had to redo the connector because all the rebases caused havoc --- core/trino-server/src/main/provisio/trino.xml | 6 + docs/src/main/sphinx/connector.md | 1 + docs/src/main/sphinx/connector/snowflake.md | 96 +++ docs/src/main/sphinx/static/img/snowflake.png | Bin 0 -> 93500 bytes plugin/trino-snowflake/pom.xml | 247 +++++++ .../plugin/snowflake/SnowflakeClient.java | 651 ++++++++++++++++++ .../snowflake/SnowflakeClientModule.java | 95 +++ .../plugin/snowflake/SnowflakeConfig.java | 100 +++ .../plugin/snowflake/SnowflakePlugin.java | 25 + .../snowflake/BaseSnowflakeConnectorTest.java | 610 ++++++++++++++++ .../snowflake/SnowflakeQueryRunner.java | 97 +++ .../plugin/snowflake/TestSnowflakeClient.java | 153 ++++ .../plugin/snowflake/TestSnowflakeConfig.java | 61 ++ .../snowflake/TestSnowflakeConnectorTest.java | 38 + .../plugin/snowflake/TestSnowflakePlugin.java | 33 + .../snowflake/TestSnowflakeTypeMapping.java | 391 +++++++++++ .../snowflake/TestingSnowflakeServer.java | 77 +++ pom.xml | 7 + .../EnvMultinodeAllConnectors.java | 1 + .../environment/EnvMultinodeSnowflake.java | 77 +++ .../launcher/suite/suites/SuiteSnowflake.java | 37 + .../multinode-all/snowflake.properties | 4 + .../multinode-snowflake/snowflake.properties | 4 + .../io/trino/tests/product/TestGroups.java | 1 + .../product/snowflake/TestSnowflake.java | 46 ++ 25 files changed, 2858 insertions(+) create mode 100644 docs/src/main/sphinx/connector/snowflake.md create mode 100644 docs/src/main/sphinx/static/img/snowflake.png create mode 100644 plugin/trino-snowflake/pom.xml create mode 100644 plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClient.java create mode 100644 plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClientModule.java create mode 100644 plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeConfig.java create mode 100644 plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakePlugin.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/BaseSnowflakeConnectorTest.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/SnowflakeQueryRunner.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeClient.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConfig.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConnectorTest.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakePlugin.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeTypeMapping.java create mode 100644 plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestingSnowflakeServer.java create mode 100644 testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeSnowflake.java create mode 100644 testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/suite/suites/SuiteSnowflake.java create mode 100644 testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-all/snowflake.properties create mode 100644 testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-snowflake/snowflake.properties create mode 100644 testing/trino-product-tests/src/main/java/io/trino/tests/product/snowflake/TestSnowflake.java diff --git a/core/trino-server/src/main/provisio/trino.xml b/core/trino-server/src/main/provisio/trino.xml index 519af7a4e53..7cceff9360d 100644 --- a/core/trino-server/src/main/provisio/trino.xml +++ b/core/trino-server/src/main/provisio/trino.xml @@ -290,6 +290,12 @@ + + + + + + diff --git a/docs/src/main/sphinx/connector.md b/docs/src/main/sphinx/connector.md index 3b86e28f3d5..d8dd8253d6d 100644 --- a/docs/src/main/sphinx/connector.md +++ b/docs/src/main/sphinx/connector.md @@ -37,6 +37,7 @@ Prometheus Redis Redshift SingleStore +Snowflake SQL Server System Thrift diff --git a/docs/src/main/sphinx/connector/snowflake.md b/docs/src/main/sphinx/connector/snowflake.md new file mode 100644 index 00000000000..579764534e2 --- /dev/null +++ b/docs/src/main/sphinx/connector/snowflake.md @@ -0,0 +1,96 @@ +# Snowflake connector + +```{raw} html + +``` + +The Snowflake connector allows querying and creating tables in an +external [Snowflake](https://www.snowflake.com/) account. This can be used to join data between +different systems like Snowflake and Hive, or between two different +Snowflake accounts. + +## Configuration + +To configure the Snowflake connector, create a catalog properties file +in `etc/catalog` named, for example, `example.properties`, to +mount the Snowflake connector as the `snowflake` catalog. +Create the file with the following contents, replacing the +connection properties as appropriate for your setup: + +```none +connector.name=snowflake +connection-url=jdbc:snowflake://.snowflakecomputing.com +connection-user=root +connection-password=secret +snowflake.account=account +snowflake.database=database +snowflake.role=role +snowflake.warehouse=warehouse +``` + +### Arrow serialization support + +This is an experimental feature which introduces support for using Apache Arrow +as the serialization format when reading from Snowflake. Please note there are +a few caveats: + +- Using Apache Arrow serialization is disabled by default. In order to enable + it, add `--add-opens=java.base/java.nio=ALL-UNNAMED` to the Trino + {ref}`jvm-config`. + +### Multiple Snowflake databases or accounts + +The Snowflake connector can only access a single database within +a Snowflake account. Thus, if you have multiple Snowflake databases, +or want to connect to multiple Snowflake accounts, you must configure +multiple instances of the Snowflake connector. + +% snowflake-type-mapping: + +## Type mapping + +Trino supports the following Snowflake data types: + +| Snowflake Type | Trino Type | +| -------------- | -------------- | +| `boolean` | `boolean` | +| `tinyint` | `bigint` | +| `smallint` | `bigint` | +| `byteint` | `bigint` | +| `int` | `bigint` | +| `integer` | `bigint` | +| `bigint` | `bigint` | +| `float` | `real` | +| `real` | `real` | +| `double` | `double` | +| `decimal` | `decimal(P,S)` | +| `varchar(n)` | `varchar(n)` | +| `char(n)` | `varchar(n)` | +| `binary(n)` | `varbinary` | +| `varbinary` | `varbinary` | +| `date` | `date` | +| `time` | `time` | +| `timestampntz` | `timestamp` | +| `timestamptz` | `timestampTZ` | +| `timestampltz` | `timestampTZ` | + +Complete list of [Snowflake data types](https://docs.snowflake.com/en/sql-reference/intro-summary-data-types.html). + +(snowflake-sql-support)= + +## SQL support + +The connector provides read access and write access to data and metadata in +a Snowflake database. In addition to the {ref}`globally available +` and {ref}`read operation ` +statements, the connector supports the following features: + +- {doc}`/sql/insert` +- {doc}`/sql/delete` +- {doc}`/sql/truncate` +- {doc}`/sql/create-table` +- {doc}`/sql/create-table-as` +- {doc}`/sql/drop-table` +- {doc}`/sql/alter-table` +- {doc}`/sql/create-schema` +- {doc}`/sql/drop-schema` diff --git a/docs/src/main/sphinx/static/img/snowflake.png b/docs/src/main/sphinx/static/img/snowflake.png new file mode 100644 index 0000000000000000000000000000000000000000..b337bc4d5a779c77e0c63cdf302ba793d235cc2c GIT binary patch literal 93500 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 literal 0 HcmV?d00001 diff --git a/plugin/trino-snowflake/pom.xml b/plugin/trino-snowflake/pom.xml new file mode 100644 index 00000000000..2a61433fe13 --- /dev/null +++ b/plugin/trino-snowflake/pom.xml @@ -0,0 +1,247 @@ + + + 4.0.0 + + + io.trino + trino-root + 435-SNAPSHOT + ../../pom.xml + + + trino-snowflake + trino-plugin + Trino - Snowflake Connector + + + ${project.parent.basedir} + + + + + com.google.guava + guava + + + + com.google.inject + guice + + + + io.airlift + configuration + + + + io.airlift + log + + + + io.trino + trino-base-jdbc + + + + io.trino + trino-plugin-toolkit + + + + net.snowflake + snowflake-jdbc + 3.13.32 + + + + + com.fasterxml.jackson.core + jackson-annotations + provided + + + + io.airlift + slice + provided + + + + io.opentelemetry + opentelemetry-api + provided + + + + io.opentelemetry + opentelemetry-context + provided + + + + io.trino + trino-spi + provided + + + + org.openjdk.jol + jol-core + provided + + + + + io.airlift + testing + test + + + + io.trino + trino-base-jdbc + test-jar + test + + + + io.trino + trino-main + test + + + + io.trino + trino-main + test-jar + test + + + + io.trino + trino-testing + test + + + + io.trino + trino-testing-services + test + + + + io.trino + trino-tpch + test + + + + io.trino.tpch + tpch + test + + + + org.assertj + assertj-core + test + + + + org.jetbrains + annotations + test + + + + org.junit.jupiter + junit-jupiter-api + test + + + + org.junit.jupiter + junit-jupiter-engine + test + + + + org.testcontainers + jdbc + test + + + + org.testcontainers + testcontainers + test + + + + org.testng + testng + test + + + + + + + org.apache.maven.plugins + maven-surefire-plugin + + --add-opens=java.base/java.nio=ALL-UNNAMED + + + + + + + + default + + true + + + + + org.apache.maven.plugins + maven-surefire-plugin + + + **/TestSnowflakeClient.java + **/TestSnowflakeConfig.java + **/TestSnowflakeConnectorTest.java + **/TestSnowflakePlugin.java + **/TestSnowflakeTypeMapping.java + + + + + + + + + + cloud-tests + + + + org.apache.maven.plugins + maven-surefire-plugin + + + **/TestSnowflakeClient.java + **/TestSnowflakeConfig.java + **/TestSnowflakeConnectorTest.java + **/TestSnowflakePlugin.java + **/TestSnowflakeTypeMapping.java + + + + + + + + diff --git a/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClient.java b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClient.java new file mode 100644 index 00000000000..56d41e6d246 --- /dev/null +++ b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClient.java @@ -0,0 +1,651 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableMap; +import com.google.common.collect.ImmutableSet; +import com.google.inject.Inject; +import io.airlift.log.Logger; +import io.airlift.slice.Slices; +import io.trino.plugin.base.aggregation.AggregateFunctionRewriter; +import io.trino.plugin.base.aggregation.AggregateFunctionRule; +import io.trino.plugin.base.expression.ConnectorExpressionRewriter; +import io.trino.plugin.base.mapping.IdentifierMapping; +import io.trino.plugin.jdbc.BaseJdbcClient; +import io.trino.plugin.jdbc.BaseJdbcConfig; +import io.trino.plugin.jdbc.ColumnMapping; +import io.trino.plugin.jdbc.ConnectionFactory; +import io.trino.plugin.jdbc.JdbcColumnHandle; +import io.trino.plugin.jdbc.JdbcExpression; +import io.trino.plugin.jdbc.JdbcTableHandle; +import io.trino.plugin.jdbc.JdbcTypeHandle; +import io.trino.plugin.jdbc.LongWriteFunction; +import io.trino.plugin.jdbc.ObjectReadFunction; +import io.trino.plugin.jdbc.ObjectWriteFunction; +import io.trino.plugin.jdbc.PredicatePushdownController; +import io.trino.plugin.jdbc.QueryBuilder; +import io.trino.plugin.jdbc.SliceReadFunction; +import io.trino.plugin.jdbc.SliceWriteFunction; +import io.trino.plugin.jdbc.StandardColumnMappings; +import io.trino.plugin.jdbc.WriteMapping; +import io.trino.plugin.jdbc.aggregation.ImplementAvgDecimal; +import io.trino.plugin.jdbc.aggregation.ImplementAvgFloatingPoint; +import io.trino.plugin.jdbc.aggregation.ImplementCount; +import io.trino.plugin.jdbc.aggregation.ImplementCountAll; +import io.trino.plugin.jdbc.aggregation.ImplementMinMax; +import io.trino.plugin.jdbc.aggregation.ImplementSum; +import io.trino.plugin.jdbc.expression.JdbcConnectorExpressionRewriterBuilder; +import io.trino.plugin.jdbc.expression.ParameterizedExpression; +import io.trino.plugin.jdbc.logging.RemoteQueryModifier; +import io.trino.spi.TrinoException; +import io.trino.spi.connector.AggregateFunction; +import io.trino.spi.connector.ColumnHandle; +import io.trino.spi.connector.ConnectorSession; +import io.trino.spi.type.CharType; +import io.trino.spi.type.Chars; +import io.trino.spi.type.DateTimeEncoding; +import io.trino.spi.type.DateType; +import io.trino.spi.type.DecimalType; +import io.trino.spi.type.LongTimestamp; +import io.trino.spi.type.LongTimestampWithTimeZone; +import io.trino.spi.type.StandardTypes; +import io.trino.spi.type.TimeType; +import io.trino.spi.type.TimeZoneKey; +import io.trino.spi.type.TimestampType; +import io.trino.spi.type.TimestampWithTimeZoneType; +import io.trino.spi.type.Timestamps; +import io.trino.spi.type.Type; +import io.trino.spi.type.TypeManager; +import io.trino.spi.type.TypeSignature; +import io.trino.spi.type.VarcharType; + +import java.math.RoundingMode; +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Time; +import java.sql.Timestamp; +import java.sql.Types; +import java.time.Instant; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.time.LocalTime; +import java.time.ZoneId; +import java.time.ZoneOffset; +import java.time.ZonedDateTime; +import java.time.format.DateTimeFormatter; +import java.util.Calendar; +import java.util.Date; +import java.util.GregorianCalendar; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.TimeZone; +import java.util.function.BiFunction; + +import static com.google.common.base.Preconditions.checkArgument; +import static com.google.common.util.concurrent.MoreExecutors.directExecutor; +import static io.airlift.slice.Slices.utf8Slice; +import static io.trino.plugin.base.util.JsonTypeUtil.jsonParse; +import static io.trino.plugin.jdbc.JdbcErrorCode.JDBC_ERROR; +import static io.trino.plugin.jdbc.PredicatePushdownController.DISABLE_PUSHDOWN; +import static io.trino.spi.StandardErrorCode.NOT_SUPPORTED; + +public class SnowflakeClient + extends BaseJdbcClient +{ + /* TIME supports an optional precision parameter for fractional seconds, e.g. TIME(3). Time precision can range from 0 (seconds) to 9 (nanoseconds). The default precision is 9. + All TIME values must be between 00:00:00 and 23:59:59.999999999. TIME internally stores “wallclock” time, and all operations on TIME values are performed without taking any time zone into consideration. + */ + private static final int SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION = 9; + private static final Logger log = Logger.get(SnowflakeClient.class); + private static final DateTimeFormatter SNOWFLAKE_DATETIME_FORMATTER = DateTimeFormatter.ofPattern("y-MM-dd'T'HH:mm:ss.SSSSSSSSSXXX"); + private static final DateTimeFormatter SNOWFLAKE_DATE_FORMATTER = DateTimeFormatter.ofPattern("uuuu-MM-dd"); + private static final DateTimeFormatter SNOWFLAKE_TIMESTAMP_FORMATTER = DateTimeFormatter.ofPattern("y-MM-dd'T'HH:mm:ss.SSSSSSSSS"); + private static final DateTimeFormatter SNOWFLAKE_TIME_FORMATTER = DateTimeFormatter.ofPattern("HH:mm:ss.SSSSSSSSS"); + private final Type jsonType; + private final AggregateFunctionRewriter aggregateFunctionRewriter; + + private interface WriteMappingFunction + { + WriteMapping convert(Type type); + } + + private interface ColumnMappingFunction + { + Optional convert(JdbcTypeHandle typeHandle); + } + + private static final TimeZone UTC_TZ = TimeZone.getTimeZone(ZoneId.of("UTC")); + // Mappings for JDBC column types to internal Trino types + private static final Map STANDARD_COLUMN_MAPPINGS = ImmutableMap.builder() + .put(Types.BOOLEAN, StandardColumnMappings.booleanColumnMapping()) + .put(Types.TINYINT, StandardColumnMappings.tinyintColumnMapping()) + .put(Types.SMALLINT, StandardColumnMappings.smallintColumnMapping()) + .put(Types.INTEGER, StandardColumnMappings.integerColumnMapping()) + .put(Types.BIGINT, StandardColumnMappings.bigintColumnMapping()) + .put(Types.REAL, StandardColumnMappings.realColumnMapping()) + .put(Types.DOUBLE, StandardColumnMappings.doubleColumnMapping()) + .put(Types.FLOAT, StandardColumnMappings.doubleColumnMapping()) + .put(Types.BINARY, StandardColumnMappings.varbinaryColumnMapping()) + .put(Types.VARBINARY, StandardColumnMappings.varbinaryColumnMapping()) + .put(Types.LONGVARBINARY, StandardColumnMappings.varbinaryColumnMapping()) + .buildOrThrow(); + + private static final Map SHOWFLAKE_COLUMN_MAPPINGS = ImmutableMap.builder() + .put("time", typeHandle -> { + //return Optional.of(columnMappingPushdown(timeColumnMapping(typeHandle))); + return Optional.of(timeColumnMapping(typeHandle)); + }) + .put("timestampntz", typeHandle -> { + return Optional.of(timestampColumnMapping(typeHandle)); + }) + .put("timestamptz", typeHandle -> { + return Optional.of(timestampTZColumnMapping(typeHandle)); + }) + .put("timestampltz", typeHandle -> { + return Optional.of(timestampTZColumnMapping(typeHandle)); + }) + .put("date", typeHandle -> { + return Optional.of(ColumnMapping.longMapping( + DateType.DATE, (resultSet, columnIndex) -> + LocalDate.ofEpochDay(resultSet.getLong(columnIndex)).toEpochDay(), + snowFlakeDateWriter())); + }) + .put("object", typeHandle -> { + return Optional.of(ColumnMapping.sliceMapping( + VarcharType.createUnboundedVarcharType(), + StandardColumnMappings.varcharReadFunction(VarcharType.createUnboundedVarcharType()), + StandardColumnMappings.varcharWriteFunction(), + PredicatePushdownController.DISABLE_PUSHDOWN)); + }) + .put("array", typeHandle -> { + return Optional.of(ColumnMapping.sliceMapping( + VarcharType.createUnboundedVarcharType(), + StandardColumnMappings.varcharReadFunction(VarcharType.createUnboundedVarcharType()), + StandardColumnMappings.varcharWriteFunction(), + PredicatePushdownController.DISABLE_PUSHDOWN)); + }) + .put("variant", typeHandle -> { + return Optional.of(ColumnMapping.sliceMapping( + VarcharType.createUnboundedVarcharType(), variantReadFunction(), StandardColumnMappings.varcharWriteFunction(), + PredicatePushdownController.FULL_PUSHDOWN)); + }) + .put("varchar", typeHandle -> { + return Optional.of(varcharColumnMapping(typeHandle.getRequiredColumnSize())); + }) + .put("number", typeHandle -> { + int decimalDigits = typeHandle.getRequiredDecimalDigits(); + int precision = typeHandle.getRequiredColumnSize() + Math.max(-decimalDigits, 0); + if (precision > 38) { + return Optional.empty(); + } + return Optional.of(columnMappingPushdown( + StandardColumnMappings.decimalColumnMapping(DecimalType.createDecimalType( + precision, Math.max(decimalDigits, 0)), RoundingMode.UNNECESSARY))); + }) + .buildOrThrow(); + + // Mappings for internal Trino types to JDBC column types + private static final Map STANDARD_WRITE_MAPPINGS = ImmutableMap.builder() + .put("BooleanType", WriteMapping.booleanMapping("boolean", StandardColumnMappings.booleanWriteFunction())) + .put("BigintType", WriteMapping.longMapping("number(19)", StandardColumnMappings.bigintWriteFunction())) + .put("IntegerType", WriteMapping.longMapping("number(10)", StandardColumnMappings.integerWriteFunction())) + .put("SmallintType", WriteMapping.longMapping("number(5)", StandardColumnMappings.smallintWriteFunction())) + .put("TinyintType", WriteMapping.longMapping("number(3)", StandardColumnMappings.tinyintWriteFunction())) + .put("DoubleType", WriteMapping.doubleMapping("double precision", StandardColumnMappings.doubleWriteFunction())) + .put("RealType", WriteMapping.longMapping("real", StandardColumnMappings.realWriteFunction())) + .put("VarbinaryType", WriteMapping.sliceMapping("varbinary", StandardColumnMappings.varbinaryWriteFunction())) + .put("DateType", WriteMapping.longMapping("date", snowFlakeDateWriter())) + .buildOrThrow(); + + private static final Map SNOWFLAKE_WRITE_MAPPINGS = ImmutableMap.builder() + .put("TimeType", type -> { + return WriteMapping.longMapping("time", SnowflakeClient.snowFlaketimeWriter(type)); + }) + .put("ShortTimestampType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeTimestampWriter(type); + return myMap; + }) + .put("ShortTimestampWithTimeZoneType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeTimestampWithTZWriter(type); + return myMap; + }) + .put("LongTimestampType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeTimestampWithTZWriter(type); + return myMap; + }) + .put("LongTimestampWithTimeZoneType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeTimestampWithTZWriter(type); + return myMap; + }) + .put("VarcharType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeVarCharWriter(type); + return myMap; + }) + .put("CharType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeCharWriter(type); + return myMap; + }) + .put("LongDecimalType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeDecimalWriter(type); + return myMap; + }) + .put("ShortDecimalType", type -> { + WriteMapping myMap = SnowflakeClient.snowFlakeDecimalWriter(type); + return myMap; + }) + .buildOrThrow(); + + @Inject + public SnowflakeClient(BaseJdbcConfig config, ConnectionFactory connectionFactory, QueryBuilder queryBuilder, + TypeManager typeManager, IdentifierMapping identifierMapping, + RemoteQueryModifier remoteQueryModifier) + { + super("\"", connectionFactory, queryBuilder, config.getJdbcTypesMappedToVarchar(), identifierMapping, remoteQueryModifier, false); + this.jsonType = typeManager.getType(new TypeSignature(StandardTypes.JSON)); + + JdbcTypeHandle bigintTypeHandle = new JdbcTypeHandle(Types.BIGINT, Optional.of("bigint"), Optional.empty(), Optional.empty(), Optional.empty(), Optional.empty()); + ConnectorExpressionRewriter connectorExpressionRewriter = JdbcConnectorExpressionRewriterBuilder.newBuilder() + .addStandardRules(this::quoted) + .build(); + + this.aggregateFunctionRewriter = new AggregateFunctionRewriter<>( + connectorExpressionRewriter, + ImmutableSet.>builder() + .add(new ImplementCountAll(bigintTypeHandle)) + .add(new ImplementCount(bigintTypeHandle)) + .add(new ImplementMinMax(false)) + .add(new ImplementSum(SnowflakeClient::toTypeHandle)) + .add(new ImplementAvgFloatingPoint()) + .add(new ImplementAvgDecimal()) + .build()); + } + + @Override + public void abortReadConnection(Connection connection, ResultSet resultSet) + throws SQLException + { + // Abort connection before closing. Without this, the Snowflake driver + // attempts to drain the connection by reading all the results. + connection.abort(directExecutor()); + } + + @Override + public Optional toColumnMapping(ConnectorSession session, Connection connection, JdbcTypeHandle typeHandle) + { + String jdbcTypeName = typeHandle.getJdbcTypeName() + .orElseThrow(() -> new TrinoException(JDBC_ERROR, "Type name is missing: " + typeHandle)); + jdbcTypeName = jdbcTypeName.toLowerCase(Locale.ENGLISH); + int type = typeHandle.getJdbcType(); + + ColumnMapping columnMap = STANDARD_COLUMN_MAPPINGS.get(type); + if (columnMap != null) { + return Optional.of(columnMap); + } + + ColumnMappingFunction columnMappingFunction = SHOWFLAKE_COLUMN_MAPPINGS.get(jdbcTypeName); + if (columnMappingFunction != null) { + return columnMappingFunction.convert(typeHandle); + } + + // Code should never reach here so throw an error. + throw new TrinoException(NOT_SUPPORTED, "SNOWFLAKE_CONNECTOR_COLUMN_TYPE_NOT_SUPPORTED: Unsupported column type(" + type + + "):" + jdbcTypeName); + } + + @Override + public WriteMapping toWriteMapping(ConnectorSession session, Type type) + { + Class myClass = type.getClass(); + String simple = myClass.getSimpleName(); + + WriteMapping writeMapping = STANDARD_WRITE_MAPPINGS.get(simple); + if (writeMapping != null) { + return writeMapping; + } + + WriteMappingFunction writeMappingFunction = SNOWFLAKE_WRITE_MAPPINGS.get(simple); + if (writeMappingFunction != null) { + return writeMappingFunction.convert(type); + } + + log.debug("SnowflakeClient.toWriteMapping: SNOWFLAKE_CONNECTOR_COLUMN_TYPE_NOT_SUPPORTED: Unsupported column type: " + type.getDisplayName() + ", simple:" + simple); + + throw new TrinoException(NOT_SUPPORTED, "SNOWFLAKE_CONNECTOR_COLUMN_TYPE_NOT_SUPPORTED: Unsupported column type: " + type.getDisplayName() + ", simple:" + simple); + } + + @Override + public Optional implementAggregation(ConnectorSession session, AggregateFunction aggregate, Map assignments) + { + // TODO support complex ConnectorExpressions + return aggregateFunctionRewriter.rewrite(session, aggregate, assignments); + } + + private static Optional toTypeHandle(DecimalType decimalType) + { + return Optional.of(new JdbcTypeHandle(Types.NUMERIC, Optional.of("decimal"), Optional.of(decimalType.getPrecision()), Optional.of(decimalType.getScale()), Optional.empty(), Optional.empty())); + } + + @Override + protected Optional> limitFunction() + { + return Optional.of((sql, limit) -> sql + " LIMIT " + limit); + } + + @Override + public boolean isLimitGuaranteed(ConnectorSession session) + { + return true; + } + + private ColumnMapping jsonColumnMapping() + { + return ColumnMapping.sliceMapping( + jsonType, + (resultSet, columnIndex) -> jsonParse(utf8Slice(resultSet.getString(columnIndex))), + StandardColumnMappings.varcharWriteFunction(), + DISABLE_PUSHDOWN); + } + + @Override + public void setColumnType(ConnectorSession session, JdbcTableHandle handle, JdbcColumnHandle column, Type type) + { + throw new TrinoException(NOT_SUPPORTED, "This connector does not support setting column types"); + } + + private static SliceReadFunction variantReadFunction() + { + return (resultSet, columnIndex) -> Slices.utf8Slice(resultSet.getString(columnIndex).replaceAll("^\"|\"$", "")); + } + + private static ColumnMapping columnMappingPushdown(ColumnMapping mapping) + { + if (mapping.getPredicatePushdownController() == PredicatePushdownController.DISABLE_PUSHDOWN) { + log.debug("SnowflakeClient.columnMappingPushdown: NOT_SUPPORTED mapping.getPredicatePushdownController() is DISABLE_PUSHDOWN. Type was " + mapping.getType()); + throw new TrinoException(NOT_SUPPORTED, "mapping.getPredicatePushdownController() is DISABLE_PUSHDOWN. Type was " + mapping.getType()); + } + + return new ColumnMapping(mapping.getType(), mapping.getReadFunction(), mapping.getWriteFunction(), + PredicatePushdownController.FULL_PUSHDOWN); + } + + private static ColumnMapping timeColumnMapping(JdbcTypeHandle typeHandle) + { + int precision = typeHandle.getRequiredDecimalDigits(); + checkArgument((precision <= SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION), + "The max timestamp precision in Snowflake is " + SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION); + return ColumnMapping.longMapping( + TimeType.createTimeType(precision), + (resultSet, columnIndex) -> { + LocalTime time = SNOWFLAKE_TIME_FORMATTER.parse(resultSet.getString(columnIndex), LocalTime::from); + long nanosOfDay = time.toNanoOfDay(); + long picosOfDay = nanosOfDay * Timestamps.PICOSECONDS_PER_NANOSECOND; + return Timestamps.round(picosOfDay, 12 - precision); + }, + timeWriteFunction(precision), + PredicatePushdownController.FULL_PUSHDOWN); + } + + private static LongWriteFunction snowFlaketimeWriter(Type type) + { + TimeType timeType = (TimeType) type; + int precision = timeType.getPrecision(); + return timeWriteFunction(precision); + } + + private static LongWriteFunction timeWriteFunction(int precision) + { + checkArgument(precision <= SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION, "Unsupported precision: %s", precision); + String bindExpression = String.format("CAST(? AS time(%s))", precision); + return new LongWriteFunction() + { + @Override + public String getBindExpression() + { + return bindExpression; + } + + @Override + public void set(PreparedStatement statement, int index, long picosOfDay) + throws SQLException + { + picosOfDay = Timestamps.round(picosOfDay, 12 - precision); + if (picosOfDay == Timestamps.PICOSECONDS_PER_DAY) { + picosOfDay = 0; + } + LocalTime localTime = LocalTime.ofNanoOfDay(picosOfDay / Timestamps.PICOSECONDS_PER_NANOSECOND); + // statement.setObject(.., localTime) would yield incorrect end result for 23:59:59.999000 + statement.setString(index, SNOWFLAKE_TIME_FORMATTER.format(localTime)); + } + }; + } + + private static long toTrinoTime(Time sqlTime) + { + return Timestamps.PICOSECONDS_PER_SECOND * sqlTime.getTime(); + } + + private static ColumnMapping timestampTZColumnMapping(JdbcTypeHandle typeHandle) + { + int precision = typeHandle.getRequiredDecimalDigits(); + String jdbcTypeName = typeHandle.getJdbcTypeName() + .orElseThrow(() -> new TrinoException(JDBC_ERROR, "Type name is missing: " + typeHandle)); + int type = typeHandle.getJdbcType(); + log.debug("timestampTZColumnMapping: jdbcTypeName(%s):%s precision:%s", type, jdbcTypeName, precision); + + if (precision <= 3) { + return ColumnMapping.longMapping(TimestampWithTimeZoneType.createTimestampWithTimeZoneType(precision), + (resultSet, columnIndex) -> { + ZonedDateTime timestamp = (ZonedDateTime) SNOWFLAKE_DATETIME_FORMATTER.parse(resultSet.getString(columnIndex), ZonedDateTime::from); + return DateTimeEncoding.packDateTimeWithZone(timestamp.toInstant().toEpochMilli(), timestamp.getZone().getId()); + }, + timestampWithTZWriter(), PredicatePushdownController.FULL_PUSHDOWN); + } + else { + return ColumnMapping.objectMapping(TimestampWithTimeZoneType.createTimestampWithTimeZoneType(precision), longTimestampWithTimezoneReadFunction(), longTimestampWithTZWriteFunction()); + } + } + + private static ColumnMapping varcharColumnMapping(int varcharLength) + { + VarcharType varcharType = varcharLength <= VarcharType.MAX_LENGTH + ? VarcharType.createVarcharType(varcharLength) + : VarcharType.createUnboundedVarcharType(); + return ColumnMapping.sliceMapping( + varcharType, + StandardColumnMappings.varcharReadFunction(varcharType), + StandardColumnMappings.varcharWriteFunction()); + } + + private static ObjectReadFunction longTimestampWithTimezoneReadFunction() + { + return ObjectReadFunction.of(LongTimestampWithTimeZone.class, (resultSet, columnIndex) -> { + ZonedDateTime timestamp = (ZonedDateTime) SNOWFLAKE_DATETIME_FORMATTER.parse(resultSet.getString(columnIndex), ZonedDateTime::from); + return LongTimestampWithTimeZone.fromEpochSecondsAndFraction(timestamp.toEpochSecond(), + (long) timestamp.getNano() * Timestamps.PICOSECONDS_PER_NANOSECOND, + TimeZoneKey.getTimeZoneKey(timestamp.getZone().getId())); + }); + } + + private static ObjectWriteFunction longTimestampWithTZWriteFunction() + { + return ObjectWriteFunction.of(LongTimestampWithTimeZone.class, (statement, index, value) -> { + long epoMilli = value.getEpochMillis(); + long epoSeconds = Math.floorDiv(epoMilli, Timestamps.MILLISECONDS_PER_SECOND); + long adjNano = Math.floorMod(epoMilli, Timestamps.MILLISECONDS_PER_SECOND) * + Timestamps.NANOSECONDS_PER_MILLISECOND + value.getPicosOfMilli() / Timestamps.PICOSECONDS_PER_NANOSECOND; + ZoneId zone = TimeZoneKey.getTimeZoneKey(value.getTimeZoneKey()).getZoneId(); + Instant timeI = Instant.ofEpochSecond(epoSeconds, adjNano); + statement.setString(index, SNOWFLAKE_DATETIME_FORMATTER.format(ZonedDateTime.ofInstant(timeI, zone))); + }); + } + + private static LongWriteFunction snowFlakeDateTimeWriter() + { + return (statement, index, encodedTimeWithZone) -> { + Instant time = Instant.ofEpochMilli(DateTimeEncoding.unpackMillisUtc(encodedTimeWithZone)); + ZoneId zone = ZoneId.of(DateTimeEncoding.unpackZoneKey(encodedTimeWithZone).getId()); + statement.setString(index, SNOWFLAKE_DATETIME_FORMATTER.format(time.atZone(zone))); + }; + } + + private static WriteMapping snowFlakeDecimalWriter(Type type) + { + DecimalType decimalType = (DecimalType) type; + String dataType = String.format("decimal(%s, %s)", new Object[] { + Integer.valueOf(decimalType.getPrecision()), Integer.valueOf(decimalType.getScale()) + }); + + if (decimalType.isShort()) { + return WriteMapping.longMapping(dataType, StandardColumnMappings.shortDecimalWriteFunction(decimalType)); + } + return WriteMapping.objectMapping(dataType, StandardColumnMappings.longDecimalWriteFunction(decimalType)); + } + + private static LongWriteFunction snowFlakeDateWriter() + { + return (statement, index, day) -> statement.setString(index, SNOWFLAKE_DATE_FORMATTER.format(LocalDate.ofEpochDay(day))); + } + + private static WriteMapping snowFlakeCharWriter(Type type) + { + CharType charType = (CharType) type; + return WriteMapping.sliceMapping("char(" + charType.getLength() + ")", + charWriteFunction(charType)); + } + + private static WriteMapping snowFlakeVarCharWriter(Type type) + { + String dataType; + VarcharType varcharType = (VarcharType) type; + + if (varcharType.isUnbounded()) { + dataType = "varchar"; + } + else { + dataType = "varchar(" + varcharType.getBoundedLength() + ")"; + } + return WriteMapping.sliceMapping(dataType, StandardColumnMappings.varcharWriteFunction()); + } + + private static SliceWriteFunction charWriteFunction(CharType charType) + { + return (statement, index, value) -> statement.setString(index, Chars.padSpaces(value, charType).toStringUtf8()); + } + + private static WriteMapping snowFlakeTimestampWriter(Type type) + { + TimestampType timestampType = (TimestampType) type; + checkArgument((timestampType.getPrecision() <= SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION), + "The max timestamp precision in Snowflake is " + SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION); + + if (timestampType.isShort()) { + return WriteMapping.longMapping( + String.format("timestamp_ntz(%d)", new Object[] {Integer.valueOf(timestampType.getPrecision()) }), + timestampWriteFunction()); + } + return WriteMapping.objectMapping( + String.format("timestamp_ntz(%d)", new Object[] {Integer.valueOf(timestampType.getPrecision()) }), + longTimestampWriter(timestampType.getPrecision())); + } + + private static LongWriteFunction timestampWriteFunction() + { + return (statement, index, value) -> statement.setString(index, + StandardColumnMappings.fromTrinoTimestamp(value).toString()); + } + + private static ObjectWriteFunction longTimestampWriter(int precision) + { + return ObjectWriteFunction.of(LongTimestamp.class, + (statement, index, value) -> statement.setString(index, + SNOWFLAKE_TIMESTAMP_FORMATTER.format(StandardColumnMappings.fromLongTrinoTimestamp(value, + precision)))); + } + + private static WriteMapping snowFlakeTimestampWithTZWriter(Type type) + { + TimestampWithTimeZoneType timeTZType = (TimestampWithTimeZoneType) type; + + checkArgument((timeTZType.getPrecision() <= SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION), + "Max Snowflake precision is is " + SNOWFLAKE_MAX_SUPPORTED_TIMESTAMP_PRECISION); + if (timeTZType.isShort()) { + return WriteMapping.longMapping(String.format("timestamp_tz(%d)", + new Object[] {Integer.valueOf(timeTZType.getPrecision()) }), + timestampWithTZWriter()); + } + return WriteMapping.objectMapping( + String.format("timestamp_tz(%d)", new Object[] {Integer.valueOf(timeTZType.getPrecision()) }), + longTimestampWithTZWriteFunction()); + } + + private static LongWriteFunction timestampWithTZWriter() + { + return (statement, index, encodedTimeWithZone) -> { + Instant timeI = Instant.ofEpochMilli(DateTimeEncoding.unpackMillisUtc(encodedTimeWithZone)); + ZoneId zone = ZoneId.of(DateTimeEncoding.unpackZoneKey(encodedTimeWithZone).getId()); + statement.setString(index, SNOWFLAKE_DATETIME_FORMATTER.format(timeI.atZone(zone))); + }; + } + + private static ObjectReadFunction longTimestampReader() + { + return ObjectReadFunction.of(LongTimestamp.class, (resultSet, columnIndex) -> { + Calendar calendar = new GregorianCalendar(UTC_TZ, Locale.ENGLISH); + calendar.setTime(new Date(0)); + Timestamp ts = resultSet.getTimestamp(columnIndex, calendar); + long epochMillis = ts.getTime(); + int nanosInTheSecond = ts.getNanos(); + int nanosInTheMilli = nanosInTheSecond % Timestamps.NANOSECONDS_PER_MILLISECOND; + long micro = epochMillis * Timestamps.MICROSECONDS_PER_MILLISECOND + (nanosInTheMilli / Timestamps.NANOSECONDS_PER_MICROSECOND); + int picosOfMicro = nanosInTheMilli % 1000 * 1000; + return new LongTimestamp(micro, picosOfMicro); + }); + } + + private static ColumnMapping timestampColumnMapping(JdbcTypeHandle typeHandle) + { + int precision = typeHandle.getRequiredDecimalDigits(); + String jdbcTypeName = typeHandle.getJdbcTypeName() + .orElseThrow(() -> new TrinoException(JDBC_ERROR, "Type name is missing: " + typeHandle)); + int type = typeHandle.getJdbcType(); + log.debug("timestampColumnMapping: jdbcTypeName(%s):%s precision:%s", type, jdbcTypeName, precision); + + // <= 6 fits into a long + if (precision <= 6) { + return ColumnMapping.longMapping( + (Type) TimestampType.createTimestampType(precision), (resultSet, columnIndex) -> + StandardColumnMappings.toTrinoTimestamp(TimestampType.createTimestampType(precision), + toLocalDateTime(resultSet, columnIndex)), + timestampWriteFunction()); + } + + // Too big. Put it in an object + return ColumnMapping.objectMapping( + (Type) TimestampType.createTimestampType(precision), + longTimestampReader(), + longTimestampWriter(precision)); + } + + private static LocalDateTime toLocalDateTime(ResultSet resultSet, int columnIndex) + throws SQLException + { + Calendar calendar = new GregorianCalendar(UTC_TZ, Locale.ENGLISH); + calendar.setTime(new Date(0)); + Timestamp ts = resultSet.getTimestamp(columnIndex, calendar); + return LocalDateTime.ofInstant(Instant.ofEpochMilli(ts.getTime()), ZoneOffset.UTC); + } +} diff --git a/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClientModule.java b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClientModule.java new file mode 100644 index 00000000000..19fc3584719 --- /dev/null +++ b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeClientModule.java @@ -0,0 +1,95 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.inject.Binder; +import com.google.inject.Module; +import com.google.inject.Provides; +import com.google.inject.Scopes; +import com.google.inject.Singleton; +import io.trino.plugin.jdbc.BaseJdbcConfig; +import io.trino.plugin.jdbc.ConnectionFactory; +import io.trino.plugin.jdbc.DriverConnectionFactory; +import io.trino.plugin.jdbc.ForBaseJdbc; +import io.trino.plugin.jdbc.JdbcClient; +import io.trino.plugin.jdbc.TypeHandlingJdbcConfig; +import io.trino.plugin.jdbc.credential.CredentialProvider; +import io.trino.spi.TrinoException; +import net.snowflake.client.jdbc.SnowflakeDriver; + +import java.net.MalformedURLException; +import java.net.URL; +import java.util.Properties; + +import static io.airlift.configuration.ConfigBinder.configBinder; +import static io.trino.spi.StandardErrorCode.NOT_SUPPORTED; + +public class SnowflakeClientModule + implements Module +{ + @Override + public void configure(Binder binder) + { + binder.bind(JdbcClient.class).annotatedWith(ForBaseJdbc.class).to(SnowflakeClient.class).in(Scopes.SINGLETON); + configBinder(binder).bindConfig(SnowflakeConfig.class); + configBinder(binder).bindConfig(TypeHandlingJdbcConfig.class); + } + + @Singleton + @Provides + @ForBaseJdbc + public ConnectionFactory getConnectionFactory(BaseJdbcConfig baseJdbcConfig, SnowflakeConfig snowflakeConfig, CredentialProvider credentialProvider) + throws MalformedURLException + { + Properties properties = new Properties(); + snowflakeConfig.getAccount().ifPresent(account -> properties.setProperty("account", account)); + snowflakeConfig.getDatabase().ifPresent(database -> properties.setProperty("db", database)); + snowflakeConfig.getRole().ifPresent(role -> properties.setProperty("role", role)); + snowflakeConfig.getWarehouse().ifPresent(warehouse -> properties.setProperty("warehouse", warehouse)); + + // Set the expected date/time formatting we expect for our plugin to parse + properties.setProperty("TIMESTAMP_OUTPUT_FORMAT", "YYYY-MM-DD\"T\"HH24:MI:SS.FF9TZH:TZM"); + properties.setProperty("TIMESTAMP_NTZ_OUTPUT_FORMAT", "YYYY-MM-DD\"T\"HH24:MI:SS.FF9TZH:TZM"); + properties.setProperty("TIMESTAMP_TZ_OUTPUT_FORMAT", "YYYY-MM-DD\"T\"HH24:MI:SS.FF9TZH:TZM"); + properties.setProperty("TIMESTAMP_LTZ_OUTPUT_FORMAT", "YYYY-MM-DD\"T\"HH24:MI:SS.FF9TZH:TZM"); + properties.setProperty("TIME_OUTPUT_FORMAT", "HH24:MI:SS.FF9"); + snowflakeConfig.getTimestampNoTimezoneAsUTC().ifPresent(as_utc -> properties.setProperty("JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC", as_utc ? "true" : "false")); + + // Support for Corporate proxies + if (snowflakeConfig.getHTTPProxy().isPresent()) { + String proxy = snowflakeConfig.getHTTPProxy().get(); + + URL url = new URL(proxy); + + properties.setProperty("useProxy", "true"); + properties.setProperty("proxyHost", url.getHost()); + properties.setProperty("proxyPort", Integer.toString(url.getPort())); + properties.setProperty("proxyProtocol", url.getProtocol()); + + String userInfo = url.getUserInfo(); + if (userInfo != null) { + String[] usernamePassword = userInfo.split(":", 2); + + if (usernamePassword.length != 2) { + throw new TrinoException(NOT_SUPPORTED, "Improper snowflake.http_proxy. username:password@ is optional but what was entered was not correct"); + } + + properties.setProperty("proxyUser", usernamePassword[0]); + properties.setProperty("proxyPassword", usernamePassword[1]); + } + } + + return new DriverConnectionFactory(new SnowflakeDriver(), baseJdbcConfig.getConnectionUrl(), properties, credentialProvider); + } +} diff --git a/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeConfig.java b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeConfig.java new file mode 100644 index 00000000000..6dbf1252017 --- /dev/null +++ b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakeConfig.java @@ -0,0 +1,100 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import io.airlift.configuration.Config; + +import java.util.Optional; + +public class SnowflakeConfig +{ + private String account; + private String database; + private String role; + private String warehouse; + private Boolean timestampNoTimezoneAsUTC; + private String httpProxy; + + public Optional getAccount() + { + return Optional.ofNullable(account); + } + + @Config("snowflake.account") + public SnowflakeConfig setAccount(String account) + { + this.account = account; + return this; + } + + public Optional getDatabase() + { + return Optional.ofNullable(database); + } + + @Config("snowflake.database") + public SnowflakeConfig setDatabase(String database) + { + this.database = database; + return this; + } + + public Optional getRole() + { + return Optional.ofNullable(role); + } + + @Config("snowflake.role") + public SnowflakeConfig setRole(String role) + { + this.role = role; + return this; + } + + public Optional getWarehouse() + { + return Optional.ofNullable(warehouse); + } + + @Config("snowflake.warehouse") + public SnowflakeConfig setWarehouse(String warehouse) + { + this.warehouse = warehouse; + return this; + } + + public Optional getTimestampNoTimezoneAsUTC() + { + return Optional.ofNullable(timestampNoTimezoneAsUTC); + } + + @Config("snowflake.timestamp-no-timezone-as-utc") + public SnowflakeConfig setTimestampNoTimezoneAsUTC(Boolean timestampNoTimezoneAsUTC) + { + this.timestampNoTimezoneAsUTC = timestampNoTimezoneAsUTC; + return this; + } + + public Optional getHTTPProxy() + { + return Optional.ofNullable(httpProxy); + } + + @Config("snowflake.http-proxy") + public SnowflakeConfig setHTTPProxy(String httpProxy) + { + this.httpProxy = httpProxy; + return this; + } +} diff --git a/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakePlugin.java b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakePlugin.java new file mode 100644 index 00000000000..728264d2977 --- /dev/null +++ b/plugin/trino-snowflake/src/main/java/io/trino/plugin/snowflake/SnowflakePlugin.java @@ -0,0 +1,25 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import io.trino.plugin.jdbc.JdbcPlugin; + +public class SnowflakePlugin + extends JdbcPlugin +{ + public SnowflakePlugin() + { + super("snowflake", new SnowflakeClientModule()); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/BaseSnowflakeConnectorTest.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/BaseSnowflakeConnectorTest.java new file mode 100644 index 00000000000..b547624cebe --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/BaseSnowflakeConnectorTest.java @@ -0,0 +1,610 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import io.trino.Session; +import io.trino.plugin.jdbc.BaseJdbcConnectorTest; +import io.trino.testing.MaterializedResult; +import io.trino.testing.TestingConnectorBehavior; +import io.trino.testing.sql.TestTable; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.junit.jupiter.api.parallel.Execution; + +import java.util.Optional; +import java.util.OptionalInt; + +import static com.google.common.base.Strings.nullToEmpty; +import static io.trino.plugin.snowflake.TestingSnowflakeServer.TEST_SCHEMA; +import static io.trino.spi.connector.ConnectorMetadata.MODIFYING_ROWS_MESSAGE; +import static io.trino.spi.type.VarcharType.VARCHAR; +import static io.trino.testing.MaterializedResult.resultBuilder; +import static io.trino.testing.TestingConnectorBehavior.SUPPORTS_CREATE_TABLE; +import static io.trino.testing.TestingConnectorBehavior.SUPPORTS_CREATE_TABLE_WITH_DATA; +import static io.trino.testing.TestingNames.randomNameSuffix; +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assumptions.abort; +import static org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS; +import static org.junit.jupiter.api.parallel.ExecutionMode.CONCURRENT; + +@TestInstance(PER_CLASS) +@Execution(CONCURRENT) +public abstract class BaseSnowflakeConnectorTest + extends BaseJdbcConnectorTest +{ + protected TestingSnowflakeServer server; + + @Override + protected boolean hasBehavior(TestingConnectorBehavior connectorBehavior) + { + switch (connectorBehavior) { + case SUPPORTS_AGGREGATION_PUSHDOWN: + case SUPPORTS_TOPN_PUSHDOWN: + case SUPPORTS_LIMIT_PUSHDOWN: + return false; + case SUPPORTS_COMMENT_ON_COLUMN: + case SUPPORTS_ADD_COLUMN_WITH_COMMENT: + case SUPPORTS_COMMENT_ON_TABLE: + case SUPPORTS_CREATE_TABLE_WITH_TABLE_COMMENT: + case SUPPORTS_CREATE_TABLE_WITH_COLUMN_COMMENT: + case SUPPORTS_SET_COLUMN_TYPE: + return false; + case SUPPORTS_DROP_FIELD: + case SUPPORTS_ROW_TYPE: + case SUPPORTS_ARRAY: + return false; + default: + return super.hasBehavior(connectorBehavior); + } + } + + @Override + protected TestTable createTableWithDefaultColumns() + { + return new TestTable( + onRemoteDatabase(), + TEST_SCHEMA, + "(col_required BIGINT NOT NULL," + + "col_nullable BIGINT," + + "col_default BIGINT DEFAULT 43," + + "col_nonnull_default BIGINT NOT NULL DEFAULT 42," + + "col_required2 BIGINT NOT NULL)"); + } + + @Override + protected TestTable createTableWithUnsupportedColumn() + { + return new TestTable( + onRemoteDatabase(), + TEST_SCHEMA, + "(one bigint, two decimal(38,0), three varchar(10))"); + } + + @Override + protected Optional filterDataMappingSmokeTestData(DataMappingTestSetup dataMappingTestSetup) + { + String typeName = dataMappingTestSetup.getTrinoTypeName(); + // TODO: Test fails with these types + // Error: No result for query: SELECT row_id FROM test_data_mapping_smoke_real_3u8xo6hp59 WHERE rand() = 42 OR value = REAL '567.123' + // In the testDataMappingSmokeTestDataProvider(), the type sampleValueLiteral of type real should be "DOUBLE" rather than "REAL". + if (typeName.equals("real")) { + return Optional.empty(); + } + // Error: Failed to insert data: SQL compilation error: error line 1 at position 130 + if (typeName.equals("time") + || typeName.equals("time(6)") + || typeName.equals("timestamp(6)")) { + return Optional.empty(); + } + // Error: not equal + if (typeName.equals("char(3)")) { + return Optional.empty(); + } + return Optional.of(dataMappingTestSetup); + } + + @Override + protected boolean isColumnNameRejected(Exception exception, String columnName, boolean delimited) + { + return nullToEmpty(exception.getMessage()).matches(".*(Incorrect column name).*"); + } + + @Override + protected MaterializedResult getDescribeOrdersResult() + { + // Override this test because the type of row "shippriority" should be bigint rather than integer for snowflake case + return resultBuilder(getSession(), VARCHAR, VARCHAR, VARCHAR, VARCHAR) + .row("orderkey", "bigint", "", "") + .row("custkey", "bigint", "", "") + .row("orderstatus", "varchar(1)", "", "") + .row("totalprice", "double", "", "") + .row("orderdate", "date", "", "") + .row("orderpriority", "varchar(15)", "", "") + .row("clerk", "varchar(15)", "", "") + .row("shippriority", "bigint", "", "") + .row("comment", "varchar(79)", "", "") + .build(); + } + + @Test + @Override + public void testShowColumns() + { + assertThat(query("SHOW COLUMNS FROM orders")).matches(getDescribeOrdersResult()); + } + + @Test + public void testViews() + { + String tableName = "test_view_" + randomNameSuffix(); + onRemoteDatabase().execute("CREATE OR REPLACE VIEW tpch." + tableName + " AS SELECT * FROM tpch.orders"); + assertQuery("SELECT orderkey FROM " + tableName, "SELECT orderkey FROM orders"); + onRemoteDatabase().execute("DROP VIEW IF EXISTS tpch." + tableName); + } + + @Test + @Override + public void testShowCreateTable() + { + // Override this test because the type of row "shippriority" should be bigint rather than integer for snowflake case + assertThat(computeActual("SHOW CREATE TABLE orders").getOnlyValue()) + .isEqualTo("CREATE TABLE snowflake.tpch.orders (\n" + + " orderkey bigint,\n" + + " custkey bigint,\n" + + " orderstatus varchar(1),\n" + + " totalprice double,\n" + + " orderdate date,\n" + + " orderpriority varchar(15),\n" + + " clerk varchar(15),\n" + + " shippriority bigint,\n" + + " comment varchar(79)\n" + + ")\n" + + "COMMENT ''"); + } + + @Test + @Override + public void testAddNotNullColumn() + { + assertThatThrownBy(super::testAddNotNullColumn) + .isInstanceOf(AssertionError.class) + .hasMessage("Unexpected failure when adding not null column"); + } + + @Test + @Override + public void testCharVarcharComparison() + { + assertThatThrownBy(super::testCharVarcharComparison) + .hasMessageContaining("For query") + .hasMessageContaining("Actual rows") + .hasMessageContaining("Expected rows"); + } + + @Test + @Override + public void testCountDistinctWithStringTypes() + { + abort("TODO"); + } + + @Test + @Override + public void testInsertInPresenceOfNotSupportedColumn() + { + abort("TODO"); + } + + @Test + @Override + public void testAggregationPushdown() + { + abort("TODO"); + } + + @Test + @Override + public void testDistinctAggregationPushdown() + { + abort("TODO"); + } + + @Test + @Override + public void testNumericAggregationPushdown() + { + abort("TODO"); + } + + @Test + @Override + public void testLimitPushdown() + { + abort("TODO"); + } + + @Test + @Override + public void testInsertIntoNotNullColumn() + { + // TODO: java.lang.UnsupportedOperationException: This method should be overridden + assertThatThrownBy(super::testInsertIntoNotNullColumn); + } + + @Test + @Override + public void testDeleteWithLike() + { + assertThatThrownBy(super::testDeleteWithLike) + .hasStackTraceContaining("TrinoException: " + MODIFYING_ROWS_MESSAGE); + } + + @Test + @Override + public void testCreateTableAsSelect() + { + String tableName = "test_ctas" + randomNameSuffix(); + if (!hasBehavior(SUPPORTS_CREATE_TABLE_WITH_DATA)) { + assertQueryFails("CREATE TABLE IF NOT EXISTS " + tableName + " AS SELECT name, regionkey FROM nation", "This connector does not support creating tables with data"); + return; + } + assertUpdate("CREATE TABLE IF NOT EXISTS " + tableName + " AS SELECT name, regionkey FROM nation", "SELECT count(*) FROM nation"); + assertTableColumnNames(tableName, "name", "regionkey"); + + assertEquals(getTableComment(getSession().getCatalog().orElseThrow(), getSession().getSchema().orElseThrow(), tableName), ""); + assertUpdate("DROP TABLE " + tableName); + + // Some connectors support CREATE TABLE AS but not the ordinary CREATE TABLE. Let's test CTAS IF NOT EXISTS with a table that is guaranteed to exist. + assertUpdate("CREATE TABLE IF NOT EXISTS nation AS SELECT nationkey, regionkey FROM nation", 0); + assertTableColumnNames("nation", "nationkey", "name", "regionkey", "comment"); + + assertCreateTableAsSelect( + "SELECT nationkey, name, regionkey FROM nation", + "SELECT count(*) FROM nation"); + + assertCreateTableAsSelect( + "SELECT mktsegment, sum(acctbal) x FROM customer GROUP BY mktsegment", + "SELECT count(DISTINCT mktsegment) FROM customer"); + + assertCreateTableAsSelect( + "SELECT count(*) x FROM nation JOIN region ON nation.regionkey = region.regionkey", + "SELECT 1"); + + assertCreateTableAsSelect( + "SELECT nationkey FROM nation ORDER BY nationkey LIMIT 10", + "SELECT 10"); + + assertCreateTableAsSelect( + "SELECT * FROM nation WITH DATA", + "SELECT * FROM nation", + "SELECT count(*) FROM nation"); + + assertCreateTableAsSelect( + "SELECT * FROM nation WITH NO DATA", + "SELECT * FROM nation LIMIT 0", + "SELECT 0"); + + // Tests for CREATE TABLE with UNION ALL: exercises PushTableWriteThroughUnion optimizer + + assertCreateTableAsSelect( + "SELECT name, nationkey, regionkey FROM nation WHERE nationkey % 2 = 0 UNION ALL " + + "SELECT name, nationkey, regionkey FROM nation WHERE nationkey % 2 = 1", + "SELECT name, nationkey, regionkey FROM nation", + "SELECT count(*) FROM nation"); + + assertCreateTableAsSelect( + Session.builder(getSession()).setSystemProperty("redistribute_writes", "true").build(), + "SELECT CAST(nationkey AS BIGINT) nationkey, regionkey FROM nation UNION ALL " + + "SELECT 1234567890, 123", + "SELECT nationkey, regionkey FROM nation UNION ALL " + + "SELECT 1234567890, 123", + "SELECT count(*) + 1 FROM nation"); + + assertCreateTableAsSelect( + Session.builder(getSession()).setSystemProperty("redistribute_writes", "false").build(), + "SELECT CAST(nationkey AS BIGINT) nationkey, regionkey FROM nation UNION ALL " + + "SELECT 1234567890, 123", + "SELECT nationkey, regionkey FROM nation UNION ALL " + + "SELECT 1234567890, 123", + "SELECT count(*) + 1 FROM nation"); + + // TODO: BigQuery throws table not found at BigQueryClient.insert if we reuse the same table name + tableName = "test_ctas" + randomNameSuffix(); + assertExplainAnalyze("EXPLAIN ANALYZE CREATE TABLE " + tableName + " AS SELECT name FROM nation"); + assertQuery("SELECT * from " + tableName, "SELECT name FROM nation"); + assertUpdate("DROP TABLE " + tableName); + } + + @Test + @Override + public void testCreateTable() + { + String tableName = "test_create_" + randomNameSuffix(); + if (!hasBehavior(SUPPORTS_CREATE_TABLE)) { + assertQueryFails("CREATE TABLE " + tableName + " (a bigint, b double, c varchar(50))", "This connector does not support creating tables"); + return; + } + + assertThat(computeActual("SHOW TABLES").getOnlyColumnAsSet()) // prime the cache, if any + .doesNotContain(tableName); + assertUpdate("CREATE TABLE " + tableName + " (a bigint, b double, c varchar(50))"); + assertTrue(getQueryRunner().tableExists(getSession(), tableName)); + assertThat(computeActual("SHOW TABLES").getOnlyColumnAsSet()) + .contains(tableName); + assertTableColumnNames(tableName, "a", "b", "c"); + assertEquals(getTableComment(getSession().getCatalog().orElseThrow(), getSession().getSchema().orElseThrow(), tableName), ""); + + assertUpdate("DROP TABLE " + tableName); + assertFalse(getQueryRunner().tableExists(getSession(), tableName)); + assertThat(computeActual("SHOW TABLES").getOnlyColumnAsSet()) + .doesNotContain(tableName); + + assertQueryFails("CREATE TABLE " + tableName + " (a bad_type)", ".* Unknown type 'bad_type' for column 'a'"); + assertFalse(getQueryRunner().tableExists(getSession(), tableName)); + + // TODO (https://github.com/trinodb/trino/issues/5901) revert to longer name when Oracle version is updated + tableName = "test_cr_not_exists_" + randomNameSuffix(); + assertUpdate("CREATE TABLE " + tableName + " (a bigint, b varchar(50), c double)"); + assertTrue(getQueryRunner().tableExists(getSession(), tableName)); + assertTableColumnNames(tableName, "a", "b", "c"); + + assertUpdate("CREATE TABLE IF NOT EXISTS " + tableName + " (d bigint, e varchar(50))"); + assertTrue(getQueryRunner().tableExists(getSession(), tableName)); + assertTableColumnNames(tableName, "a", "b", "c"); + + assertUpdate("DROP TABLE " + tableName); + assertFalse(getQueryRunner().tableExists(getSession(), tableName)); + + // Test CREATE TABLE LIKE + tableName = "test_create_orig_" + randomNameSuffix(); + assertUpdate("CREATE TABLE " + tableName + " (a bigint, b double, c varchar(50))"); + assertTrue(getQueryRunner().tableExists(getSession(), tableName)); + assertTableColumnNames(tableName, "a", "b", "c"); + + String tableNameLike = "test_create_like_" + randomNameSuffix(); + assertUpdate("CREATE TABLE " + tableNameLike + " (LIKE " + tableName + ", d bigint, e varchar(50))"); + assertTrue(getQueryRunner().tableExists(getSession(), tableNameLike)); + assertTableColumnNames(tableNameLike, "a", "b", "c", "d", "e"); + + assertUpdate("DROP TABLE " + tableName); + assertFalse(getQueryRunner().tableExists(getSession(), tableName)); + + assertUpdate("DROP TABLE " + tableNameLike); + assertFalse(getQueryRunner().tableExists(getSession(), tableNameLike)); + } + + @Test + @Override + public void testNativeQueryCreateStatement() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQueryInsertStatementTableExists() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQuerySelectUnsupportedType() + { + abort("TODO"); + } + + @Test + @Override + public void testCreateTableWithLongColumnName() + { + String tableName = "test_long_column" + randomNameSuffix(); + String baseColumnName = "col"; + + int maxLength = maxColumnNameLength() + // Assume 2^16 is enough for most use cases. Add a bit more to ensure 2^16 isn't actual limit. + .orElse(65536 + 5); + + String validColumnName = baseColumnName + "z".repeat(maxLength - baseColumnName.length()); + assertUpdate("CREATE TABLE " + tableName + " (" + validColumnName + " bigint)"); + assertTrue(columnExists(tableName, validColumnName)); + assertUpdate("DROP TABLE " + tableName); + + if (maxColumnNameLength().isEmpty()) { + return; + } + assertFalse(getQueryRunner().tableExists(getSession(), tableName)); + } + + @Test + @Override + public void testCreateTableWithLongTableName() + { + // TODO: Find the maximum table name length in Snowflake and enable this test. + abort("TODO"); + } + + @Override + protected OptionalInt maxColumnNameLength() + { + return OptionalInt.of(251); + } + + @Test + @Override + public void testAlterTableAddLongColumnName() + { + String tableName = "test_long_column" + randomNameSuffix(); + assertUpdate("CREATE TABLE " + tableName + " AS SELECT 123 x", 1); + + String baseColumnName = "col"; + int maxLength = maxColumnNameLength() + // Assume 2^16 is enough for most use cases. Add a bit more to ensure 2^16 isn't actual limit. + .orElse(65536 + 5); + + String validTargetColumnName = baseColumnName + "z".repeat(maxLength - baseColumnName.length()); + assertUpdate("ALTER TABLE " + tableName + " ADD COLUMN " + validTargetColumnName + " int"); + assertTrue(getQueryRunner().tableExists(getSession(), tableName)); + assertQuery("SELECT x FROM " + tableName, "VALUES 123"); + assertUpdate("DROP TABLE " + tableName); + + if (maxColumnNameLength().isEmpty()) { + return; + } + + assertUpdate("CREATE TABLE " + tableName + " AS SELECT 123 x", 1); + assertQuery("SELECT x FROM " + tableName, "VALUES 123"); + } + + @Test + @Override + public void testAlterTableRenameColumnToLongName() + { + String tableName = "test_long_column" + randomNameSuffix(); + assertUpdate("CREATE TABLE " + tableName + " AS SELECT 123 x", 1); + + String baseColumnName = "col"; + int maxLength = maxColumnNameLength() + // Assume 2^16 is enough for most use cases. Add a bit more to ensure 2^16 isn't actual limit. + .orElse(65536 + 5); + + String validTargetColumnName = baseColumnName + "z".repeat(maxLength - baseColumnName.length()); + assertUpdate("ALTER TABLE " + tableName + " RENAME COLUMN x TO " + validTargetColumnName); + assertQuery("SELECT " + validTargetColumnName + " FROM " + tableName, "VALUES 123"); + assertUpdate("DROP TABLE " + tableName); + + if (maxColumnNameLength().isEmpty()) { + return; + } + + assertUpdate("CREATE TABLE " + tableName + " AS SELECT 123 x", 1); + assertQuery("SELECT x FROM " + tableName, "VALUES 123"); + } + + @Test + @Override + public void testCreateSchemaWithLongName() + { + // TODO: Find the maximum table schema length in Snowflake and enable this test. + abort("TODO"); + } + + @Test + @Override + public void testInsertArray() + { + // Snowflake does not support this feature. + abort("Not supported"); + } + + @Test + @Override + public void testInsertRowConcurrently() + { + abort("TODO: Connection is already closed"); + } + + @Test + @Override + public void testNativeQueryColumnAlias() + { + abort("TODO: Table function system.query not registered"); + } + + @Test + @Override + public void testNativeQueryColumnAliasNotFound() + { + abort("TODO: Table function system.query not registered"); + } + + @Test + @Override + public void testNativeQueryIncorrectSyntax() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQueryInsertStatementTableDoesNotExist() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQueryParameters() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQuerySelectFromNation() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQuerySelectFromTestTable() + { + abort("TODO"); + } + + @Test + @Override + public void testNativeQuerySimple() + { + abort("TODO"); + } + + @Test + @Override + public void testRenameSchemaToLongName() + { + // TODO: Find the maximum table schema length in Snowflake and enable this test. + abort("TODO"); + } + + @Test + @Override + public void testRenameTableToLongTableName() + { + // TODO: Find the maximum table length in Snowflake and enable this test. + abort("TODO"); + } + + @Test + @Override + public void testCharTrailingSpace() + { + assertThatThrownBy(super::testCharVarcharComparison) + .hasMessageContaining("For query") + .hasMessageContaining("Actual rows") + .hasMessageContaining("Expected rows"); + } + + @Test + @Override + public void testDescribeTable() + { + assertThat(query("DESCRIBE orders")).matches(getDescribeOrdersResult()); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/SnowflakeQueryRunner.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/SnowflakeQueryRunner.java new file mode 100644 index 00000000000..a50debaf003 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/SnowflakeQueryRunner.java @@ -0,0 +1,97 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableList; +import com.google.common.collect.ImmutableMap; +import io.airlift.log.Logger; +import io.trino.Session; +import io.trino.plugin.tpch.TpchPlugin; +import io.trino.testing.DistributedQueryRunner; +import io.trino.tpch.TpchTable; + +import java.util.HashMap; +import java.util.Map; + +import static io.airlift.testing.Closeables.closeAllSuppress; +import static io.trino.plugin.tpch.TpchMetadata.TINY_SCHEMA_NAME; +import static io.trino.testing.QueryAssertions.copyTpchTables; +import static io.trino.testing.TestingSession.testSessionBuilder; + +public final class SnowflakeQueryRunner +{ + public static final String TPCH_SCHEMA = "tpch"; + + private SnowflakeQueryRunner() {} + + public static DistributedQueryRunner createSnowflakeQueryRunner( + TestingSnowflakeServer server, + Map extraProperties, + Map connectorProperties, + Iterable> tables) + throws Exception + { + DistributedQueryRunner queryRunner = DistributedQueryRunner.builder(createSession()) + .setExtraProperties(extraProperties) + .build(); + try { + queryRunner.installPlugin(new TpchPlugin()); + queryRunner.createCatalog("tpch", "tpch"); + + connectorProperties = new HashMap<>(ImmutableMap.copyOf(connectorProperties)); + connectorProperties.putIfAbsent("connection-url", TestingSnowflakeServer.TEST_URL); + connectorProperties.putIfAbsent("connection-user", TestingSnowflakeServer.TEST_USER); + connectorProperties.putIfAbsent("connection-password", TestingSnowflakeServer.TEST_PASSWORD); + connectorProperties.putIfAbsent("snowflake.database", TestingSnowflakeServer.TEST_DATABASE); + connectorProperties.putIfAbsent("snowflake.role", TestingSnowflakeServer.TEST_ROLE); + connectorProperties.putIfAbsent("snowflake.warehouse", TestingSnowflakeServer.TEST_WAREHOUSE); + if (TestingSnowflakeServer.TEST_PROXY != null) { + connectorProperties.putIfAbsent("snowflake.httpProxy", TestingSnowflakeServer.TEST_PROXY); + } + + queryRunner.installPlugin(new SnowflakePlugin()); + queryRunner.createCatalog("snowflake", "snowflake", connectorProperties); + + copyTpchTables(queryRunner, "tpch", TINY_SCHEMA_NAME, createSession(), tables); + + return queryRunner; + } + catch (Throwable e) { + closeAllSuppress(e, queryRunner); + throw e; + } + } + + public static Session createSession() + { + return testSessionBuilder() + .setCatalog("snowflake") + .setSchema(TPCH_SCHEMA) + .build(); + } + + public static void main(String[] args) + throws Exception + { + DistributedQueryRunner queryRunner = createSnowflakeQueryRunner( + new TestingSnowflakeServer(), + ImmutableMap.of("http-server.http.port", "8080"), + ImmutableMap.of(), + ImmutableList.of()); + + Logger log = Logger.get(SnowflakeQueryRunner.class); + log.info("======== SERVER STARTED ========"); + log.info("\n====\n%s\n====", queryRunner.getCoordinator().getBaseUrl()); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeClient.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeClient.java new file mode 100644 index 00000000000..b743314af76 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeClient.java @@ -0,0 +1,153 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import io.trino.plugin.base.mapping.DefaultIdentifierMapping; +import io.trino.plugin.jdbc.BaseJdbcConfig; +import io.trino.plugin.jdbc.ColumnMapping; +import io.trino.plugin.jdbc.DefaultQueryBuilder; +import io.trino.plugin.jdbc.JdbcClient; +import io.trino.plugin.jdbc.JdbcColumnHandle; +import io.trino.plugin.jdbc.JdbcExpression; +import io.trino.plugin.jdbc.JdbcTypeHandle; +import io.trino.plugin.jdbc.logging.RemoteQueryModifier; +import io.trino.spi.connector.AggregateFunction; +import io.trino.spi.connector.ColumnHandle; +import io.trino.spi.expression.ConnectorExpression; +import io.trino.spi.expression.Variable; +import org.testng.annotations.Test; + +import java.sql.Types; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import static io.trino.spi.type.BigintType.BIGINT; +import static io.trino.spi.type.BooleanType.BOOLEAN; +import static io.trino.spi.type.DoubleType.DOUBLE; +import static io.trino.testing.TestingConnectorSession.SESSION; +import static io.trino.type.InternalTypeManager.TESTING_TYPE_MANAGER; +import static org.assertj.core.api.Assertions.assertThat; +import static org.testng.Assert.assertEquals; +import static org.testng.Assert.assertTrue; + +public class TestSnowflakeClient +{ + private static final JdbcColumnHandle BIGINT_COLUMN = + JdbcColumnHandle.builder() + .setColumnName("c_bigint") + .setColumnType(BIGINT) + .setJdbcTypeHandle(new JdbcTypeHandle(Types.BIGINT, Optional.of("int8"), Optional.empty(), Optional.empty(), Optional.empty(), Optional.empty())) + .build(); + + private static final JdbcColumnHandle DOUBLE_COLUMN = + JdbcColumnHandle.builder() + .setColumnName("c_double") + .setColumnType(DOUBLE) + .setJdbcTypeHandle(new JdbcTypeHandle(Types.DOUBLE, Optional.of("double"), Optional.empty(), Optional.empty(), Optional.empty(), Optional.empty())) + .build(); + + private static final JdbcClient JDBC_CLIENT = new SnowflakeClient( + new BaseJdbcConfig(), + session -> { throw new UnsupportedOperationException(); }, + new DefaultQueryBuilder(RemoteQueryModifier.NONE), + TESTING_TYPE_MANAGER, + new DefaultIdentifierMapping(), + RemoteQueryModifier.NONE); + + @Test + public void testImplementCount() + { + Variable bigintVariable = new Variable("v_bigint", BIGINT); + Variable doubleVariable = new Variable("v_double", BIGINT); + Optional filter = Optional.of(new Variable("a_filter", BOOLEAN)); + + // count(*) + testImplementAggregation( + new AggregateFunction("count", BIGINT, List.of(), List.of(), false, Optional.empty()), + Map.of(), + Optional.of("count(*)")); + + // count(bigint) + testImplementAggregation( + new AggregateFunction("count", BIGINT, List.of(bigintVariable), List.of(), false, Optional.empty()), + Map.of(bigintVariable.getName(), BIGINT_COLUMN), + Optional.of("count(\"c_bigint\")")); + + // count(double) + testImplementAggregation( + new AggregateFunction("count", BIGINT, List.of(doubleVariable), List.of(), false, Optional.empty()), + Map.of(doubleVariable.getName(), DOUBLE_COLUMN), + Optional.of("count(\"c_double\")")); + + // count() FILTER (WHERE ...) + testImplementAggregation( + new AggregateFunction("count", BIGINT, List.of(), List.of(), false, filter), + Map.of(), + Optional.empty()); + + // count(bigint) FILTER (WHERE ...) + testImplementAggregation( + new AggregateFunction("count", BIGINT, List.of(bigintVariable), List.of(), false, filter), + Map.of(bigintVariable.getName(), BIGINT_COLUMN), + Optional.empty()); + } + + @Test + public void testImplementSum() + { + Variable bigintVariable = new Variable("v_bigint", BIGINT); + Variable doubleVariable = new Variable("v_double", DOUBLE); + Optional filter = Optional.of(new Variable("a_filter", BOOLEAN)); + + // sum(bigint) + testImplementAggregation( + new AggregateFunction("sum", BIGINT, List.of(bigintVariable), List.of(), false, Optional.empty()), + Map.of(bigintVariable.getName(), BIGINT_COLUMN), + Optional.of("sum(\"c_bigint\")")); + + // sum(double) + testImplementAggregation( + new AggregateFunction("sum", DOUBLE, List.of(doubleVariable), List.of(), false, Optional.empty()), + Map.of(doubleVariable.getName(), DOUBLE_COLUMN), + Optional.of("sum(\"c_double\")")); + + // sum(DISTINCT bigint) + testImplementAggregation( + new AggregateFunction("sum", BIGINT, List.of(bigintVariable), List.of(), true, Optional.empty()), + Map.of(bigintVariable.getName(), BIGINT_COLUMN), + Optional.of("sum(DISTINCT \"c_bigint\")")); + + // sum(bigint) FILTER (WHERE ...) + testImplementAggregation( + new AggregateFunction("sum", BIGINT, List.of(bigintVariable), List.of(), false, filter), + Map.of(bigintVariable.getName(), BIGINT_COLUMN), + Optional.empty()); // filter not supported + } + + private static void testImplementAggregation(AggregateFunction aggregateFunction, Map assignments, Optional expectedExpression) + { + Optional result = JDBC_CLIENT.implementAggregation(SESSION, aggregateFunction, assignments); + if (expectedExpression.isEmpty()) { + assertThat(result).isEmpty(); + } + else { + assertThat(result).isPresent(); + assertEquals(result.get().getExpression(), expectedExpression.get()); + Optional columnMapping = JDBC_CLIENT.toColumnMapping(SESSION, null, result.get().getJdbcTypeHandle()); + assertTrue(columnMapping.isPresent(), "No mapping for: " + result.get().getJdbcTypeHandle()); + assertEquals(columnMapping.get().getType(), aggregateFunction.getOutputType()); + } + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConfig.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConfig.java new file mode 100644 index 00000000000..eb5c32a3d06 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConfig.java @@ -0,0 +1,61 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableMap; +import org.testng.annotations.Test; + +import java.util.Map; + +import static io.airlift.configuration.testing.ConfigAssertions.assertFullMapping; +import static io.airlift.configuration.testing.ConfigAssertions.assertRecordedDefaults; +import static io.airlift.configuration.testing.ConfigAssertions.recordDefaults; + +public class TestSnowflakeConfig +{ + @Test + public void testDefaults() + { + assertRecordedDefaults(recordDefaults(SnowflakeConfig.class) + .setAccount(null) + .setDatabase(null) + .setRole(null) + .setWarehouse(null) + .setHTTPProxy(null) + .setTimestampNoTimezoneAsUTC(null)); + } + + @Test + public void testExplicitPropertyMappings() + { + Map properties = ImmutableMap.builder() + .put("snowflake.account", "MYACCOUNT") + .put("snowflake.database", "MYDATABASE") + .put("snowflake.role", "MYROLE") + .put("snowflake.warehouse", "MYWAREHOUSE") + .put("snowflake.http-proxy", "MYPROXY") + .put("snowflake.timestamp-no-timezone-as-utc", "true") + .buildOrThrow(); + + SnowflakeConfig expected = new SnowflakeConfig() + .setAccount("MYACCOUNT") + .setDatabase("MYDATABASE") + .setRole("MYROLE") + .setWarehouse("MYWAREHOUSE") + .setHTTPProxy("MYPROXY") + .setTimestampNoTimezoneAsUTC(true); + + assertFullMapping(properties, expected); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConnectorTest.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConnectorTest.java new file mode 100644 index 00000000000..8b9b0c78c73 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeConnectorTest.java @@ -0,0 +1,38 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableMap; +import io.trino.testing.QueryRunner; +import io.trino.testing.sql.SqlExecutor; + +import static io.trino.plugin.snowflake.SnowflakeQueryRunner.createSnowflakeQueryRunner; + +public class TestSnowflakeConnectorTest + extends BaseSnowflakeConnectorTest +{ + @Override + protected QueryRunner createQueryRunner() + throws Exception + { + server = closeAfterClass(new TestingSnowflakeServer()); + return createSnowflakeQueryRunner(server, ImmutableMap.of(), ImmutableMap.of(), REQUIRED_TPCH_TABLES); + } + + @Override + protected SqlExecutor onRemoteDatabase() + { + return server::execute; + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakePlugin.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakePlugin.java new file mode 100644 index 00000000000..26165c3f018 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakePlugin.java @@ -0,0 +1,33 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableMap; +import io.trino.spi.Plugin; +import io.trino.spi.connector.ConnectorFactory; +import io.trino.testing.TestingConnectorContext; +import org.testng.annotations.Test; + +import static com.google.common.collect.Iterables.getOnlyElement; + +public class TestSnowflakePlugin +{ + @Test + public void testCreateConnector() + { + Plugin plugin = new SnowflakePlugin(); + ConnectorFactory factory = getOnlyElement(plugin.getConnectorFactories()); + factory.create("test", ImmutableMap.of("connection-url", "jdbc:snowflake://test"), new TestingConnectorContext()).shutdown(); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeTypeMapping.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeTypeMapping.java new file mode 100644 index 00000000000..5377e013a6c --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestSnowflakeTypeMapping.java @@ -0,0 +1,391 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import com.google.common.collect.ImmutableList; +import com.google.common.collect.ImmutableMap; +import io.trino.Session; +import io.trino.spi.type.TimeZoneKey; +import io.trino.testing.AbstractTestQueryFramework; +import io.trino.testing.QueryRunner; +import io.trino.testing.TestingSession; +import io.trino.testing.datatype.CreateAndInsertDataSetup; +import io.trino.testing.datatype.CreateAsSelectDataSetup; +import io.trino.testing.datatype.DataSetup; +import io.trino.testing.datatype.SqlDataTypeTest; +import io.trino.testing.sql.TrinoSqlExecutor; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.junit.jupiter.api.parallel.Execution; + +import java.time.LocalDate; +import java.time.ZoneId; + +import static com.google.common.base.Preconditions.checkState; +import static com.google.common.base.Verify.verify; +import static io.trino.plugin.snowflake.SnowflakeQueryRunner.createSnowflakeQueryRunner; +import static io.trino.spi.type.BigintType.BIGINT; +import static io.trino.spi.type.BooleanType.BOOLEAN; +import static io.trino.spi.type.DateType.DATE; +import static io.trino.spi.type.DecimalType.createDecimalType; +import static io.trino.spi.type.DoubleType.DOUBLE; +import static io.trino.spi.type.TimeZoneKey.getTimeZoneKey; +import static io.trino.spi.type.TimestampType.createTimestampType; +import static io.trino.spi.type.VarbinaryType.VARBINARY; +import static io.trino.spi.type.VarcharType.createVarcharType; +import static java.time.ZoneOffset.UTC; +import static org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS; +import static org.junit.jupiter.api.parallel.ExecutionMode.CONCURRENT; + +@TestInstance(PER_CLASS) +@Execution(CONCURRENT) +public class TestSnowflakeTypeMapping + extends AbstractTestQueryFramework +{ + protected TestingSnowflakeServer snowflakeServer; + + private final ZoneId jvmZone = ZoneId.systemDefault(); + // no DST in 1970, but has DST in later years (e.g. 2018) + private final ZoneId vilnius = ZoneId.of("Europe/Vilnius"); + // minutes offset change since 1970-01-01, no DST + private final ZoneId kathmandu = ZoneId.of("Asia/Kathmandu"); + + @BeforeAll + public void setUp() + { + String zone = jvmZone.getId(); + checkState(jvmZone.getId().equals("America/Bahia_Banderas"), "Timezone not configured correctly. Add -Duser.timezone=America/Bahia_Banderas to your JVM arguments"); + checkIsGap(jvmZone, LocalDate.of(1970, 1, 1)); + checkIsGap(vilnius, LocalDate.of(1983, 4, 1)); + verify(vilnius.getRules().getValidOffsets(LocalDate.of(1983, 10, 1).atStartOfDay().minusMinutes(1)).size() == 2); + } + + @Override + protected QueryRunner createQueryRunner() + throws Exception + { + snowflakeServer = new TestingSnowflakeServer(); + return createSnowflakeQueryRunner( + snowflakeServer, + ImmutableMap.of(), + ImmutableMap.of(), + ImmutableList.of()); + } + + @Test + public void testBoolean() + { + SqlDataTypeTest.create() + .addRoundTrip("boolean", "true", BOOLEAN, "BOOLEAN '1'") + .addRoundTrip("boolean", "false", BOOLEAN, "BOOLEAN '0'") + .addRoundTrip("boolean", "NULL", BOOLEAN, "CAST(NULL AS BOOLEAN)") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_boolean")) + .execute(getQueryRunner(), trinoCreateAsSelect("tpch.test_boolean")) + .execute(getQueryRunner(), trinoCreateAndInsert("tpch.test_boolean")); + } + + @Test + public void testInteger() + { + // INT , INTEGER , BIGINT , SMALLINT , TINYINT , BYTEINT, DECIMAL , NUMERIC are aliases for NUMBER(38, 0) in snowflake + // https://docs.snowflake.com/en/sql-reference/data-types-numeric.html#int-integer-bigint-smallint-tinyint-byteint + testInteger("INT"); + testInteger("INTEGER"); + testInteger("BIGINT"); + testInteger("SMALLINT"); + testInteger("TINYINT"); + testInteger("BYTEINT"); + } + + private void testInteger(String inputType) + { + SqlDataTypeTest.create() + .addRoundTrip(inputType, "-9223372036854775808", BIGINT, "-9223372036854775808") + .addRoundTrip(inputType, "9223372036854775807", BIGINT, "9223372036854775807") + .addRoundTrip(inputType, "0", BIGINT, "CAST(0 AS BIGINT)") + .addRoundTrip(inputType, "NULL", BIGINT, "CAST(NULL AS BIGINT)") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.integer")); + } + + @Test + public void testDecimal() + { + SqlDataTypeTest.create() + .addRoundTrip("decimal(3, 0)", "NULL", BIGINT, "CAST(NULL AS BIGINT)") + .addRoundTrip("decimal(3, 0)", "CAST('193' AS decimal(3, 0))", BIGINT, "CAST('193' AS BIGINT)") + .addRoundTrip("decimal(3, 0)", "CAST('19' AS decimal(3, 0))", BIGINT, "CAST('19' AS BIGINT)") + .addRoundTrip("decimal(3, 0)", "CAST('-193' AS decimal(3, 0))", BIGINT, "CAST('-193' AS BIGINT)") + .addRoundTrip("decimal(3, 1)", "CAST('10.0' AS decimal(3, 1))", createDecimalType(3, 1), "CAST('10.0' AS decimal(3, 1))") + .addRoundTrip("decimal(3, 1)", "CAST('10.1' AS decimal(3, 1))", createDecimalType(3, 1), "CAST('10.1' AS decimal(3, 1))") + .addRoundTrip("decimal(3, 1)", "CAST('-10.1' AS decimal(3, 1))", createDecimalType(3, 1), "CAST('-10.1' AS decimal(3, 1))") + .addRoundTrip("decimal(4, 2)", "CAST('2' AS decimal(4, 2))", createDecimalType(4, 2), "CAST('2' AS decimal(4, 2))") + .addRoundTrip("decimal(4, 2)", "CAST('2.3' AS decimal(4, 2))", createDecimalType(4, 2), "CAST('2.3' AS decimal(4, 2))") + .addRoundTrip("decimal(24, 2)", "CAST('2' AS decimal(24, 2))", createDecimalType(24, 2), "CAST('2' AS decimal(24, 2))") + .addRoundTrip("decimal(24, 2)", "CAST('2.3' AS decimal(24, 2))", createDecimalType(24, 2), "CAST('2.3' AS decimal(24, 2))") + .addRoundTrip("decimal(24, 2)", "CAST('123456789.3' AS decimal(24, 2))", createDecimalType(24, 2), "CAST('123456789.3' AS decimal(24, 2))") + .addRoundTrip("decimal(24, 4)", "CAST('12345678901234567890.31' AS decimal(24, 4))", createDecimalType(24, 4), "CAST('12345678901234567890.31' AS decimal(24, 4))") + .addRoundTrip("decimal(30, 5)", "CAST('3141592653589793238462643.38327' AS decimal(30, 5))", createDecimalType(30, 5), "CAST('3141592653589793238462643.38327' AS decimal(30, 5))") + .addRoundTrip("decimal(30, 5)", "CAST('-3141592653589793238462643.38327' AS decimal(30, 5))", createDecimalType(30, 5), "CAST('-3141592653589793238462643.38327' AS decimal(30, 5))") + .addRoundTrip("decimal(38, 0)", "CAST(NULL AS decimal(38, 0))", BIGINT, "CAST(NULL AS BIGINT)") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_decimal")) + .execute(getQueryRunner(), trinoCreateAsSelect("test_decimal")) + .execute(getQueryRunner(), trinoCreateAndInsert("test_decimal")); + } + + @Test + public void testFloat() + { + // https://docs.snowflake.com/en/sql-reference/data-types-numeric.html#float-float4-float8 + SqlDataTypeTest.create() + .addRoundTrip("real", "3.14", DOUBLE, "DOUBLE '3.14'") + .addRoundTrip("real", "10.3e0", DOUBLE, "DOUBLE '10.3e0'") + .addRoundTrip("real", "NULL", DOUBLE, "CAST(NULL AS DOUBLE)") + .addRoundTrip("real", "CAST('NaN' AS DOUBLE)", DOUBLE, "nan()") + .addRoundTrip("real", "CAST('Infinity' AS DOUBLE)", DOUBLE, "+infinity()") + .addRoundTrip("real", "CAST('-Infinity' AS DOUBLE)", DOUBLE, "-infinity()") + .execute(getQueryRunner(), trinoCreateAsSelect("tpch.test_real")) + .execute(getQueryRunner(), trinoCreateAndInsert("tpch.test_real")); + + SqlDataTypeTest.create() + .addRoundTrip("float", "3.14", DOUBLE, "DOUBLE '3.14'") + .addRoundTrip("float", "10.3e0", DOUBLE, "DOUBLE '10.3e0'") + .addRoundTrip("float", "NULL", DOUBLE, "CAST(NULL AS DOUBLE)") + .addRoundTrip("float", "CAST('NaN' AS float)", DOUBLE, "nan()") + .addRoundTrip("float", "CAST('Infinity' AS float)", DOUBLE, "+infinity()") + .addRoundTrip("float", "CAST('-Infinity' AS float)", DOUBLE, "-infinity()") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_float")); + } + + @Test + public void testDouble() + { + SqlDataTypeTest.create() + .addRoundTrip("double", "3.14", DOUBLE, "CAST(3.14 AS DOUBLE)") + .addRoundTrip("double", "1.0E100", DOUBLE, "1.0E100") + .addRoundTrip("double", "1.23456E12", DOUBLE, "1.23456E12") + .addRoundTrip("double", "NULL", DOUBLE, "CAST(NULL AS DOUBLE)") + .addRoundTrip("double", "CAST('NaN' AS DOUBLE)", DOUBLE, "nan()") + .addRoundTrip("double", "CAST('Infinity' AS DOUBLE)", DOUBLE, "+infinity()") + .addRoundTrip("double", "CAST('-Infinity' AS DOUBLE)", DOUBLE, "-infinity()") + .execute(getQueryRunner(), trinoCreateAsSelect("trino_test_double")) + .execute(getQueryRunner(), trinoCreateAndInsert("trino_test_double")) + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_double")); + } + + @Test + public void testSnowflakeCreatedParameterizedVarchar() + { + SqlDataTypeTest.create() + .addRoundTrip("text", "'b'", createVarcharType(16777216), "CAST('b' AS VARCHAR(16777216))") + .addRoundTrip("varchar(32)", "'e'", createVarcharType(32), "CAST('e' AS VARCHAR(32))") + .addRoundTrip("varchar(15000)", "'f'", createVarcharType(15000), "CAST('f' AS VARCHAR(15000))") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.snowflake_test_parameterized_varchar")); + } + + @Test + public void testSnowflakeCreatedParameterizedVarcharUnicode() + { + SqlDataTypeTest.create() + .addRoundTrip("text collate \'utf8\'", "'攻殻機動隊'", createVarcharType(16777216), "CAST('攻殻機動隊' AS VARCHAR(16777216))") + .addRoundTrip("varchar(5) collate \'utf8\'", "'攻殻機動隊'", createVarcharType(5), "CAST('攻殻機動隊' AS VARCHAR(5))") + .addRoundTrip("varchar(32) collate \'utf8\'", "'攻殻機動隊'", createVarcharType(32), "CAST('攻殻機動隊' AS VARCHAR(32))") + .addRoundTrip("varchar(20000) collate \'utf8\'", "'攻殻機動隊'", createVarcharType(20000), "CAST('攻殻機動隊' AS VARCHAR(20000))") + .addRoundTrip("varchar(1) collate \'utf8mb4\'", "'😂'", createVarcharType(1), "CAST('😂' AS VARCHAR(1))") + .addRoundTrip("varchar(77) collate \'utf8mb4\'", "'Ну, погоди!'", createVarcharType(77), "CAST('Ну, погоди!' AS VARCHAR(77))") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.snowflake_test_parameterized_varchar_unicode")); + } + + @Test + public void testParameterizedChar() + { + SqlDataTypeTest.create() + .addRoundTrip("char", "''", createVarcharType(1), "CAST(' ' AS varchar(1))") + .addRoundTrip("char", "'a'", createVarcharType(1), "CAST('a' AS varchar(1))") + .addRoundTrip("char(1)", "''", createVarcharType(1), "CAST(' ' AS varchar(1))") + .addRoundTrip("char(1)", "'a'", createVarcharType(1), "CAST('a' AS varchar(1))") + .addRoundTrip("char(8)", "'abc'", createVarcharType(8), "CAST('abc ' AS varchar(8))") + .addRoundTrip("char(8)", "'12345678'", createVarcharType(8), "CAST('12345678' AS varchar(8))") + .execute(getQueryRunner(), trinoCreateAsSelect("snowflake_test_parameterized_char")); + + SqlDataTypeTest.create() + .addRoundTrip("char", "''", createVarcharType(1), "CAST('' AS varchar(1))") + .addRoundTrip("char", "'a'", createVarcharType(1), "CAST('a' AS varchar(1))") + .addRoundTrip("char(1)", "''", createVarcharType(1), "CAST('' AS varchar(1))") + .addRoundTrip("char(1)", "'a'", createVarcharType(1), "CAST('a' AS varchar(1))") + .addRoundTrip("char(8)", "'abc'", createVarcharType(8), "CAST('abc' AS varchar(8))") + .addRoundTrip("char(8)", "'12345678'", createVarcharType(8), "CAST('12345678' AS varchar(8))") + .execute(getQueryRunner(), trinoCreateAndInsert("snowflake_test_parameterized_char")) + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.snowflake_test_parameterized_char")); + } + + @Test + public void testSnowflakeParameterizedCharUnicode() + { + SqlDataTypeTest.create() + .addRoundTrip("char(1) collate \'utf8\'", "'攻'", createVarcharType(1), "CAST('攻' AS VARCHAR(1))") + .addRoundTrip("char(5) collate \'utf8\'", "'攻殻'", createVarcharType(5), "CAST('攻殻' AS VARCHAR(5))") + .addRoundTrip("char(5) collate \'utf8\'", "'攻殻機動隊'", createVarcharType(5), "CAST('攻殻機動隊' AS VARCHAR(5))") + .addRoundTrip("char(1)", "'😂'", createVarcharType(1), "CAST('😂' AS VARCHAR(1))") + .addRoundTrip("char(77)", "'Ну, погоди!'", createVarcharType(77), "CAST('Ну, погоди!' AS VARCHAR(77))") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.snowflake_test_parameterized_char")); + } + + @Test + public void testBinary() + { + SqlDataTypeTest.create() + .addRoundTrip("binary(18)", "NULL", VARBINARY, "CAST(NULL AS varbinary)") + .addRoundTrip("binary(18)", "X''", VARBINARY, "X''") + .addRoundTrip("binary(18)", "X'68656C6C6F'", VARBINARY, "to_utf8('hello')") + .addRoundTrip("binary(18)", "X'C582C4856B61207720E69DB1E4BAACE983BD'", VARBINARY, "to_utf8('łąka w 東京都')") // no trailing zeros + .addRoundTrip("binary(18)", "X'4261672066756C6C206F6620F09F92B0'", VARBINARY, "to_utf8('Bag full of 💰')") + .addRoundTrip("binary(18)", "X'0001020304050607080DF9367AA7000000'", VARBINARY, "X'0001020304050607080DF9367AA7000000'") // non-text prefix + .addRoundTrip("binary(18)", "X'000000000000'", VARBINARY, "X'000000000000'") + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_binary")); + } + + @Test + public void testVarbinary() + { + SqlDataTypeTest.create() + .addRoundTrip("varbinary", "NULL", VARBINARY, "CAST(NULL AS varbinary)") + .addRoundTrip("varbinary", "X''", VARBINARY, "X''") + .addRoundTrip("varbinary", "X'68656C6C6F'", VARBINARY, "to_utf8('hello')") + .addRoundTrip("varbinary", "X'5069C4996B6E6120C582C4856B61207720E69DB1E4BAACE983BD'", VARBINARY, "to_utf8('Piękna łąka w 東京都')") + .addRoundTrip("varbinary", "X'4261672066756C6C206F6620F09F92B0'", VARBINARY, "to_utf8('Bag full of 💰')") + .addRoundTrip("varbinary", "X'0001020304050607080DF9367AA7000000'", VARBINARY, "X'0001020304050607080DF9367AA7000000'") // non-text + .addRoundTrip("varbinary", "X'000000000000'", VARBINARY, "X'000000000000'") + .execute(getQueryRunner(), trinoCreateAsSelect("test_varbinary")) + .execute(getQueryRunner(), trinoCreateAndInsert("test_varbinary")) + .execute(getQueryRunner(), snowflakeCreateAndInsert("tpch.test_varbinary")); + } + + @Test + public void testDate() + { + testDate(UTC); + testDate(jvmZone); + testDate(vilnius); + testDate(kathmandu); + testDate(TestingSession.DEFAULT_TIME_ZONE_KEY.getZoneId()); + } + + private void testDate(ZoneId sessionZone) + { + Session session = Session.builder(getSession()) + .setTimeZoneKey(getTimeZoneKey(sessionZone.getId())) + .build(); + + SqlDataTypeTest.create() + .addRoundTrip("date", "NULL", DATE, "CAST(NULL AS DATE)") + .addRoundTrip("date", "'-5877641-06-23'", DATE, "DATE '-5877641-06-23'") // min value in Trino + .addRoundTrip("date", "'0000-01-01'", DATE, "DATE '0000-01-01'") + .addRoundTrip("date", "DATE '0001-01-01'", DATE, "DATE '0001-01-01'") // Min value for the function Date. + .addRoundTrip("date", "DATE '1582-10-05'", DATE, "DATE '1582-10-05'") // begin julian->gregorian switch + .addRoundTrip("date", "DATE '1582-10-14'", DATE, "DATE '1582-10-14'") // end julian->gregorian switch + .addRoundTrip("date", "DATE '1983-04-01'", DATE, "DATE '1983-04-01'") + .addRoundTrip("date", "DATE '1983-10-01'", DATE, "DATE '1983-10-01'") + .addRoundTrip("date", "DATE '2017-07-01'", DATE, "DATE '2017-07-01'") // summer on northern hemisphere (possible DST) + .addRoundTrip("date", "DATE '2017-01-01'", DATE, "DATE '2017-01-01'") // winter on northern hemisphere (possible DST on southern hemisphere) + .addRoundTrip("date", "DATE '99999-12-31'", DATE, "DATE '99999-12-31'") + .addRoundTrip("date", "'5881580-07-11'", DATE, "DATE '5881580-07-11'") // max value in Trino + .execute(getQueryRunner(), session, trinoCreateAsSelect("test_date")) + .execute(getQueryRunner(), session, snowflakeCreateAndInsert("tpch.test_date")); + } + + @Test + public void testTimestamp() + { + testTimestamp(UTC); + testTimestamp(jvmZone); + testTimestamp(vilnius); + testTimestamp(kathmandu); + testTimestamp(TestingSession.DEFAULT_TIME_ZONE_KEY.getZoneId()); + } + + private void testTimestamp(ZoneId sessionZone) + { + Session session = Session.builder(getSession()) + .setTimeZoneKey(TimeZoneKey.getTimeZoneKey(sessionZone.getId())) + .build(); + + SqlDataTypeTest.create() + // after epoch (MariaDb's timestamp type doesn't support values <= epoch) + .addRoundTrip("timestamp(3)", "TIMESTAMP '2019-03-18 10:01:17.987'", createTimestampType(3), "TIMESTAMP '2019-03-18 10:01:17.987'") + // time doubled in JVM zone + .addRoundTrip("timestamp(3)", "TIMESTAMP '2018-10-28 01:33:17.456'", createTimestampType(3), "TIMESTAMP '2018-10-28 01:33:17.456'") + // time double in Vilnius + .addRoundTrip("timestamp(3)", "TIMESTAMP '2018-10-28 03:33:33.333'", createTimestampType(3), "TIMESTAMP '2018-10-28 03:33:33.333'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '1970-01-01 00:13:42.000'", createTimestampType(3), "TIMESTAMP '1970-01-01 00:13:42.000'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '2018-04-01 02:13:55.123'", createTimestampType(3), "TIMESTAMP '2018-04-01 02:13:55.123'") + // time gap in Vilnius + .addRoundTrip("timestamp(3)", "TIMESTAMP '2018-03-25 03:17:17.000'", createTimestampType(3), "TIMESTAMP '2018-03-25 03:17:17.000'") + // time gap in Kathmandu + .addRoundTrip("timestamp(3)", "TIMESTAMP '1986-01-01 00:13:07.000'", createTimestampType(3), "TIMESTAMP '1986-01-01 00:13:07.000'") + // max value 2038-01-19 03:14:07 + .addRoundTrip("timestamp(3)", "TIMESTAMP '2038-01-19 03:14:07.000'", createTimestampType(3), "TIMESTAMP '2038-01-19 03:14:07.000'") + // test arbitrary time for all supported precisions + .addRoundTrip("timestamp(0)", "TIMESTAMP '1970-01-01 00:00:01'", createTimestampType(0), "TIMESTAMP '1970-01-01 00:00:01'") + .addRoundTrip("timestamp(1)", "TIMESTAMP '1970-01-01 00:00:01.1'", createTimestampType(1), "TIMESTAMP '1970-01-01 00:00:01.1'") + .addRoundTrip("timestamp(1)", "TIMESTAMP '1970-01-01 00:00:01.9'", createTimestampType(1), "TIMESTAMP '1970-01-01 00:00:01.9'") + .addRoundTrip("timestamp(2)", "TIMESTAMP '1970-01-01 00:00:01.12'", createTimestampType(2), "TIMESTAMP '1970-01-01 00:00:01.12'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '1970-01-01 00:00:01.123'", createTimestampType(3), "TIMESTAMP '1970-01-01 00:00:01.123'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '1970-01-01 00:00:01.999'", createTimestampType(3), "TIMESTAMP '1970-01-01 00:00:01.999'") + .addRoundTrip("timestamp(1)", "TIMESTAMP '2020-09-27 12:34:56.1'", createTimestampType(1), "TIMESTAMP '2020-09-27 12:34:56.1'") + .addRoundTrip("timestamp(1)", "TIMESTAMP '2020-09-27 12:34:56.9'", createTimestampType(1), "TIMESTAMP '2020-09-27 12:34:56.9'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '2020-09-27 12:34:56.123'", createTimestampType(3), "TIMESTAMP '2020-09-27 12:34:56.123'") + .addRoundTrip("timestamp(3)", "TIMESTAMP '2020-09-27 12:34:56.999'", createTimestampType(3), "TIMESTAMP '2020-09-27 12:34:56.999'") + .execute(getQueryRunner(), session, snowflakeCreateAndInsert("tpch.test_timestamp")) + .execute(getQueryRunner(), session, trinoCreateAsSelect(session, "test_timestamp")) + .execute(getQueryRunner(), session, trinoCreateAsSelect("test_timestamp")) + .execute(getQueryRunner(), session, trinoCreateAndInsert(session, "test_timestamp")) + .execute(getQueryRunner(), session, trinoCreateAndInsert("test_timestamp")); + } + + private DataSetup trinoCreateAsSelect(String tableNamePrefix) + { + return trinoCreateAsSelect(getSession(), tableNamePrefix); + } + + private DataSetup trinoCreateAsSelect(Session session, String tableNamePrefix) + { + return new CreateAsSelectDataSetup(new TrinoSqlExecutor(getQueryRunner(), session), tableNamePrefix); + } + + private DataSetup trinoCreateAndInsert(String tableNamePrefix) + { + return trinoCreateAndInsert(getSession(), tableNamePrefix); + } + + private DataSetup trinoCreateAndInsert(Session session, String tableNamePrefix) + { + return new CreateAndInsertDataSetup(new TrinoSqlExecutor(getQueryRunner(), session), tableNamePrefix); + } + + private DataSetup snowflakeCreateAndInsert(String tableNamePrefix) + { + return new CreateAndInsertDataSetup(snowflakeServer::execute, tableNamePrefix); + } + + private static void checkIsGap(ZoneId zone, LocalDate date) + { + verify(isGap(zone, date), "Expected %s to be a gap in %s", date, zone); + } + + private static boolean isGap(ZoneId zone, LocalDate date) + { + return zone.getRules().getValidOffsets(date.atStartOfDay()).isEmpty(); + } +} diff --git a/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestingSnowflakeServer.java b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestingSnowflakeServer.java new file mode 100644 index 00000000000..bd64f303075 --- /dev/null +++ b/plugin/trino-snowflake/src/test/java/io/trino/plugin/snowflake/TestingSnowflakeServer.java @@ -0,0 +1,77 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.plugin.snowflake; + +import org.intellij.lang.annotations.Language; + +import java.sql.Connection; +import java.sql.DriverManager; +import java.sql.SQLException; +import java.sql.Statement; +import java.util.Properties; + +import static java.util.Objects.requireNonNull; + +public class TestingSnowflakeServer + implements AutoCloseable +{ + public static final String TEST_URL = requireNonNull(System.getProperty("snowflake.test.server.url"), "snowflake.test.server.url is not set"); + public static final String TEST_USER = requireNonNull(System.getProperty("snowflake.test.server.user"), "snowflake.test.server.user is not set"); + public static final String TEST_PASSWORD = requireNonNull(System.getProperty("snowflake.test.server.password"), "snowflake.test.server.password is not set"); + public static final String TEST_DATABASE = requireNonNull(System.getProperty("snowflake.test.server.database"), "snowflake.test.server.database is not set"); + public static final String TEST_WAREHOUSE = requireNonNull(System.getProperty("snowflake.test.server.warehouse"), "snowflake.test.server.warehouse is not set"); + public static final String TEST_ROLE = requireNonNull(System.getProperty("snowflake.test.server.role"), "snowflake.test.server.role is not set"); + public static final String TEST_PROXY = System.getProperty("snowflake.test.http_proxy"); + public static final String TEST_SCHEMA = "tpch"; + + public TestingSnowflakeServer() + { + execute("CREATE SCHEMA IF NOT EXISTS tpch"); + } + + public void execute(@Language("SQL") String sql) + { + execute(TEST_URL, getProperties(), sql); + } + + private static void execute(String url, Properties properties, String sql) + { + try (Connection connection = DriverManager.getConnection(url, properties); + Statement statement = connection.createStatement()) { + statement.execute(sql); + } + catch (SQLException e) { + throw new RuntimeException(e); + } + } + + public Properties getProperties() + { + Properties properties = new Properties(); + properties.setProperty("user", TEST_USER); + properties.setProperty("password", TEST_PASSWORD); + properties.setProperty("db", TEST_DATABASE); + properties.setProperty("schema", TEST_SCHEMA); + properties.setProperty("warehouse", TEST_WAREHOUSE); + properties.setProperty("role", TEST_ROLE); + return properties; + } + + @Override + public void close() + throws Exception + { + execute("DROP SCHEMA IF EXISTS tpch"); + } +} diff --git a/pom.xml b/pom.xml index 84976e4108e..97d3d383ef6 100644 --- a/pom.xml +++ b/pom.xml @@ -105,6 +105,7 @@ plugin/trino-resource-group-managers plugin/trino-session-property-managers plugin/trino-singlestore + plugin/trino-snowflake plugin/trino-sqlserver plugin/trino-teradata-functions plugin/trino-thrift @@ -1404,6 +1405,12 @@ test-jar + + io.trino + trino-snowflake + ${project.version} + + io.trino trino-spi diff --git a/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeAllConnectors.java b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeAllConnectors.java index 0ba9cf6edd0..7e289ee8583 100644 --- a/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeAllConnectors.java +++ b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeAllConnectors.java @@ -77,6 +77,7 @@ public void extendEnvironment(Environment.Builder builder) "raptor_legacy", "redis", "redshift", + "snowflake", "sqlserver", "trino_thrift", "tpcds") diff --git a/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeSnowflake.java b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeSnowflake.java new file mode 100644 index 00000000000..7f4ab574084 --- /dev/null +++ b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/env/environment/EnvMultinodeSnowflake.java @@ -0,0 +1,77 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.tests.product.launcher.env.environment; + +import com.google.inject.Inject; +import io.trino.tests.product.launcher.docker.DockerFiles; +import io.trino.tests.product.launcher.env.Environment; +import io.trino.tests.product.launcher.env.EnvironmentProvider; +import io.trino.tests.product.launcher.env.common.Standard; +import io.trino.tests.product.launcher.env.common.TestsEnvironment; + +import java.io.File; +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.attribute.PosixFilePermissions; + +import static java.nio.file.attribute.PosixFilePermissions.fromString; +import static java.util.Objects.requireNonNull; +import static org.testcontainers.utility.MountableFile.forHostPath; + +@TestsEnvironment +public class EnvMultinodeSnowflake + extends EnvironmentProvider +{ + private final DockerFiles.ResourceProvider configDir; + + @Inject + public EnvMultinodeSnowflake(DockerFiles dockerFiles, Standard standard) + { + super(standard); + configDir = requireNonNull(dockerFiles, "dockerFiles is null").getDockerFilesHostDirectory("conf/environment/multinode-snowflake"); + } + + @Override + public void extendEnvironment(Environment.Builder builder) + { + builder.addConnector("snowflake", forHostPath(getEnvProperties())); + } + + private Path getEnvProperties() + { + try { + String properties = Files.readString(configDir.getPath("snowflake.properties")) + .replace("${ENV:SNOWFLAKE_URL}", requireEnv("SNOWFLAKE_URL")) + .replace("${ENV:SNOWFLAKE_USER}", requireEnv("SNOWFLAKE_USER")) + .replace("${ENV:SNOWFLAKE_PASSWORD}", requireEnv("SNOWFLAKE_PASSWORD")) + .replace("${ENV:SNOWFLAKE_DATABASE}", requireEnv("SNOWFLAKE_DATABASE")) + .replace("${ENV:SNOWFLAKE_ROLE}", requireEnv("SNOWFLAKE_ROLE")) + .replace("${ENV:SNOWFLAKE_WAREHOUSE}", requireEnv("SNOWFLAKE_WAREHOUSE")); + File newProperties = Files.createTempFile("snowflake-replaced", ".properties", PosixFilePermissions.asFileAttribute(fromString("rwxrwxrwx"))).toFile(); + newProperties.deleteOnExit(); + Files.writeString(newProperties.toPath(), properties); + return newProperties.toPath(); + } + catch (IOException e) { + throw new UncheckedIOException(e); + } + } + + private static String requireEnv(String variable) + { + return requireNonNull(System.getenv(variable), () -> "environment variable not set: " + variable); + } +} diff --git a/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/suite/suites/SuiteSnowflake.java b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/suite/suites/SuiteSnowflake.java new file mode 100644 index 00000000000..317d3481723 --- /dev/null +++ b/testing/trino-product-tests-launcher/src/main/java/io/trino/tests/product/launcher/suite/suites/SuiteSnowflake.java @@ -0,0 +1,37 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.tests.product.launcher.suite.suites; + +import com.google.common.collect.ImmutableList; +import io.trino.tests.product.launcher.env.EnvironmentConfig; +import io.trino.tests.product.launcher.env.environment.EnvMultinodeSnowflake; +import io.trino.tests.product.launcher.suite.Suite; +import io.trino.tests.product.launcher.suite.SuiteTestRun; + +import java.util.List; + +import static io.trino.tests.product.launcher.suite.SuiteTestRun.testOnEnvironment; + +public class SuiteSnowflake + extends Suite +{ + @Override + public List getTestRuns(EnvironmentConfig config) + { + return ImmutableList.of( + testOnEnvironment(EnvMultinodeSnowflake.class) + .withGroups("configured_features", "snowflake") + .build()); + } +} diff --git a/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-all/snowflake.properties b/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-all/snowflake.properties new file mode 100644 index 00000000000..669489ea436 --- /dev/null +++ b/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-all/snowflake.properties @@ -0,0 +1,4 @@ +connector.name=snowflake +connection-url=${ENV:SNOWFLAKE_URL} +connection-user=${ENV:SNOWFLAKE_USER} +connection-password=${ENV:SNOWFLAKE_PASSWORD} diff --git a/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-snowflake/snowflake.properties b/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-snowflake/snowflake.properties new file mode 100644 index 00000000000..669489ea436 --- /dev/null +++ b/testing/trino-product-tests-launcher/src/main/resources/docker/presto-product-tests/conf/environment/multinode-snowflake/snowflake.properties @@ -0,0 +1,4 @@ +connector.name=snowflake +connection-url=${ENV:SNOWFLAKE_URL} +connection-user=${ENV:SNOWFLAKE_USER} +connection-password=${ENV:SNOWFLAKE_PASSWORD} diff --git a/testing/trino-product-tests/src/main/java/io/trino/tests/product/TestGroups.java b/testing/trino-product-tests/src/main/java/io/trino/tests/product/TestGroups.java index 3ab097d94fb..1d4b1c7a32c 100644 --- a/testing/trino-product-tests/src/main/java/io/trino/tests/product/TestGroups.java +++ b/testing/trino-product-tests/src/main/java/io/trino/tests/product/TestGroups.java @@ -82,6 +82,7 @@ public final class TestGroups public static final String CLICKHOUSE = "clickhouse"; public static final String KUDU = "kudu"; public static final String MARIADB = "mariadb"; + public static final String SNOWFLAKE = "snowflake"; public static final String DELTA_LAKE_OSS = "delta-lake-oss"; public static final String DELTA_LAKE_HDFS = "delta-lake-hdfs"; public static final String DELTA_LAKE_MINIO = "delta-lake-minio"; diff --git a/testing/trino-product-tests/src/main/java/io/trino/tests/product/snowflake/TestSnowflake.java b/testing/trino-product-tests/src/main/java/io/trino/tests/product/snowflake/TestSnowflake.java new file mode 100644 index 00000000000..8850ca21655 --- /dev/null +++ b/testing/trino-product-tests/src/main/java/io/trino/tests/product/snowflake/TestSnowflake.java @@ -0,0 +1,46 @@ +/* + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package io.trino.tests.product.snowflake; + +import io.trino.tempto.ProductTest; +import io.trino.tempto.query.QueryResult; +import org.testng.annotations.Test; + +import static io.trino.tempto.assertions.QueryAssert.Row.row; +import static io.trino.tempto.assertions.QueryAssert.assertThat; +import static io.trino.testing.TestingNames.randomNameSuffix; +import static io.trino.tests.product.TestGroups.PROFILE_SPECIFIC_TESTS; +import static io.trino.tests.product.TestGroups.SNOWFLAKE; +import static io.trino.tests.product.utils.QueryExecutors.onTrino; + +public class TestSnowflake + extends ProductTest +{ + @Test(groups = {SNOWFLAKE, PROFILE_SPECIFIC_TESTS}) + public void testCreateTableAsSelect() + { + String tableName = "snowflake.tpch.nation_" + randomNameSuffix(); + + onTrino().executeQuery("DROP TABLE IF EXISTS " + tableName); + QueryResult result = onTrino().executeQuery("CREATE TABLE " + tableName + " AS SELECT * FROM tpch.tiny.nation"); + try { + assertThat(result).updatedRowsCountIsEqualTo(25); + assertThat(onTrino().executeQuery("SELECT COUNT(*) FROM " + tableName)) + .containsOnly(row(25)); + } + finally { + onTrino().executeQuery("DROP TABLE " + tableName); + } + } +}