# Interface DatabaseClient (2.40.0)

2.40.0 (latest) 2.38.0 2.35.4 2.34.0 2.33.2 2.32.3 2.31.2 2.30.4 2.28.0 2.27.1 2.26.1 2.25.1 2.24.1 2.23.0 2.22.1 2.21.0 2.20.2 2.19.3 2.18.1 2.17.0 2.16.1 2.15.5 2.14.6 2.13.4 2.11.4 2.10.0 2.9.16 2.8.0 2.7.12 2.6.4 2.5.11

    public interface DatabaseClient

## Methods

### batchWriteAtLeastOnce(Iterable\<MutationGroup\> arg0, Options.TransactionOption\[\] arg1)

    public abstract ServerStream<BatchWriteResponse> batchWriteAtLeastOnce(Iterable<MutationGroup> arg0, Options.TransactionOption[] arg1)

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.MutationGroup>` |
| `arg1` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.rpc.ServerStream.html<com.google.spanner.v1.BatchWriteResponse>` |   |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.SpannerException` |   |

### executePartitionedUpdate(Statement arg0, Options.UpdateOption\[\] arg1)

    public abstract long executePartitionedUpdate(Statement arg0, Options.UpdateOption[] arg1)

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Statement` |
| `arg1` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.UpdateOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |   |

### getDatabaseRole()

    public default String getDatabaseRole()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` |   |

### getDialect()

    public default Dialect getDialect()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Dialect` |   |

### getStatementFactory()

    public default Statement.StatementFactory getStatementFactory()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Statement.StatementFactory` |   |

### readOnlyTransaction()

    public abstract ReadOnlyTransaction readOnlyTransaction()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### readOnlyTransaction(Options.ReadOnlyTransactionOption\[\] arg0)

    public default ReadOnlyTransaction readOnlyTransaction(Options.ReadOnlyTransactionOption[] arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.ReadOnlyTransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### readOnlyTransaction(TimestampBound arg0)

    public abstract ReadOnlyTransaction readOnlyTransaction(TimestampBound arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TimestampBound` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### readOnlyTransaction(TimestampBound arg0, Options.ReadOnlyTransactionOption\[\] arg1)

    public default ReadOnlyTransaction readOnlyTransaction(TimestampBound arg0, Options.ReadOnlyTransactionOption[] arg1)

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TimestampBound` |
| `arg1` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.ReadOnlyTransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### readWriteTransaction(Options.TransactionOption\[\] arg0)

    public abstract TransactionRunner readWriteTransaction(Options.TransactionOption[] arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TransactionRunner` |   |

### runAsync(Options.TransactionOption\[\] arg0)

    public abstract AsyncRunner runAsync(Options.TransactionOption[] arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.AsyncRunner` |   |

### singleUse()

    public abstract ReadContext singleUse()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadContext` |   |

### singleUse(TimestampBound arg0)

    public abstract ReadContext singleUse(TimestampBound arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TimestampBound` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadContext` |   |

### singleUseReadOnlyTransaction()

    public abstract ReadOnlyTransaction singleUseReadOnlyTransaction()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### singleUseReadOnlyTransaction(TimestampBound arg0)

    public abstract ReadOnlyTransaction singleUseReadOnlyTransaction(TimestampBound arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TimestampBound` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.ReadOnlyTransaction` |   |

### transactionManager(Options.TransactionOption\[\] arg0)

    public abstract TransactionManager transactionManager(Options.TransactionOption[] arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.TransactionManager` |   |

### transactionManagerAsync(Options.TransactionOption\[\] arg0)

    public abstract AsyncTransactionManager transactionManagerAsync(Options.TransactionOption[] arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.AsyncTransactionManager` |   |

### write(Iterable\<Mutation\> arg0)

    public abstract Timestamp write(Iterable<Mutation> arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Mutation>` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.cloud.Timestamp` |   |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.SpannerException` |   |

### writeAtLeastOnce(Iterable\<Mutation\> arg0)

    public abstract Timestamp writeAtLeastOnce(Iterable<Mutation> arg0)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Mutation>` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.cloud.Timestamp` |   |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.SpannerException` |   |

### writeAtLeastOnceWithOptions(Iterable\<Mutation\> arg0, Options.TransactionOption\[\] arg1)

    public abstract CommitResponse writeAtLeastOnceWithOptions(Iterable<Mutation> arg0, Options.TransactionOption[] arg1)

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Mutation>` |
| `arg1` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.CommitResponse` |   |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.SpannerException` |   |

### writeWithOptions(Iterable\<Mutation\> arg0, Options.TransactionOption\[\] arg1)

    public abstract CommitResponse writeWithOptions(Iterable<Mutation> arg0, Options.TransactionOption[] arg1)

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `arg0` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Mutation>` |
| `arg1` | `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.Options.TransactionOption[]` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.CommitResponse` |   |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-spanner-jdbc/latest/com.google.cloud.spanner.SpannerException` |   |