/// <summary>
/// Executes a query and ingests the results as documents into Couchbase server for further analytics.
/// <para>
/// NOTE: This is an experimental API and may change in the future.
/// </para>
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="cluster"></param>
/// <param name="collection"></param>
/// <param name="statement"></param>
/// <param name="configureOptions"></param>
/// <returns></returns>
public static Task <IEnumerable <IMutationResult> > IngestAsync <T>(this ICluster cluster, string statement, ICollection collection, Action <IngestOptions> configureOptions)
{
var options = new IngestOptions();
configureOptions(options);
return(IngestAsync <T>(
cluster,
statement,
collection,
options
));
}
/// <summary>
/// Executes a query and ingests the results as documents into Couchbase server for further analytics.
/// <para>
/// NOTE: This is an experimental API and may change in the future.
/// </para>
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="cluster"></param>
/// <param name="collection"></param>
/// <param name="statement"></param>
/// <param name="ingestOptions"></param>
/// <returns></returns>
public static async Task <IEnumerable <IMutationResult> > IngestAsync <T>(this ICluster cluster, string statement, ICollection collection, IngestOptions ingestOptions = null)
{
//use defaults if not options not explicitly passed
ingestOptions = ingestOptions ?? new IngestOptions();
if (ingestOptions.CancellationToken.IsCancellationRequested)
{
ingestOptions.CancellationToken.ThrowIfCancellationRequested();
}
//execute the analytics query
IAnalyticsResult <T> result;
try
{
result = await cluster.AnalyticsQueryAsync <T>(
statement,
options => options.WithCancellationToken(ingestOptions.CancellationToken)
).ConfigureAwait(false);
}
catch (Exception exception)
{
throw new AnalyticsException {
Context = exception.Message
};
}
// ingest result into collection
var results = new ConcurrentBag <Task <IMutationResult> >();
foreach (var row in result.Rows)
{
Task <IMutationResult> op;
switch (ingestOptions.IngestMethod)
{
case IngestMethod.Insert:
op = collection.Insert(
ingestOptions.IdGenerator(row),
row,
options =>
{
options.WithExpiration(ingestOptions.Expiration);
options.WithTimeout(ingestOptions.Timeout);
});
break;
case IngestMethod.Upsert:
op = collection.Upsert(
ingestOptions.IdGenerator(row),
row,
options =>
{
options.WithExpiration(ingestOptions.Expiration);
options.WithTimeout(ingestOptions.Timeout);
});
break;
case IngestMethod.Replace:
op = collection.Replace(
ingestOptions.IdGenerator(row),
row,
options =>
{
options.WithExpiration(ingestOptions.Expiration);
options.WithTimeout(ingestOptions.Timeout);
});
break;
default:
throw new ArgumentOutOfRangeException();
}
results.Add(op);
}
return(await Task.WhenAll(results).ConfigureAwait(false));
}
