Compartilhar via


sp_approlepassword (Transact-SQL)

Aplica-se: SQL Server

Altera a senha de uma função de aplicativo no banco de dados atual.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use ALTER APPLICATION ROLE .

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_approlepassword
    [ @rolename = ] N'rolename'
    , [ @newpwd = ] N'newpwd'
[ ; ]

Argumentos

@rolename [ = ] N'nome da função'

O nome da função do aplicativo. @rolename é sysname, sem padrão. @rolename deve existir no banco de dados atual.

@newpwd [ = ] N'newpwd'

A nova senha para a função de aplicativo. @newpwd é sysname, sem padrão. @newpwd não pode ser NULL.

Importante

Não use uma NULL senha. Use uma senha forte. Para saber mais, confira Strong Passwords.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_approlepassword não pode ser executado em uma transação definida pelo usuário.

Permissões

Requer a permissão ALTER ANY APPLICATION ROLE no banco de dados.

Exemplos

O exemplo a seguir define a senha para a função de aplicativo PayrollAppRole como B3r12-36.

EXEC sp_approlepassword 'PayrollAppRole', 'B3r12-36';