Slick

Slick (Scala Language Integrated Connection Kit) is a modern database query and access library for Scala

Programming language: Scala

License: BSD 2-clause "Simplified" License

Tags: Database    

Latest version: v3.3.3

README

Slick

<!-- [] -->

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

• Post questions and suggestions on GitHub Discussions
• Ask on the #slick channel on the official Scala Discord server
• There is a gitter channel too, but Discord is preferred
• Report bugs to GitHub issues

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.

<!-- [] -->