public class BigtableClient : ClientBase<Bigtable.BigtableClient>Client for Bigtable
Namespace
Google.Cloud.Bigtable.V2Assembly
Google.Cloud.Bigtable.V2.dll
Constructors
BigtableClient()
protected BigtableClient()Protected parameterless constructor to allow creation of test doubles.
BigtableClient(CallInvoker)
public BigtableClient(CallInvoker callInvoker)Creates a new client for Bigtable that uses a custom CallInvoker.
| Parameter | |
|---|---|
| Name | Description |
callInvoker | CallInvokerThe callInvoker to use to make remote calls. |
BigtableClient(Channel)
[Obsolete("This constructor overload is present for compatibility only, and will be removed in the next major version")]
public BigtableClient(Channel channel)Creates a new client using a channel.
| Parameter | |
|---|---|
| Name | Description |
channel | Grpc.Core.ChannelThe channel to use to make remote calls. |
BigtableClient(ChannelBase)
public BigtableClient(ChannelBase channel)Creates a new client for Bigtable
| Parameter | |
|---|---|
| Name | Description |
channel | ChannelBaseThe channel to use to make remote calls. |
BigtableClient(ClientBase.ClientBaseConfiguration)
protected BigtableClient(ClientBase.ClientBaseConfiguration configuration)Protected constructor to allow creation of configured clients.
| Parameter | |
|---|---|
| Name | Description |
configuration | ClientBase.ClientBaseConfigurationThe client configuration. |
Methods
CheckAndMutateRow(CheckAndMutateRowRequest, CallOptions)
public virtual CheckAndMutateRowResponse CheckAndMutateRow(CheckAndMutateRowRequest request, CallOptions options)Mutates a row atomically based on the output of a predicate Reader filter.
| Parameters | |
|---|---|
| Name | Description |
request | CheckAndMutateRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
CheckAndMutateRowResponse | The response received from the server. |
CheckAndMutateRow(CheckAndMutateRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual CheckAndMutateRowResponse CheckAndMutateRow(CheckAndMutateRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Mutates a row atomically based on the output of a predicate Reader filter.
| Parameters | |
|---|---|
| Name | Description |
request | CheckAndMutateRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
CheckAndMutateRowResponse | The response received from the server. |
CheckAndMutateRowAsync(CheckAndMutateRowRequest, CallOptions)
public virtual AsyncUnaryCall<CheckAndMutateRowResponse> CheckAndMutateRowAsync(CheckAndMutateRowRequest request, CallOptions options)Mutates a row atomically based on the output of a predicate Reader filter.
| Parameters | |
|---|---|
| Name | Description |
request | CheckAndMutateRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<CheckAndMutateRowResponse> | The call object. |
CheckAndMutateRowAsync(CheckAndMutateRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<CheckAndMutateRowResponse> CheckAndMutateRowAsync(CheckAndMutateRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Mutates a row atomically based on the output of a predicate Reader filter.
| Parameters | |
|---|---|
| Name | Description |
request | CheckAndMutateRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<CheckAndMutateRowResponse> | The call object. |
MutateRow(MutateRowRequest, CallOptions)
public virtual MutateRowResponse MutateRow(MutateRowRequest request, CallOptions options)Mutates a row atomically. Cells already present in the row are left
unchanged unless explicitly changed by mutation.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
MutateRowResponse | The response received from the server. |
MutateRow(MutateRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual MutateRowResponse MutateRow(MutateRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Mutates a row atomically. Cells already present in the row are left
unchanged unless explicitly changed by mutation.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
MutateRowResponse | The response received from the server. |
MutateRowAsync(MutateRowRequest, CallOptions)
public virtual AsyncUnaryCall<MutateRowResponse> MutateRowAsync(MutateRowRequest request, CallOptions options)Mutates a row atomically. Cells already present in the row are left
unchanged unless explicitly changed by mutation.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<MutateRowResponse> | The call object. |
MutateRowAsync(MutateRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<MutateRowResponse> MutateRowAsync(MutateRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Mutates a row atomically. Cells already present in the row are left
unchanged unless explicitly changed by mutation.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<MutateRowResponse> | The call object. |
MutateRows(MutateRowsRequest, CallOptions)
public virtual AsyncServerStreamingCall<MutateRowsResponse> MutateRows(MutateRowsRequest request, CallOptions options)Mutates multiple rows in a batch. Each individual row is mutated atomically as in MutateRow, but the entire batch is not executed atomically.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowsRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<MutateRowsResponse> | The call object. |
MutateRows(MutateRowsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncServerStreamingCall<MutateRowsResponse> MutateRows(MutateRowsRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Mutates multiple rows in a batch. Each individual row is mutated atomically as in MutateRow, but the entire batch is not executed atomically.
| Parameters | |
|---|---|
| Name | Description |
request | MutateRowsRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<MutateRowsResponse> | The call object. |
NewInstance(ClientBase.ClientBaseConfiguration)
protected override Bigtable.BigtableClient NewInstance(ClientBase.ClientBaseConfiguration configuration)Creates a new instance of client from given ClientBaseConfiguration.
| Parameter | |
|---|---|
| Name | Description |
configuration | ClientBase.ClientBaseConfiguration |
| Returns | |
|---|---|
| Type | Description |
Bigtable.BigtableClient | |
PingAndWarm(PingAndWarmRequest, CallOptions)
public virtual PingAndWarmResponse PingAndWarm(PingAndWarmRequest request, CallOptions options)Warm up associated instance metadata for this connection. This call is not required but may be useful for connection keep-alive.
| Parameters | |
|---|---|
| Name | Description |
request | PingAndWarmRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
PingAndWarmResponse | The response received from the server. |
PingAndWarm(PingAndWarmRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual PingAndWarmResponse PingAndWarm(PingAndWarmRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Warm up associated instance metadata for this connection. This call is not required but may be useful for connection keep-alive.
| Parameters | |
|---|---|
| Name | Description |
request | PingAndWarmRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
PingAndWarmResponse | The response received from the server. |
PingAndWarmAsync(PingAndWarmRequest, CallOptions)
public virtual AsyncUnaryCall<PingAndWarmResponse> PingAndWarmAsync(PingAndWarmRequest request, CallOptions options)Warm up associated instance metadata for this connection. This call is not required but may be useful for connection keep-alive.
| Parameters | |
|---|---|
| Name | Description |
request | PingAndWarmRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<PingAndWarmResponse> | The call object. |
PingAndWarmAsync(PingAndWarmRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<PingAndWarmResponse> PingAndWarmAsync(PingAndWarmRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Warm up associated instance metadata for this connection. This call is not required but may be useful for connection keep-alive.
| Parameters | |
|---|---|
| Name | Description |
request | PingAndWarmRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<PingAndWarmResponse> | The call object. |
ReadModifyWriteRow(ReadModifyWriteRowRequest, CallOptions)
public virtual ReadModifyWriteRowResponse ReadModifyWriteRow(ReadModifyWriteRowRequest request, CallOptions options)Modifies a row atomically on the server. The method reads the latest existing timestamp and value from the specified columns and writes a new entry based on pre-defined read/modify/write rules. The new value for the timestamp is the greater of the existing timestamp or the current server time. The method returns the new contents of all modified cells.
| Parameters | |
|---|---|
| Name | Description |
request | ReadModifyWriteRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
ReadModifyWriteRowResponse | The response received from the server. |
ReadModifyWriteRow(ReadModifyWriteRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual ReadModifyWriteRowResponse ReadModifyWriteRow(ReadModifyWriteRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Modifies a row atomically on the server. The method reads the latest existing timestamp and value from the specified columns and writes a new entry based on pre-defined read/modify/write rules. The new value for the timestamp is the greater of the existing timestamp or the current server time. The method returns the new contents of all modified cells.
| Parameters | |
|---|---|
| Name | Description |
request | ReadModifyWriteRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
ReadModifyWriteRowResponse | The response received from the server. |
ReadModifyWriteRowAsync(ReadModifyWriteRowRequest, CallOptions)
public virtual AsyncUnaryCall<ReadModifyWriteRowResponse> ReadModifyWriteRowAsync(ReadModifyWriteRowRequest request, CallOptions options)Modifies a row atomically on the server. The method reads the latest existing timestamp and value from the specified columns and writes a new entry based on pre-defined read/modify/write rules. The new value for the timestamp is the greater of the existing timestamp or the current server time. The method returns the new contents of all modified cells.
| Parameters | |
|---|---|
| Name | Description |
request | ReadModifyWriteRowRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<ReadModifyWriteRowResponse> | The call object. |
ReadModifyWriteRowAsync(ReadModifyWriteRowRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<ReadModifyWriteRowResponse> ReadModifyWriteRowAsync(ReadModifyWriteRowRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Modifies a row atomically on the server. The method reads the latest existing timestamp and value from the specified columns and writes a new entry based on pre-defined read/modify/write rules. The new value for the timestamp is the greater of the existing timestamp or the current server time. The method returns the new contents of all modified cells.
| Parameters | |
|---|---|
| Name | Description |
request | ReadModifyWriteRowRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncUnaryCall<ReadModifyWriteRowResponse> | The call object. |
ReadRows(ReadRowsRequest, CallOptions)
public virtual AsyncServerStreamingCall<ReadRowsResponse> ReadRows(ReadRowsRequest request, CallOptions options)Streams back the contents of all requested rows in key order, optionally applying the same Reader filter to each. Depending on their size, rows and cells may be broken up across multiple responses, but atomicity of each row will still be preserved. See the ReadRowsResponse documentation for details.
| Parameters | |
|---|---|
| Name | Description |
request | ReadRowsRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<ReadRowsResponse> | The call object. |
ReadRows(ReadRowsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncServerStreamingCall<ReadRowsResponse> ReadRows(ReadRowsRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Streams back the contents of all requested rows in key order, optionally applying the same Reader filter to each. Depending on their size, rows and cells may be broken up across multiple responses, but atomicity of each row will still be preserved. See the ReadRowsResponse documentation for details.
| Parameters | |
|---|---|
| Name | Description |
request | ReadRowsRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<ReadRowsResponse> | The call object. |
SampleRowKeys(SampleRowKeysRequest, CallOptions)
public virtual AsyncServerStreamingCall<SampleRowKeysResponse> SampleRowKeys(SampleRowKeysRequest request, CallOptions options)Returns a sample of row keys in the table. The returned row keys will delimit contiguous sections of the table of approximately equal size, which can be used to break up the data for distributed tasks like mapreduces.
| Parameters | |
|---|---|
| Name | Description |
request | SampleRowKeysRequestThe request to send to the server. |
options | CallOptionsThe options for the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<SampleRowKeysResponse> | The call object. |
SampleRowKeys(SampleRowKeysRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncServerStreamingCall<SampleRowKeysResponse> SampleRowKeys(SampleRowKeysRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))Returns a sample of row keys in the table. The returned row keys will delimit contiguous sections of the table of approximately equal size, which can be used to break up the data for distributed tasks like mapreduces.
| Parameters | |
|---|---|
| Name | Description |
request | SampleRowKeysRequestThe request to send to the server. |
headers | MetadataThe initial metadata to send with the call. This parameter is optional. |
deadline | Nullable<DateTime>An optional deadline for the call. The call will be cancelled if deadline is hit. |
cancellationToken | CancellationTokenAn optional token for canceling the call. |
| Returns | |
|---|---|
| Type | Description |
AsyncServerStreamingCall<SampleRowKeysResponse> | The call object. |