sp_addsubscriber (Transact-SQL)
Si applica a:
SQL Server database SQL di Azure
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.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_addsubscriber
[ @subscriber = ] N'subscriber'
[ , [ @type = ] type ]
[ , [ @login = ] N'login' ]
[ , [ @password = ] N'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 = ] N'description' ]
[ , [ @security_mode = ] security_mode ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Argomenti
[ @subscriber = ] N'subscriber'
Nome del server da aggiungere come Sottoscrittore valido alle pubblicazioni nel server. @subscriber è sysname, senza impostazione predefinita.
[ @type = ] tipo
Tipo di Sottoscrittore. @type è tinyint e può essere uno di questi valori.
| Valore | Descrizione |
|---|---|
0 (predefinito) |
Sottoscrittore di SQL Server |
1 |
Server dell'origine dei dati ODBC. |
2 |
Database Microsoft Jet |
3 |
Provider OLE DB |
[ @login = ] N'login'
ID di accesso per l'autenticazione di SQL Server. @login è sysname, con il valore predefinito NULL.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @password = ] N'password'
Password per l'autenticazione di SQL Server. @password è nvarchar(524), con il valore predefinito NULL.
Non usare una password vuota. Usare una password complessa.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @commit_batch_size = ] commit_batch_size
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @status_batch_size = ] status_batch_size
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @flush_frequency = ] flush_frequency
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.
Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_type = ] frequency_type
Specifica la frequenza con cui pianificare l'agente di replica. @frequency_type è int e può essere uno di questi valori.
| Valore | Descrizione |
|---|---|
1 |
Singola occorrenza |
2 |
Su richiesta |
4 |
Ogni giorno |
8 |
Settimanale |
16 |
Mensile |
32 |
Mensile relativa |
64 (predefinito) |
Avvio automatico |
128 |
Ricorrente |
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_interval = ] frequency_interval
Valore applicato alla frequenza impostata da @frequency_type. @frequency_interval è int, con il valore predefinito 1.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_relative_interval = ] frequency_relative_interval
Data dell'agente di replica. Questo parametro viene usato quando @frequency_type è impostato su 32 (relativo mensile). @frequency_relative_interval è int e può essere uno di questi valori.
| Valore | Descrizione |
|---|---|
1 (predefinito) |
First |
2 |
Secondo |
4 |
Terza |
8 |
Quarta |
16 |
Last |
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Fattore di ricorrenza utilizzato da @frequency_type. @frequency_recurrence_factor è int, con un valore predefinito .0
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_subday = ] frequency_subday
Frequenza con cui riprogrammare durante il periodo definito. @frequency_subday è int e può essere uno di questi valori.
| Valore | Descrizione |
|---|---|
1 |
Una sola volta |
2 |
Secondo |
4 (predefinito) |
Minute |
8 |
Ore |
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @frequency_subday_interval = ] frequency_subday_interval
Intervallo per frequency_subday. @frequency_subday_interval è int, con il valore predefinito 5.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @active_start_time_of_day = ] active_start_time_of_day
Ora del giorno in cui l'agente di replica viene pianificato per la prima volta, formattato come HHmmss. @active_start_time_of_day è int, con il valore predefinito 0.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @active_end_time_of_day = ] active_end_time_of_day
Ora del giorno in cui l'agente di replica smette di essere pianificato, formattato come HHmmss. @active_end_time_of_day è int, con un valore predefinito , 235959che significa 11:59:59 P.M. come misurato su un orologio di 24 ore.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @active_start_date = ] active_start_date
Data della prima pianificazione dell'agente di replica, formattata come yyyyMMdd. @active_start_date è int, con un valore predefinito .0
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @active_end_date = ] active_end_date
Data in cui l'agente di replica smette di essere pianificato, formattato come yyyyMMdd. @active_end_date è int, con un valore predefinito 99991231, che indica il 31 dicembre 9999.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @description = ] N'description'
Descrizione testuale del Sottoscrittore. @description è nvarchar(255), con il valore predefinito NULL.
[ @security_mode = ] security_mode
Modalità di sicurezza implementata. @security_mode è int, con un valore predefinito .1
0specifica l'autenticazione di SQL Server.1specifica autenticazione di Windows.
Nota
Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script. La proprietà viene ora specificata per ogni sottoscrizione durante l'esecuzione di sp_addsubscription. Quando si specifica un valore, viene usato come valore predefinito durante la creazione di sottoscrizioni nel Sottoscrittore e viene restituito un messaggio di avviso.
[ @encrypted_password = ] encrypted_password
Questo parametro è deprecato e viene fornito solo per la compatibilità con le versioni precedenti. Se si imposta @encrypted_password su qualsiasi valore, viene generato 0 un errore.
[ @publisher = ] N'publisher'
Specifica un server di pubblicazione non SQL Server. @publisher è sysname, con un valore predefinito .NULL
@publisher non deve essere usato durante la pubblicazione da un server di pubblicazione di SQL Server.
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Osservazioni:
sp_addsubscriber viene usato nella replica snapshot, nella replica transazionale e nella replica di tipo merge.
sp_addsubscriber non è obbligatorio quando il Sottoscrittore dispone solo di sottoscrizioni anonime per le pubblicazioni di tipo merge.
sp_addsubscriber scrive nella tabella MSsubscriber_info nel database di distribuzione .
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_addsubscriber.