There is no prerequisite and no right order. Every chapter starts plain and gets deeper
as it goes, so the same page works in your first week on the platform and in your fifth
year. Stop when you have what you came for.
42 chapters
The short version
Nearly every chapter opens with one: what the thing is and why it matters, in plain
language, assuming nothing. Read only these, front to back, and you are about twenty
minutes from an accurate picture of the whole platform.
Then the detail
How it actually works
Everything after that opening is for the person who has to build it. Basics first,
then the parts most teams never find. Much of the resistance we meet comes from
comparing Databricks against a half-remembered feature list, so we go and name them.
44 comparisons
Side by side
What you would use on AWS, Azure or Google Cloud to do the same job, named rather
than implied. We argue for Databricks in these. We also say where the other clouds
genuinely win, instead of pretending they do not.
40 objections
What people say
The arguments that come up in every architecture review, in the words people really
use. Each one is answered by admitting the part of it that is true. If a colleague
sent you here to change your mind, start with these.
Two markers run through the guide. Warning flags something that has
cost us or a client real time, money or trust, and there are
thirty of them. Our position marks a place where
reasonable teams disagree and we have picked a side. Those
thirty are the paragraphs most worth arguing with.