sp_adjustpublisheridentityrange (Transact-SQL)

Regola l'intervallo di valori Identity in una pubblicazione e riassegna nuovi intervalli in base al valore di soglia previsto per la pubblicazione. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @publication=] 'publication'
    Nome della pubblicazione in cui vengono riallocati i nuovi intervalli di valori Identity. publication è di tipo sysname e il valore predefinito è NULL.

  • [ @table_name=] 'table_name'
    Nome della tabella in cui vengono riallocati i nuovi intervalli di valori Identity. table_name è di tipo sysname e il valore predefinito è NULL.

  • [ @table_owner=] 'table_owner'
    Proprietario della tabella nel server di pubblicazione. table_owner è di tipo sysname e il valore predefinito è NULL. Se table_owner viene omesso, viene utilizzato il nome dell'utente corrente.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_adjustpublisheridentityrange viene utilizzata in tutti i tipi di replica.

Nel caso di una pubblicazione per la quale è attivata la gestione automatica di intervalli di valori Identity, l'agente di distribuzione o di merge è responsabile della regolazione automatica dell'intervallo di valori Identity in una pubblicazione in base al valore di soglia corrispondente. Se tuttavia l'agente di distribuzione o di merge non è stato eseguito per un certo periodo di tempo e la risorsa dell'intervallo di valori Identity è stata utilizzata fino al punto di soglia, gli utenti possono richiamare sp_adjustpublisheridentityrange per allocare un nuovo intervallo di valori per un server di pubblicazione.

Durante l'esecuzione di sp_adjustpublisheridentityrange è necessario specificare publication oppure table_name. Se vengono specificati entrambi oppure viene omesso uno dei due, viene restituito un errore.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_adjustpublisheridentityrange.