GH-46835: [C++] Add more configuration options to arrow::EqualOptions

[andishgar]

Rationale for this change

Parameterizing the comparison of metadata and arrow::Schema via arrow::EqualOptions.

What changes are included in this PR?

• Added two attributes to arrow::EqualOptions for parameterizing the comparison of metadata and schema.

Are these changes tested?

Yes, I ran the relevant unit tests.

Are there any user-facing changes?

• Added use_schema() to arrow::EqualOptions.
• Added use_metadata() to arrow::EqualOptions.
• Added a new overload for arrow::RecordBatch::Equals that accepts only another arrow::RecordBatch and an arrow::EqualOptions instance.
• GitHub Issue: [C++] Add more configuration options to arrow::EqualOptions #46835

[github-actions]

⚠️ GitHub issue #46835 has been automatically assigned in GitHub to PR creator.

[andishgar]

Dear @kou , could you review it?

[kou]

@github-actions crossbow submit preview-docs

[Copilot]

Pull Request Overview

This PR adds more configuration options to arrow::EqualOptions to parameterize the comparison of metadata and schema in record batch equality checks. The changes allow users to control whether schema and metadata are considered during equality comparisons.

• Adds use_schema() and use_metadata() configuration methods to EqualOptions
• Introduces a new overload for RecordBatch::Equals that only takes another RecordBatch and EqualOptions
• Refactors existing equality comparison methods to use the new options

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
cpp/src/arrow/compare.h	Adds use_schema_ and use_metadata_ fields with corresponding getter/setter methods to EqualOptions
cpp/src/arrow/record_batch.h	Adds new Equals overload and updates ApproxEquals to be inline with simplified implementation
cpp/src/arrow/record_batch.cc	Consolidates equality logic into single method that respects new schema/metadata options
cpp/src/arrow/record_batch_test.cc	Updates tests to use new API and adds comprehensive test coverage for new options

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Revision: b5ab8ab6841d9977394bab82ece6dcabee73d234

Submitted crossbow builds: ursacomputing/crossbow @ actions-f0c3a4f46f

Task	Status
preview-docs

[andishgar]

Thank you for your feedback. I will look into it.

[kou]

@github-actions crossbow submit preview-docs

[github-actions]

Revision: 22a3544

Submitted crossbow builds: ursacomputing/crossbow @ actions-213c549c83

Task	Status
preview-docs

[kou]

@github-actions crossbow submit preview-docs

[kou]

http://crossbow.voltrondata.com/pr_docs/47204/cpp/api/utilities.html#_CPPv4N5arrow12EqualOptionsE

[github-actions]

Revision: c876f0c

Submitted crossbow builds: ursacomputing/crossbow @ actions-4c8f212ecc

Task	Status
preview-docs

[kou]

@github-actions crossbow submit preview-docs

[github-actions]

Revision: 97aedd6

Submitted crossbow builds: ursacomputing/crossbow @ actions-dd2ad05b92

Task	Status
preview-docs

[kou]

+1

[conbench-apache-arrow]

After merging your PR, Conbench analyzed the 4 benchmarking runs that have been run so far on merge-commit 084a365.

There weren't enough matching historic benchmark results to make a call on whether there were regressions.

The full Conbench report has more details.