ALTER CREDENTIAL (Transact-SQL)

Artikel
10/16/2024

Gilt für: SQL Server Azure SQL Managed Instance

Ändert die Eigenschaften von Anmeldeinformationen.

Wichtig

Informationen mit „Sollte“ stehen für Best Practices, Informationen mit „Muss“ sind zum Abschließen eines Tasks erforderlich. Transact-SQL-Syntaxkonventionen.

Syntax

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

Argumente

credential_name
Gibt den Namen der Anmeldeinformationen an, die geändert werden.

IDENTITY = 'identity_name'
Gibt den Namen des Kontos an, das beim Herstellen einer Verbindung außerhalb des Servers verwendet wird.

SECRET ='secret'
Gibt den geheimen Bereich an, der für die ausgehende Authentifizierung erforderlich ist. secret ist optional.

Wichtig

Azure SQL-Datenbank unterstützt nur Azure Key Vault- und Shared Access Signature-Identitäten. Windows-Benutzeridentitäten werden nicht unterstützt.

Hinweise

Wenn Anmeldeinformationen geändert werden, werden die Werte von identity_name und secret zurückgesetzt. Falls das optionale SECRET-Argument nicht angegeben wird, wird der Wert des gespeicherten Kennworts auf NULL festgelegt.

Das Kennwort wird mithilfe des Diensthauptschlüssels verschlüsselt. Falls der Diensthauptschlüssel erneut generiert wird, wird das Kennwort erneut mithilfe des neuen Diensthauptschlüssels verschlüsselt.

Informationen zu Anmeldeinformationen werden in der sys.credentials-Katalogsicht angezeigt.

Berechtigungen

Erfordert die ALTER ANY CREDENTIAL-Berechtigung. Falls es sich bei dem Anmeldeinformationen um Systemanmeldeinformationen handelt, ist die CONTROL SERVER-Berechtigung erforderlich.

Beispiele

A. Ändern des Kennworts für Anmeldeinformationen

Im folgenden Beispiel wird das Kennwort, das in den Anmeldeinformationen namens Saddles gespeichert ist, geändert. Diese Anmeldeinformationen enthalten den Windows-Anmeldenamen RettigB und das zugehörige Kennwort. Das neue Kennwort wird den Anmeldeinformationen mithilfe der SECRET-Klausel hinzugefügt.

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

B. Entfernen des Kennworts aus Anmeldeinformationen

Im folgenden Beispiel wird das Kennwort aus Anmeldeinformationen namens Frames entfernt. Diese Anmeldeinformationen enthalten den Windows-Anmeldenamen Aboulrus8 und ein Kennwort. Nach der Ausführung der Anweisung weisen die Anmeldeinformationen ein NULL-Kennwort auf, weil die Option SECRET nicht angegeben ist.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO

Weitere Informationen

Anmeldeinformationen (Datenbank-Engine)
CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)

Freigeben über