public RangeMapping <TKey> MarkMappingOnline(RangeMapping <TKey> mapping, MappingLockToken mappingLockToken)
{
ExceptionUtils.DisallowNullArgument(mapping, "mapping");
ExceptionUtils.DisallowNullArgument(mappingLockToken, "mappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"MarkMappingOnline", "Start; ");
Stopwatch stopwatch = Stopwatch.StartNew();
RangeMapping <TKey> result = this.rsm.MarkMappingOnline(mapping, mappingLockToken.LockOwnerId);
stopwatch.Stop();
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"MarkMappingOnline", "Complete; Duration: {0}",
stopwatch.Elapsed);
return(result);
}
}
public RangeMapping <TKey> UpdateMapping(RangeMapping <TKey> currentMapping, RangeMappingUpdate update,
MappingLockToken mappingLockToken)
{
ExceptionUtils.DisallowNullArgument(currentMapping, "currentMapping");
ExceptionUtils.DisallowNullArgument(update, "update");
ExceptionUtils.DisallowNullArgument(mappingLockToken, "mappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"UpdateMapping", "Start; Current mapping shard: {0}",
currentMapping.Shard.Location);
Stopwatch stopwatch = Stopwatch.StartNew();
RangeMapping <TKey> rangeMapping = this.rsm.Update(currentMapping, update, mappingLockToken.LockOwnerId, MappingOptions.Validate);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"UpdateMapping", "Complete; Current mapping shard: {0}; Duration: {1}",
currentMapping.Shard.Location, stopwatch.Elapsed);
return(rangeMapping);
}
}
public void LockMapping(RangeMapping <TKey> mapping, MappingLockToken mappingLockToken)
{
ExceptionUtils.DisallowNullArgument(mapping, "mapping");
ExceptionUtils.DisallowNullArgument(mappingLockToken, "mappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
// Generate a lock owner id
Guid lockOwnerId = mappingLockToken.LockOwnerId;
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"Lock", "Start; LockOwnerId: {0}", lockOwnerId);
Stopwatch stopwatch = Stopwatch.StartNew();
this.rsm.LockOrUnlockMappings(mapping, lockOwnerId, LockOwnerIdOpType.Lock);
stopwatch.Stop();
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"Lock", "Complete; Duration: {0}; StoreLockOwnerId: {1}",
stopwatch.Elapsed, lockOwnerId);
}
}
/// <summary>
/// Removes a range mapping.
/// </summary>
/// <param name="mapping">Mapping being removed.</param>
/// <param name="lockOwnerId">Lock owner id of this mapping</param>
public void Remove(RangeMapping <TKey> mapping, Guid lockOwnerId)
{
this.Remove <RangeMapping <TKey> >(
mapping,
(smm, sm, ssm) => new RangeMapping <TKey>(smm, sm, ssm),
lockOwnerId);
}
public RangeMapping <TKey> MergeMappings(RangeMapping <TKey> left, RangeMapping <TKey> right,
MappingLockToken leftMappingLockToken, MappingLockToken rightMappingLockToken)
{
ExceptionUtils.DisallowNullArgument(left, "left");
ExceptionUtils.DisallowNullArgument(right, "right");
ExceptionUtils.DisallowNullArgument(leftMappingLockToken, "leftMappingLockToken");
ExceptionUtils.DisallowNullArgument(rightMappingLockToken, "rightMappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"SplitMapping", "Start; Left Shard: {0}; Right Shard: {1}",
left.Shard.Location, right.Shard.Location);
Stopwatch stopwatch = Stopwatch.StartNew();
RangeMapping <TKey> rangeMapping = this.rsm.Merge(left, right, leftMappingLockToken.LockOwnerId, rightMappingLockToken.LockOwnerId);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"SplitMapping", "Complete; Duration: {0}", stopwatch.Elapsed);
return(rangeMapping);
}
}
internal void LockOrUnlockMappings(RangeMapping <TKey> mapping, Guid lockOwnerId, LockOwnerIdOpType lockOwnerIdOpType)
{
this.LockOrUnlockMappings <RangeMapping <TKey> >(
mapping,
lockOwnerId,
lockOwnerIdOpType,
ShardManagementErrorCategory.RangeShardMap);
}
/// <summary>
/// Allows for update to a range mapping with the updates provided in
/// the <paramref name="update"/> parameter.
/// </summary>
/// <param name="currentMapping">Mapping being updated.</param>
/// <param name="update">Updated properties of the Shard.</param>
/// <param name="lockOwnerId">Lock owner id of this mapping</param>
/// <returns>New instance of mapping with updated information.</returns>
internal RangeMapping <TKey> Update(RangeMapping <TKey> currentMapping, RangeMappingUpdate update, Guid lockOwnerId)
{
return(this.Update <RangeMapping <TKey>, RangeMappingUpdate, MappingStatus>(
currentMapping,
update,
(smm, sm, ssm) => new RangeMapping <TKey>(smm, sm, ssm),
rms => (int)rms,
i => (MappingStatus)i,
lockOwnerId));
}
/// <summary>
/// Tries to looks up the key value and returns the corresponding mapping.
/// </summary>
/// <param name="key">Input key value.</param>
/// <param name="lookupOptions">Whether to search in the cache and/or store.</param>
/// <param name="mapping">Mapping that contains the key value.</param>
/// <returns><c>true</c> if mapping is found, <c>false</c> otherwise.</returns>
public bool TryLookup(TKey key, LookupOptions lookupOptions, out RangeMapping <TKey> mapping)
{
RangeMapping <TKey> p = this.Lookup <RangeMapping <TKey>, TKey>(
key,
lookupOptions,
(smm, sm, ssm) => new RangeMapping <TKey>(smm, sm, ssm),
ShardManagementErrorCategory.RangeShardMap);
mapping = p;
return(p != null);
}
/// <summary>
/// Marks the given mapping online.
/// </summary>
/// <param name="mapping">Input range mapping.</param>
/// <param name="lockOwnerId">Lock owner id of this mapping</param>
/// <returns>An online mapping.</returns>
public RangeMapping <TKey> MarkMappingOnline(RangeMapping <TKey> mapping, Guid lockOwnerId)
{
return(BaseShardMapper.SetStatus <RangeMapping <TKey>, RangeMappingUpdate, MappingStatus>(
mapping,
mapping.Status,
s => MappingStatus.Online,
s => new RangeMappingUpdate()
{
Status = s
},
this.Update,
lockOwnerId));
}
/// <summary>
/// Determines whether the specified object is equal to the current object.
/// </summary>
/// <param name="obj">The object to compare with the current object.</param>
/// <returns>True if the specified object is equal to the current object; otherwise, false.</returns>
public override bool Equals(object obj)
{
RangeMapping <TKey> other = obj as RangeMapping <TKey>;
if (other == null)
{
return(false);
}
if (this.Id.Equals(other.Id))
{
Debug.Assert(this.Range.Equals(other.Range));
return(true);
}
return(false);
}
/// <summary>
/// Looks up the key value and returns the corresponding mapping.
/// </summary>
/// <param name="key">Input key value.</param>
/// <returns>Mapping that contains the key value.</returns>
public RangeMapping <TKey> GetMappingForKey(TKey key)
{
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"GetMapping", "Start; Range Mapping Key Type: {0}", typeof(TKey));
Stopwatch stopwatch = Stopwatch.StartNew();
RangeMapping <TKey> rangeMapping = this.rsm.Lookup(key, false);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"GetMapping", "Complete; Range Mapping Key Type: {0} Duration: {1}",
typeof(TKey), stopwatch.Elapsed);
return(rangeMapping);
}
}
/// <summary>
/// Looks up the key value and returns the corresponding mapping.
/// </summary>
/// <param name="key">Input key value.</param>
/// <param name="lookupOptions">Whether to search in the cache and/or store.</param>
/// <returns>Mapping that contains the key value.</returns>
public RangeMapping <TKey> Lookup(TKey key, LookupOptions lookupOptions)
{
RangeMapping <TKey> p = this.Lookup <RangeMapping <TKey>, TKey>(
key,
lookupOptions,
(smm, sm, ssm) => new RangeMapping <TKey>(smm, sm, ssm),
ShardManagementErrorCategory.RangeShardMap);
if (p == null)
{
throw new ShardManagementException(
ShardManagementErrorCategory.RangeShardMap,
ShardManagementErrorCode.MappingNotFoundForKey,
Errors._Store_ShardMapper_MappingNotFoundForKeyGlobal,
this.ShardMap.Name,
StoreOperationRequestBuilder.SpFindShardMappingByKeyGlobal,
"Lookup");
}
return(p);
}
public void DeleteMapping(RangeMapping <TKey> mapping, MappingLockToken mappingLockToken)
{
ExceptionUtils.DisallowNullArgument(mapping, "mapping");
ExceptionUtils.DisallowNullArgument(mappingLockToken, "mappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"DeleteMapping", "Start; Shard: {0}", mapping.Shard.Location);
Stopwatch stopwatch = Stopwatch.StartNew();
this.rsm.Remove(mapping, mappingLockToken.LockOwnerId);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"DeleteMapping", "Complete; Shard: {0}; Duration: {1}",
mapping.Shard.Location, stopwatch.Elapsed);
}
}
/// <summary>
/// Tries to looks up the key value and place the corresponding mapping in <paramref name="rangeMapping"/>.
/// </summary>
/// <param name="key">Input key value.</param>
/// <param name="rangeMapping">Mapping that contains the key value.</param>
/// <returns><c>true</c> if mapping is found, <c>false</c> otherwise.</returns>
public bool TryGetMappingForKey(TKey key, out RangeMapping <TKey> rangeMapping)
{
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"TryLookupRangeMapping", "Start; ShardMap name: {0}; Range Mapping Key Type: {1}",
this.Name, typeof(TKey));
Stopwatch stopwatch = Stopwatch.StartNew();
bool result = this.rsm.TryLookup(key, false, out rangeMapping);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"TryLookupRangeMapping", "Complete; ShardMap name: {0}; Range Mapping Key Type: {1}; Duration: {2}",
this.Name, typeof(TKey), stopwatch.Elapsed);
return(result);
}
}
public RangeMapping <TKey> CreateRangeMapping(RangeMappingCreationInfo <TKey> creationInfo)
{
ExceptionUtils.DisallowNullArgument(creationInfo, "args");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"CreateRangeMapping", "Start; Shard: {0}", creationInfo.Shard.Location);
Stopwatch stopwatch = Stopwatch.StartNew();
RangeMapping <TKey> rangeMapping = this.rsm.Add(new RangeMapping <TKey>(this.Manager, creationInfo));
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"CreateRangeMapping", "Complete; Shard: {0}; Duration: {1}",
creationInfo.Shard.Location, stopwatch.Elapsed);
return(rangeMapping);
}
}
public IReadOnlyList <RangeMapping <TKey> > SplitMapping(RangeMapping <TKey> existingMapping, TKey splitAt,
MappingLockToken mappingLockToken)
{
ExceptionUtils.DisallowNullArgument(existingMapping, "existingMapping");
ExceptionUtils.DisallowNullArgument(mappingLockToken, "mappingLockToken");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"SplitMapping", "Start; Shard: {0}", existingMapping.Shard.Location);
Stopwatch stopwatch = Stopwatch.StartNew();
IReadOnlyList <RangeMapping <TKey> > rangeMapping = this.rsm.Split(existingMapping, splitAt, mappingLockToken.LockOwnerId);
stopwatch.Stop();
Tracer.TraceInfo(TraceSourceConstants.ComponentNames.RangeShardMap,
"SplitMapping", "Complete; Shard: {0}; Duration: {1}",
existingMapping.Shard.Location, stopwatch.Elapsed);
return(rangeMapping);
}
}
/// <summary>
/// Gets the lock owner id of the specified mapping.
/// </summary>
/// <param name="mapping">Input range mapping.</param>
/// <returns>An instance of <see cref="MappingLockToken"/></returns>
public MappingLockToken GetMappingLockOwner(RangeMapping <TKey> mapping)
{
ExceptionUtils.DisallowNullArgument(mapping, "mapping");
using (ActivityIdScope activityIdScope = new ActivityIdScope(Guid.NewGuid()))
{
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"LookupLockOwner", "Start");
Stopwatch stopwatch = Stopwatch.StartNew();
Guid storeLockOwnerId = this.rsm.GetLockOwnerForMapping(mapping);
stopwatch.Stop();
Tracer.TraceInfo(
TraceSourceConstants.ComponentNames.RangeShardMap,
"LookupLockOwner", "Complete; Duration: {0}; StoreLockOwnerId: {1}",
stopwatch.Elapsed, storeLockOwnerId);
return(new MappingLockToken(storeLockOwnerId));
}
}
/// <summary>
/// Adds a range mapping.
/// </summary>
/// <param name="mapping">Mapping being added.</param>
/// <returns>The added mapping object.</returns>
public RangeMapping <TKey> Add(RangeMapping <TKey> mapping)
{
return(this.Add <RangeMapping <TKey> >(
mapping,
(smm, sm, ssm) => new RangeMapping <TKey>(smm, sm, ssm)));
}
public RangeMapping <TKey> MergeMappings(RangeMapping <TKey> left, RangeMapping <TKey> right)
{
return(this.MergeMappings(left, right, MappingLockToken.NoLock, MappingLockToken.NoLock));
}
/// <summary>
/// Gets the lock owner of a mapping.
/// </summary>
/// <param name="mapping">The mapping</param>
/// <returns>Lock owner for the mapping.</returns>
internal Guid GetLockOwnerForMapping(RangeMapping <TKey> mapping)
{
return(this.GetLockOwnerForMapping <RangeMapping <TKey> >(mapping, ShardManagementErrorCategory.RangeShardMap));
}
public IReadOnlyList <RangeMapping <TKey> > SplitMapping(RangeMapping <TKey> existingMapping, TKey splitAt)
{
return(this.SplitMapping(existingMapping, splitAt, MappingLockToken.NoLock));
}
/// <summary>
/// Splits the given mapping into 2 at the given key. The new mappings point to the same shard
/// as the existing mapping.
/// </summary>
/// <param name="existingMapping">Given existing mapping.</param>
/// <param name="splitAt">Split point.</param>
/// <param name="lockOwnerId">Lock owner id of this mapping</param>
/// <returns>Read-only collection of 2 new mappings thus created.</returns>
internal IReadOnlyList <RangeMapping <TKey> > Split(RangeMapping <TKey> existingMapping, TKey splitAt, Guid lockOwnerId)
{
this.EnsureMappingBelongsToShardMap <RangeMapping <TKey> >(
existingMapping,
"Split",
"existingMapping");
ShardKey shardKey = new ShardKey(ShardKey.ShardKeyTypeFromType(typeof(TKey)), splitAt);
if (!existingMapping.Range.Contains(shardKey) ||
existingMapping.Range.Low == shardKey ||
existingMapping.Range.High == shardKey)
{
throw new ArgumentOutOfRangeException(
"splitAt",
Errors._ShardMapping_SplitPointOutOfRange);
}
IStoreShard newShard = new DefaultStoreShard(
existingMapping.Shard.StoreShard.Id,
Guid.NewGuid(),
existingMapping.ShardMapId,
existingMapping.Shard.StoreShard.Location,
existingMapping.Shard.StoreShard.Status);
IStoreMapping mappingToRemove = new DefaultStoreMapping(
existingMapping.StoreMapping.Id,
existingMapping.StoreMapping.ShardMapId,
newShard,
existingMapping.StoreMapping.MinValue,
existingMapping.StoreMapping.MaxValue,
existingMapping.StoreMapping.Status,
existingMapping.StoreMapping.LockOwnerId);
IStoreMapping[] mappingsToAdd = new IStoreMapping[2]
{
new DefaultStoreMapping(
Guid.NewGuid(),
newShard.ShardMapId,
newShard,
existingMapping.Range.Low.RawValue,
shardKey.RawValue,
(int)existingMapping.Status,
lockOwnerId),
new DefaultStoreMapping(
Guid.NewGuid(),
newShard.ShardMapId,
newShard,
shardKey.RawValue,
existingMapping.Range.High.RawValue,
(int)existingMapping.Status,
lockOwnerId)
};
using (IStoreOperation op = this.Manager.StoreOperationFactory.CreateReplaceMappingsOperation(
this.Manager,
StoreOperationCode.SplitMapping,
this.ShardMap.StoreShardMap,
new[] { new Tuple <IStoreMapping, Guid>(mappingToRemove, lockOwnerId) },
mappingsToAdd.Select(mappingToAdd => new Tuple <IStoreMapping, Guid>(mappingToAdd, lockOwnerId)).ToArray()))
{
op.Do();
}
return(mappingsToAdd
.Select(m => new RangeMapping <TKey>(this.Manager, this.ShardMap, m))
.ToList()
.AsReadOnly());
}
public RangeMapping <TKey> UpdateMapping(RangeMapping <TKey> currentMapping, RangeMappingUpdate update)
{
return(this.UpdateMapping(currentMapping, update, MappingLockToken.NoLock));
}
public void DeleteMapping(RangeMapping <TKey> mapping)
{
this.DeleteMapping(mapping, MappingLockToken.NoLock);
}
internal RangeMapping <TKey> Merge(RangeMapping <TKey> left, RangeMapping <TKey> right, Guid leftLockOwnerId, Guid rightLockOwnerId)
{
this.EnsureMappingBelongsToShardMap <RangeMapping <TKey> >(left, "Merge", "left");
this.EnsureMappingBelongsToShardMap <RangeMapping <TKey> >(right, "Merge", "right");
if (!left.Shard.Location.Equals(right.Shard.Location))
{
throw new ArgumentException(
StringUtils.FormatInvariant(
Errors._ShardMapping_MergeDifferentShards,
this.ShardMap.Name,
left.Shard.Location,
right.Shard.Location),
"left");
}
if (left.Range.Intersects(right.Range) || left.Range.High != right.Range.Low)
{
throw new ArgumentOutOfRangeException(
"left",
Errors._ShardMapping_MergeNotAdjacent);
}
if (left.Status != right.Status)
{
throw new ArgumentException(
StringUtils.FormatInvariant(
Errors._ShardMapping_DifferentStatus,
this.ShardMap.Name),
"left");
}
IStoreShard newShard = new DefaultStoreShard(
left.Shard.StoreShard.Id,
Guid.NewGuid(),
left.Shard.StoreShard.ShardMapId,
left.Shard.StoreShard.Location,
left.Shard.StoreShard.Status);
IStoreMapping mappingToRemoveLeft = new DefaultStoreMapping(
left.StoreMapping.Id,
left.StoreMapping.ShardMapId,
newShard,
left.StoreMapping.MinValue,
left.StoreMapping.MaxValue,
left.StoreMapping.Status,
left.StoreMapping.LockOwnerId);
IStoreMapping mappingToRemoveRight = new DefaultStoreMapping(
right.StoreMapping.Id,
right.StoreMapping.ShardMapId,
newShard,
right.StoreMapping.MinValue,
right.StoreMapping.MaxValue,
right.StoreMapping.Status,
right.StoreMapping.LockOwnerId);
IStoreMapping mappingToAdd = new DefaultStoreMapping(
Guid.NewGuid(),
newShard.ShardMapId,
newShard,
left.Range.Low.RawValue,
right.Range.High.RawValue,
(int)left.Status,
leftLockOwnerId);
using (IStoreOperation op = this.Manager.StoreOperationFactory.CreateReplaceMappingsOperation(
this.Manager,
StoreOperationCode.MergeMappings,
this.ShardMap.StoreShardMap,
new[]
{
new Tuple <IStoreMapping, Guid> (mappingToRemoveLeft, leftLockOwnerId),
new Tuple <IStoreMapping, Guid> (mappingToRemoveRight, rightLockOwnerId)
},
new[]
{
new Tuple <IStoreMapping, Guid>(mappingToAdd, leftLockOwnerId)
}))
{
op.Do();
}
return(new RangeMapping <TKey>(this.Manager, this.ShardMap, mappingToAdd));
}
/// <summary>
/// Marks the specified mapping online.
/// </summary>
/// <param name="mapping">Input range mapping.</param>
/// <returns>An online mapping.</returns>
public RangeMapping <TKey> MarkMappingOnline(RangeMapping <TKey> mapping)
{
return(this.MarkMappingOnline(mapping, MappingLockToken.NoLock));
}
/// <summary>
/// Marks the specified mapping offline.
/// </summary>
/// <param name="mapping">Input range mapping.</param>
/// <param name="options">Options for validation operations to perform on opened connection to affected shard.</param>
/// <returns>An offline mapping.</returns>
public RangeMapping <TKey> MarkMappingOffline(RangeMapping <TKey> mapping, MappingOptions options)
{
return(this.MarkMappingOffline(mapping, MappingLockToken.NoLock, options));
}
/// <summary>
/// Marks the specified mapping offline.
/// </summary>
/// <param name="mapping">Input range mapping.</param>
/// <param name="mappingLockToken">An instance of <see cref="MappingLockToken"/></param>
/// <returns>An offline mapping.</returns>
public RangeMapping <TKey> MarkMappingOffline(RangeMapping <TKey> mapping, MappingLockToken mappingLockToken)
{
return(this.MarkMappingOffline(mapping, mappingLockToken, MappingOptions.Validate));
}
