sp_adjustpublisheridentityrange (Transact-SQL)

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. Cette procédure stockée est exécutée dans la base de données de publication du serveur de publication.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @publication=] 'publication'
    Nom de la publication dans laquelle de nouvelles plages d'identité sont réaffectées. publication est de type sysname et sa valeur par défaut est NULL.

  • [ @table_name =] 'table_name'
    Nom de la table dans laquelle de nouvelles plages d'identité sont réaffectées. table_name est de type sysname et sa valeur par défaut est NULL.

  • [ @table_owner=] 'table_owner'
    Nom du propriétaire de la table au niveau du serveur de publication. table_owner est de type sysname, avec NULL comme valeur par défaut. Si la valeur de table_owner n'est pas spécifiée, le nom de l'utilisateur actuel est utilisé.

Valeurs des codes renvoyés

0 (réussite) ou 1 (échec)

Notes

La procédure sp_adjustpublisheridentityrange est utilisée dans tous les types de réplications.

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. Toutefois, si pour une raison quelconque l'Agent de distribution ou de fusion n'a pas été exécuté pendant un certain temps et qu'une ressource de plage d'identité a été sensiblement sollicitée jusqu'à la valeur de seuil, les utilisateurs peuvent appeler sp_adjustpublisheridentityrange pour allouer une nouvelle plage de valeurs à un serveur de publication.

Lors de l'exécution de la procédure sp_adjustpublisheridentityrange, l'élément publication ou table_name doit être spécifié. Si les deux sont spécifiés ou aucun des deux, un message d'erreur est renvoyé.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter la procédure sp_adjustpublisheridentityrange.