ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure simAzure Synapse Analytics (SQL DW) simParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Altera as propriedades de uma credencial no escopo do banco de dados.Changes the properties of a database scoped credential.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

credential_namecredential_name
Especifica o nome da credencial no escopo do banco de dados que está sendo alterada.Specifies the name of the database scoped credential that is being altered.

IDENTITY ='identity_name'IDENTITY ='identity_name'
Especifica o nome da conta a ser usada ao conectar o servidor externamente.Specifies the name of the account to be used when connecting outside the server. Para importar um arquivo do armazenamento de Blobs do Azure, o nome de identidade deve ser SHARED ACCESS SIGNATURE.To import a file from Azure Blob storage, the identity name must be SHARED ACCESS SIGNATURE. Para mais informações sobre assinaturas de acesso compartilhado, consulte Usando SAS (Assinatura de Acesso Compartilhado).For more information about shared access signatures, see Using Shared Access Signatures (SAS).

SECRET ='secret'SECRET ='secret'
Especifica o segredo necessário para a autenticação de saída.Specifies the secret required for outgoing authentication. secret é necessário para importar um arquivo de armazenamento de Blobs do Azure.secret is required to import a file from Azure Blob storage. secret pode ser opcional para outros fins.secret may be optional for other purposes.

Aviso

O valor da chave SAS pode começar com um '?' (ponto de interrogação).The SAS key value might begin with a '?' (question mark). Quando você usa a chave SAS, deve remover o '?' à esquerda.When you use the SAS key, you must remove the leading '?'. Caso contrário, seus esforços poderão ser bloqueados.Otherwise your efforts might be blocked.

RemarksRemarks

Quando uma credencial no escopo do banco de dados é alterada, os valores identity_name e secret são redefinidos.When a database scoped credential is changed, the values of both identity_name and secret are reset. Se o argumento SECRET opcional não for especificado, o valor do segredo armazenado será definido como NULL.If the optional SECRET argument is not specified, the value of the stored secret will be set to NULL.

O segredo é criptografado com a chave mestra de serviço.The secret is encrypted by using the service master key. Se a chave mestra de serviço for gerada novamente, o segredo será criptografado usando a nova chave mestra de serviço.If the service master key is regenerated, the secret is reencrypted by using the new service master key.

Informações sobre credenciais no escopo do banco de dados ficam visíveis na exibição do catálogo database_scoped_credentials.Information about database scoped credentials is visible in the sys.database_scoped_credentials catalog view.

PermissõesPermissions

Requer a permissão ALTER na credencial.Requires ALTER permission on the credential.

ExemplosExamples

A.A. Alterando a senha de uma credencial no escopo do banco de dadosChanging the password of a database scoped credential

O exemplo a seguir altera o segredo armazenado em uma credencial no escopo do banco de dados chamada Saddles.The following example changes the secret stored in a database scoped credential called Saddles. A credencial no escopo do banco de dados contém o logon do Windows RettigB e sua senha.The database scoped credential contains the Windows login RettigB and its password. A nova senha é adicionada à credencial no escopo do banco de dados que usa a cláusula SECRET.The new password is added to the database scoped credential using the SECRET clause.

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

B.B. Removendo a senha de uma credencialRemoving the password from a credential

O exemplo a seguir remove a senha de uma credencial no escopo do banco de dados chamada Frames.The following example removes the password from a database scoped credential named Frames. A credencial no escopo do banco de dados contém o logon do Windows Aboulrus8 e uma senha.The database scoped credential contains Windows login Aboulrus8 and a password. Depois que a instrução for executada, a credencial no escopo do banco de dados terá uma senha NULL porque a opção SECRET não é especificada.After the statement is executed, the database scoped credential will have a NULL password because the SECRET option is not specified.

ALTER DATABASE SCOPED CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO  

Consulte TambémSee Also

Credenciais (Mecanismo de Banco de Dados) Credentials (Database Engine)
CREATE DATABASE SCOPED CREDENTIAL (Transact-SQL) CREATE DATABASE SCOPED CREDENTIAL (Transact-SQL)
DROP DATABASE SCOPED CREDENTIAL (Transact-SQL) DROP DATABASE SCOPED CREDENTIAL (Transact-SQL)
sys.database_scoped_credentials sys.database_scoped_credentials
CREATE CREDENTIAL (Transact-SQL) CREATE CREDENTIAL (Transact-SQL)
sys.credentials (Transact-SQL)sys.credentials (Transact-SQL)