Bagikan melalui


sp_addrole (T-SQL)

Berlaku untuk:SQL Server

Membuat peran database baru dalam database saat ini.

Penting

sp_addrole disertakan untuk kompatibilitas dengan versi SQL Server yang lebih lama dan mungkin tidak didukung dalam rilis mendatang. Gunakan CREATE ROLE sebagai gantinya.

Konvensi sintaks transact-SQL

Sintaks

sp_addrole
    [ @rolename = ] N'rolename'
    [ , [ @ownername = ] N'ownername' ]
[ ; ]

Argumen

[ @rolename = ] N'rolename'

Nama peran database baru. @rolename adalah sysname, tanpa default. @rolename harus berupa pengidentifikasi yang valid dan belum boleh ada di database saat ini.

[ @ownername = ] N'ownername'

Pemilik peran database baru. @ownername adalah sysname, dengan default pengguna yang menjalankan saat ini. @ownername harus menjadi peran pengguna atau database database dalam database saat ini.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Nama peran database SQL Server dapat berisi dari 1 hingga 128 karakter, termasuk huruf, simbol, dan angka. Nama peran database tidak boleh berisi karakter garis miring terbalik (\), menjadi NULL, atau string kosong ('').

Setelah Anda menambahkan peran database, gunakan sp_addrolemember (Transact-SQL) untuk menambahkan prinsipal ke peran tersebut. Ketika GRANTpernyataan , DENY, atau REVOKE digunakan untuk menerapkan izin ke peran database, anggota peran database mewarisi izin tersebut seolah-olah izin diterapkan langsung ke akun mereka.

Catatan

Peran server baru tidak dapat dibuat. Peran hanya dapat dibuat di tingkat database.

sp_addrole tidak dapat digunakan di dalam transaksi yang ditentukan pengguna.

Izin

CREATE ROLE Memerlukan izin pada database. Jika membuat skema, diperlukan CREATE SCHEMA pada database. Jika @ownername ditentukan sebagai pengguna atau grup, diperlukan IMPERSONATE pada pengguna atau grup tersebut. Jika @ownername ditentukan sebagai peran, memerlukan ALTER izin pada peran tersebut atau pada anggota peran tersebut. Jika pemilik ditentukan sebagai peran aplikasi, memerlukan ALTER izin pada peran aplikasi tersebut.

Contoh

Contoh berikut menambahkan peran baru yang dipanggil Managers ke database saat ini.

EXEC sp_addrole 'Managers';