Class DataClient (2.21.0)

Version 2.21.0

• 2.25.0-rc (latest)
• 2.24.0
• 2.23.0
• 2.22.0
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.0
• 2.17.0
• 2.16.0
• 2.15.1
• 2.14.0
• 2.13.0
• 2.12.0
• 2.11.0

Connects to Cloud Bigtable's data manipulation APIs.

This class is used by the Cloud Bigtable wrappers to access Cloud Bigtable. Multiple bigtable::Table objects may share a connection via a single DataClient object. The DataClient object is configured at construction time, this configuration includes the credentials, access endpoints, default timeouts, and other gRPC configuration options. This is an interface class because it is also used as a dependency injection point in some of the tests.

Cost

Applications should avoid unnecessarily creating new objects of type DataClient. Creating a new object of this type typically requires connecting to the Cloud Bigtable servers, and performing the authentication workflows with Google Cloud Platform. These operations can take many milliseconds, therefore applications should try to reuse the same DataClient instances when possible.

Deprecated:

google::cloud::bigtable::DataConnection is the preferred way to communicate with the Bigtable Data API. To migrate existing code, see Migrating from DataClient.

Functions

MutateRow(grpc::ClientContext *, google::bigtable::v2::MutateRowRequest const &, google::bigtable::v2::MutateRowResponse *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::MutateRowRequest const &
response	google::bigtable::v2::MutateRowResponse *

Returns
Type	Description
grpc::Status

AsyncMutateRow(grpc::ClientContext *, google::bigtable::v2::MutateRowRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::MutateRowRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr< grpc::ClientAsyncResponseReaderInterface< google::bigtable::v2::MutateRowResponse > >

CheckAndMutateRow(grpc::ClientContext *, google::bigtable::v2::CheckAndMutateRowRequest const &, google::bigtable::v2::CheckAndMutateRowResponse *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::CheckAndMutateRowRequest const &
response	google::bigtable::v2::CheckAndMutateRowResponse *

Returns
Type	Description
grpc::Status

AsyncCheckAndMutateRow(grpc::ClientContext *, google::bigtable::v2::CheckAndMutateRowRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::CheckAndMutateRowRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr< grpc::ClientAsyncResponseReaderInterface< google::bigtable::v2::CheckAndMutateRowResponse > >

ReadModifyWriteRow(grpc::ClientContext *, google::bigtable::v2::ReadModifyWriteRowRequest const &, google::bigtable::v2::ReadModifyWriteRowResponse *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::ReadModifyWriteRowRequest const &
response	google::bigtable::v2::ReadModifyWriteRowResponse *

Returns
Type	Description
grpc::Status

AsyncReadModifyWriteRow(grpc::ClientContext *, google::bigtable::v2::ReadModifyWriteRowRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::ReadModifyWriteRowRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr< grpc::ClientAsyncResponseReaderInterface< google::bigtable::v2::ReadModifyWriteRowResponse > >

ReadRows(grpc::ClientContext *, google::bigtable::v2::ReadRowsRequest const &)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::ReadRowsRequest const &

Returns
Type	Description
std::unique_ptr< grpc::ClientReaderInterface< google::bigtable::v2::ReadRowsResponse > >

AsyncReadRows(grpc::ClientContext *, google::bigtable::v2::ReadRowsRequest const &, grpc::CompletionQueue *, void *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::ReadRowsRequest const &
cq	grpc::CompletionQueue *
tag	void *

Returns
Type	Description
std::unique_ptr< grpc::ClientAsyncReaderInterface< google::bigtable::v2::ReadRowsResponse > >

PrepareAsyncReadRows(::grpc::ClientContext *, google::bigtable::v2::ReadRowsRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	::grpc::ClientContext *
request	google::bigtable::v2::ReadRowsRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr<::grpc::ClientAsyncReaderInterface< google::bigtable::v2::ReadRowsResponse > >

SampleRowKeys(grpc::ClientContext *, google::bigtable::v2::SampleRowKeysRequest const &)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::SampleRowKeysRequest const &

Returns
Type	Description
std::unique_ptr< grpc::ClientReaderInterface< google::bigtable::v2::SampleRowKeysResponse > >

AsyncSampleRowKeys(grpc::ClientContext *, google::bigtable::v2::SampleRowKeysRequest const &, grpc::CompletionQueue *, void *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::SampleRowKeysRequest const &
cq	grpc::CompletionQueue *
tag	void *

Returns
Type	Description
std::unique_ptr<::grpc::ClientAsyncReaderInterface< google::bigtable::v2::SampleRowKeysResponse > >

virtual PrepareAsyncSampleRowKeys(grpc::ClientContext *, google::bigtable::v2::SampleRowKeysRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::SampleRowKeysRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr<::grpc::ClientAsyncReaderInterface< google::bigtable::v2::SampleRowKeysResponse > >

MutateRows(grpc::ClientContext *, google::bigtable::v2::MutateRowsRequest const &)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::MutateRowsRequest const &

Returns
Type	Description
std::unique_ptr< grpc::ClientReaderInterface< google::bigtable::v2::MutateRowsResponse > >

AsyncMutateRows(::grpc::ClientContext *, google::bigtable::v2::MutateRowsRequest const &, grpc::CompletionQueue *, void *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	::grpc::ClientContext *
request	google::bigtable::v2::MutateRowsRequest const &
cq	grpc::CompletionQueue *
tag	void *

Returns
Type	Description
std::unique_ptr<::grpc::ClientAsyncReaderInterface< google::bigtable::v2::MutateRowsResponse > >

PrepareAsyncMutateRows(grpc::ClientContext *, google::bigtable::v2::MutateRowsRequest const &, grpc::CompletionQueue *)

the google.bigtable.v2.Bigtable wrappers.

Parameters
Name	Description
context	grpc::ClientContext *
request	google::bigtable::v2::MutateRowsRequest const &
cq	grpc::CompletionQueue *

Returns
Type	Description
std::unique_ptr<::grpc::ClientAsyncReaderInterface< google::bigtable::v2::MutateRowsResponse > >

project_id() const

Returns
Type	Description
std::string const &

instance_id() const

Returns
Type	Description
std::string const &

Channel()

Return a new channel to handle admin operations.

Intended to access rarely used services in the same endpoints as the Bigtable admin interfaces, for example, the google.longrunning.Operations.

Deprecated: This member function is scheduled for deletion and DataClient will be marked as final. Do not extend this class. Application developers who need to configure the gRPC Channel can pass any of the following options into MakeDataClient(...): - google::cloud::GrpcChannelArgumentsOption - google::cloud::GrpcChannelArgumentsNativeOption

Returns
Type	Description
std::shared_ptr< grpc::Channel >

reset()

Reset and create new Channels.

Deprecated: This member function is scheduled for deletion and DataClient will be marked as final. Do not extend this class. The client library will handle all interactions with the gRPC channels.

Returns
Type	Description
void

BackgroundThreadsFactory()

The thread factory this client was created with.

Deprecated: This member function is scheduled for deletion and DataClient will be marked as final. Do not extend this class. Application developers who need to configure the background threads can pass any of the following options into MakeDataClient(...): - google::cloud::GrpcBackgroundThreadPoolSizeOption - google::cloud::GrpcCompletionQueueOption - google::cloud::GrpcBackgroundThreadFactoryOption

Returns
Type	Description
google::cloud::BackgroundThreadsFactory