sp_helpsubscription (Transact-SQL)
Restituisce l'elenco delle informazioni sulla sottoscrizione associate a una pubblicazione, un articolo, un Sottoscrittore o un set di sottoscrizioni. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
Sintassi
sp_helpsubscription [ [ @publication = ] 'publication' ]
[ , [ @article = ] 'article' ]
[ , [ @subscriber = ] 'subscriber' ]
[ , [ @destination_db = ] 'destination_db' ]
[ , [ @found=] found OUTPUT ]
[ , [ @publisher = ] 'publisher' ]
Argomenti
[ @publication = ] 'publication'
Nome della pubblicazione associata. publication è di tipo sysname e il valore predefinito è %, che restituisce tutte le informazioni sulla sottoscrizione per il server specificato.[ @article= ] 'article'
Nome dell'articolo. article è di tipo sysname e il valore predefinito è %, che restituisce tutte le informazioni sulla sottoscrizione per le pubblicazioni e i Sottoscrittori selezionati. Se il valore è all, viene restituita una sola voce per l'intera sottoscrizione di una pubblicazione.[ @subscriber= ] 'subscriber'
Nome del Sottoscrittore di cui si desidera ottenere le informazioni sulla sottoscrizione. subscriber è di tipo sysname e il valore predefinito è %, che restituisce tutte le informazioni sulla sottoscrizione per le pubblicazioni e gli articoli selezionati.[ @destination_db= ] 'destination_db'
Nome del database di destinazione. destination_db è di tipo sysname e il valore predefinito è %.[ @found= ] **'found'**OUTPUT
Flag che indica le righe che restituiscono valori. foundè di tipo int, è un parametro OUTPUT e il valore predefinito è 23456.1 indica che la pubblicazione è stata individuata.
0 indica che la pubblicazione non è stata individuata.
[ @publisher= ] 'publisher'
Nome del server di pubblicazione. publisher è di tipo sysname e il valore predefinito è il nome del server corrente.Nota
publisher non deve essere specificato, tranne nel caso di un server di pubblicazione Oracle.
Set di risultati
Nome colonna |
Tipo di dati |
Descrizione |
---|---|---|
subscriber |
sysname |
Nome del Sottoscrittore. |
publication |
sysname |
Nome della pubblicazione. |
article |
sysname |
Nome dell'articolo. |
destination database |
sysname |
Nome del database di destinazione per i dati replicati. |
subscription status |
tinyint |
Stato della sottoscrizione: 0 = inattivo 1 = sottoscritto 2 = attivo |
synchronization type |
tinyint |
Tipo di sincronizzazione per la sottoscrizione: 1 = automatica 2 = nessuna |
subscription type |
int |
Tipo di sottoscrizione: 0 = push 1 = pull 2 = anonima |
full subscription |
bit |
Indica se la sottoscrizione è associata a tutti gli articoli della pubblicazione: 0 = No 1 = Sì |
subscription name |
nvarchar(255) |
Nome della sottoscrizione. |
update mode |
int |
0 = sola lettura 1 = sottoscrizione ad aggiornamento immediato |
distribution job id |
binary(16) |
ID di processo dell'agente di distribuzione. |
loopback_detection |
bit |
Il rilevamento di loopback determina se l'agente di distribuzione deve inviare nuovamente al Sottoscrittore le transazioni provenienti dal Sottoscrittore: 0 = restituisce le transazioni 1 = non restituisce le transazioni Utilizzato con la replica transazionale bidirezionale. Per ulteriori informazioni, vedere Replica transazionale bidirezionale. |
offload_enabled |
bit |
Specifica se per un agente di replica è impostata l'esecuzione con ripartizione del carico di lavoro nel Sottoscrittore. Se corrisponde a 0, l'agente viene eseguito nel server di pubblicazione. Se corrisponde a 1, l'agente viene eseguito nel Sottoscrittore. |
offload_server |
sysname |
Nome del server abilitato per l'attivazione remota degli agenti. Se è NULL, viene utilizzato il valore di offload_server corrente riportato nella tabella MSdistribution_agents. |
dts_package_name |
sysname |
Specifica il nome del pacchetto Data Transformation Services (DTS). |
dts_package_location |
int |
Posizione del pacchetto DTS, se assegnato alla sottoscrizione. Se è assegnato, il valore 0 specifica la posizione del pacchetto nel server di distribuzione. Il valore 1 specifica il Sottoscrittore. |
subscriber_security_mode |
smallint |
Modalità di protezione 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 |
|
La password effettiva per il Sottoscrittore non viene mai restituita. Il risultato viene mascherato da una serie di asterischi, ad esempio: "******". |
job_login |
sysname |
Nome dell'account di Windows utilizzato per l'esecuzione dell'agente di distribuzione. |
job_password |
|
La password effettiva per il processo non viene mai restituita. Il risultato viene mascherato da una serie di asterischi, ad esempio: "******". |
distrib_agent_name |
nvarchar(100) |
Nome del processo dell'agente che sincronizza la sottoscrizione. |
subscriber_type |
tinyint |
Tipo di Sottoscrittore. I possibili tipi sono i seguenti:
ValoreDescrizione
0Sottoscrittore SQL Server
1Server dell'origine dei dati ODBC
2Database Microsoft JET (obsoleto)
3Provider OLE DB
|
subscriber_provider |
sysname |
ProgID univoco con il quale viene registrato il provider OLE DB per l'origine dei dati non SQL Server. |
subscriber_datasource |
nvarchar(4000) |
Nome dell'origine dei dati riconosciuto dal provider OLE DB. |
subscriber_providerstring |
nvarchar(4000) |
Stringa di connessione specifica del provider OLE DB che identifica l'origine dei dati. |
subscriber_location |
nvarchar(4000) |
Percorso del database riconosciuto dal provider OLE DB. |
subscriber_catalog |
sysname |
Catalogo da utilizzare per stabilire una connessione al provider OLE DB |
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
sp_helpsubscription viene utilizzata in repliche snapshot e transazionali.
Autorizzazioni
Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita al ruolo public. All'utente vengono restituite solo le informazioni relative alle sottoscrizioni create dall'utente stesso. Le informazioni su tutte le sottoscrizioni vengono restituite ai membri del ruolo predefinito del server sysadmin sul server di pubblicazione o ai membri del ruolo predefinito del database db_owner nel database di pubblicazione.