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

doc: Add Plan Stability Testing to development guide #432

Merged
merged 2 commits into from
May 15, 2024

Conversation

viirya
Copy link
Member

@viirya viirya commented May 14, 2024

Which issue does this PR close?

Closes #.

Rationale for this change

What changes are included in this PR?

How are these changes tested?

The plan stability testing framework is located in the `spark` module and can be run using the following command:

```
mvn -pl spark -Dsuites="org.apache.spark.sql.comet.CometTPCDSV1_4_PlanStabilitySuite" test
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 we should recommend to use ./mvnw

Copy link
Member Author

Choose a reason for hiding this comment

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

Okay

mvn -pl spark -Dsuites="org.apache.spark.sql.comet.CometTPCDSV2_7_PlanStabilitySuite" test
```

If your pull request changes the query plans generated by Comet, you should run the plan stability tests to regenerate the golden files.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: I guess we can remove run the plan stability tests to

Copy link
Member

Choose a reason for hiding this comment

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

Should we have a CI check that runs the plan stability tests to generate the golden files and then fail the build if the generated files cause a local diff?

Copy link
Member

Choose a reason for hiding this comment

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

Actually, never mind. We don't need this because the build would fail anyway if the golden files do not match the output from the test.

Copy link
Member Author

Choose a reason for hiding this comment

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

nit: I guess we can remove run the plan stability tests to

Okay.

@viirya viirya merged commit 1a04805 into apache:main May 15, 2024
@viirya
Copy link
Member Author

viirya commented May 15, 2024

Merged. Thanks @kazuyukitanimura @andygrove

@viirya viirya deleted the update_doc_plan_stability branch May 15, 2024 01:28
himadripal pushed a commit to himadripal/datafusion-comet that referenced this pull request Sep 7, 2024
* doc: Add Plan Stability Testing to development guide

* For review

(cherry picked from commit 1a04805)
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