Partilhar via


ALTER CREDENTIAL (Transact-SQL)

Altera as propriedades de uma credencial.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

ALTER CREDENTIAL credential_name WITH IDENTITY = 'identity_name'
    [ , SECRET = 'secret' ]

Argumentos

  • credential_name
    Especifica o nome da credencial que está sendo alterada.

  • IDENTITY ='identity_name'
    Especifica o nome da conta a ser usada ao conectar o servidor externamente.

  • SECRET ='secret'
    Especifica o segredo necessário para autenticação de saída. secret é opcional.

Comentários

Quando uma credencial é alterada, os valores de identity_name e secret são redefinidos. Se o argumento SECRET opcional não for especificado, o valor do segredo armazenado será definido como NULL.

O segredo é criptografado com a chave mestra de serviço. Se a chave mestra de serviço for gerada novamente, o segredo será criptografado usando a nova chave mestra de serviço.

As informações sobre as credenciais estão disponíveis na exibição do catálogo sys.credentials.

Permissões

Requer a permissão ALTER ANY CREDENTIAL. Se a credencial for uma credencial do sistema, será necessária a permissão CONTROL SERVER.

Exemplos

A. Alterando a senha de uma credencial

O exemplo a seguir altera o segredo armazenado em uma credencial chamada Saddles. A credencial contém o logon do Windows RettigB e sua senha. A nova senha é adicionada à credencial que usa a cláusula SECRET.

ALTER CREDENTIAL Saddles WITH IDENTITY = 'RettigB', 
    SECRET = 'sdrlk8$40-dksli87nNN8';
GO

B. Removendo a senha de uma credencial

O exemplo a seguir remove a senha de uma credencial chamada Frames. A credencial contém o logon do Windows Aboulrus8 e uma senha. Depois que a instrução for executada, a credencial terá uma senha NULL porque a opção SECRET não é especificada.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';
GO