ALTER CREDENTIAL (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Altera as propriedades de uma credencial.

Importante

"Recomendável": informações como melhor prática; "obrigatório" para concluir a tarefa Convenções da 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 a autenticação de saída. secret é opcional.

Importante

O Banco de dados SQL do Azure é compatível apenas as identidades do Azure Key Vault e com Assinatura de Acesso Compartilhado. Não há suporte para identidades de usuário do Windows.

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 são visí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

Consulte Também

Credenciais (Mecanismo de Banco de Dados)
CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)