From 658f195056a65f29e05b930ec1ba81ab636f5b1d Mon Sep 17 00:00:00 2001 From: David Pacheco Date: Wed, 8 Nov 2023 10:57:16 -0800 Subject: [PATCH] rework headings --- schema/crdb/README.adoc | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/schema/crdb/README.adoc b/schema/crdb/README.adoc index 4a312e274d..fba36ed73b 100644 --- a/schema/crdb/README.adoc +++ b/schema/crdb/README.adoc @@ -50,7 +50,7 @@ fall-back pathway for performing upgrades. See RFD 319 for more discussion of the online upgrade plans. -=== How to change the schema +== How to change the schema Assumptions: @@ -89,7 +89,7 @@ SQL Validation, via Automated Tests: `dbinit.sql` * All `up.sql` files can be applied twice without error -==== General notes +=== General notes CockroachDB's representation of the schema includes some opaque internally-generated fields that are order dependent, like the names of @@ -101,6 +101,8 @@ As convention, however, we recommend keeping the `db_metadata` file at the end of `dbinit.sql`, so that the database does not contain a version until it is fully populated. +=== Scenario-specific gotchas + ==== Renaming columns Idempotently renaming existing columns is unfortunately not possible in our