Compartir a través de

  • Artículo

sp_grantdbaccess (Transact-SQL)

Agrega un usuario de base de datos a la base de datos actual.

Nota importanteImportante

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use CREATE USER.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_grantdbaccess [ @loginame = ] 'login'
    [ , [ @name_in_db = ] 'name_in_db' [ OUTPUT ] ]

Argumentos

  • [ @loginame = ] **'**login '
    Es el nombre del grupo de Windows, inicio de sesión de Windows o inicio de sesión de SQL Server que se va a asignar al nuevo usuario de la base de datos. Los nombres de grupos de Windows e inicios de sesión de Windows deben calificarse con un nombre de dominio de Windows en la forma Dominio\inicio de sesión; por ejemplo, LONDON\Joeb. El inicio de sesión ya no se puede asignar a un usuario de la base de datos. login es de tipo sysname y no tiene valor predeterminado.

  • [ @name_in_db=] 'name_in_db' [ OUTPUT]
    Es el nombre del nuevo usuario de la base de datos. name_in_db es una variable OUTPUT con el tipo de datos sysname y su valor predeterminado es NULL. Cuando no se especifique, se utilizará login. Si se especifica como variable OUTPUT con un valor NULL, @name_in_db se establece en login. name_in_db no debe existir en la base de datos activa.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_grantdbaccess llama CREATE USER, que admite opciones adicionales. Para obtener información sobre cómo crear usuarios de base de datos, vea CREATE USER (Transact-SQL). Para quitar un usuario de una base de datos, use DROP USER.

sp_grantdbaccess no se puede ejecutar desde una transacción definida por el usuario.

Permisos

Debe pertenecer a las funciones fijas de base de datos db_owner o db_accessadmin.

Ejemplos

En el siguiente ejemplo se utiliza CREATE USER para agregar un usuario de base de datos al inicio de sesión de Windows Edmonds\LolanSo en la base de datos actual. El nuevo usuario se llama Lolan. Es el método preferido para crear un usuario de base de datos.

CREATE USER Lolan FOR LOGIN [Edmonds\LolanSo];
GO