Ajout d’une partition à l’aide des outils de base de données élastique

S’applique à Azure SQL Database

Pour ajouter une partition pour une nouvelle plage ou clé

Les applications ont souvent besoin d’ajouter de nouvelles partitions pour gérer des données attendues de nouvelles clés ou plages de clés, pour une carte de partitions qui existe déjà. Par exemple, une application partitionnée par un ID de client peut requérir la création d’une partition pour un nouveau client, ou des données partitionnées mensuellement peuvent requérir l’approvisionnement d’une nouvelle partition avant le début de chaque mois.

Si la nouvelle plage de valeurs de clé n’appartient pas déjà à un mappage existant, vous pouvez ajouter la nouvelle partition et associer la nouvelle clé ou la plage à cette partition.

Exemple : ajout d’une partition et de sa plage à une carte de partition existante

Cet exemple utilise les méthodes TryGetShard (Java, .NET), CreateShard (Java, .NET) et CreateRangeMapping (Java, .NET), puis crée une instance de la classe ShardLocation (Java, .NET). Dans l’exemple ci-dessous, une base de données nommée sample_shard_2 et tous les objets de schéma nécessaires qu’elle contient ont été créés pour contenir la plage [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));

Pour la version .NET, vous pouvez aussi utiliser PowerShell comme alternative pour créer un Gestionnaire de cartes de partitions. Un exemple est disponible ici.

Pour ajouter une partition pour une partie vide d’une plage existante

Il peut arriver que vous ayez déjà mappé une plage à une partition et l’ayez partiellement remplie avec des données, mais que vous souhaitiez maintenant que les données futures soient dirigées vers une autre partition. Par exemple, vous pouvez partitionner par plage de jours et vous avez déjà alloué 50 jours à une partition, mais le jour 24, vous souhaitez que les données futures soient dirigées vers une autre partition. L’outil de fusion et de fractionnement de la base de données élastique peut effectuer cette opération, mais s’il n’est pas nécessaire de déplacer des données (par exemple, les données de la plage de jours [25, 50), c’est-à-dire le jour 25 inclus et le jour 50 exclu, n’existent pas encore) vous pouvez effectuer cela entièrement en utilisant directement les API de gestion de carte de partition.

Exemple : fractionnement d’une plage et affectation de la partie vide dans une partition nouvellement ajoutée

Une base de données nommée « sample_shard_2 » et tous les objets de schéma nécessaires qu’elle contient ont été créés.

// 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));

Important

Utilisez cette technique seulement si vous êtes certain que la plage de mappage mis à jour est vide. Les méthodes précédentes ne vérifient pas les données de la plage déplacée. Il est donc préférable d’inclure des vérifications dans votre code. S’il existe des lignes dans la plage déplacée, la distribution des données réelle ne correspondra pas à la carte des partitions mise à jour. Utilisez l’outil de fusion et de fractionnement pour effectuer cette opération, au lieu de le faire dans ces cases.

Ressources supplémentaires

Vous n’utilisez pas encore d’outils de base de données élastique ? Consultez notre Guide de prise en main. Pour toute question, contactez-nous par le biais de la page de questions Microsoft Q&A sur SQL Database et, pour vos demandes de fonctionnalités, ajoutez de nouvelles idées ou votez pour les idées existantes sur le forum de commentaires SQL Database.