redshift-fake-driver is a JDBC driver accepting Redshift specific commands (e.g. COPY, UNLOAD), which is useful for local testing.

The driver uses AWS SDK for Java to connect to S3, so you can use mocking libraries to emulate S3. (e.g. fake-s3)

• COPY
  • JSON with jsonpaths
  • MANIFEST
• UNLOAD
• DDLs
  • just drop Redshift specific directives (e.g. DISTSTYLE, DISTKEY, ...)

Some options are currently not supported.

Contributions are welcome !

• S3 (fake-s3 is OK)
• aws-java-sdk-s3, aws-java-sdk-sts >= 1.10.8
• postgresql or h2 JDBC driver
• Java >= 1.8
• (If you use in Scala projects) Scala 2.10.x / 2.11.x / 2.12.x

• Add following dependency to pom.xml

<dependency>
    <groupId>jp.ne.opt</groupId>
    <artifactId>redshift-fake-driver_2.11</artifactId>
    <version>1.0.15</version>
</dependency>

• Add other required dependencies (aws-java-sdk-s3, h2 or postgresql driver) to pom.xml.

• Add following dependency to build.sbt

"jp.ne.opt" %% "redshift-fake-driver" % "1.0.15"

• Add other required dependencies (aws-java-sdk-s3, h2 or postgresql driver) to build.sbt.

• Start postgresql database to mock Redshift.

Class.forName("jp.ne.opt.redshiftfake.postgres.FakePostgresqlDriver")

val endpoint = "https://localhost:9444/" // in production, scheme  will be "s3:https://"

val url = "jdbc:postgresqlredshift:https://localhost:5432/foo"
val prop = new Properties()
prop.setProperty("driver", "jp.ne.opt.redshiftfake.postgres.FakePostgresqlDriver")
prop.setProperty("user", "sa")

val conn = DriverManager.getConnection(url, prop)
val stmt = conn.createStatement()

val unloadSql =
  s"""unload ('select * from foo') to '${endpoint}foo/unloaded_'
      |credentials 'aws_access_key_id=AKIAXXXXXXXXXXXXXXX;aws_secret_access_key=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY' 
      |manifest""".stripMargin
stmt.execute(unloadSql)

val copySql =
  s"""copy bar from '${endpoint}foo/unloaded_manifest'
      |credentials 'aws_access_key_id=AKIAXXXXXXXXXXXXXXX;aws_secret_access_key=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'
      |manifest""".stripMargin

val copySqlWithTemporaryToken = 
s"""COPY bar FROM '${endpoint}foo/unloaded_manifest'
    |ACCESS_KEY_ID 'some_access_key_id'
    |SECRET_ACCESS_KEY 'some_secret_access_key'
    |SESSION_TOKEN 'some_session_token';""".stripMargin

stmt.execute(copySql)

• Specify region via fake.awsRegion system property.
  • ap-northeast-1 by default

• Specify s3 endpoint via fake.awsS3Endpoint system property.
  • if you started a fake-s3 server on https://localhost:9444/, specify -Dfake.awsS3Endpoint="https://localhost:9444/". (trailing slash is required)
  • you do not have to change S3 URL in your SQL (copy/unload).

Apache 2.0