Bagikan melalui


MENGUBAH PERAN APLIKASI (Transact-SQL)

Berlaku untuk: SQL ServerAzure SQL Database Azure SQL Managed Instance

Mengubah nama, kata sandi, atau skema default peran aplikasi.

Konvensi sintaks transact-SQL

Sintaksis

  
ALTER APPLICATION ROLE application_role_name
    WITH <set_item> [ ,...n ]  
  
<set_item> ::=
    NAME = new_application_role_name
    | PASSWORD = 'password'  
    | DEFAULT_SCHEMA = schema_name  

Catatan

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

Argumen

application_role_name
Adalah nama peran aplikasi yang akan dimodifikasi.

NAME =new_application_role_name
Menentukan nama baru peran aplikasi. Nama ini belum boleh digunakan untuk merujuk ke prinsipal apa pun dalam database.

PASSWORD ='password'
Menentukan kata sandi untuk peran aplikasi. kata sandi harus memenuhi persyaratan kebijakan kata sandi Windows komputer yang menjalankan instans SQL Server. Anda harus selalu menggunakan kata sandi yang kuat.

DEFAULT_SCHEMA =schema_name
Menentukan skema pertama yang akan dicari oleh server ketika menyelesaikan nama objek. schema_name bisa menjadi skema yang tidak ada dalam database.

Keterangan

Jika nama peran aplikasi baru sudah ada dalam database, pernyataan akan gagal. Ketika nama, kata sandi, atau skema default peran aplikasi diubah, ID yang terkait dengan peran tidak diubah.

Penting

Kebijakan kedaluwarsa kata sandi tidak diterapkan pada kata sandi peran aplikasi. Untuk alasan ini, berhati-hatilah dalam memilih kata sandi yang kuat. Aplikasi yang memanggil peran aplikasi harus menyimpan kata sandinya.

Peran aplikasi terlihat dalam tampilan katalog sys.database_principals.

Perhatian

Di SQL Server 2005 (9.x)perilaku skema berubah dari perilaku di versi SQL Server sebelumnya. Kode yang mengasumsikan bahwa skema setara dengan pengguna database mungkin tidak 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 di mana salah satu pernyataan ini pernah digunakan, Anda harus menggunakan tampilan katalog baru. Tampilan katalog baru memperhitungkan pemisahan prinsipal dan skema yang diperkenalkan di SQL Server 2005 (9.x). Untuk informasi selengkapnya tentang tampilan katalog, lihat Tampilan Katalog (Transact-SQL).

Izin

Memerlukan izin UBAH PERAN APLIKASI APA PUN pada database. Untuk mengubah skema default, pengguna juga memerlukan izin ALTER pada peran aplikasi. Peran aplikasi dapat mengubah skema defaultnya sendiri, tetapi bukan nama atau kata sandinya.

Contoh

J. Mengubah nama peran aplikasi

Contoh berikut mengubah nama peran weekly_receipts aplikasi menjadi receipts_ledger.

USE AdventureWorks2022;  
CREATE APPLICATION ROLE weekly_receipts   
    WITH PASSWORD = '987Gbv8$76sPYY5m23' ,   
    DEFAULT_SCHEMA = Sales;  
GO  
ALTER APPLICATION ROLE weekly_receipts   
    WITH NAME = receipts_ledger;  
GO  

B. Mengubah kata sandi peran aplikasi

Contoh berikut mengubah kata sandi peran receipts_ledgeraplikasi .

ALTER APPLICATION ROLE receipts_ledger   
    WITH PASSWORD = '897yUUbv867y$200nk2i';  
GO  

C. Mengubah nama, kata sandi, dan skema default

Contoh berikut mengubah nama, kata sandi, dan skema default peran receipts_ledger aplikasi secara bersamaan.

ALTER APPLICATION ROLE receipts_ledger   
    WITH NAME = weekly_ledger,   
    PASSWORD = '897yUUbv77bsrEE00nk2i',   
    DEFAULT_SCHEMA = Production;  
GO  

Lihat Juga

Peran Aplikasi
MEMBUAT PERAN APLIKASI (Transact-SQL)
DROP APPLICATION ROLE (Transact-SQL)
EVENTDATA (Transact-SQL)