Condividi tramite


sp_helpsubscription (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

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 relative alla sintassi Transact-SQL

Sintassi

sp_helpsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione associata. @publication è sysname, con un valore predefinito %, che restituisce tutte le informazioni sulla sottoscrizione per questo server.

[ @article = ] N'article'

Nome dell'articolo. @article è sysname, con un valore predefinito %, che restituisce tutte le informazioni di sottoscrizione per le pubblicazioni e i Sottoscrittori selezionati. Se all, viene restituita una sola voce per la sottoscrizione completa in una pubblicazione.

[ @subscriber = ] N'subscriber'

Nome del Sottoscrittore in cui ottenere informazioni sulla sottoscrizione. @subscriber è sysname, con un valore predefinito %, che restituisce tutte le informazioni sulla sottoscrizione per le pubblicazioni e gli articoli selezionati.

[ @destination_db = ] N'destination_db'

Nome del database di destinazione. @destination_db è sysname, con il valore predefinito %.

[ @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.

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname e il nome predefinito è il nome del server corrente.

@publisher non deve essere specificato, tranne quando si tratta 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 = Automatico
2 = Nessuno
subscription type int Tipo di sottoscrizione:

0 = Push
1 = Pull
2 = Anonimo
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.
1 = Non restituisce.

Utilizzato con la replica transazionale bidirezionale. Per altre informazioni, vedere Bidirectional Transactional Replication.
offload_enabled bit Specifica se l'esecuzione di offload di un agente di replica è impostata per l'esecuzione nel Sottoscrittore.

Se 0, l'agente viene eseguito nel server di pubblicazione.
Se 1, l'agente viene eseguito nel Sottoscrittore.
offload_server sysname Nome del server abilitato per l'attivazione remota degli agenti. Se NULL, viene utilizzata la offload_server corrente elencata 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 è presente un pacchetto, un valore di 0 specifica il percorso del pacchetto in distributor. Un valore di 1 specifica l'oggetto subscriber.
subscriber_security_mode smallint 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 La password effettiva per il Sottoscrittore non viene mai restituita. Il risultato è mascherato da una ****** stringa.
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 è mascherato da una ****** stringa.
distrib_agent_name nvarchar(100) Nome del processo dell'agente che sincronizza la sottoscrizione.
subscriber_type tinyint Tipo di Sottoscrittore, che può essere uno dei valori seguenti:

0 = Sottoscrittore di SQL Server
1 = Server origine dati ODBC
2 = Database Microsoft JET (deprecato)
3 = Provider 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 del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_helpsubscription viene usato nella replica snapshot e transazionale.

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 nel server di pubblicazione o nei membri del db_owner ruolo predefinito del database nel database di pubblicazione.