sp_copysubscription (T-SQL)

Berlaku untuk: SQL Server Azure SQL Managed Instance

Penting

Fitur langganan yang dapat dilampirkan tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Fitur ini tidak boleh digunakan dalam pekerjaan pengembangan baru. Untuk publikasi gabungan yang dipartisi menggunakan filter berparameter, sebaiknya gunakan fitur baru rekam jepret yang dipartisi, yang menyederhanakan inisialisasi sejumlah besar langganan. Untuk informasi selengkapnya, lihat Rekam Jepret untuk Gabungkan Publikasi dengan Filter Berparameter. Untuk publikasi yang tidak dipartisi, Anda dapat menginisialisasi langganan dengan cadangan. Untuk informasi selengkapnya, lihat Menginisialisasi Langganan Transaksi tanpa Rekam Jepret.

Menyalin database langganan yang memiliki langganan penarikan, tetapi tidak ada langganan push. Hanya database file tunggal yang dapat disalin. Prosedur tersimpan ini dijalankan di Pelanggan pada database langganan.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @filename = ] 'file_name' Apakah string yang menentukan jalur lengkap, termasuk nama file, tempat salinan file data (.mdf) disimpan. nama file adalah nvarchar(260), tanpa default.

[ @temp_dir = ] 'temp_dir' Adalah nama direktori yang berisi file sementara. temp_dir adalah nvarchar(260), dengan default NULL. Jika NULL, direktori data default Microsoft SQL Server akan digunakan. Direktori harus memiliki cukup ruang untuk menyimpan file dengan ukuran semua file database pelanggan yang digabungkan.

[ @overwrite_existing_file = ] 'overwrite_existing_file' Adalah bendera Boolean opsional yang menentukan apakah akan menimpa file yang ada dengan nama yang sama yang ditentukan dalam @filename atau tidak. overwrite_existing_file adalah bit, dengan default 0. Jika 1, file akan menimpa file yang ditentukan oleh @filename, jika ada. Jika 0, prosedur tersimpan gagal jika file ada, dan file tidak ditimpa.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_copysubscription digunakan di semua jenis replikasi untuk menyalin database langganan ke file sebagai alternatif untuk menerapkan rekam jepret di Pelanggan. Database harus dikonfigurasi untuk hanya mendukung langganan penarikan. Pengguna yang memiliki izin yang sesuai dapat membuat salinan database langganan lalu mengirim email, menyalin, atau mengangkut file langganan (.msf) ke Pelanggan lain, di mana kemudian dapat dilampirkan sebagai langganan.

Ukuran database langganan yang sedang disalin harus kurang dari 2 gigabyte (GB).

sp_copysubscription hanya didukung untuk database dengan langganan klien dan tidak dapat dijalankan saat database memiliki langganan server.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_copysubscription.

Lihat Juga

Lokasi Folder Rekam Jepret Alternatif
Prosedur Tersimpan Sistem (Transact-SQL)