summaryrefslogtreecommitdiff
path: root/alembic/templates
diff options
context:
space:
mode:
authorChris Dary <umbrae@gmail.com>2021-09-24 15:47:08 -0400
committerGitHub <noreply@github.com>2021-09-24 15:47:08 -0400
commitd95e15cac59dc449f712f51183462a8688a51086 (patch)
treea45940df32f7e9a4252abc618eff3f0b97812502 /alembic/templates
parente96e5fa151dac59e287a20c738e877d9c9a504bf (diff)
downloadalembic-d95e15cac59dc449f712f51183462a8688a51086.tar.gz
MultiDB README: Add a bit more detail
Diffstat (limited to 'alembic/templates')
-rw-r--r--alembic/templates/multidb/README13
1 files changed, 12 insertions, 1 deletions
diff --git a/alembic/templates/multidb/README b/alembic/templates/multidb/README
index 5db219f..f046ec9 100644
--- a/alembic/templates/multidb/README
+++ b/alembic/templates/multidb/README
@@ -1 +1,12 @@
-Rudimentary multi-database configuration. \ No newline at end of file
+Rudimentary multi-database configuration.
+
+Multi-DB isn't vastly different from generic. The primary difference is that it
+will run the migrations N times (depending on how many databases you have
+configured), providing one engine name and associated context for each run.
+
+That engine name will then allow the migration to restrict what runs within it to
+just the appropriate migrations for that engine. You can see this behavior within
+the mako template.
+
+In the provided configuration, you'll need to have `databases` provided in
+alembic's config, and an `sqlalchemy.url` provided for each engine name.