ALTER CREDENTIAL (Transact-SQL)ALTER CREDENTIAL (Transact-SQL)

SI APPLICA A: sìSQL Server sìDatabase SQL di Azure (solo Istanza gestita) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Modifica le proprietà di una credenziale.Changes the properties of a credential.

Importante

Info "consigliabile" come procedura consigliata; "da fare" per completare l'attività Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL"Should do" info as best practice; "must do" to complete task Topic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

credential_namecredential_name
Specifica il nome della credenziale che si desidera modificare.Specifies the name of the credential that is being altered.

IDENTITY ='identity_name'IDENTITY ='identity_name'
Specifica il nome dell'account da utilizzare per la connessione all'esterno del server.Specifies the name of the account to be used when connecting outside the server.

SECRET ='secret'SECRET ='secret'
Specifica il segreto richiesto per l'autenticazione in uscita.Specifies the secret required for outgoing authentication. secret è facoltativo.secret is optional.

Importante

Database SQL di Azure supporta solo le identità Azure Key Vault e di firma di accesso condiviso.Azure SQL Database only supports Azure Key Vault and Shared Access Signature identities. Le identità utente di Windows non sono supportate.Windows user identities are not supported.

OsservazioniRemarks

Quando si modifica una credenziale, i valori di identity_name e secret vengono reimpostati.When a credential is changed, the values of both identity_name and secret are reset. Se l'argomento facoltativo SECRET viene omesso, il valore del segreto archiviato verrà impostato su NULL.If the optional SECRET argument is not specified, the value of the stored secret will be set to NULL.

Il segreto viene crittografato tramite la chiave master del servizio.The secret is encrypted by using the service master key. Se la chiave master del servizio viene rigenerata, il segreto verrà crittografato nuovamente tramite la nuova chiave master del servizio.If the service master key is regenerated, the secret is reencrypted by using the new service master key.

Le informazioni sulle credenziali sono visibili nella vista del catalogo sys.credentials.Information about credentials is visible in the sys.credentials catalog view.

AutorizzazioniPermissions

È richiesta l'autorizzazione ALTER ANY CREDENTIAL.Requires ALTER ANY CREDENTIAL permission. Se la credenziale è una credenziale di sistema, è richiesta l'autorizzazione CONTROL SERVER.If the credential is a system credential, requires CONTROL SERVER permission.

EsempiExamples

R.A. Modifica della password di una credenzialeChanging the password of a credential

Nell'esempio seguente viene modificato il segreto archiviato nella credenziale denominata Saddles.The following example changes the secret stored in a credential called Saddles. La credenziale include l'account di accesso di Windows RettigB e la relativa password.The credential contains the Windows login RettigB and its password. La nuova password viene aggiunta alla credenziale tramite la clausola SECRET.The new password is added to the credential using the SECRET clause.

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

B.B. Rimozione della password da una credenzialeRemoving the password from a credential

Nell'esempio seguente la password viene rimossa da una credenziale denominata Frames.The following example removes the password from a credential named Frames. La credenziale include l'account di accesso di Windows Aboulrus8 e una password.The credential contains Windows login Aboulrus8 and a password. Dopo l'esecuzione dell'istruzione, la credenziale includerà una password NULL perché l'opzione SECRET è stata omessa.After the statement is executed, the credential will have a NULL password because the SECRET option is not specified.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO  

Vedere ancheSee Also

Credenziali (motore di database) Credentials (Database Engine)
CREATE CREDENTIAL (Transact-SQL) CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL) DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL) ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL) CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)sys.credentials (Transact-SQL)