sp_addsubscriber (Transact-SQL)

Aggiunge in un server di pubblicazione un nuovo Sottoscrittore per abilitarlo alla ricezione di pubblicazioni. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione per pubblicazioni snapshot e transazionali. Per pubblicazioni di tipo merge che utilizzano un server di distribuzione remoto, viene eseguita nel server di distribuzione.

Importante
Questa stored procedure è obsoleta. Non è più necessario registrare in modo esplicito un Sottoscrittore nel server di pubblicazione.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_addsubscriber [ @subscriber = ] 'subscriber'
    [ , [ @type = ] type ] 
    [ , [ @login = ] 'login' ]
    [ , [ @password = ] 'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @description = ] 'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] 'publisher' ]

Argomenti

• [ @subscriber=] 'subscriber'
  Nome del server da aggiungere come Sottoscrittore valido delle pubblicazioni in questo server. subscriber è di tipo sysname e non prevede alcun valore predefinito.

• [ @type=] type
  Tipo di Sottoscrittore. type è di tipo tinyint e i possibili valori sono i seguenti.

  Valore	Descrizione
  0 (predefinito)	MicrosoftSQL Server
  1	Server dell'origine dei dati ODBC
  2	Database Microsoft Jet
  3	Provider OLE DB

• [ @login=] 'login'
  ID di accesso per l'autenticazione di SQL Server. login è di tipo sysname e il valore predefinito è NULL.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @password=] 'password'
  Password per l'autenticazione di SQL Server. password è di tipo nvarchar(524) e il valore predefinito è NULL.

  Nota sulla protezione
  Non utilizzare una password vuota. Utilizzare una password complessa.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @commit_batch_size=] commit_batch_size
  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti.

  [!NOTA]

  Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @status_batch_size=] status_batch_size
  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti.

  [!NOTA]

  Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @flush_frequency=] flush_frequency
  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti.

  [!NOTA]

  Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @frequency_type=] frequency_type
  Frequenza per l'esecuzione pianificata dell'agente di replica. frequency_type è di tipo int e i possibili valori sono i seguenti.

  Valore	Descrizione
  1	Singola occorrenza
  2	A richiesta
  4	Giornaliera
  8	Settimanale
  16	Mensile
  32	Mensile relativa
  64 (predefinito)	Avvio automatico
  128	Periodica

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [@frequency_interval= ] frequency_interval
  Valore applicato alla frequenza impostata da frequency_type. frequency_interval è di tipo int e il valore predefinito è 1.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @frequency_relative_interval=] frequency_relative_interval
  Data dell'agente di replica. Questo parametro viene utilizzato quando frequency_type è impostato su 32 (frequenza mensile relativa). frequency_relative_interval è di tipo int e i possibili valori sono i seguenti.

  Valore	Descrizione
  1 (predefinito)	Primo
  2	Secondo
  4	Terzo
  8	Quarto
  16	Ultimo

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Fattore di ricorrenza utilizzato da frequency_type. frequency_recurrence_factor è di tipo int e il valore predefinito è 0.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @frequency_subday=] frequency_subday
  Frequenza di ripianificazione durante il periodo definito. frequency_subday è di tipo int e i possibili valori sono i seguenti.

  Valore	Descrizione
  1	Una volta
  2	Secondo
  4 (predefinito)	Minuto
  8	Ora

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @frequency_subday_interval=] frequency_subday_interval
  Intervallo per frequency_subday. frequency_subday_interval è di tipo int e il valore predefinito è 5.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @active_start_time_of_day=] active_start_time_of_day
  Ora del giorno della prima esecuzione pianificata dell'agente di replica, nel formato HHMMSS. active_start_time_of_day è di tipo int e il valore predefinito è 0.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @active_end_time_of_day=] active_end_time_of_day
  Ora del giorno dell'ultima esecuzione pianificata dell'agente di replica, nel formato HHMMSS. active_end_time_of_dayè di tipo int e il valore predefinito è 235959, che corrisponde alle 23.59.59 nel formato 24 ore.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @active_start_date=] active_start_date
  Data della prima esecuzione pianificata dell'agente di replica, nel formato AAAAMMGG. active_start_date è di tipo int e il valore predefinito è 0.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @active_end_date=] active_end_date
  Data dell'ultima esecuzione pianificata dell'agente di replica, nel formato AAAAMMGG. active_end_date è di tipo int e il valore predefinito è 99991231, che corrisponde al 31 dicembre 9999.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @description=] 'description'
  Descrizione del Sottoscrittore. description è di tipo nvarchar(255) e il valore predefinito è NULL.

• [ @security_mode=] security_mode
  Modalità di protezione implementata. security_mode è di tipo int e il valore predefinito è 1. Il valore 0 indica l'autenticazione di SQL Server. Il valore 1 indica l'autenticazione di Windows.

  [!NOTA]

  Questo parametro è obsoleto ed è ancora disponibile per compatibilità con gli script di versioni precedenti. La proprietà viene ora specificata per ogni sottoscrizione quando si esegue sp_addsubscription. Se si specifica un valore, questo verrà utilizzato come valore predefinito per la creazione di sottoscrizioni nel Sottoscrittore e verrà restituito un messaggio di avviso.

• [ @encrypted_password=] encrypted_password
  Questo parametro è obsoleto ed è ancora disponibile solo per compatibilità con le versioni precedenti. Se si imposta encrypted_password su un qualsiasi valore diverso da 0, verrà generato un errore.

• [ @publisher= ] 'publisher'
  Specifica un server di pubblicazione non SQL Server. publisher è di tipo sysname e il valore predefinito è NULL.

  [!NOTA]

  Evitare di utilizzare publisher quando si esegue una pubblicazione da un server di pubblicazione SQL Server.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_addsubscriber viene utilizzata per la replica snapshot, transazionale e di tipo merge.

sp_addsubscriber non è necessaria quando il Sottoscrittore utilizza esclusivamente sottoscrizioni anonime di pubblicazioni di tipo merge.

sp_addsubscriber esegue operazioni di scrittura nella tabella MSsubscriber_info del database didistribuzione.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_addsubscriber.

Vedere anche

Attivitá

Procedura: Creazione di una sottoscrizione push (programmazione Transact-SQL della replica)

Procedura: Creazione di una sottoscrizione pull (programmazione Transact-SQL della replica)

Riferimento

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)