Deprecate legacy datafusion::logical_plan module

[andygrove]

Which issue does this PR close?

Part of #2683

Rationale for this change

Part of stabilizing the public API

What changes are included in this PR?

Deprecate the legacy logical_plan module in datafusion "core" crate. This just contains re-exports of other items.

Are there any user-facing changes?

Yes, API change.

[codecov-commenter]

Codecov Report

Merging #3338 (c37fe23) into master (dadd2dc) will not change coverage.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##           master    #3338   +/-   ##
=======================================
  Coverage   85.83%   85.83%           
=======================================
  Files         294      294           
  Lines       53752    53752           
=======================================
  Hits        46137    46137           
  Misses       7615     7615           

Impacted Files	Coverage Δ
datafusion/core/src/dataframe.rs	88.91% <ø> (ø)
datafusion/core/src/datasource/listing/helpers.rs	95.01% <100.00%> (ø)
datafusion/core/src/physical_optimizer/pruning.rs	94.75% <100.00%> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[alamb]

I merged the code in this PR with the latest apache/master and verified the tests still pass 👍

[ursabot]

Benchmark runs are scheduled for baseline = 5621e3b and contender = 93a95c2. 93a95c2 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Skipped ⚠️ Benchmarking of arrow-datafusion-commits is not supported on ec2-t3-xlarge-us-east-2] ec2-t3-xlarge-us-east-2
[Skipped ⚠️ Benchmarking of arrow-datafusion-commits is not supported on test-mac-arm] test-mac-arm
[Skipped ⚠️ Benchmarking of arrow-datafusion-commits is not supported on ursa-i9-9960x] ursa-i9-9960x
[Skipped ⚠️ Benchmarking of arrow-datafusion-commits is not supported on ursa-thinkcentre-m75q] ursa-thinkcentre-m75q
Buildkite builds:
Supported benchmarks:
ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python, R. Runs only benchmarks with cloud = True
test-mac-arm: Supported benchmark langs: C++, Python, R
ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java