Skip to content

Conversation

@florence-crl
Copy link
Contributor

@florence-crl florence-crl commented Dec 12, 2025

Fixes DOC-15477

  • In user-defined-function.md and stored-procedures.md, added Statement statistics section.
  • In routine-limitations.md, added limitation for statement diagnostics.
  • In statements-views.md, added callout that statements include those executed in UDF/SPs.
  • In transaction-diagnostics.md, added callout about limitation for statement diagnostics.

Rendered preview

… statistics section.

In routine-limitations.md, added limitation for statement diagnostics.

In statements-views.md, added callout that statements include those executed in UDF/SPs.

In transaction-diagnostics.md, added callout about limitation for statement diagnostics.
@github-actions
Copy link

@netlify
Copy link

netlify bot commented Dec 12, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 110e5f3
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/693c9ea9754bab00085ee7d2

@netlify
Copy link

netlify bot commented Dec 12, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 110e5f3
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/693c9ea9b55abe0008821d93

@florence-crl
Copy link
Contributor Author

@kyle-a-wong , please review and let me know what is the issue number for the limitation. thanks!

@netlify
Copy link

netlify bot commented Dec 12, 2025

Netlify Preview

Name Link
🔨 Latest commit 110e5f3
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/693c9ea8631f0a00085ceb64
😎 Deploy Preview https://deploy-preview-21621--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.


{{site.data.alerts.callout_info}}
Transaction diagnostics cannot be collected for statements executed within [user-defined functions]({% link {{ page.version.version }}/user-defined-functions.md %}) or [stored procedures]({% link {{ page.version.version }}/stored-procedures.md %}). Transaction diagnostics continue to work only for top-level statement executions.
{{site.data.alerts.end}}
Copy link
Contributor

Choose a reason for hiding this comment

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

I think it would be better phrased as something like: "Transaction diagnostics will not contain a statement diagnostic bundle for statements executed in udfs / sps, but will contain a bundle for the top level udf / sp invocation (or call)"

These statements will also appear in the [**Transaction details**]({% link {{ page.version.version }}/ui-transactions-page.md %}#transaction-details-page) in the **Statement Fingerprints** table when the stored procedure is invoked as part of a transaction.

{{site.data.alerts.callout_info}}
Statement diagnostics cannot be collected for statements executed within stored procedures. Statement diagnostics continue to work only for top-level statement executions. For details, see [Known limitations](#known-limitations).
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure where exactly it should live in this document, but I want to note that statement diagnostics can be requested for the top level UDF / SP statement, and the trace will contain spans for each statement executed. There is just no way (currently) to get specific to have statements executed in the UDF / SP to fulfill an open statement diagnostics request.

These statements will also appear in the [**Transaction details**]({% link {{ page.version.version }}/ui-transactions-page.md %}#transaction-details-page) in the **Statement Fingerprints** table when the UDF is invoked as part of a transaction.

{{site.data.alerts.callout_info}}
Statement diagnostics cannot be collected for statements executed within UDFs. Statement diagnostics continue to work only for top-level statement executions. For details, see [Known limitations](#known-limitations).
Copy link
Contributor

Choose a reason for hiding this comment

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

Same here as i mentioned in the stored procedure doc

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.

2 participants