sp_copysubscription (Transact-SQL)

Importante:

La funzionalità di sottoscrizione collegabile è obsoleta e verrà rimossa a partire da una delle prossime versioni. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo. Nel caso di pubblicazioni di tipo merge partizionate mediante filtri con parametri, è consigliabile utilizzare le nuove funzionalità degli snapshot partizionati, che semplificano l'inizializzazione di un ampio numero di sottoscrizioni. Per ulteriori informazioni, vedere Snapshot per pubblicazioni di tipo merge con filtri con parametri. Nel caso di pubblicazioni non partizionate, è possibile inizializzare una sottoscrizione con un backup. Per ulteriori informazioni, vedere Inizializzazione di una sottoscrizione di tipo merge senza snapshot e Inizializzazione di una sottoscrizione transazionale senza uno snapshot.

Copia un database di sottoscrizione che include sottoscrizioni pull, ma non push. È possibile copiare solo database a file singolo. Questa stored procedure viene eseguita nel database di sottoscrizione del Sottoscrittore.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_copysubscription [ @filename = ] 'file_name'
    [ , [ @temp_dir = ] 'temp_dir' ]
    [ , [ @overwrite_existing_file = ] overwrite_existing_file]

Argomenti

• [ @filename =] 'file_name'
  Stringa che specifica il percorso completo, compreso il nome del file, in cui salvare una copia del file con estensione mdf. file name è di tipo nvarchar(260) e non prevede alcun valore predefinito.

• [ @temp_dir=] 'temp_dir'
  Nome della directory contenente i file temporanei. temp_dir è di tipo nvarchar(260) e il valore predefinito è NULL, con cui viene utilizzata la directory dei dati predefinita di Microsoft SQL Server. Nella directory deve essere disponibile spazio sufficiente per l'archiviazione di un file le cui dimensioni sono pari alla somma delle dimensioni di tutti i file di database del Sottoscrittore.

• [ @overwrite_existing_file=] 'overwrite_existing_file'
  Flag booleano facoltativo che indica se sovrascrivere o meno un file esistente con lo stesso nome specificato in @filename. overwrite_existing_fileè di tipo bit e il valore predefinito è 0. Se è 1 l'eventuale file specificato in @filename viene sovrascritto. Se è 0, la stored procedure non viene eseguita correttamente se il file specificato esiste e il file non viene sovrascritto.

Osservazioni

La stored procedure sp_copysubscription viene utilizzata in tutti i tipi di replica per la copia di un database di sottoscrizione in un file come soluzione alternativa all'applicazione di uno snapshot nel Sottoscrittore. Il database deve essere configurato in modo che supporti solo le sottoscrizioni pull. Gli utenti che dispongono delle autorizzazioni appropriate possono eseguire copie del database di sottoscrizione e quindi inviare tramite posta elettronica, copiare o trasferire il file ottenuto (con estensione msf) in un altro Sottoscrittore, dove è possibile collegarlo come sottoscrizione.

Le dimensioni del database di sottoscrizione copiato devono essere inferiori a 2 gigabyte (GB)

La stored procedure sp_copysubscription è supportata solo per i database con sottoscrizioni client e non può essere eseguita quando il database ha sottoscrizioni server.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_copysubscription.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)

Altre risorse

Posizioni alternative della cartella snapshot

Guida in linea e informazioni

Assistenza su SQL Server 2005