Condividi tramite


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.

Nota importanteImportante

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 sicurezzaNota 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.

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