DROP ROLE (Transact-SQL)

Artikel
08/11/2023

Berlaku untuk:SQL Server Azure SQL Managed InstanceAzure Synapse Analytics Analytics Platform System (PDW)

Menghapus peran dari database.

Sintaksis

-- Syntax for SQL Server  
  
DROP ROLE [ IF EXISTS ] role_name

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse  

DROP ROLE role_name

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

JIKA ADA
Berlaku untuk: SQL Server (SQL Server 2016 (13.x) melalui versi saat ini).

Secara kondisional menghilangkan peran hanya jika sudah ada.

role_name
Menentukan peran yang akan dihilangkan dari database.

Keterangan

Peran yang memiliki keamanan tidak dapat dihilangkan dari database. Untuk menghilangkan peran database yang memiliki jaminan, Anda harus terlebih dahulu mentransfer kepemilikan atas barang-barang yang diamankan tersebut atau menghilangkannya dari database. Peran yang memiliki anggota tidak dapat dihilangkan dari database. Untuk menghilangkan peran yang memiliki anggota, Anda harus terlebih dahulu menghapus anggota peran.

Untuk menghapus anggota dari peran database, gunakan ALTER ROLE (Transact-SQL).

Anda tidak dapat menggunakan DROP ROLE untuk menghilangkan peran database tetap.

Informasi tentang keanggotaan peran dapat dilihat dalam tampilan katalog sys.database_role_members.

Perhatian

Dimulai dengan SQL Server 2005, perilaku skema berubah. Akibatnya, kode yang mengasumsikan bahwa skema setara dengan pengguna database mungkin tidak lagi mengembalikan hasil yang benar. Tampilan katalog lama, termasuk sysobjects, tidak boleh digunakan dalam database di mana salah satu pernyataan DDL berikut pernah digunakan: CREATE SCHEMA, ALTER SCHEMA, DROP SCHEMA, CREATE USER, ALTER USER, DROP USER, CREATE ROLE, ALTER ROLE, DROP ROLE, CREATE APPROLE, ALTER APPROLE, DROP APPROLE, ALTER AUTHORIZATION. Dalam database tersebut, Anda harus menggunakan tampilan katalog baru. Tampilan katalog baru memperhitungkan pemisahan prinsipal dan skema yang diperkenalkan di SQL Server 2005. Untuk informasi selengkapnya tentang tampilan katalog, lihat Tampilan Katalog (Transact-SQL).

Untuk menghapus peran server, gunakan DROP SERVER ROLE (Transact-SQL).

Izin

Memerlukan izin UBAH PERAN APA PUN pada database, atau izin CONTROL pada peran, atau keanggotaan dalam db_securityadmin.

Contoh

Contoh berikut menghilangkan peran purchasing database dari AdventureWorks2022 database.

DROP ROLE purchasing;  
GO

Lihat Juga

BUAT PERAN (Transact-SQL)
UBAH PERAN (Transact-SQL)
Prinsipal (Mesin Database)
EVENTDATA (Transact-SQL)
sp_addrolemember (T-SQL)
sys.database_role_members (T-SQL)
sys.database_principals (T-SQL)
Fungsi Keamanan (T-SQL)