EXECUTE AS (Transact-SQL)EXECUTE AS (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Définit le contexte d'exécution d'une session.Sets the execution context of a session.

Par défaut, une session commence lorsqu'un utilisateur se connecte et se termine lorsqu'il se déconnecte.By default, a session starts when a user logs in and ends when the user logs off. Au cours d'une session, toutes les opérations sont soumises à des vérifications d'autorisations pour cet utilisateur.All operations during a session are subject to permission checks against that user. Lorsqu’un EXECUTE AS instruction est exécutée, le contexte d’exécution de la session bascule vers le nom de connexion ou un utilisateur spécifié.When an EXECUTE AS statement is run, the execution context of the session is switched to the specified login or user name. Après le changement de contexte, les autorisations sont vérifiées sur les jetons de sécurité de connexion et l’utilisateur pour ce compte au lieu de la personne qui appelle le EXECUTE AS instruction.After the context switch, permissions are checked against the login and user security tokens for that account instead of the person calling the EXECUTE AS statement. L'identité du compte d'utilisateur ou de connexion est naturellement empruntée pour toute la durée de la session ou de l'exécution du module, ou le changement de contexte est explicitement annulé.In essence, the user or login account is impersonated for the duration of the session or module execution, or the context switch is explicitly reverted.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

{ EXEC | EXECUTE } AS <context_specification>  
[;]  

<context_specification>::=  
{ LOGIN | USER } = 'name'  
    [ WITH { NO REVERT | COOKIE INTO @varbinary_variable } ]   
| CALLER  

ArgumentsArguments

ConnexionLOGIN
S'applique à: SQL Server 2008SQL Server 2008 et SQL Server 2017SQL Server 2017.Applies to: SQL Server 2008SQL Server 2008 through SQL Server 2017SQL Server 2017.

Spécifie que le contexte d'exécution dont l'identité est empruntée est une connexion.Specifies the execution context to be impersonated is a login. L'étendue de l'emprunt d'identité est au niveau du serveur.The scope of impersonation is at the server level.

Note

Cette option n’est pas disponible dans une base de données ou dans la base de données SQL.This option is not available in a contained database or in SQL Database.

UtilisateurUSER
Spécifie que le contexte dont l'identité doit être empruntée est un utilisateur de la base de données active.Specifies the context to be impersonated is a user in the current database. L'étendue de l'emprunt d'identité est limitée à la base de données active.The scope of impersonation is restricted to the current database. Le changement de contexte vers un utilisateur de base de données n'hérite pas des autorisations de cet utilisateur au niveau serveur.A context switch to a database user does not inherit the server-level permissions of that user.

Important

Tant que le changement de contexte en faveur d'un utilisateur de base de données est en vigueur, toute tentative d'accès à des ressources situées en dehors de la base de données causera l'échec de l'instruction.While the context switch to the database user is active, any attempt to access resources outside of the database will cause the statement to fail. Cela inclut l’utilisation base de données , les requêtes distribuées, requêtes et instructions qui font référence à une autre base de données qui utilise des identificateurs de trois ou quatre parties.This includes USE database statements, distributed queries, and queries that reference another database that uses three- or four-part identifiers.

' nom '' name '
Nom d'utilisateur ou de connexion valide.Is a valid user or login name. nom doit être un membre de la sysadmin rôle serveur fixe, ou exister en tant que principal dans sys.database_principals ou sys.server_principals, respectivement.name must be a member of the sysadmin fixed server role, or exist as a principal in sys.database_principals or sys.server_principals, respectively.

nom peut être spécifié comme une variable locale.name can be specified as a local variable.

nom doit être un compte singleton et ne peut pas être un groupe, un rôle, un certificat, une clé ou un compte intégré, tel que NT AUTHORITY\LocalService, NT AUTHORITY\NetworkService ou NT AUTHORITY\LocalSystem.name must be a singleton account, and cannot be a group, role, certificate, key, or built-in account, such as NT AUTHORITY\LocalService, NT AUTHORITY\NetworkService, or NT AUTHORITY\LocalSystem.

Pour plus d’informations, consultez spécifiant un utilisateur ou un nom de connexion plus loin dans cette rubrique.For more information, see Specifying a User or Login Name later in this topic.

NO REVERTNO REVERT
Spécifie qu'il n'est pas possible de restaurer le changement de contexte pour revenir au contexte précédent.Specifies that the context switch cannot be reverted back to the previous context. Le NO REVERT option ne peut être utilisée qu’au niveau approprié.The NO REVERT option can only be used at the adhoc level.

Pour plus d’informations sur le retour au contexte précédent, consultez REVERT ( Transact-SQL ) .For more information about reverting to the previous context, see REVERT (Transact-SQL).

COOKIE dans @ varbinary_variableCOOKIE INTO @varbinary_variable
Spécifie le contexte d’exécution ne peut être restauré vers le contexte précédent que si l’instruction REVERT WITH COOKIE appelante contienne la bonne @ varbinary_variable valeur.Specifies the execution context can only be reverted back to the previous context if the calling REVERT WITH COOKIE statement contains the correct @varbinary_variable value. Le Moteur de base de donnéesDatabase Engine passe le cookie à @ varbinary_variable.The Moteur de base de donnéesDatabase Engine passes the cookie to @varbinary_variable. Le COOKIE dans option ne peut être utilisée qu’au niveau approprié.The COOKIE INTO option can only be used at the adhoc level.

@varbinary_variable est varbinary (8000).@ varbinary_variable is varbinary(8000).

Note

Le cookie sortie paramètre est actuellement documenté comme varbinary (8000) qui est la longueur maximale correcte.The cookie OUTPUT parameter for is currently documented as varbinary(8000) which is the correct maximum length. Toutefois, l’implémentation actuelle retourne varbinary(100).However the current implementation returns varbinary(100). Applications doivent réserver varbinary (8000) afin que l’application continue à fonctionner correctement si le cookie de taille de retour augmente dans une version ultérieure.Applications should reserve varbinary(8000) so that the application continues to operate correctly if the cookie return size increases in a future release.

CALLERCALLER
Dans un module, il spécifie que les instructions de ce module sont exécutées dans le contexte de l'appelant du module.When used inside a module, specifies the statements inside the module are executed in the context of the caller of the module.

En dehors d'un module, cette instruction n'a pas d'effet.When used outside a module, the statement has no action.

NotesRemarks

Le changement dans le contexte d'exécution reste en vigueur jusqu'à ce que se produise l'une des actions suivantes :The change in execution context remains in effect until one of the following occurs:

  • Une autre instruction EXECUTE AS s'exécute.Another EXECUTE AS statement is run.

  • Une instruction REVERT s'exécute.A REVERT statement is run.

  • Suppression de la session.The session is dropped.

  • La procédure stockée ou le déclencheur où la commande exécutée se termine.The stored procedure or trigger where the command was executed exits.

Vous pouvez créer une pile de contextes d'exécution en appelant l'instruction EXECUTE AS plusieurs fois sur plusieurs principaux.You can create an execution context stack by calling the EXECUTE AS statement multiple times across multiple principals. Lorsqu'elle est appelée, l'instruction REVERT bascule le contexte vers la connexion ou l'utilisateur du niveau supérieur dans la pile de contexte.When called, the REVERT statement switches the context to the login or user in the next level up in the context stack. Pour une démonstration de ce comportement, consultez exemple A.For a demonstration of this behavior, see Example A.

Spécification d’un utilisateur ou un nom de connexionSpecifying a User or Login Name

Le nom d’utilisateur ou de connexion spécifié dans EXECUTE AS <context_specification > doit exister en tant que principal dans sys.database_principals ou sys.server_principals, respectivement, ou l’instruction EXECUTE AS échoue.The user or login name specified in EXECUTE AS <context_specification> must exist as a principal in sys.database_principals or sys.server_principals, respectively, or the EXECUTE AS statement fails. De plus, les autorisations IMPERSONATE doivent être accordées sur le principal.Additionally, IMPERSONATE permissions must be granted on the principal. À moins que l’appelant est le propriétaire de la base de données, ou un membre de la sysadmin rôle serveur fixe, le principal doit exister même lorsque l’utilisateur accède à la base de données ou l’instance de SQL ServerSQL Server via une fenêtre de l’appartenance au groupe.Unless the caller is the database owner, or is a member of the sysadmin fixed server role, the principal must exist even when the user is accessing the database or instance of SQL ServerSQL Server through a Windows group membership. Par exemple, supposons les conditions suivantes :For example, assume the following conditions:

  • CompanyDomain\SQLUsers groupe a accès à la Sales base de données.CompanyDomain\SQLUsers group has access to the Sales database.

  • CompanyDomain\SqlUser1 est un membre de SQLUsers et, par conséquent, a un accès implicite à la Sales base de données.CompanyDomain\SqlUser1 is a member of SQLUsers and, therefore, has implicit access to the Sales database.

    Bien que CompanyDomain\SqlUser1 a accès à la base de données via l’appartenance à la SQLUsers groupe, l’instruction EXECUTE AS USER = 'CompanyDomain\SqlUser1' échoue car CompanyDomain\SqlUser1 n’existe pas en tant que principal dans la base de données.Although CompanyDomain\SqlUser1 has access to the database through membership in the SQLUsers group, the statement EXECUTE AS USER = 'CompanyDomain\SqlUser1' fails because CompanyDomain\SqlUser1 does not exist as a principal in the database.

Si l’utilisateur est orphelin (la connexion associée n’existe plus), et l’utilisateur n’a pas été créé avec sans connexion, EXECUTE AS ne fonctionnera pas pour l’utilisateur.If the user is orphaned (the associated login no longer exists), and the user was not created with WITHOUT LOGIN, EXECUTE AS will fail for the user.

Bonne pratiqueBest Practice

Spécifiez une connexion ou un utilisateur bénéficiant du minimum de privilèges indispensable pour effectuer les opérations dans la session.Specify a login or user that has the least privileges required to perform the operations in the session. Par exemple, ne spécifiez pas de nom de connexion avec des autorisations de niveau serveur, si seules les autorisations de niveau base de données sont requises ; ne spécifiez pas non plus un compte de propriétaire de base de données à moins que ces autorisations ne soient nécessaires.For example, do not specify a login name with server-level permissions, if only database-level permissions are required; or do not specify a database owner account unless those permissions are required.

Attention

L'instruction EXECUTE AS peut réussir tant que le Moteur de base de donnéesDatabase Engine peut résoudre le nom.The EXECUTE AS statement can succeed as long as the Moteur de base de donnéesDatabase Engine can resolve the name. Si un utilisateur de domaine existe, Windows peut être en mesure de résoudre l'utilisateur pour le Moteur de base de donnéesDatabase Engine, même si l'utilisateur windows n'a pas accès à SQL ServerSQL Server.If a domain user exists, Windows might be able to resolve the user for the Moteur de base de donnéesDatabase Engine, even though the Windows user does not have access to SQL ServerSQL Server. Cela peut entraîner une condition selon laquelle une connexion sans accès à SQL ServerSQL Server semble être connectée, alors que la connexion avec emprunt d'identité dispose uniquement des autorisations accordées au public ou à l'invité.This can lead to a condition where a login with no access to SQL ServerSQL Server appears to be logged in, though the impersonated login would only have the permissions granted to public or guest.

Utilisation de WITH NO REVERTUsing WITH NO REVERT

Lorsque l'instruction EXECUTE AS comporte la clause WITH NO REVERT facultative, le contexte d'exécution d'une session ne peut pas être réinitialisé à l'aide de REVERT ou en exécutant une autre instruction EXECUTE AS.When the EXECUTE AS statement includes the optional WITH NO REVERT clause, the execution context of a session cannot be reset using REVERT or by executing another EXECUTE AS statement. Le contexte défini par l'instruction reste en vigueur jusqu'à ce que la session soit supprimée.The context set by the statement remains in affect until the session is dropped.

Lorsque le WITH NO REVERT COOKIE = @varbinary_variable clause est spécifiée, la Moteur de base de données SQL ServerSQL Server Database Engine transmet la valeur du cookie à @varbinary_variable.When the WITH NO REVERT COOKIE = @varbinary_variable clause is specified, the Moteur de base de données SQL ServerSQL Server Database Engine passes the cookie value to @varbinary_variable. Le contexte d’exécution définie par cette instruction ne peut être restauré au contexte précédent si l’instruction REVERT WITH COOKIE = @varbinary_variable instruction contient la même @varbinary_variable valeur.The execution context set by that statement can only be reverted to the previous context if the calling REVERT WITH COOKIE = @varbinary_variable statement contains the same @varbinary_variable value.

Cette option est utile dans un environnement où le groupement de connexions est utilisé.This option is useful in an environment in which connection pooling is used. Le groupement de connexions est la maintenance d'un groupe de connexions de base de données à réutiliser par des applications sur un serveur d'applications.Connection pooling is the maintenance of a group of database connections for reuse by applications on an application server. Étant donné que la valeur passée à @varbinary_variable est connue uniquement de l’appelant de la clause EXECUTE AS instruction, l’appelant peut garantir que le contexte d’exécution qu’il établit ne peut pas être modifié par quelqu'un d’autre.Because the value passed to @varbinary_variable is known only to the caller of the EXECUTE AS statement, the caller can guarantee that the execution context they establish cannot be changed by anyone else.

Identification de la connexion originaleDetermining the Original Login

Utilisez le ORIGINAL_LOGIN fonction pour retourner le nom de la connexion connecté à l’instance de SQL ServerSQL Server.Use the ORIGINAL_LOGIN function to return the name of the login that connected to the instance of SQL ServerSQL Server. Vous pouvez utiliser cette fonction pour renvoyer l'identité de la connexion d'origine dans les sessions où il y a un grand nombre de changements de contexte implicites ou explicites.You can use this function to return the identity of the original login in sessions in which there are many explicit or implicit context switches.

PermissionsPermissions

Pour spécifier EXECUTE AS sur une connexion, l’appelant doit avoir emprunter l’identité autorisation sur la connexion spécifiée nommer et ne doit pas être refusé le IMPERSONATE ANY LOGIN autorisation.To specify EXECUTE AS on a login, the caller must have IMPERSONATE permission on the specified login name and must not be denied the IMPERSONATE ANY LOGIN permission. Pour spécifier EXECUTE AS sur un utilisateur de base de données, l’appelant doit avoir IMPERSONATE autorisations sur le nom d’utilisateur spécifié.To specify EXECUTE AS on a database user, the caller must have IMPERSONATE permissions on the specified user name. Lorsque EXECUTE AS CALLER est spécifié, IMPERSONATE autorisations ne sont pas requises.When EXECUTE AS CALLER is specified, IMPERSONATE permissions are not required.

ExemplesExamples

A.A. Utilisation de EXECUTE AS et REVERT pour changer de contexteUsing EXECUTE AS and REVERT to switch context

L'exemple suivant crée une pile d'exécutions de contexte à l'aide de plusieurs principaux.The following example creates a context execution stack using multiple principals. L'instruction REVERT est ensuite utilisée pour réinitialiser le contexte d'exécution à l'appelant précédent.The REVERT statement is then used to reset the execution context to the previous caller. L'instruction REVERT est exécutée plusieurs fois en remontant la pile jusqu'à ce que le contexte d'exécution soit défini pour l'appelant d'origine.The REVERT statement is executed multiple times moving up the stack until the execution context is set to the original caller.

USE AdventureWorks2012;  
GO  
--Create two temporary principals  
CREATE LOGIN login1 WITH PASSWORD = 'J345#$)thb';  
CREATE LOGIN login2 WITH PASSWORD = 'Uor80$23b';  
GO  
CREATE USER user1 FOR LOGIN login1;  
CREATE USER user2 FOR LOGIN login2;  
GO  
--Give IMPERSONATE permissions on user2 to user1  
--so that user1 can successfully set the execution context to user2.  
GRANT IMPERSONATE ON USER:: user2 TO user1;  
GO  
--Display current execution context.  
SELECT SUSER_NAME(), USER_NAME();  
-- Set the execution context to login1.   
EXECUTE AS LOGIN = 'login1';  
--Verify the execution context is now login1.  
SELECT SUSER_NAME(), USER_NAME();  
--Login1 sets the execution context to login2.  
EXECUTE AS USER = 'user2';  
--Display current execution context.  
SELECT SUSER_NAME(), USER_NAME();  
-- The execution context stack now has three principals: the originating caller, login1 and login2.  
--The following REVERT statements will reset the execution context to the previous context.  
REVERT;  
--Display current execution context.  
SELECT SUSER_NAME(), USER_NAME();  
REVERT;  
--Display current execution context.  
SELECT SUSER_NAME(), USER_NAME();  

--Remove temporary principals.  
DROP LOGIN login1;  
DROP LOGIN login2;  
DROP USER user1;  
DROP USER user2;  
GO  

L’exemple suivant définit le contexte d’exécution d’une session à un utilisateur spécifié et spécifie le WITH NO REVERT COOKIE = @varbinary_variablclause de e.The following example sets the execution context of a session to a specified user and specifies the WITH NO REVERT COOKIE = @varbinary_variable clause. L'instruction REVERT doit spécifier la valeur passée à la variable @cookie dans l'instruction EXECUTE AS pour ramener le contexte à l'appelant.The REVERT statement must specify the value passed to the @cookie variable in the EXECUTE AS statement to successfully revert the context back to the caller. Pour exécuter cet exemple, la connexion login1 et l'utilisateur user1 créés dans l'exemple A doivent exister.To run this example, the login1 login and user1 user created in example A must exist.

DECLARE @cookie varbinary(8000);  
EXECUTE AS USER = 'user1' WITH COOKIE INTO @cookie;  
-- Store the cookie in a safe location in your application.  
-- Verify the context switch.  
SELECT SUSER_NAME(), USER_NAME();  
--Display the cookie value.  
SELECT @cookie;  
GO  
-- Use the cookie in the REVERT statement.  
DECLARE @cookie varbinary(8000);  
-- Set the cookie value to the one from the SELECT @cookie statement.  
SET @cookie = <value from the SELECT @cookie statement>;  
REVERT WITH COOKIE = @cookie;  
-- Verify the context switch reverted.  
SELECT SUSER_NAME(), USER_NAME();  
GO  

Voir aussiSee Also

Rétablir ( Transact-SQL ) REVERT (Transact-SQL)
EXÉCUTER en tant que la clause for ( Transact-SQL )EXECUTE AS Clause (Transact-SQL)