sp_droprole (T-SQL)

Berlaku untuk:SQL Server

Menghapus peran database dari database saat ini.

Penting

Di SQL Server 2005 (9.x), sp_droprole digantikan oleh pernyataan DROP ROLE. sp_droprole hanya disertakan untuk kompatibilitas dengan versi SQL Server yang lebih lama dan mungkin tidak didukung dalam rilis mendatang.

Konvensi sintaks transact-SQL

Sintaks

sp_droprole [ @rolename = ] N'rolename'
[ ; ]

Argumen

[ @rolename = ] N'rolename'

Nama peran database yang akan dihapus dari database saat ini. @rolename adalah sysname, tanpa default. @rolename harus sudah ada di database saat ini.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Hanya peran database yang dapat dihapus dengan menggunakan sp_droprole.

Peran database dengan anggota yang sudah ada tidak dapat dihapus. Semua anggota peran database harus dihapus sebelum peran database dapat dihapus. Untuk menghapus pengguna dari peran, gunakan sp_droprolemember. Jika ada pengguna yang masih menjadi anggota peran, sp_droprole menampilkan anggota tersebut.

Peran tetap dan peran publik tidak dapat dihapus.

Peran tidak dapat dihapus jika memiliki jaminan apa pun. Sebelum menghilangkan peran aplikasi yang memiliki securables, Anda harus terlebih dahulu mentransfer kepemilikan securables, atau menjatuhkannya. Gunakan ALTER AUTHORIZATION untuk mengubah pemilik objek yang tidak boleh dihapus.

sp_droprole tidak dapat dijalankan dalam transaksi yang ditentukan pengguna.

Izin

CONTROL Memerlukan izin pada peran.

Contoh

Contoh berikut menghapus peran Salesaplikasi .

EXEC sp_droprole 'Sales';
GO