diff --git a/README.md b/README.md index 4a389bfc..84b7e76f 100644 --- a/README.md +++ b/README.md @@ -44,42 +44,42 @@ warning[prefer-bigint-over-int]: Using 32-bit integer fields can result in hitti --> example.sql:6:10 | 6 | "id" serial NOT NULL PRIMARY KEY, - | ^^^^^^ + | ------ | = help: Use 64-bit integer values instead to prevent hitting this limit. warning[prefer-identity]: Serial types make schema, dependency, and permission management difficult. --> example.sql:6:10 | 6 | "id" serial NOT NULL PRIMARY KEY, - | ^^^^^^ + | ------ | = help: Use Identity columns instead. warning[prefer-text-field]: Changing the size of a `varchar` field requires an `ACCESS EXCLUSIVE` lock, that will prevent all reads and writes to the table. --> example.sql:7:13 | 7 | "alpha" varchar(100) NOT NULL - | ^^^^^^^^^^^^ + | ------------ | = help: Use a `TEXT` field with a `CHECK` constraint. warning[require-concurrent-index-creation]: During normal index creation, table updates are blocked, but reads are still allowed. --> example.sql:10:1 | 10 | CREATE INDEX "field_name_idx" ON "table_name" ("field_name"); - | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + | ------------------------------------------------------------ | = help: Use `CONCURRENTLY` to avoid blocking writes. warning[constraint-missing-not-valid]: By default new constraints require a table scan and block writes to the table while that scan occurs. --> example.sql:12:24 | 12 | ALTER TABLE table_name ADD CONSTRAINT field_name_constraint UNIQUE (field_name); - | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + | -------------------------------------------------------- | = help: Use `NOT VALID` with a later `VALIDATE CONSTRAINT` call. warning[disallowed-unique-constraint]: Adding a `UNIQUE` constraint requires an `ACCESS EXCLUSIVE` lock which blocks reads and writes to the table while the index is built. --> example.sql:12:28 | 12 | ALTER TABLE table_name ADD CONSTRAINT field_name_constraint UNIQUE (field_name); - | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + | ---------------------------------------------------- | = help: Create an index `CONCURRENTLY` and create the constraint using the index. diff --git a/docs/docs/quick_start.md b/docs/docs/quick_start.md index 1fa53f44..256f5706 100644 --- a/docs/docs/quick_start.md +++ b/docs/docs/quick_start.md @@ -57,13 +57,13 @@ warning[constraint-missing-not-valid]: By default new constraints require a tabl --> example-migration.sql:2:24 | 2 | ALTER TABLE table_name ADD CONSTRAINT field_name_constraint UNIQUE (field_name); - | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + | -------------------------------------------------------- | warning[disallowed-unique-constraint]: Adding a `UNIQUE` constraint requires an `ACCESS EXCLUSIVE` lock which blocks reads and writes to the table while the index is built. --> example-migration.sql:2:28 | 2 | ALTER TABLE table_name ADD CONSTRAINT field_name_constraint UNIQUE (field_name); - | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + | ---------------------------------------------------- | = help: Create an index CONCURRENTLY and create the constraint using the index.