Method WaitForLocalReplicaInitAsync

WaitForLocalReplicaInitAsync(String, Nullable<TimeSpan>, Nullable<TimeSpan>, CancellationToken)

Cloud Service only. Waits asynchronously for local table replica to complete its initialization.
Declaration
public Task<TableResult> WaitForLocalReplicaInitAsync(string tableName, Nullable<TimeSpan> timeout = null, Nullable<TimeSpan> pollDelay = null, CancellationToken cancellationToken = null)
Parameters
Type Name Description
String tableName Name of the table.
Nullable<TimeSpan> timeout
Nullable<TimeSpan> pollDelay
CancellationToken cancellationToken (Optional) Cancellation token.
Returns
Type Description
Task<TableResult> Task returning TableResult.
Remarks

After table replica is created, it needs to be initialized by copying the data (if any) from the sender region. During this initialization process, even though the table state of the replica table is Active, data operations cannot be performed on the replica table.

This method is used to ensure that the replica table is ready for data operations by asynchronously waiting for the initialization process to complete. It works similar to WaitForCompletionAsync(Nullable<TimeSpan>, Nullable<TimeSpan>, CancellationToken) and WaitForTableStateAsync(String, TableState, TableCompletionOptions, CancellationToken) by polling the table state at regular intervals until IsLocalReplicaInitialized is true.

Note that this operation must be performed in the receiver region where the table replica resides (not in the sender region from where the replica was created), meaning that this NoSQLClient instance must be configured with the receiver region (see Region).

Exceptions
Type Condition
TimeoutException Operation has timed out.
InvalidOperationException The table or the service is not in a valid state to perform this operation.
NoSQLException NoSQLException or one of its subclasses is thrown if operation cannot be performed for any other reason. See documentation for corresponding subclass of NoSQLException.
See Also

WaitForLocalReplicaInitAsync(String, TableCompletionOptions, CancellationToken)

Cloud Service only. Waits asynchronously for local table replica to complete its initialization.
Declaration
public Task<TableResult> WaitForLocalReplicaInitAsync(string tableName, TableCompletionOptions options, CancellationToken cancellationToken = null)
Parameters
Type Name Description
String tableName Name of the table.
TableCompletionOptions options Options for the operation.
CancellationToken cancellationToken (Optional) Cancellation token.
Returns
Type Description
Task<TableResult> Task returning TableResult.
Remarks
This method is equivalent to WaitForLocalReplicaInitAsync(String, Nullable<TimeSpan>, Nullable<TimeSpan>, CancellationToken) except that it takes TableCompletionOptions parameter (thus allowing to specify Compartment in addition to Timeout and PollDelay).
Exceptions
Type Condition
TimeoutException Operation has timed out.
InvalidOperationException The table or the service is not in a valid state to perform this operation.
NoSQLException NoSQLException or one of its subclasses is thrown if operation cannot be performed for any other reason. See documentation for corresponding subclass of NoSQLException.
See Also