sp_copysubscription (Transact-SQL)sp_copysubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Important

La fonctionnalité concernant les abonnements pouvant être attachés est déconseillée et sera retirée dans une version ultérieure.The attachable subscriptions feature is deprecated and will be removed in a future release. Elle ne doit pas être utilisée dans tout nouveau travail de développement.This feature should not be used in new development work. Dans le cas des publications de fusion partitionnées par le biais de filtres paramétrés, nous vous recommandons d'utiliser plutôt les nouvelles fonctionnalités d'instantanés partitionnés qui simplifient l'initialisation de larges volumes d'abonnements.For merge publications that are partitioned using parameterized filters, we recommend using the new features of partitioned snapshots, which simplify the initialization of a large number of subscriptions. Pour plus d'informations, voir Snapshots for Merge Publications with Parameterized Filters.For more information, see Snapshots for Merge Publications with Parameterized Filters. Dans le cas de publications qui ne sont pas partitionnées, vous pouvez initialiser un abonnement par le biais d'une sauvegarde.For publications that are not partitioned, you can initialize a subscription with a backup. Pour plus d’informations, consultez Initialiser un abonnement transactionnel sans instantané.For more information, see Initialize a Transactional Subscription Without a Snapshot.

Copie une base de données d'abonnement contenant des abonnements par extraction de données (pull) mais pas d'abonnements par envoi de données (push).Copies a subscription database that has pull subscriptions, but no push subscriptions. Seules les bases de données monofichier peuvent être copiées.Only single file databases can be copied. Cette procédure stockée est exécutée sur la base de données d'abonnement de l'Abonné.This stored procedure is executed at the Subscriber on the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @filename = ] 'file_name' est la chaîne qui spécifie le chemin d’accès complet, y compris le nom de fichier, vers lequel une copie du fichier de données (. mdf) est enregistrée.[ @filename = ] 'file_name' Is the string that specifies the complete path, including file name, to which a copy of the data file (.mdf) is saved. le nom de fichier est de type nvarchar (260) , sans valeur par défaut.file name is nvarchar(260), with no default.

[ @temp_dir = ] 'temp_dir' est le nom du répertoire qui contient les fichiers temporaires.[ @temp_dir = ] 'temp_dir' Is the name of the directory that contains the temp files. temp_dir est de type nvarchar (260) , avec NULL comme valeur par défaut.temp_dir is nvarchar(260), with a default of NULL. Si la valeur est NULL, le répertoire de données par défaut MicrosoftMicrosoft SQL ServerSQL Server sera utilisé.If NULL, the MicrosoftMicrosoft SQL ServerSQL Server default data directory will be used. Le répertoire doit contenir suffisamment d'espace pour stocker un fichier d'une taille équivalente à celle de tous les fichiers de bases de données d'abonnés réunis.The directory should have enough space to hold a file the size of all the subscriber database files combined.

[ @overwrite_existing_file = ] 'overwrite_existing_file' est un indicateur booléen facultatif qui spécifie s’il faut ou non remplacer un fichier existant portant le même nom que celui spécifié dans @filename.[ @overwrite_existing_file = ] 'overwrite_existing_file' Is an optional Boolean flag that specifies whether or not to overwrite an existing file of the same name specified in @filename. overwrite_existing_fileest de valeur de bit, avec 0comme valeur par défaut.overwrite_existing_fileis bit, with a default of 0. Si la 1est définie, elle remplace le fichier spécifié par @filename, s’il existe.If 1, it overwrites the file specified by @filename, if it exists. Si la valeur est 0, la procédure stockée échoue si le fichier existe et si le fichier n’est pas remplacé.If 0, the stored procedure fails if the file exists, and the file is not overwritten.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_copysubscription est utilisé dans tous les types de réplication pour copier une base de données d’abonnement dans un fichier comme alternative à l’application d’un instantané sur l’abonné.sp_copysubscription is used in all types of replication to copy a subscription database to a file as an alternative to applying a snapshot at the Subscriber. La base de données doit être configurée pour prendre uniquement en charge les abonnements par extraction de données (pull).The database must be configured to support only pull subscriptions. Les utilisateurs détenant les autorisations appropriées peuvent réaliser des copies de la base de données d'abonnement, puis copier ou transporter le fichier d'abonnement (.msf) vers un autre Abonné, ou le lui transmettre par courrier électronique en vue de son attachement en tant qu'abonnement.Users having appropriate permissions can make copies of the subscription database and then e-mail, copy, or transport the subscription file (.msf) to another Subscriber, where it can then be attached as a subscription.

La taille de la base de données d'abonnement copiée doit être inférieure à 2 gigaoctets (Go).The size of the subscription database being copied must be less than 2 gigabytes (GB).

sp_copysubscription est uniquement pris en charge pour les bases de données avec des abonnements client et ne peut pas être exécuté lorsque la base de données a des abonnements serveur.sp_copysubscription is only supported for databases with client subscriptions and cannot be executed when the database has server subscriptions.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_copysubscription.Only members of the sysadmin fixed server role can execute sp_copysubscription.

Voir aussiSee Also

Autres emplacements du dossier d’instantanés Alternate Snapshot Folder Locations
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)