ARROW-18322: [Python] Add PYARROW_WITH_FLIGHT to PyArrow C++ cmake

[AlenkaF]

This PR adds the use of PYARROW_WITH_FLIGHT environment variable when building PyArrow C++. With this change PyArrow will be able to build successfully even when Arrow C++ is installed without Arrow Flight (example, JFrog artifactory) but ARROW_FLIGHT flag is not registered to be set to off.
Note: PYARROW_WITH_FLIGHT=0 is needed when building PyArrow.

I tested the change on my regular build with Arrow Flight but with removed libarrow_flight* libs. Without this patch I get:

CMake Error at /Users/alenkafrim/repos/arrow/dist/lib/cmake/ArrowFlight/ArrowFlightTargets.cmake:93 (message):
  The imported target "ArrowFlight::arrow_flight_shared" references the file

     "/Users/alenkafrim/repos/arrow/dist/lib/libarrow_flight.1100.0.0.dylib"

  but this file does not exist.  Possible reasons include:

  * The file was deleted, renamed, or moved to another location.

  * An install or uninstall procedure did not complete successfully.

  * The installation package was faulty and contained

     "/Users/alenkafrim/repos/arrow/dist/lib/cmake/ArrowFlight/ArrowFlightTargets.cmake"

  but not all the files it references.

Call Stack (most recent call first):
  /Users/alenkafrim/repos/arrow/dist/lib/cmake/ArrowFlight/ArrowFlightConfig.cmake:56 (include)
  CMakeLists.txt:262 (find_package)

With this patch PyArrow builds succesfully.

[github-actions]

https://issues.apache.org/jira/browse/ARROW-18322

[kou]

+1

Thanks!

[ursabot]

Benchmark runs are scheduled for baseline = 77f099f and contender = 8f43a9f. 8f43a9f is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Finished ⬇️0.0% ⬆️0.0%] ec2-t3-xlarge-us-east-2
[Finished ⬇️0.6% ⬆️0.03%] test-mac-arm
[Finished ⬇️0.82% ⬆️0.82%] ursa-i9-9960x
[Finished ⬇️1.5% ⬆️0.03%] ursa-thinkcentre-m75q
Buildkite builds:
[Finished] 8f43a9fc ec2-t3-xlarge-us-east-2
[Finished] 8f43a9fc test-mac-arm
[Finished] 8f43a9fc ursa-i9-9960x
[Finished] 8f43a9fc ursa-thinkcentre-m75q
[Finished] 77f099fb ec2-t3-xlarge-us-east-2
[Finished] 77f099fb test-mac-arm
[Finished] 77f099fb ursa-i9-9960x
[Finished] 77f099fb ursa-thinkcentre-m75q
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

[ursabot]

['Python', 'R'] benchmarks have high level of regressions.
ursa-i9-9960x