Package com.google.cloud.spanner
Interface Spanner
- All Superinterfaces:
AutoCloseable
,com.google.cloud.Service<SpannerOptions>
An interface for Cloud Spanner. Typically, there would only be one instance of this for the
lifetime of the application which must be closed by invoking
close()
when it is no
longer needed. Failure to do so may result in leaking session resources and exhausting session
quota.-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes all the clients associated with this instance and frees up all the resources.com.google.api.gax.core.ExecutorProvider
Returns aBatchClient
to do batch operations on Cloud Spanner databases.Returns aDatabaseAdminClient
to do admin operations on Cloud Spanner databases.Returns aDatabaseClient
for the given database.Returns anInstanceAdminClient
to do admin operations on Cloud Spanner instances.boolean
isClosed()
Methods inherited from interface com.google.cloud.Service
getOptions
-
Method Details
-
getDatabaseAdminClient
DatabaseAdminClient getDatabaseAdminClient()Returns aDatabaseAdminClient
to do admin operations on Cloud Spanner databases. -
getInstanceAdminClient
InstanceAdminClient getInstanceAdminClient()Returns anInstanceAdminClient
to do admin operations on Cloud Spanner instances. -
getDatabaseClient
Returns aDatabaseClient
for the given database. It uses a pool of sessions to talk to the database.SpannerOptions options = SpannerOptions.newBuilder().build(); Spanner spanner = options.getService(); final String project = "test-project"; final String instance = "test-instance"; final String database = "example-db"; DatabaseId db = DatabaseId.of(project, instance, database); DatabaseClient dbClient = spanner.getDatabaseClient(db);
-
getBatchClient
Returns aBatchClient
to do batch operations on Cloud Spanner databases. Batch client is useful when one wants to read/query a large amount of data from Cloud Spanner across multiple processes, even across different machines. It allows to create partitions of Cloud Spanner database and then read/query over each partition independently yet at the same snapshot.For all other use cases,
DatabaseClient
is more appropriate and performant.SpannerOptions options = SpannerOptions.newBuilder().build(); Spanner spanner = options.getService(); final String project = "test-project"; final String instance = "test-instance"; final String database = "example-db"; DatabaseId db = DatabaseId.of(project, instance, database); BatchClient batchClient = spanner.getBatchClient(db);
-
close
void close()Closes all the clients associated with this instance and frees up all the resources. This method will block until it can clean up all the resources. Specifically, it deletes all the underlying sessions (which involves rpcs) and closes all the gRPC channels. Once this method called, this object is no longer usable. It is strongly advised to call this method when you are done with theSpanner
object, typically when your application shuts down. There is a hard limit on number of sessions in Cloud Spanner and not calling this method can lead to unused sessions piling up on the backend.- Specified by:
close
in interfaceAutoCloseable
-
isClosed
boolean isClosed()- Returns:
true
if thisSpanner
object is closed.
-
getAsyncExecutorProvider
com.google.api.gax.core.ExecutorProvider getAsyncExecutorProvider()- Returns:
- the
ExecutorProvider
that is used for asynchronous queries and operations.
-