ALTER PARTITION FUNCTION (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Modifie une fonction de partition en divisant ou en fusionnant ses valeurs limites. Le fait d’exécuter une instruction ALTER PARTITION FUNCTION permet de fractionner en deux partitions une partition de table ou d’index qui utilise la fonction de partition. L’instruction peut également fusionner deux partitions en une partition unique.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
ALTER PARTITION FUNCTION partition_function_name()  
{   
    SPLIT RANGE ( boundary_value )  
  | MERGE RANGE ( boundary_value )   
} [ ; ]  

Arguments

partition_function_name
Nom de la fonction de partition à modifier.

SPLIT RANGE ( boundary_value )
Ajoute une partition à la fonction de partition. boundary_value détermine la plage de la nouvelle partition. Elle doit être différente des plages limites existantes de la fonction de partition. En fonction de la valeur de boundary_value, le moteur de base de données fractionne l’une des plages existantes en deux. Parmi ces deux plages, celle avec la nouvelle valeur boundary_value est la nouvelle partition.

Un groupe de fichiers doit exister en ligne. Et le schéma de partition qui utilise la fonction de partition comme NEXT HOLD pour conserver la nouvelle partition doit marquer le groupe de fichiers. Les groupes de fichiers sont alloués aux partitions dans une instruction CREATE PARTITION SCHEME. L’instruction CREATE PARTITION FUNCTION crée moins de partitions que de groupes de fichiers pour les contenir. Une instruction CREATE PARTITION SCHEME peut mettre de côté davantage de groupes de fichiers que nécessaire. Si cela se produit, vous obtiendrez des groupes de fichiers non attribués. En outre, le schéma de partition marque l’un des groupes de fichiers comme NEXT USED. Ce groupe de fichiers accueille la nouvelle partition. S’il n’y a aucun groupe de fichiers que le schéma de partition marque comme NEXT USED, vous devez utiliser une instruction ALTER PARTITION SCHEME.

L’instruction ALTER PARTITION SCHEME peut ajouter un groupe de fichiers, ou en sélectionner un existant, pour contenir la nouvelle partition. Vous pouvez attribuer un groupe de fichiers contenant déjà des partitions pour accueillir des partitions supplémentaires. Une fonction de partition peut faire partie de plusieurs schémas de partition. Ainsi, tous les schémas de partition qui utilisent la fonction de partition à laquelle vous ajoutez des partitions doivent avoir un groupe de fichiers NEXT USED. À défaut, l’instruction ALTER PARTITION FUNCTION échoue et génère une erreur indiquant le ou les schémas de partition qui sont dépourvus d'un groupe de fichiers NEXT USED.

Si vous créez toutes les partitions dans le même groupe de fichiers, celui-ci est initialement et automatiquement affecté comme le groupe de fichiers NEXT USED. Toutefois, après une opération de fractionnement, il n'y a plus de groupe de fichiers NEXT USED sélectionné. Vous devez affecter explicitement le groupe de fichiers comme groupe de fichiers NEXT USED à l’aide de l’instruction ALTER PARTITION SCHEME, sinon toute division ultérieure échouera.

MERGE [ RANGE ( boundary_value) ]
Supprime une partition et fusionne les valeurs qui existent dans la partition dans une partition restante. La plage (boundary_value) doit être une valeur limite existante de la partition à supprimer. Cet argument supprime le groupe de fichiers qui contenait initialement boundary_value du schéma de partition, sauf s’il est utilisé par une partition restante, ou le marque avec la propriété NEXT USED. La partition fusionnée existe dans le groupe de fichiers qui ne contenait pas initialement boundary_value. boundary_value est une expression constante qui peut référencer des variables (notamment des variables de type défini par l’utilisateur) ou des fonctions (notamment des fonctions définies par l’utilisateur). Cela ne peut pas faire référence à une expression Transact-SQL. boundary_value doit correspondre au type de données de sa colonne de partitionnement correspondante ou être convertible de façon implicite en celui-ci. Vous ne pouvez pas non plus tronquer boundary_value pendant une conversion implicite d’une manière à ce que la taille et la mise à l’échelle de la valeur ne correspondent pas à celles de son paramètre input_parameter_type correspondant.

Bonnes pratiques

Conservez toujours les partitions vides aux deux extrémités de la plage de partitions. Conservez les partitions aux deux extrémités afin de garantir que le fractionnement et la fusion de la partition n’entraînent aucun déplacement de données. Le fractionnement de la partition se produit au début et la fusion de partition se produit à la fin. Évitez de fractionner ou fusionner des partitions remplies. Le fractionnement ou la fusion des partitions remplies peut être inefficace. En effet, le fractionnement ou la fusion peut entraîner quatre fois plus de générations de journaux et provoquer également un verrouillage grave.

La principale raison de placer des partitions sur des groupes de fichiers distincts est de s’assurer que vous pouvez réaliser des opérations de sauvegarde et de restauration indépendantes sur les partitions. Découvrez les groupes de fichiers et les stratégies de partitionnement dans les groupes de fichiers.

Limitations et restrictions

ALTER PARTITION FUNCTION repartitionne les tables et les index qui utilisent la fonction en une opération atomique unique. Toutefois, cette opération se produit hors ligne et, selon l'étendue du repartitionnement, elle peut s'avérer gourmande en ressources.

L'utilisation de ALTER PARTITION FUNCTION doit uniquement viser à diviser une partition en deux, ou à fusionner deux partitions dans une seule. Pour modifier la façon dont une table est partitionnée (par exemple, de 10 partitions à 5), vous pouvez utiliser l'une des options indiquées ci-dessous. La consommation en ressources de ces options peut varier en fonction de la configuration de votre système :

• Créez une nouvelle table partitionnée avec la fonction de partition nécessaire. Puis, insérez les données à partir de l’ancienne table dans la nouvelle table en utilisant une instruction INSERT INTO...SELECT FROM.

• Créez un index cluster partitionné sur un segment.

  Notes

  La suppression d'un index cluster partitionné engendre un segment partitionné.

• Annulez et reconstruisez un index partitionné existant à l'aide de l'instruction Transact-SQL CREATE INDEX avec la clause DROP EXISTING = ON.

• Exécutez une séquence d'instructions ALTER PARTITION FUNCTION.

Tous les groupes de fichiers concernés par l’instruction ALTER PARTITION FUNCTION doivent être en ligne.

ALTER PARTITION FUNCTION échoue s'il existe un index cluster désactivé dans une table qui utilise la fonction de partition.

Le moteur de base de données n’assure pas la prise en charge de la réplication lors de la modification d’une fonction de partition. Les modifications apportées à une fonction de partition dans la base de données de publication doivent être appliquées manuellement dans la base de données d'abonnement.

Autorisations

L'instruction ALTER PARTITION FUNCTION peut être exécutée avec les autorisations suivantes :

• Autorisation ALTER ANY DATASPACE. Cette autorisation est attribuée par défaut aux membres du rôle de serveur fixe sysadmin et des rôles de base de données fixes db_owner et db_ddladmin .

• Autorisation CONTROL ou ALTER sur la base de données dans laquelle la fonction de partition a été créée.

• Autorisation CONTROL SERVER ou ALTER ANY DATABASE sur le serveur de la base de données dans laquelle la fonction de partition a été créée.

Exemples

R. Fractionner une partition de table ou d’index partitionné en deux partitions

L'exemple suivant crée une fonction de partition pour partitionner une table ou un index en quatre partitions. ALTER PARTITION FUNCTION fractionne l'une des partitions en deux pour créer au total cinq partitions.

IF EXISTS (SELECT * FROM sys.partition_functions  
    WHERE name = 'myRangePF1')  
DROP PARTITION FUNCTION myRangePF1;  
GO  
CREATE PARTITION FUNCTION myRangePF1 (int)  
AS RANGE LEFT FOR VALUES ( 1, 100, 1000 );  
GO  
--Split the partition between boundary_values 100 and 1000  
--to create two partitions between boundary_values 100 and 500  
--and between boundary_values 500 and 1000.  
ALTER PARTITION FUNCTION myRangePF1 ()  
SPLIT RANGE (500);  

B. Fusion de deux partitions d’une table partitionnée en une seule partition

L'exemple suivant crée une fonction de partition (identique à celle de l'exemple précédent), puis fusionne deux des partitions en une seule partition, pour un total de trois partitions.

IF EXISTS (SELECT * FROM sys.partition_functions  
    WHERE name = 'myRangePF1')  
DROP PARTITION FUNCTION myRangePF1;  
GO  
CREATE PARTITION FUNCTION myRangePF1 (int)  
AS RANGE LEFT FOR VALUES ( 1, 100, 1000 );  
GO  
--Merge the partitions between boundary_values 1 and 100  
--and between boundary_values 100 and 1000 to create one partition  
--between boundary_values 1 and 1000.  
ALTER PARTITION FUNCTION myRangePF1 ()  
MERGE RANGE (100);  

Étapes suivantes

Découvrez le partitionnement des tables et les concepts associés dans les articles suivants :

• CREATE PARTITION FUNCTION (Transact-SQL)
• Tables et index partitionnés
• Modifier une fonction de partition
• CREATE PARTITION SCHEME (Transact-SQL)
• Modifier un schéma de partition