Functional Relational Mapping for Scala

Scala

Seamless data access for your Scala application — Write Scala code to query your database.

Type Safe

All database entities and queries are statically checked at compile-time.

Composable

Compose query operations just as if you were using Scala's collections.

Slick is an advanced, comprehensive database access library for Scala with strongly-typed, highly composable APIs.

Slick makes it easy to use your database in a way that’s natural to it. It allows you to work with relational databases almost as if you were using Scala collections, while at the same time giving you full control over when the database is accessed and how much data is transferred. And by writing your queries in Scala you can benefit from compile-time safety and great compositionality, while retaining the ability to drop down to raw SQL when necessary for custom or advanced database features.

Its features include:

  • Query API inspired by Scala’s collections API
  • Full control over how the database schema is seen by Slick, by using an explicit representation that can be code-generated from the actual database
  • Asynchronous API using Future for complete results, and a streaming API that conforms to the Reactive Streams interface, for easy integration with any streaming library, such as Akka Streams, FS2, or ZIO.
  • Composability at many levels
    • Compose actions (steps to run in a database context) with for comprehensions
    • Compose queries with for comprehensions or combinators
    • Compose row expressions (column sets, predicates, and column mappings)
  • A database metadata introspection API

Slick features an advanced query compiler which can generate SQL for a variety of different database engines from the same Scala code, allowing you to focus on application logic without worrying about database-specific syntax and quirks.

Resources

Learn

  • Full documentation, including Scaladocs and more complex examples, can be found on the website. For the latest release you can go straight to https://scala-slick.org/doc/stable/
  • Our friends at underscore.io have written “Essential Slick”, an excellent guide to using slick from first principles, and is available as a free download

  • Videos by Rock the JVM

Get help

Example

As a simple example we will create a Scala object Coffee, and a table to store instances of this object in the database:

import slick.jdbc.PostgresProfile.api._

// First declare our Scala object
final case class Coffee(name: String, price: Double)

// Next define how Slick maps from a database table to Scala objects
class Coffees(tag: Tag) extends Table[Coffee](tag, "COFFEES") {
  def name  = column[String]("NAME")
  def price = column[Double]("PRICE")
  def * = (name, price).mapTo[Coffee]
}

// The `TableQuery` object gives us access to Slick's rich query API
val coffees = TableQuery[Coffees]

// Inserting is done by appending to our query object
// as if it were a regular Scala collection
// SQL: insert into COFFEES (NAME, PRICE) values ('Latte', 2.50)
coffees += Coffee("Latte", 2.50)

// Fetching data is also done using the query object
// SQL: select NAME from COFFEES
coffees.map(_.name)

// More complex queries can be chained together
// SQL: select NAME, PRICE from COFFEES where PRICE < 10.0 order by NAME
coffees.filter(_.price < 10.0).sortBy(_.name)

Database support

The following databases are directly supported by Slick, and are currently covered by a large suite of automated tests to ensure compatibility:

Database JDBC Driver Tested server version
PostgreSQL "org.postgresql" % "postgresql" % "42.5.0" Latest
MySQL "mysql" % "mysql-connector-java" % "8.0.30" Latest
SQLServer "net.sourceforge.jtds" % "jtds" % "1.3.1" and 2022
  "com.microsoft.sqlserver" % "mssql-jdbc" % "7.2.2.jre11"  
Oracle "com.oracle.database.jdbc.debug" % "ojdbc8_g" % "21.6.0.0.1" 11g
DB2 "com.ibm.db2.jcc" % "db2jcc" % "db2jcc4" 11.5.7.0
Derby/JavaDB "org.apache.derby" % "derby" % "10.14.2.0"  
H2 "com.h2database" % "h2" % "1.4.200"  
HSQLDB/HyperSQL "org.hsqldb" % "hsqldb" % "2.5.2"  
SQLite "org.xerial" % "sqlite-jdbc" % "3.39.2.1"  

Accessing other database systems is possible, although possibly with a reduced feature set.

Contributing

Slick is community-maintained: pull requests are very welcome, and we ask that all contributors abide by the Lightbend Community Code of Conduct.

Lightbend staff (such as @SethTisue) may be able to assist with administrative issues.

News

Sep 18 2022
Slick 3.4.0 was released and published to Maven Central, with 281 merged pull requests, many from the community. A pull request that could cause issues was then rolled back, so... more
Aug 16 2022
If you use Slick, please try 3.4.0-RC3 by changing the version in your build. After a week, if no regressions have been reported we will G-d willing release 3.4.0 (final).... more

News archive