sp_addsubscriber (Transact-SQL)

Articolo
05/07/2013

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 è deprecata. Non è più necessario registrare in modo esplicito un Sottoscrittore nel server di pubblicazione.

Icona di collegamento a un argomento 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. I valori possibili sono i seguenti.

Valore

Descrizione

0 (predefinito)

Sottoscrittore Microsoft SQL Server

1

Server dell'origine dei dati ODBC.

2

Database Microsoft Jet

3

Provider OLE DB
[ @login=] 'login'
ID dell'account di accesso per l'autenticazione di SQL Server. login è di tipo sysname e il valore predefinito è NULL.

[!NOTA]

Questo parametro è deprecato 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 utilizzata per l'autenticazione di SQL Server. password è di tipo nvarchar(524) e il valore predefinito è NULL.

Nota sulla sicurezza

Non utilizzare una password vuota. Utilizzare una password complessa.

[!NOTA]

Questo parametro è deprecato 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 è deprecato 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 è deprecato 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 è deprecato 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. I valori possibili sono i seguenti.

Valore

Descrizione

1

Una volta

2

Su richiesta

4

Giornaliera

8

Settimanale

16

Mensile

32

Mensile relativa

64 (predefinito)

Avvio automatico

128

Periodica

[!NOTA]

Questo parametro è deprecato 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 è deprecato 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 (mensile relativa). frequency_relative_interval è di tipo int. I valori possibili sono i seguenti.

Valore

Descrizione

1 (predefinito)

Primo

2

Secondo

4

Terzo

8

Quarto

16

Ultimo

[!NOTA]

Questo parametro è deprecato 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 occorrenza utilizzato da frequency_type. frequency_recurrence_factor è int, con valore predefinito 0.

[!NOTA]

Questo parametro è deprecato 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. I valori possibili sono i seguenti.

Valore

Descrizione

1

Una volta sola

2

Secondo

4 (predefinito)

Minuto

8

Ora

[!NOTA]

Questo parametro è deprecato 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 è int, con valore predefinito 5.

[!NOTA]

Questo parametro è deprecato 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 è int, con valore predefinito 0.

[!NOTA]

Questo parametro è deprecato 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 è deprecato 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 è deprecato 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 è deprecato 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 sicurezza 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 è deprecato 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 è deprecato 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.

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

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

Valore	Descrizione
1	Una volta
2	Su richiesta
4	Giornaliera
8	Settimanale
16	Mensile
32	Mensile relativa
64 (predefinito)	Avvio automatico
128	Periodica

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

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

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

Riferimento

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

Concetti

Creazione di una sottoscrizione push

Creazione di una sottoscrizione pull

Condividi tramite