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

  • 0 specifica 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.