feat(bigtable): modern Table constructor

[dbolduc]

Fixes #8860
Technically this fixes #6465 which fixes #1161. Although we should probably update our credentials sample. (I think of that task as #7434).

Release the Table constructor that accepts a DataConnection. Yay, we are close to having a good mocking story. and a good credentials story. (I say close because there is still the pesky legacy API which does not have these things and lives alongside the "new shinny").

For now I just list the relevant options in the constructor's documentation. I would like to link to examples of how the Options are used. But the examples must exist first. (#9309 tracks this work).

I would also like to provide guidance on how to mock the Table calls in this constructor's documentation. (which is blocked on #9308).

I think this feature warrants a detailed CHANGELOG entry, but I am going to wait until the other modernization work is done before writing the post.

---

This change is 

[google-cloud-cpp-bot]

Google Cloud Build Logs
For commit: 7f75d607b6c06db4b167c43997208a6bc95ee1b9

• Public Access Build Logs
• Cloud Build Console (requires auth)
• Kokoro Logs (requires auth)

ℹ️ NOTE: Kokoro logs are linked from "Details" below.

[codecov]

Codecov Report

Merging #9403 (f2db272) into main (28610e6) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main    #9403   +/-   ##
=======================================
  Coverage   94.60%   94.60%           
=======================================
  Files        1485     1485           
  Lines      136006   136008    +2     
=======================================
+ Hits       128669   128677    +8     
+ Misses       7337     7331    -6     

Impacted Files	Coverage Δ
google/cloud/bigtable/table.h	98.42% <100.00%> (-0.06%)	⬇️
google/cloud/bigtable/table_test.cc	100.00% <100.00%> (ø)
...e/cloud/bigtable/testing/table_integration_test.cc	80.87% <100.00%> (+0.21%)	⬆️
...ogle/cloud/bigtable/tests/data_integration_test.cc	97.72% <100.00%> (ø)
...gtable/tests/table_sample_rows_integration_test.cc	100.00% <100.00%> (ø)
google/cloud/internal/curl_impl.cc	91.87% <0.00%> (+0.22%)	⬆️
...cloud/pubsub/internal/subscription_session_test.cc	98.00% <0.00%> (+0.24%)	⬆️
...torage/examples/storage_service_account_samples.cc	97.64% <0.00%> (+0.58%)	⬆️
...loud/bigtable/internal/connection_refresh_state.cc	100.00% <0.00%> (+2.77%)	⬆️
...e/cloud/pubsublite/internal/alarm_registry_impl.cc	100.00% <0.00%> (+2.94%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 28610e6...f2db272. Read the comment docs.

[google-cloud-cpp-bot]

Google Cloud Build Logs
For commit: f2db272cfc5d49721713a19158a22d9600d51a3f

• Public Access Build Logs
• Cloud Build Console (requires auth)
• Kokoro Logs (requires auth)

ℹ️ NOTE: Kokoro logs are linked from "Details" below.

[dbolduc]

/gcbrun

[google-cloud-cpp-bot]

Google Cloud Build Logs
For commit: f2db272cfc5d49721713a19158a22d9600d51a3f

• Public Access Build Logs
• Cloud Build Console (requires auth)
• Kokoro Logs (requires auth)

ℹ️ NOTE: Kokoro logs are linked from "Details" below.

[dbolduc]

Another build failed to trigger. We go again.

[dbolduc]

/gcbrun

[google-cloud-cpp-bot]

Google Cloud Build Logs
For commit: f2db272cfc5d49721713a19158a22d9600d51a3f

• Public Access Build Logs
• Cloud Build Console (requires auth)
• Kokoro Logs (requires auth)

ℹ️ NOTE: Kokoro logs are linked from "Details" below.

[dbolduc]

oh duh, because the trigger is disabled...

[dbolduc]

/gcbrun

[google-cloud-cpp-bot]

Google Cloud Build Logs
For commit: f2db272cfc5d49721713a19158a22d9600d51a3f

• Public Access Build Logs
• Cloud Build Console (requires auth)
• Kokoro Logs (requires auth)

ℹ️ NOTE: Kokoro logs are linked from "Details" below.