Bagikan melalui

sp_copysubscription (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

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

Penting

Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. 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 Membuat Rekam Jepret untuk Publikasi Gabungan dengan Filter Berparameter. Untuk publikasi yang tidak dipartisi, Anda dapat menginisialisasi langganan dengan cadangan. Untuk informasi selengkapnya, lihat Menginisialisasi Langganan Transaksi tanpa Rekam Jepret.

Konvensi sintaks transact-SQL

Sintaks

sp_copysubscription
    [ @filename = ] N'filename'
    [ , [ @temp_dir = ] N'temp_dir' ]
    [ , [ @overwrite_existing_file = ] overwrite_existing_file ]
[ ; ]

Argumen

[ @filename = ] N'filename'

String yang menentukan jalur lengkap, termasuk nama file, tempat salinan file data (.mdf) disimpan. @filename adalah nvarchar(260), tanpa default.

[ @temp_dir = ] N'temp_dir'

Nama direktori yang berisi file sementara. @temp_dir adalah nvarchar(260), dengan default NULL. Jika NULL, direktori data default SQL Server digunakan. Direktori harus memiliki cukup ruang untuk menyimpan file dengan ukuran semua file database pelanggan yang digabungkan.

[ @overwrite_existing_file = ] overwrite_existing_file

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 dalam 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 memindahkan 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.

Konten terkait