sp_adjustpublisheridentityrange (Transact-SQL)sp_adjustpublisheridentityrange (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Ajuste la plage d'identités sur une publication et réaffecte de nouvelles plages en fonction de la valeur de seuil définie pour la publication.Adjusts the identity range on a publication and reallocates new ranges based on the threshold value on the publication. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_adjustpublisheridentityrange [ [ @publication = ] 'publication' ]  
    [ , [ @table_name = ] 'table_name' ]  
    [ , [ @table_owner= ] 'table_owner' ]  

ArgumentsArguments

[ @publication = ] 'publication' Est le nom de la publication dans laquelle de nouvelles plages d’identité sont réaffectées.[ @publication = ] 'publication' Is the name of the publication in which new identity ranges are reallocated. publication est sysname, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL.

[ @table_name = ] 'table_name' Est le nom de la table dans laquelle de nouvelles plages d’identité sont réaffectées.[ @table_name = ] 'table_name' Is the name of the table in which new identity ranges are reallocated. table_name est sysname, avec NULL comme valeur par défaut.table_name is sysname, with a default of NULL.

[ @table_owner = ] 'table_owner' Est le propriétaire de la table sur le serveur de publication.[ @table_owner = ] 'table_owner' Is the owner of the table at the Publisher. TABLE_OWNER est sysname, avec NULL comme valeur par défaut.table_owner is sysname, with a default of NULL. Si table_owner n’est pas spécifié, le nom de l’utilisateur actuel est utilisé.If table_owner is not specified, the name of the current user is used.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_adjustpublisheridentityrange est utilisée dans tous les types de réplication.sp_adjustpublisheridentityrange is used in all types of replication.

Lorsque le paramètre d'affectation automatique de plage d'identités est activé pour une publication, l'Agent de distribution ou de fusion est responsable de l'ajustement automatique de la plage d'identités en fonction de la valeur de seuil de la publication.For a publication which has the auto identity range enabled, the Distribution Agent or Merge Agent is responsible for automatically adjusting the identity range in a publication based on its threshold value. Toutefois, si pour une raison quelconque l’Agent de Distribution ou l’Agent de fusion n'a pas été exécuté pendant une période de temps, et la ressource de plage d’identité a été sensiblement sollicitée jusqu’au point de seuil, les utilisateurs peuvent appeler sp_adjustpublisheridentityrange pour allouer une nouvelle plage de valeurs pour un serveur de publication.However, if for some reason the Distribution Agent or Merge Agent has not been run for a period of time, and identity range resource have been consumed heavily to the point of threshold, users can call sp_adjustpublisheridentityrange to allocate a new range of values for a Publisher.

Lors de l’exécution sp_adjustpublisheridentityrange, soit publication ou table_name doit être spécifié.When executing sp_adjustpublisheridentityrange, either publication or table_name must be specified. Si les deux sont spécifiés ou aucun des deux, un message d'erreur est renvoyé.If both or neither are specified an error is returned.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe ou db_owner rôle de base de données fixe peuvent exécuter sp_adjustpublisheridentityrange.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_adjustpublisheridentityrange.

Voir aussiSee Also

Répliquer des colonnes d’identité Replicate Identity Columns
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)