通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用弹性数据库工具添加分片

  • 项目

适用于：Azure SQL 数据库

添加新范围或键的分片

对于已经存在的分片映射，应用程序通常仅需要添加新分片，以处理预期的新键或键范围数据。 例如，由租户 ID 分片的应用程序可能需要为新的租户创建新分片，或者在每个新的月份开始之前，每月分片的数据可能需要预配新分片。

如果新的键值范围还不是现有映射的一部分，则可以添加新分片并将新键或范围与该分片相关联。

示例：将分片及其范围添加到现有的分片映射

本示例使用 TryGetShard（Java、.NET）、CreateShard（Java、.NET）、CreateRangeMapping（Java、.NET）方法，并创建 ShardLocation（Java、.NET）类的实例。 在以下示例中，创建了一个名为 sample_shard_2 的数据库以及其中所有必要的架构对象，用于保存范围 [300, 400)。

// sm is a RangeShardMap object.
// Add a new shard to hold the range being added.
Shard shard2 = null;

if (!sm.TryGetShard(new ShardLocation(shardServer, "sample_shard_2"),out shard2))
{
    shard2 = sm.CreateShard(new ShardLocation(shardServer, "sample_shard_2"));  
}

// Create the mapping and associate it with the new shard
sm.CreateRangeMapping(new RangeMappingCreationInfo<long>
                            (new Range<long>(300, 400), shard2, MappingStatus.Online));

为现有范围的空部分添加分片

在某些情况下，用户可能已将某个范围映射到了某个分片，并在该分片中填充了部分数据，但是，现在用户希望将以后的数据定向到其他的分片。 例如，用户可按日期范围进行分片，并且已在某个分片中分配了 50 天的数据，但从第 24 天开始，用户希望以后的数据都驻留在其他分片中。 弹性数据库拆分/合并工具可以执行此操作，但是，如果不需要数据移动（例如，[25, 50) 天范围的数据 - 即，从第 25 天（含）到第 50 天（不含）的数据尚不存在），完全可以直接使用分片映射管理 API 执行此操作。

示例：拆分范围并将空部分分配到新增的分片

已创建名为“sample_shard_2”的数据库以及其中所有必要的架构对象。

// sm is a RangeShardMap object.
// Add a new shard to hold the range we will move
Shard shard2 = null;

if (!sm.TryGetShard(new ShardLocation(shardServer, "sample_shard_2"),out shard2))
{
    shard2 = sm.CreateShard(new ShardLocation(shardServer,"sample_shard_2"));  
}

// Split the Range holding Key 25
sm.SplitMapping(sm.GetMappingForKey(25), 25);

// Map new range holding [25-50) to different shard:
// first take existing mapping offline
sm.MarkMappingOffline(sm.GetMappingForKey(25));

// now map while offline to a different shard and take online
RangeMappingUpdate upd = new RangeMappingUpdate();
upd.Shard = shard2;
sm.MarkMappingOnline(sm.UpdateMapping(sm.GetMappingForKey(25), upd));

重要

仅当确定所更新映射的范围为空时，才使用此方法。 上述方法不会在数据中检查要移动的范围，因此最好在代码中包含检查操作。 如果要移动的范围中存在行，则实际的数据分布将与更新后的分片映射不匹配。 在这种情况下，请改用拆分/合并工具来执行操作。

相关内容

尚未使用弹性数据库工具？ 请查看入门指南。 如有问题，请在有关 SQL 数据库的 Microsoft Q&A 问题页面上联系我们；如有功能请求，请在 SQL 数据库反馈论坛添加新意见或为现有意见投票。