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.

Convenzioni della sintassi Transact-SQL

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:

Valore

Descrizione

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

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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005