public class DatastoreClient : ClientBase<Datastore.DatastoreClient>
Client for Datastore
Namespace
Google.Cloud.Datastore.V1Assembly
Google.Cloud.Datastore.V1.dll
Constructors
DatastoreClient()
protected DatastoreClient()
Protected parameterless constructor to allow creation of test doubles.
DatastoreClient(CallInvoker)
public DatastoreClient(CallInvoker callInvoker)
Creates a new client for Datastore that uses a custom CallInvoker
.
Parameter | |
---|---|
Name | Description |
callInvoker |
CallInvoker The callInvoker to use to make remote calls. |
DatastoreClient(ChannelBase)
public DatastoreClient(ChannelBase channel)
Creates a new client for Datastore
Parameter | |
---|---|
Name | Description |
channel |
ChannelBase The channel to use to make remote calls. |
DatastoreClient(ClientBase.ClientBaseConfiguration)
protected DatastoreClient(ClientBase.ClientBaseConfiguration configuration)
Protected constructor to allow creation of configured clients.
Parameter | |
---|---|
Name | Description |
configuration |
ClientBase.ClientBaseConfiguration The client configuration. |
Methods
AllocateIds(AllocateIdsRequest, CallOptions)
public virtual AllocateIdsResponse AllocateIds(AllocateIdsRequest request, CallOptions options)
Allocates IDs for the given keys, which is useful for referencing an entity before it is inserted.
Parameters | |
---|---|
Name | Description |
request |
AllocateIdsRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AllocateIdsResponse |
The response received from the server. |
AllocateIds(AllocateIdsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AllocateIdsResponse AllocateIds(AllocateIdsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Allocates IDs for the given keys, which is useful for referencing an entity before it is inserted.
Parameters | |
---|---|
Name | Description |
request |
AllocateIdsRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AllocateIdsResponse |
The response received from the server. |
AllocateIdsAsync(AllocateIdsRequest, CallOptions)
public virtual AsyncUnaryCall<AllocateIdsResponse> AllocateIdsAsync(AllocateIdsRequest request, CallOptions options)
Allocates IDs for the given keys, which is useful for referencing an entity before it is inserted.
Parameters | |
---|---|
Name | Description |
request |
AllocateIdsRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<AllocateIdsResponse> |
The call object. |
AllocateIdsAsync(AllocateIdsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<AllocateIdsResponse> AllocateIdsAsync(AllocateIdsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Allocates IDs for the given keys, which is useful for referencing an entity before it is inserted.
Parameters | |
---|---|
Name | Description |
request |
AllocateIdsRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<AllocateIdsResponse> |
The call object. |
BeginTransaction(BeginTransactionRequest, CallOptions)
public virtual BeginTransactionResponse BeginTransaction(BeginTransactionRequest request, CallOptions options)
Begins a new transaction.
Parameters | |
---|---|
Name | Description |
request |
BeginTransactionRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
BeginTransactionResponse |
The response received from the server. |
BeginTransaction(BeginTransactionRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual BeginTransactionResponse BeginTransaction(BeginTransactionRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Begins a new transaction.
Parameters | |
---|---|
Name | Description |
request |
BeginTransactionRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
BeginTransactionResponse |
The response received from the server. |
BeginTransactionAsync(BeginTransactionRequest, CallOptions)
public virtual AsyncUnaryCall<BeginTransactionResponse> BeginTransactionAsync(BeginTransactionRequest request, CallOptions options)
Begins a new transaction.
Parameters | |
---|---|
Name | Description |
request |
BeginTransactionRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<BeginTransactionResponse> |
The call object. |
BeginTransactionAsync(BeginTransactionRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<BeginTransactionResponse> BeginTransactionAsync(BeginTransactionRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Begins a new transaction.
Parameters | |
---|---|
Name | Description |
request |
BeginTransactionRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<BeginTransactionResponse> |
The call object. |
Commit(CommitRequest, CallOptions)
public virtual CommitResponse Commit(CommitRequest request, CallOptions options)
Commits a transaction, optionally creating, deleting or modifying some entities.
Parameters | |
---|---|
Name | Description |
request |
CommitRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
CommitResponse |
The response received from the server. |
Commit(CommitRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual CommitResponse Commit(CommitRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Commits a transaction, optionally creating, deleting or modifying some entities.
Parameters | |
---|---|
Name | Description |
request |
CommitRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
CommitResponse |
The response received from the server. |
CommitAsync(CommitRequest, CallOptions)
public virtual AsyncUnaryCall<CommitResponse> CommitAsync(CommitRequest request, CallOptions options)
Commits a transaction, optionally creating, deleting or modifying some entities.
Parameters | |
---|---|
Name | Description |
request |
CommitRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<CommitResponse> |
The call object. |
CommitAsync(CommitRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<CommitResponse> CommitAsync(CommitRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Commits a transaction, optionally creating, deleting or modifying some entities.
Parameters | |
---|---|
Name | Description |
request |
CommitRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<CommitResponse> |
The call object. |
Lookup(LookupRequest, CallOptions)
public virtual LookupResponse Lookup(LookupRequest request, CallOptions options)
Looks up entities by key.
Parameters | |
---|---|
Name | Description |
request |
LookupRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
LookupResponse |
The response received from the server. |
Lookup(LookupRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual LookupResponse Lookup(LookupRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Looks up entities by key.
Parameters | |
---|---|
Name | Description |
request |
LookupRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
LookupResponse |
The response received from the server. |
LookupAsync(LookupRequest, CallOptions)
public virtual AsyncUnaryCall<LookupResponse> LookupAsync(LookupRequest request, CallOptions options)
Looks up entities by key.
Parameters | |
---|---|
Name | Description |
request |
LookupRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<LookupResponse> |
The call object. |
LookupAsync(LookupRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<LookupResponse> LookupAsync(LookupRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Looks up entities by key.
Parameters | |
---|---|
Name | Description |
request |
LookupRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<LookupResponse> |
The call object. |
NewInstance(ClientBase.ClientBaseConfiguration)
protected override Datastore.DatastoreClient NewInstance(ClientBase.ClientBaseConfiguration configuration)
Creates a new instance of client from given ClientBaseConfiguration
.
Parameter | |
---|---|
Name | Description |
configuration |
ClientBase.ClientBaseConfiguration |
Returns | |
---|---|
Type | Description |
Datastore.DatastoreClient |
ReserveIds(ReserveIdsRequest, CallOptions)
public virtual ReserveIdsResponse ReserveIds(ReserveIdsRequest request, CallOptions options)
Prevents the supplied keys' IDs from being auto-allocated by Cloud Datastore.
Parameters | |
---|---|
Name | Description |
request |
ReserveIdsRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
ReserveIdsResponse |
The response received from the server. |
ReserveIds(ReserveIdsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual ReserveIdsResponse ReserveIds(ReserveIdsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Prevents the supplied keys' IDs from being auto-allocated by Cloud Datastore.
Parameters | |
---|---|
Name | Description |
request |
ReserveIdsRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
ReserveIdsResponse |
The response received from the server. |
ReserveIdsAsync(ReserveIdsRequest, CallOptions)
public virtual AsyncUnaryCall<ReserveIdsResponse> ReserveIdsAsync(ReserveIdsRequest request, CallOptions options)
Prevents the supplied keys' IDs from being auto-allocated by Cloud Datastore.
Parameters | |
---|---|
Name | Description |
request |
ReserveIdsRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<ReserveIdsResponse> |
The call object. |
ReserveIdsAsync(ReserveIdsRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<ReserveIdsResponse> ReserveIdsAsync(ReserveIdsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Prevents the supplied keys' IDs from being auto-allocated by Cloud Datastore.
Parameters | |
---|---|
Name | Description |
request |
ReserveIdsRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<ReserveIdsResponse> |
The call object. |
Rollback(RollbackRequest, CallOptions)
public virtual RollbackResponse Rollback(RollbackRequest request, CallOptions options)
Rolls back a transaction.
Parameters | |
---|---|
Name | Description |
request |
RollbackRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
RollbackResponse |
The response received from the server. |
Rollback(RollbackRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual RollbackResponse Rollback(RollbackRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Rolls back a transaction.
Parameters | |
---|---|
Name | Description |
request |
RollbackRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
RollbackResponse |
The response received from the server. |
RollbackAsync(RollbackRequest, CallOptions)
public virtual AsyncUnaryCall<RollbackResponse> RollbackAsync(RollbackRequest request, CallOptions options)
Rolls back a transaction.
Parameters | |
---|---|
Name | Description |
request |
RollbackRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<RollbackResponse> |
The call object. |
RollbackAsync(RollbackRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<RollbackResponse> RollbackAsync(RollbackRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Rolls back a transaction.
Parameters | |
---|---|
Name | Description |
request |
RollbackRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<RollbackResponse> |
The call object. |
RunQuery(RunQueryRequest, CallOptions)
public virtual RunQueryResponse RunQuery(RunQueryRequest request, CallOptions options)
Queries for entities.
Parameters | |
---|---|
Name | Description |
request |
RunQueryRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
RunQueryResponse |
The response received from the server. |
RunQuery(RunQueryRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual RunQueryResponse RunQuery(RunQueryRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Queries for entities.
Parameters | |
---|---|
Name | Description |
request |
RunQueryRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
RunQueryResponse |
The response received from the server. |
RunQueryAsync(RunQueryRequest, CallOptions)
public virtual AsyncUnaryCall<RunQueryResponse> RunQueryAsync(RunQueryRequest request, CallOptions options)
Queries for entities.
Parameters | |
---|---|
Name | Description |
request |
RunQueryRequest The request to send to the server. |
options |
CallOptions The options for the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<RunQueryResponse> |
The call object. |
RunQueryAsync(RunQueryRequest, Metadata, Nullable<DateTime>, CancellationToken)
public virtual AsyncUnaryCall<RunQueryResponse> RunQueryAsync(RunQueryRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default(CancellationToken))
Queries for entities.
Parameters | |
---|---|
Name | Description |
request |
RunQueryRequest The request to send to the server. |
headers |
Metadata The 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 |
CancellationToken An optional token for canceling the call. |
Returns | |
---|---|
Type | Description |
AsyncUnaryCall<RunQueryResponse> |
The call object. |