Bagikan melalui


sp_addumpdevice (T-SQL)

Berlaku untuk: SQL Server

Menambahkan perangkat cadangan ke instans SQL Server.

Konvensi sintaks transact-SQL

Sintaks

sp_addumpdevice
    [ @devtype = ] 'devtype'
    , [ @logicalname = ] N'logicalname'
    , [ @physicalname = ] N'physicalname'
    [ , [ @cntrltype = ] cntrltype ]
    [ , [ @devstatus = ] 'devstatus' ]
[ ; ]

Argumen

[ @devtype = ] 'devtype'

Jenis perangkat cadangan. @devtype adalah varchar(20), tanpa default, dan bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
disk File hard disk sebagai perangkat cadangan.
tape Perangkat pita apa pun yang didukung oleh Microsoft Windows.

Catatan: Dukungan untuk perangkat cadangan pita akan dihapus di 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.

[ @logicalname = ] N'logicalname'

Nama logis perangkat cadangan yang digunakan dalam pernyataan BACKUP dan RESTORE. @logicalname adalah sysname, tanpa default, dan tidak boleh NULL.

[ @physicalname = ] N'physicalname'

Nama fisik perangkat cadangan. @physicalname adalah nvarchar(260), tanpa default, dan tidak boleh NULL. Nama fisik harus mengikuti aturan untuk nama file sistem operasi, atau konvensi penamaan universal untuk perangkat jaringan, dan harus menyertakan jalur lengkap.

Saat membuat perangkat cadangan di lokasi jaringan jarak jauh, pastikan bahwa nama tempat Mesin Database dimulai memiliki kemampuan tulis yang sesuai di komputer jarak jauh.

Jika Anda menambahkan perangkat pita, parameter ini harus berupa nama fisik yang ditetapkan ke perangkat pita lokal oleh Windows; misalnya, \\.\TAPE0 untuk perangkat pita pertama di komputer. Perangkat pita harus dilampirkan ke komputer server; tidak dapat digunakan dari jarak jauh. Sertakan nama yang berisi karakter nonalphanumeric dalam tanda kutip.

Catatan

Prosedur ini memasukkan nama fisik yang ditentukan ke dalam katalog. Prosedur ini tidak mencoba mengakses atau membuat perangkat.

[ @cntrltype = ] cntrltype

Kedaluwarsa. Jika ditentukan, parameter ini diabaikan. Didukung untuk kompatibilitas mundur. sp_addumpdevice Penggunaan baru harus menghilangkan parameter ini.

[ @devstatus = ] 'devstatus'

Kedaluwarsa. Jika ditentukan, parameter ini diabaikan. Didukung untuk kompatibilitas mundur. sp_addumpdevice Penggunaan baru harus menghilangkan parameter ini.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

sp_addumpdevice menambahkan perangkat cadangan ke sys.backup_devices tampilan katalog. Perangkat kemudian dapat dirujuk ke masuk BACKUP dan RESTORE pernyataan secara logis. sp_addumpdevice tidak melakukan akses apa pun ke perangkat fisik. Akses ke perangkat yang ditentukan hanya terjadi ketika pernyataan BACKUP atau RESTORE dilakukan. Membuat perangkat cadangan logis dapat menyederhanakan BACKUP dan RESTORE pernyataan, di mana menentukan nama perangkat adalah alternatif menggunakan TAPE = klausa atau DISK = untuk menentukan jalur perangkat.

Masalah kepemilikan dan izin dapat mengganggu penggunaan disk atau perangkat cadangan file. Pastikan bahwa izin file yang sesuai diberikan ke akun Windows tempat Mesin Database dimulai.

Mesin Database mendukung pencadangan pita ke perangkat pita yang didukung oleh Windows. Untuk informasi selengkapnya tentang perangkat pita yang didukung Windows, lihat daftar kompatibilitas perangkat keras untuk Windows. Untuk melihat perangkat pita yang tersedia di komputer, gunakan SQL Server Management Studio.

Gunakan hanya kaset yang direkomendasikan untuk drive pita tertentu yang disarankan oleh produsen drive. Jika Anda menggunakan drive pita audio digital (DAT), gunakan pita DAT tingkat komputer (Digital Data Storage (DDS)).

sp_addumpdevice tidak dapat dijalankan di dalam transaksi.

Untuk menghapus perangkat, gunakan sp_dropdevice atau Hapus Perangkat Cadangan (SQL Server).

Izin

Memerlukan keanggotaan dalam peran server tetap diskadmin .

Memerlukan izin untuk menulis ke disk.

Contoh

J. Menambahkan perangkat cadangan disk

Contoh berikut menambahkan perangkat cadangan disk bernama mydiskdump, dengan nama C:\dump\dump1.bakfisik .

USE master;
GO
EXEC sp_addumpdevice 'disk', 'mydiskdump', 'C:\dump\dump1.bak';

B. Menambahkan perangkat cadangan disk jaringan

Contoh berikut menunjukkan penambahan perangkat cadangan disk jarak jauh yang disebut networkdevice. Nama tempat Mesin Database dimulai harus memiliki izin ke file jarak jauh tersebut (\\<servername>\<sharename>\<path>\<filename>.bak).

USE master;
GO
EXEC sp_addumpdevice 'disk', 'networkdevice',
    '\\<servername>\<sharename>\<path>\<filename>.bak';

C. Menambahkan perangkat cadangan pita

Contoh berikut menambahkan tapedump1 perangkat dengan nama \\.\tape0fisik .

USE master;
GO
EXEC sp_addumpdevice 'tape', 'tapedump1', '\\.\tape0';

D. Mencadangkan ke perangkat cadangan logis

Contoh berikut membuat perangkat cadangan logis, AdvWorksData, untuk file disk cadangan. Contoh kemudian mencadangkan AdventureWorks2022 database ke perangkat cadangan logis ini.

USE master;
GO
EXEC sp_addumpdevice
    'disk',
    'AdvWorksData',
    'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\BACKUP\AdvWorksData.bak';
GO
BACKUP DATABASE AdventureWorks2022
 TO AdvWorksData WITH FORMAT;
GO