Compartir a través de


ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Base de datos SQL de Microsoft Fabric

Cambia las propiedades de una credencial de ámbito de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

credential_name

Especifica el nombre de la credencial de ámbito de base de datos que se va a modificar.

IDENTITY = "identity_name"

Especifica el nombre de la cuenta que se utilizará para conectarse fuera del servidor. Para importar un archivo de Azure Blob Storage, el nombre de identidad debe ser SHARED ACCESS SIGNATURE. Para saber más sobre las firmas de acceso compartido, vea Uso de firmas de acceso compartido (SAS).

SECRET = 'secret'

Especifica el secreto necesario para la autenticación de salida. secret es necesario para importar un archivo de Azure Blob Storage. el secreto puede ser opcional para otros fines.

Advertencia

El valor de clave SAS puede comenzar con un ? (signo de interrogación). Al usar la clave SAS, debe quitar el inicial ?. Si no lo hace, puede que se bloquee su trabajo.

Observaciones

Cuando se cambia una credencial de ámbito de base de datos, se restablecen los valores de identity_name y secret. Si no se especifica el argumento SECRET opcional, el valor del secreto almacenado se establecerá NULLen .

El secreto está cifrado mediante la clave maestra de servicio. Si se vuelve a generar la clave maestra de servicio, el secreto se vuelve a cifrar utilizando la nueva clave maestra de servicio.

Encontrará información sobre las credenciales de ámbito de base de datos en la vista de catálogo sys.database_scoped_credentials.

Al conceder permisos para las firmas de acceso compartido (SAS) para su uso con una tabla externa de PolyBase, seleccione Container y Object como tipos de recursos permitidos. Si no se concede, es posible que reciba el error 16535 o 16561 al intentar acceder a la tabla externa.

Permisos

Necesita el permiso ALTER en la credencial.

Ejemplos

Un. Cambiar la contraseña de una credencial de ámbito de base de datos

En el ejemplo siguiente se cambia el secreto almacenado en una credencial con ámbito de base de datos. La credencial con ámbito de base de datos contiene un inicio de sesión de Windows y su contraseña. La nueva contraseña se agrega a la credencial con ámbito de base de datos mediante la SECRET cláusula .

ALTER DATABASE SCOPED CREDENTIAL AppCred WITH IDENTITY = '<login>',
    SECRET = '<storng password>';
GO

B. Quitar la contraseña de una credencial

En este ejemplo se quita la contraseña de una credencial de ámbito de base de datos denominada Frames. La credencial con ámbito de base de datos contiene un inicio de sesión de Windows y una contraseña. Una vez ejecutada la instrucción , la credencial con ámbito de base de datos tendrá una NULL contraseña porque no se especifica la opción SECRET.

ALTER DATABASE SCOPED CREDENTIAL Frames WITH IDENTITY = '<login>';
GO