Skip to content

Document INSPECT improvements for v26.2#23199

Open
rmloveland wants to merge 1 commit intomainfrom
20260416-DOC-16220-inspect-improvements
Open

Document INSPECT improvements for v26.2#23199
rmloveland wants to merge 1 commit intomainfrom
20260416-DOC-16220-inspect-improvements

Conversation

@rmloveland
Copy link
Copy Markdown
Contributor

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 20, 2026

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit bd649bd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/69e65e256159c30007bced77

@github-actions
Copy link
Copy Markdown

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 20, 2026

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit bd649bd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/69e65e257b02de000827961c

@rmloveland rmloveland requested review from bghal and rafiss April 20, 2026 17:16
@rmloveland
Copy link
Copy Markdown
Contributor Author

@rafiss adding you as the author of cockroachdb/cockroach#163543

@bghal adding you as the author of cockroachdb/cockroach#164449

please let me know if i got something wrong here, or if there's missing context that we need to add, etc.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 20, 2026

Deploy Preview for cockroachdb-docs failed. Why did it fail? →

Name Link
🔨 Latest commit bd649bd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69e65e25663eda0007084ed0

- `IMPORT INTO` works with existing tables. To import data into a new table, see [Import into a new table from a CSV file](#import-into-a-new-table-from-a-csv-file).
- `IMPORT INTO` cannot be used during a [rolling upgrade]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}).
- `IMPORT INTO` is a blocking statement. To run an `IMPORT INTO` job asynchronously, use the [`DETACHED`](#options-detached) option.
- {% include_cached new-in.html version="v26.2" %} By default, after a successful `IMPORT INTO`, CockroachDB starts a background [`INSPECT`]({% link {{ page.version.version }}/inspect.md %}) job to validate the imported row count. The [`bulkio.import.row_count_validation.mode` cluster setting]({% link {{ page.version.version }}/cluster-settings.md %}#setting-bulkio-import-row-count-validation-mode) controls this behavior: `off`, `async` (default), or `sync`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We ended up not moving forward with this default (#168403) due to some unresolved issues.

Comment on lines +90 to +98
### Run a uniqueness check on a `REGIONAL BY ROW` primary index

On supported [`REGIONAL BY ROW`]({% link {{ page.version.version }}/alter-table.md %}#regional-by-row) tables, naming the primary index lets `INSPECT` run the uniqueness check for that index:

{% include_cached copy-clipboard.html %}
~~~ sql
INSPECT TABLE mr_db.public.users WITH OPTIONS INDEX (users_pkey);
~~~

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to be clear, the primary doesn't need to be named to run explicitly (i.e. INSPECT TABLE t would run the uniqueness check on the primary index if it's a supported type in addition to any other supported checks).

@rafiss rafiss requested a review from spilchen April 22, 2026 21:48
Copy link
Copy Markdown
Contributor

@spilchen spilchen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good. I didn't have any other comments other than the ones Brendan had

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants