sp_helpmergesubscription (Transact-SQL)

Si applica a:SQL Server

Restituisce informazioni su una sottoscrizione, sia push che pull, di una pubblicazione di tipo merge. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione o nel database di sottoscrizione di un Sottoscrittore di ripubblicazione.

Convenzioni di sintassi Transact-SQL

Sintassi

sp_helpmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione. @publication è sysname, con il valore predefinito %. La pubblicazione deve essere già presente e conforme alle regole per gli identificatori. Se NULL o %, vengono restituite informazioni su tutte le pubblicazioni e le sottoscrizioni di tipo merge nel database corrente.

[ @subscriber = ] N'subscriber'

Nome del Sottoscrittore. @subscriber è sysname, con il valore predefinito %. Se NULL o %, vengono restituite informazioni su tutte le sottoscrizioni della pubblicazione specificata.

[ @subscriber_db = ] N'subscriber_db'

Nome del database di sottoscrizione. @subscriber_db è sysname, con un valore predefinito %, che restituisce informazioni su tutti i database di sottoscrizione.

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, con un valore predefinito , con un valore predefinito %%, che restituisce informazioni su tutti i server di pubblicazione. Il server di pubblicazione deve essere un server valido.

[ @publisher_db = ] N'publisher_db'

Nome del database del server di pubblicazione. @publisher_db è sysname, con un valore predefinito %, che restituisce informazioni su tutti i database del server di pubblicazione.

[ @subscription_type = ] N'subscription_type'

Tipo di sottoscrizione @subscription_type è nvarchar(15)e può essere uno di questi valori.

Valore Descrizione
push (predefinito) Sottoscrizione push
pull Sottoscrizione pull
both Sottoscrizione sia push che pull

[ @found = ] found OUTPUT

Flag che indica le righe che restituiscono valori. @found è un parametro OUTPUT di tipo int.

  • 1 indica che la pubblicazione è stata trovata.
  • 0 indica che la pubblicazione non è stata trovata.

Set di risultati

Nome colonna Tipo di dati Descrizione
subscription_name sysname Nome della sottoscrizione.
publication sysname Nome della pubblicazione.
publisher sysname Nome del server di pubblicazione.
publisher_db sysname Nome del database del server di pubblicazione.
subscriber sysname Nome del Sottoscrittore.
subscriber_db sysname Nome del database di sottoscrizione.
status int Stato della sottoscrizione:

0 = Tutti i processi sono in attesa di avvio

1 = Vengono avviati uno o più processi

2 = Tutti i processi sono stati eseguiti correttamente

3 = Almeno un processo è in esecuzione

4 = Tutti i processi sono pianificati e inattive

5 = Almeno un processo sta tentando di eseguire dopo un errore precedente

6 = Almeno un processo non è riuscito a essere eseguito correttamente
subscriber_type int Tipo di Sottoscrittore.
subscription_type int Tipo di sottoscrizione:

0 = Push

1 = Pull

2 = Entrambi
priority float(8) Numero che indica il livello di priorità della sottoscrizione.
sync_type tinyint Tipo di sincronizzazione della sottoscrizione.
description nvarchar(255) Breve descrizione della sottoscrizione di tipo merge.
merge_jobid binary(16) ID di processo dell'agente di merge.
full_publication tinyint Specifica se la sottoscrizione si riferisce a una pubblicazione completa o filtrata.
offload_enabled bit Specifica se per un agente di replica è impostata l'esecuzione con ripartizione del carico di lavoro nel Sottoscrittore. Se NULL, l'esecuzione viene eseguita nel server di pubblicazione.
offload_server sysname Nome del server in cui è in esecuzione l'agente.
use_interactive_resolver int Specifica se durante la fase di riconciliazione viene utilizzato il sistema di risoluzione dei conflitti interattivo. Se 0, il sistema di risoluzione interattivo non viene usato.
hostname sysname Valore specificato quando una sottoscrizione viene filtrata in base al valore della funzione HOST_NAME .
subscriber_security_mode smallint La modalità di sicurezza nel Sottoscrittore, dove 1 indica l'autenticazione di Windows e 0 indica l'autenticazione di SQL Server.
subscriber_login sysname Nome dell'account di accesso nel Sottoscrittore.
subscriber_password sysname La password effettiva per il Sottoscrittore non viene mai restituita. Il risultato è mascherato da una ****** stringa.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_helpmergesubscription viene utilizzato nella replica di tipo merge per restituire le informazioni sulla sottoscrizione archiviate nel server di pubblicazione o nel Sottoscrittore di ripubblicazione.

Per le sottoscrizioni anonime, il valore subscription_typeè sempre 1 (pull). Tuttavia, è necessario eseguire sp_helpmergepullsubscription nel Sottoscrittore per informazioni sulle sottoscrizioni anonime.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin , il ruolo predefinito del database db_owner o l'elenco di accesso alla pubblicazione a cui appartiene la sottoscrizione possono eseguire sp_helpmergesubscription.