docs: add background info for session pool (#2498)

* docs: add background info for session pool

Adds additional technical background information on how the session and
and channel pools work.

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* chore: add code formatting

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: olavloite

.readme-partials.yaml

@@ -41,6 +41,15 @@ custom_content: |
 
   In [DatabaseSelect.java](https://github.com/googleapis/google-cloud-java/tree/master/google-cloud-examples/src/main/java/com/google/cloud/examples/spanner/snippets/DatabaseSelect.java) we put together all the code shown above in a single program.
 
+  ## Session Pool
+
+  The Cloud Spanner client maintains a session pool, as sessions are expensive to create and are
+  intended to be long-lived. The client automatically takes a session from the pool and uses this
+  executing queries and transactions.
+  See [Session Pool and Channel Pool Configuration](session-and-channel-pool-configuration.md)
+  for in-depth background information about sessions and gRPC channels and how these are handled in
+  the Cloud Spanner Java client.
+
   ## OpenCensus Metrics
 
   Cloud Spanner client supports [Opencensus Metrics](https://opencensus.io/stats/),

README.md

@@ -147,6 +147,15 @@ try {
 
 In [DatabaseSelect.java](https://github.com/googleapis/google-cloud-java/tree/master/google-cloud-examples/src/main/java/com/google/cloud/examples/spanner/snippets/DatabaseSelect.java) we put together all the code shown above in a single program.
 
+## Session Pool
+
+The Cloud Spanner client maintains a session pool, as sessions are expensive to create and are
+intended to be long-lived. The client automatically takes a session from the pool and uses this
+executing queries and transactions.
+See [Session Pool and Channel Pool Configuration](session-and-channel-pool-configuration.md)
+for in-depth background information about sessions and gRPC channels and how these are handled in
+the Cloud Spanner Java client.
+
 ## OpenCensus Metrics
 
 Cloud Spanner client supports [Opencensus Metrics](https://opencensus.io/stats/),