Skip to content
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.

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

Change all references in user-facing error messages to point to discussions instead of issues #29611

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

chaas
Copy link
Contributor

@chaas chaas commented Sep 17, 2024

In some cases, I first added a new discussion item to track the feature request and then updated the error message to reference the discussion item.
In other cases, I removed the issue reference if it wasn't useful anymore or something that users are likely to ask for.

Motivation

  • This PR refactors existing code. In service of the plans to make Github issues private, and use Github discussions for public tracking instead.

Checklist

  • This PR has adequate test coverage / QA involvement has been duly considered. (trigger-ci for additional test/nightly runs)
  • This PR has an associated up-to-date design doc, is a design doc (template), or is sufficiently small to not require a design.
  • If this PR evolves an existing $T ⇔ Proto$T mapping (possibly in a backwards-incompatible way), then it is tagged with a T-proto label.
  • If this PR will require changes to cloud orchestration or tests, there is a companion cloud PR to account for those changes that is tagged with the release-blocker label (example).
  • If this PR includes major user-facing behavior changes, I have pinged the relevant PM to schedule a changelog post.

…ssions instead of issues, or remove the issue reference if it wasn't useful anymore
@chaas chaas marked this pull request as ready for review September 19, 2024 14:23
@chaas chaas requested review from a team as code owners September 19, 2024 14:23
Copy link
Member

@benesch benesch left a comment

Choose a reason for hiding this comment

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

Thank you!

Copy link
Contributor

@jkosh44 jkosh44 left a comment

Choose a reason for hiding this comment

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

LGTM

src/expr/src/scalar.proto Outdated Show resolved Hide resolved
Co-authored-by: Joseph Koshakow <[email protected]>
@@ -736,7 +736,9 @@ message ProtoDomainLimit {
message ProtoEvalError {
message ProtoUnsupported {
string feature = 1;
optional uint64 issue_no = 2;
Copy link
Member

Choose a reason for hiding this comment

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

We need to be careful with this change as it can prevent data from being compacted in persist. We should determine if we have any of these errors durably recorded in persist before merging the change.

Copy link
Contributor

Choose a reason for hiding this comment

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

These are not used in the catalog persist shard. Would they be used anywhere else?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We do write the error message text to mz_internal.mz_statement_execution_history (the activity log) in some cases. Would this change make it so the index on the activity log wouldn't compact properly?

Copy link
Member

Choose a reason for hiding this comment

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

I think we can write the error proto itself to any persist shard, but I'm not exactly sure about this variant. Someone who knows more would need to check.

The issue is that once we fix the error, we'd generate a retraction, but that retraction would not match any durable error, so both the insert and retraction would stay around forever. The same problem happens for the in-memory representation I think and can cause problems at runtime.

Copy link
Member

Choose a reason for hiding this comment

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

In this case, changing the name of the field won't change its on-disk encoding, so we can do that to get around the problem. @chaas can you remove the reserved 2 and bumping the field number, and just do a rename of the existing field with ID 2?

Copy link
Member

Choose a reason for hiding this comment

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

I think I successfully confused myself! For the in-memory representation, it shouldn't cause problems because the persist sink self-corrects the contents of a materialized view. Only the persist compaction might leave things around that are semantically equivalent but have a different bit pattern. So, retracting my request changes!

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.

4 participants