Uses of Class
com.google.cloud.spanner.SpannerException
Package
Description
A client for Cloud Spanner - A no-compromise relational database service.
Internal API for Google Cloud Spanner.
-
Uses of SpannerException in com.google.cloud.spanner
Modifier and TypeClassDescriptionclass
Exception thrown by aConnection
when a database operation detects that a transaction has aborted and an internal retry failed because of a concurrent modification.class
Exception thrown by Cloud Spanner when an operation detects that a transaction has aborted.class
Exception thrown by Cloud Spanner the number of administrative requests per minute has been exceeded.class
Exception thrown by Cloud Spanner when an operation detects that the database that is being used no longer exists.class
Exception thrown by Cloud Spanner when an operation detects that the instance that is being used no longer exists.class
Exception thrown by Cloud Spanner when an operation detects that the session that is being used is no longer valid.class
static class
Base exception type for NOT_FOUND exceptions for known resource types.Modifier and TypeMethodDescriptionstatic SpannerException
SpannerExceptionFactory.asSpannerException
(Throwable t) Converts the givenThrowable
to aSpannerException
.AbortedDueToConcurrentModificationException.getDatabaseErrorDuringRetry()
static SpannerException
SpannerExceptionFactory.newSpannerException
(ErrorCode code, String message) static SpannerException
SpannerExceptionFactory.newSpannerException
(ErrorCode code, String message, Throwable cause) static SpannerException
SpannerExceptionFactory.newSpannerException
(io.grpc.Context context, Throwable cause) Creates a new exception based oncause
.static SpannerException
SpannerExceptionFactory.newSpannerException
(Throwable cause) Creates a new exception based oncause
.static SpannerException
SpannerExceptionFactory.propagateInterrupt
(InterruptedException e) static SpannerException
SpannerExceptionFactory.propagateTimeout
(TimeoutException e) Transforms aTimeoutException
to aSpannerException
.Modifier and TypeMethodDescriptionSpannerExceptionFactory.newAbortedDueToConcurrentModificationException
(AbortedException cause, SpannerException databaseError) Constructs a specific aborted exception that should only be thrown by a connection after an internal retry aborted because a database call caused an exception that did not happen during the original attempt.Modifier and TypeMethodDescriptioncom.google.api.gax.longrunning.OperationFuture<Backup,
CreateBackupMetadata> DatabaseAdminClient.createBackup
(Backup backup) Creates a new backup from a database in a Cloud Spanner.com.google.api.gax.longrunning.OperationFuture<Backup,
CreateBackupMetadata> DatabaseAdminClient.createBackup
(String sourceInstanceId, String backupId, String databaseId, com.google.cloud.Timestamp expireTime) Creates a new backup from a database in a Cloud Spanner instance.com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> DatabaseAdminClient.createDatabase
(Database database, Iterable<String> statements) Creates a database in a Cloud Spanner instance.default com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> DatabaseAdminClient.createDatabase
(String instanceId, String createDatabaseStatement, Dialect dialect, Iterable<String> statements) Creates a new database in a Cloud Spanner instance with the givenDialect
.com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> DatabaseAdminClient.createDatabase
(String instanceId, String databaseId, Iterable<String> statements) Creates a new database in a Cloud Spanner instance.com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> Instance.createDatabase
(String databaseId, Iterable<String> statements) Creates a new database in this instance.com.google.api.gax.longrunning.OperationFuture<Instance,
CreateInstanceMetadata> InstanceAdminClient.createInstance
(InstanceInfo instance) Creates an instance and begins preparing it to begin serving.default com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
CreateInstanceConfigMetadata> InstanceAdminClient.createInstanceConfig
(InstanceConfigInfo instanceConfig, Options.CreateAdminApiOption... options) Creates an instance config and begins preparing it to be used.void
Backup.delete()
Deletes this backup on Cloud Spanner.void
InstanceAdminClient.deleteInstance
(String instanceId) Deletes an instance.default void
InstanceAdminClient.deleteInstanceConfig
(String instanceConfigId, Options.DeleteAdminApiOption... options) Deletes a custom instance config.void
Database.drop()
Drops this database.void
DatabaseAdminClient.dropDatabase
(String instanceId, String databaseId) Drops a Cloud Spanner database.Execute the partition to returnResultSet
.static <T> T
SpannerApiFutures.get
(com.google.api.core.ApiFuture<T> future) Gets the current state of a Cloud Spanner database backup.DatabaseAdminClient.getDatabase
(String instanceId, String databaseId) Gets the current state of a Cloud Spanner database.Database.getDdl()
Returns the schema of a Cloud Spanner database as a list of formatted DDL statements.InstanceAdminClient.getInstance
(String instanceId) Gets an instance.InstanceAdminClient.getInstanceConfig
(String configId) Gets an instance config.static <T> T
SpannerApiFutures.getOrNull
(com.google.api.core.ApiFuture<T> future) Operation.getResult()
Returns result of the operation if the operation is complete and had a result.com.google.api.gax.paging.Page<InstanceConfig>
InstanceAdminClient.listInstanceConfigs
(Options.ListOption... options) Lists the supported instance configs for current project.com.google.api.gax.paging.Page<Instance>
InstanceAdminClient.listInstances
(Options.ListOption... options) Lists the instances.boolean
ForwardingResultSet.next()
boolean
ResultSet.next()
Advances the result set to the next row, returning false if no such row exists.BatchReadOnlyTransaction.partitionQuery
(PartitionOptions partitionOptions, Statement statement, Options.QueryOption... options) Returns a list ofPartition
to execute a query against the database.BatchReadOnlyTransaction.partitionRead
(PartitionOptions partitionOptions, String table, KeySet keys, Iterable<String> columns, Options.ReadOption... options) Returns a list ofPartition
to read zero or more rows from a database.BatchReadOnlyTransaction.partitionReadUsingIndex
(PartitionOptions partitionOptions, String table, String index, KeySet keys, Iterable<String> columns, Options.ReadOption... options) Returns a list ofPartition
to read zero or more rows from a database using an index.Backup.reload()
Fetches the backup's current information and returns a newBackup
instance.Database.reload()
Fetches the database's current information.Operation.reload()
Fetches the current status of this operation.com.google.api.gax.longrunning.OperationFuture<Database,
RestoreDatabaseMetadata> DatabaseAdminClient.restoreDatabase
(Restore restore) Restore a database from a backup.com.google.api.gax.longrunning.OperationFuture<Database,
RestoreDatabaseMetadata> DatabaseAdminClient.restoreDatabase
(String backupInstanceId, String backupId, String restoreInstanceId, String restoreDatabaseId) Restore a database from a backup.<T> List<T>
AsyncResultSet.toList
(com.google.common.base.Function<StructReader, T> transformer) Transforms the row cursor into an immutable list using the given transformer function.<T> List<T>
ForwardingAsyncResultSet.toList
(com.google.common.base.Function<StructReader, T> transformer) AsyncResultSet.tryNext()
Non-blocking call that attempts to step the cursor to the next position in the stream.ForwardingAsyncResultSet.tryNext()
com.google.api.gax.longrunning.OperationFuture<Database,
UpdateDatabaseMetadata> DatabaseAdminClient.updateDatabase
(Database database, DatabaseInfo.DatabaseField... fieldsToUpdate) Updates a Cloud Spanner database.com.google.api.gax.longrunning.OperationFuture<Void,
UpdateDatabaseDdlMetadata> DatabaseAdminClient.updateDatabaseDdl
(String instanceId, String databaseId, Iterable<String> statements, String operationId) Enqueues the given DDL statements to be applied, in order but not necessarily all at once, to the database schema at some point (or points) in the future.com.google.api.gax.longrunning.OperationFuture<Void,
UpdateDatabaseDdlMetadata> Enqueues the given DDL statements to be applied, in order but not necessarily all at once, to the database schema at some point (or points) in the future.default com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
UpdateInstanceConfigMetadata> InstanceAdminClient.updateInstanceConfig
(InstanceConfigInfo instanceConfig, Iterable<InstanceConfigInfo.InstanceConfigField> fieldsToUpdate, Options.UpdateAdminApiOption... options) Updates a custom instance config.Operation.waitFor
(com.google.cloud.RetryOption... waitOptions) Blocks till the operation is complete or maximum time, if specified, has elapsed.com.google.cloud.Timestamp
Writes the given mutations atomically to the database.com.google.cloud.Timestamp
DatabaseClient.writeAtLeastOnce
(Iterable<Mutation> mutations) Writes the given mutations atomically to the database without replay protection.DatabaseClient.writeAtLeastOnceWithOptions
(Iterable<Mutation> mutations, Options.TransactionOption... options) Writes the given mutations atomically to the database without replay protection.DatabaseClient.writeWithOptions
(Iterable<Mutation> mutations, Options.TransactionOption... options) Writes the given mutations atomically to the database with the given options. -
Uses of SpannerException in com.google.cloud.spanner.connection
Modifier and TypeMethodDescriptionstatic com.google.cloud.Timestamp
ReadOnlyStalenessUtil.parseRfc3339
(String str) Parses an RFC3339 date/time value with nanosecond precision and returns this as aTimestamp
. -
Uses of SpannerException in com.google.cloud.spanner.spi.v1
Modifier and TypeMethodDescriptionvoid
SpannerRpc.ResultStreamConsumer.onError
(SpannerException e) Modifier and TypeMethodDescriptioncom.google.api.core.ApiFuture<com.google.protobuf.Empty>
SpannerRpc.asyncDeleteSession
(String sessionName, Map<SpannerRpc.Option, ?> options) GapicSpannerRpc.batchCreateSessions
(String databaseName, int sessionCount, String databaseRole, Map<String, String> labels, Map<SpannerRpc.Option, ?> options) SpannerRpc.batchCreateSessions
(String databaseName, int sessionCount, String databaseRole, Map<String, String> labels, Map<SpannerRpc.Option, ?> options) GapicSpannerRpc.beginTransaction
(BeginTransactionRequest request, Map<SpannerRpc.Option, ?> options, boolean routeToLeader) SpannerRpc.beginTransaction
(BeginTransactionRequest request, Map<SpannerRpc.Option, ?> options, boolean routeToLeader) Begins a transaction.void
GapicSpannerRpc.cancelOperation
(String name) void
SpannerRpc.cancelOperation
(String name) Cancels the specified long-running operation.GapicSpannerRpc.commit
(CommitRequest commitRequest, Map<SpannerRpc.Option, ?> options) SpannerRpc.commit
(CommitRequest commitRequest, Map<SpannerRpc.Option, ?> options) com.google.api.gax.longrunning.OperationFuture<Backup,
CopyBackupMetadata> GapicSpannerRpc.copyBackup
(BackupId sourceBackupId, Backup destinationBackup) com.google.api.gax.longrunning.OperationFuture<Backup,
CreateBackupMetadata> GapicSpannerRpc.createBackup
(Backup backupInfo) com.google.api.gax.longrunning.OperationFuture<Backup,
CreateBackupMetadata> SpannerRpc.createBackup
(Backup backupInfo) Creates a new backup from the source database specified in theBackup
instance.com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> GapicSpannerRpc.createDatabase
(String instanceName, String createDatabaseStatement, Iterable<String> additionalStatements, Database databaseInfo) com.google.api.gax.longrunning.OperationFuture<Database,
CreateDatabaseMetadata> SpannerRpc.createDatabase
(String instanceName, String createDatabaseStatement, Iterable<String> additionalStatements, Database database) com.google.api.gax.longrunning.OperationFuture<Instance,
CreateInstanceMetadata> GapicSpannerRpc.createInstance
(String parent, String instanceId, Instance instance) com.google.api.gax.longrunning.OperationFuture<Instance,
CreateInstanceMetadata> SpannerRpc.createInstance
(String parent, String instanceId, Instance instance) com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
CreateInstanceConfigMetadata> GapicSpannerRpc.createInstanceConfig
(String parent, String instanceConfigId, InstanceConfig instanceConfig, Boolean validateOnly) default com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
CreateInstanceConfigMetadata> SpannerRpc.createInstanceConfig
(String parent, String instanceConfigId, InstanceConfig instanceConfig, Boolean validateOnly) GapicSpannerRpc.createSession
(String databaseName, String databaseRole, Map<String, String> labels, Map<SpannerRpc.Option, ?> options) SpannerRpc.createSession
(String databaseName, String databaseRole, Map<String, String> labels, Map<SpannerRpc.Option, ?> options) void
GapicSpannerRpc.deleteInstance
(String instanceName) void
SpannerRpc.deleteInstance
(String instanceName) void
GapicSpannerRpc.deleteInstanceConfig
(String instanceConfigName, String etag, Boolean validateOnly) default void
SpannerRpc.deleteInstanceConfig
(String instanceConfigName, String etag, Boolean validateOnly) void
GapicSpannerRpc.deleteSession
(String sessionName, Map<SpannerRpc.Option, ?> options) void
SpannerRpc.deleteSession
(String sessionName, Map<SpannerRpc.Option, ?> options) void
GapicSpannerRpc.dropDatabase
(String databaseName) void
SpannerRpc.dropDatabase
(String databaseName) Gets the backup with the specified name.GapicSpannerRpc.getDatabase
(String databaseName) SpannerRpc.getDatabase
(String databaseName) GapicSpannerRpc.getDatabaseDdl
(String databaseName) SpannerRpc.getDatabaseDdl
(String databaseName) GapicSpannerRpc.getInstance
(String instanceName) SpannerRpc.getInstance
(String instanceName) GapicSpannerRpc.getInstanceConfig
(String instanceConfigName) SpannerRpc.getInstanceConfig
(String instanceConfigName) com.google.longrunning.Operation
GapicSpannerRpc.getOperation
(String name) com.google.longrunning.Operation
SpannerRpc.getOperation
(String name) Retrieves a long running operation.GapicSpannerRpc.listBackups
(String instanceName, int pageSize, String filter, String pageToken) SpannerRpc.listBackups
(String instanceName, int pageSize, String filter, String pageToken) Lists the backups in the specified instance.GapicSpannerRpc.listDatabases
(String instanceName, int pageSize, String pageToken) SpannerRpc.listDatabases
(String instanceName, int pageSize, String pageToken) GapicSpannerRpc.listInstanceConfigs
(int pageSize, String pageToken) SpannerRpc.listInstanceConfigs
(int pageSize, String pageToken) GapicSpannerRpc.listInstances
(int pageSize, String pageToken, String filter) SpannerRpc.listInstances
(int pageSize, String pageToken, String filter) GapicSpannerRpc.partitionQuery
(PartitionQueryRequest request, Map<SpannerRpc.Option, ?> options) SpannerRpc.partitionQuery
(PartitionQueryRequest request, Map<SpannerRpc.Option, ?> options) GapicSpannerRpc.partitionRead
(PartitionReadRequest request, Map<SpannerRpc.Option, ?> options) SpannerRpc.partitionRead
(PartitionReadRequest request, Map<SpannerRpc.Option, ?> options) void
GapicSpannerRpc.rollback
(RollbackRequest request, Map<SpannerRpc.Option, ?> options) void
SpannerRpc.rollback
(RollbackRequest request, Map<SpannerRpc.Option, ?> options) com.google.api.gax.longrunning.OperationFuture<Database,
UpdateDatabaseMetadata> GapicSpannerRpc.updateDatabase
(Database database, com.google.protobuf.FieldMask updateMask) com.google.api.gax.longrunning.OperationFuture<Database,
UpdateDatabaseMetadata> SpannerRpc.updateDatabase
(Database database, com.google.protobuf.FieldMask fieldMask) Updates the specified fields of a Cloud Spanner database.com.google.api.gax.longrunning.OperationFuture<com.google.protobuf.Empty,
UpdateDatabaseDdlMetadata> GapicSpannerRpc.updateDatabaseDdl
(String databaseName, Iterable<String> updateDatabaseStatements, String updateId) If the update database ddl operation returns an ALREADY_EXISTS error, meaning the operation id used is already in flight, this method will simply resume the original operation.com.google.api.gax.longrunning.OperationFuture<com.google.protobuf.Empty,
UpdateDatabaseDdlMetadata> SpannerRpc.updateDatabaseDdl
(String databaseName, Iterable<String> updateDatabaseStatements, String updateId) com.google.api.gax.longrunning.OperationFuture<Instance,
UpdateInstanceMetadata> GapicSpannerRpc.updateInstance
(Instance instance, com.google.protobuf.FieldMask fieldMask) com.google.api.gax.longrunning.OperationFuture<Instance,
UpdateInstanceMetadata> SpannerRpc.updateInstance
(Instance instance, com.google.protobuf.FieldMask fieldMask) com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
UpdateInstanceConfigMetadata> GapicSpannerRpc.updateInstanceConfig
(InstanceConfig instanceConfig, Boolean validateOnly, com.google.protobuf.FieldMask fieldMask) default com.google.api.gax.longrunning.OperationFuture<InstanceConfig,
UpdateInstanceConfigMetadata> SpannerRpc.updateInstanceConfig
(InstanceConfig instanceConfig, Boolean validateOnly, com.google.protobuf.FieldMask fieldMask) -
Uses of SpannerException in com.google.cloud.spanner.testing
Modifier and TypeMethodDescriptionRemoteSpannerHelper.createTestDatabase
(Dialect dialect, Iterable<String> statements) Creates a test database defined bystatements
in the test instance.RemoteSpannerHelper.createTestDatabase
(Iterable<String> statements) RemoteSpannerHelper.createTestDatabase
(String... statements) Creates a test database defined bystatements
.