Skip to content

DOC-15514: Product Change- PR #158499 - sql: show KV CPU Time in EXPLAIN ANALYZE #21727

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
florence-crl wants to merge 6 commits into
base: main
Choose a base branch
from
Open

DOC-15514: Product Change- PR #158499 - sql: show KV CPU Time in EXPLAIN ANALYZE #21727

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
86fcb49
In explain-analyze.md, in Global properties, added kv cpu time.
florence-crl Dec 18, 2025
0d86210
Merge remote-tracking branch 'origin/main' into DOC-15514
florence-crl Dec 18, 2025
978086c
Merge remote-tracking branch 'origin/main' into DOC-15514
florence-crl Dec 18, 2025
583901e
Incorporated Alyshan’s feedback.
florence-crl Dec 18, 2025
08ce6aa
Merge remote-tracking branch 'origin/main' into DOC-15514
florence-crl Dec 19, 2025
4b864f0
Incorporated Alyshan’s feedback.
florence-crl Dec 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion src/current/v26.1/explain-analyze.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,8 @@ Property | Description
`maximum memory usage` | The maximum amount of memory used by this statement anytime during its execution.
`network usage` | The amount of data transferred over the network while the statement was executed. If the value is 0 B, the statement was executed on a single node and didn't use the network.
`regions` | The [regions]({% link {{ page.version.version }}/show-regions.md %}) where the affected nodes were located.
`sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}). It does not include time spent in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}).
`kv cpu time` | The total amount of time spent in the [KV layer]({% link {{ page.version.version }}/architecture/overview.md %}#layers) on the critical path of serving the query. Excludes time spent on asynchronous replication and in the [storage layer]({% link {{ page.version.version }}/architecture/storage-layer.md %}).
Copy link
Contributor

@peachdawnleach peachdawnleach Dec 23, 2025

Choose a reason for hiding this comment

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

This links to a section about different layers, but the "KV layer" is not one of the layers mentioned. I'm guessing that "KV layer" is more of an overarching term rather than a specific layer, but I may be misunderstanding something. Approving the PR but this might need a bit of clarification unless there's just some common knowledge that I don't know here

`sql cpu time` | The total amount of time spent in the [SQL layer]({% link {{ page.version.version }}/architecture/sql-layer.md %}).
`max sql temp disk usage` | ([`DISTSQL`](#distsql-option) option only) How much disk spilling occurs when executing a query. This property is displayed only when the disk usage is greater than zero.
`estimated RUs consumed` | The estimated number of [Request Units (RUs)]({% link cockroachcloud/plan-your-cluster-basic.md %}#request-units) consumed by the statement. This property is visible only on CockroachDB {{ site.data.products.basic }} clusters.
`isolation level` | The [isolation level]({% link {{ page.version.version }}/transactions.md %}#isolation-levels) at which this statement executed.
Expand Down Expand Up @@ -226,6 +227,7 @@ EXPLAIN ANALYZE SELECT city, AVG(revenue) FROM rides GROUP BY city;
maximum memory usage: 240 KiB
network usage: 0 B (0 messages)
regions: us-east1
kv cpu time: 1ms
sql cpu time: 443µs
estimated RUs consumed: 0
isolation level: serializable
Expand Down Expand Up @@ -354,6 +356,7 @@ EXPLAIN ANALYZE (VERBOSE) SELECT city, AVG(revenue) FROM rides GROUP BY city;
maximum memory usage: 240 KiB
network usage: 0 B (0 messages)
regions: us-east1
kv cpu time: 944µs
sql cpu time: 275µs
estimated RUs consumed: 0
isolation level: serializable
Expand Down Expand Up @@ -418,6 +421,7 @@ EXPLAIN ANALYZE (DISTSQL) SELECT city, AVG(revenue) FROM rides GROUP BY city;
maximum memory usage: 240 KiB
network usage: 0 B (0 messages)
regions: us-east1
kv cpu time: 1ms
sql cpu time: 300µs
estimated RUs consumed: 0
isolation level: serializable
Expand Down Expand Up @@ -498,6 +502,7 @@ EXPLAIN ANALYZE (REDACT) SELECT * FROM rides WHERE revenue > 90 ORDER BY revenue
maximum memory usage: 290 KiB
network usage: 0 B (0 messages)
regions: us-east1
kv cpu time: 2ms
sql cpu time: 2ms
estimated RUs consumed: 0
isolation level: serializable
Expand Down
Loading