«

Moving to Cloud

Datomic Cloud is ideal for greenfield projects where you need:

  • Quick and easy access to Datomic on AWS
  • More ops ability with less responsibility

To take the greatest advantage of AWS features, Cloud uses a storage format different from that used in Datomic Pro.

We are currently designing migration tools for users who want to move from Datomic Pro to Cloud, but these tools are not part of the initial release. If, after reviewing the differences outlined below, you want to migrate from Datomic Pro to Cloud, we want to hear from you, and help you plan.

Similarities Between Cloud and Datomic Pro

The information model is what makes Datomic Datomic, and is entirely the same between Cloud and Datomic Pro. This includes:

  • Datoms, entities, and indexes
  • ACID transactions
  • The universal schema
  • Datalog query and structural pull
  • The indelible, accumulate-only model of time
  • The database as a value

Difference 1: AWS Integration

Datomic Cloud is tightly integrated with AWS.

This has three implications:

  • Greenfield Datomic apps on AWS should target Cloud
  • Datomic apps that do not run on AWS must target Datomic Pro
  • Existing Datomic apps on AWS can be ported to the Cloud once the migration tools are available

Difference 2: Clients and Peers

Datomic Pro supports client or peer access, while Cloud supports only client access.

This has two implications:

  • Apps that target the client API are much easier to move between Datomic Pro and Cloud
  • Apps that make heavy use of peer locality will require substantial alteration for Cloud

Check clients and peers for more information.

Difference 3: Ions

Datomic lets you run your code in process with your data. In Datomic Pro, this takes the form of functions installed in a database, or functions you add to the classpath.

Datomic Cloud's tight AWS integration makes this capability much more powerful. Ions let you run your entire application on Datomic, with reproducible deployment, elastic autoscaling, and integration via AWS lambda events and AWS API gateway.

Other Differences

In each of the areas in the table below, we believe that the Cloud architecture can offer capabilities that will be superior to those currently in Datomic Pro:

Datomic Pro Cloud (Future)
User partition control Auto partitioning (now), partition routing
Limited search capability CloudSearch integration
Byte array type LOB types

These and other differences are explained below.

Auto Partitioning

The peer model supports two kinds of tempids: #db/id structures and strings. The client model supports only strings. This makes client drivers and client programs easier to write and use, and it eliminates partition control as a user-space concern.

No Symbol Magic

To transparently reach languages lacking a symbolic type, Datomic Pro will in some situations magically convert strings into symbolic types, e.g. ":hello" to :hello.

Cloud does not perform this kind of magic, and client libraries are always responsible for mapping EDN types to sensible language-local representations.

No Excision

Cloud does not currently support excision.