ALTER APPLICATION ROLE (Transact-SQL)

發行項
05/04/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體

變更應用程式角色的名稱、密碼或預設結構描述。

Syntax

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

注意

若要檢視 SQL Server 2014 （12.x）和舊版的 Transact-SQL 語法，請參閱舊版檔。

引數

application_role_name
這是要修改的應用程式角色名稱。

NAME =new_application_role_name
指定應用程式角色的新名稱。這個名稱必須尚未用來參考資料庫中的任何主體。

PASSWORD ='password'
指定應用程式角色的密碼。 password 必須符合執行 SQL Server 執行個體的電腦的 Windows 密碼原則需求。您一定要使用增強式密碼。

DEFAULT_SCHEMA =schema_name
指定當伺服器解析物件名稱時，將搜尋的第一個結構描述。 schema_name 可以是資料庫中不存在的結構描述。

備註

如果資料庫中已存在新的應用程式角色名稱，則這個陳述式會失敗。變更應用程式角色的名稱、密碼或預設結構描述時，與角色相關聯的識別碼不變。

重要

密碼到期原則不適用於應用程式角色密碼。因此，在選取增強式密碼時請特別小心。叫用應用程式角色的應用程式必須儲存其密碼。

您可以在 sys.database_principals 目錄檢視中，看到應用程式角色。

警告

在 SQL Server 2005 (9.x) 中，結構描述的行為已經與舊版 SQL Server 中的行為不同。假設結構描述相當於資料庫使用者的程式碼可能不會傳回正確的結果。不應該在曾經使用下列任何一個 DDL 陳述式的資料庫中使用舊的目錄檢視 (包括 sysobjects)：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。在曾經使用這些陳述式的任何一個資料庫中，您必須使用新的目錄檢視。新的目錄檢視會考量 SQL Server 2005 (9.x) 中所推出的主體和結構描述分隔。如需目錄檢視的詳細資訊，請參閱目錄檢視 (Transact-SQL)。

權限

需要資料庫的 ALTER ANY APPLICATION ROLE 權限。若要變更預設的結構描述，使用者還需要在應用程式角色上具有 ALTER 權限。應用程式角色可改變它自己的預設結構描述，但不能變更它的名稱或密碼。

範例

A. 變更應用程式角色的名稱

下列範例會將應用程式角色的名稱 weekly_receipts 變更為 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. 變更應用程式角色的密碼

下列範例會變更應用程式角色 receipts_ledger 的密碼。

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

C. 變更名稱、密碼和預設結構描述

下列範例會同時變更應用程式角色 receipts_ledger 的名稱、密碼和預設結構描述。

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

另請參閱

應用程式角色
 CREATE APPLICATION ROLE (Transact-SQL)
DROP APPLICATION ROLE (Transact-SQL)
EVENTDATA (Transact-SQL)