EXECUTE (Transact-SQL)

語法

Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    { 
      [ @return_status = ]
      { module_name [ ;number ] | @module_name_var } 
        [ [ @parameter = ] { value 
                           | @variable [ OUTPUT ] 
                           | [ DEFAULT ] 
                           }
        ]
      [ ,...n ]
      [ WITH RECOMPILE ]
    }
[;]

Execute a character string
{ EXEC | EXECUTE } 
        ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS { LOGIN | USER } = ' name ' ]
[;]

Execute a pass-through command against a linked server
{ EXEC | EXECUTE }
        ( { @string_variable | [ N ] 'command_string [ ? ]' } [ + ...n ]
        [ { , { value | @variable [ OUTPUT ] } } [ ...n ] ]
        ) 
    [ AS { LOGIN | USER } = ' name ' ]
    [ AT linked_server_name ]
[;]

引數

• @return\_status
  這是儲存模組傳回狀態的選擇性整數變數。這個變數必須先在批次、預存程序或函數中宣告之後，才能用在 EXECUTE 陳述式。

  當您利用 @return\_status 變數叫用純量值使用者定義函數時，該變數可以是任何純量資料類型。

• module_name
  這是您要呼叫的預存程序或純量值使用者定義函數的完整或不完整名稱。模組名稱必須符合識別碼的規則。無論伺服器定序為何，擴充預存程序的名稱一定有大小寫區分。

  已在另一個資料庫建立的模組，如果執行它的使用者擁有它，或者具有適當的權限可以在該資料庫執行它，那麼這個模組就可以執行。如果執行某個模組的使用者，具有適當的權限可以使用該伺服器 (遠端存取)，以及在該資料庫中執行該模組，就可以在另一個執行 SQL Server 的伺服器上執行該模組。如果指定了伺服器名稱，但沒有指定資料庫名稱，則 SQL Server Database Engine 會在該使用者的預設資料庫中尋找該模組。

• ; number
  這是用來將同名程序分組的選擇性整數。這個參數不用於擴充預存程序。

  [!附註]

  未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。

  如需有關程序群組的詳細資訊，請參閱＜CREATE PROCEDURE (Transact-SQL)＞。

• @module\_name\_var
  這是在本機定義的變數名稱，它代表模組名稱。

• @parameter
  這是 module_name 的參數，在模組中定義。參數名稱前面必須加上 @ 記號 (@)。搭配 @parameter\_name=value 格式使用時，參數名稱和常數不必以它們在模組中定義的順序來提供。不過，只要有任何參數採用 @parameter\_name=value 格式，所有後續的參數就必須採用該格式。

  依預設，參數可為 Null。

• value
  這是要傳遞到模組或傳遞命令的參數值。如果未指定參數名稱，參數值就必須依照模組所定義的順序來提供。

  在對連結伺服器執行傳遞命令時，參數值的順序會隨著連結伺服器的 OLE DB 提供者而不同。大部分的 OLE DB 提供者，都會將值由左到右繫結到參數。

  如果參數值是物件名稱、字元字串或者由資料庫名稱或結構描述名稱所限定，則必須以單引號括住整個名稱。如果參數值是關鍵字，則必須以雙引號括住關鍵字。

  如果預設值是在模組中定義，使用者就可以直接執行該模組，不必指定參數。

  預設值也可以是 NULL。通常，模組定義會指定當參數值為 NULL 時，應該採取什麼動作。

• @variable
  這是儲存參數或傳回參數的變數。

• OUTPUT
  指定讓模組或命令字串傳回參數。模組或命令字串中的相符參數，也必須先利用 OUTPUT 關鍵字加以建立。當您把資料指標變數當做參數使用時，請使用這個關鍵字。

  如果 value 被定義為針對連結伺服器執行之模組的 OUTPUT，則對 OLE DB 提供者執行之對應 @parameter 所做的變更，會在模組執行結束時複製回變數。

  如果 OUTPUT 參數正在使用中，且其目的是在呼叫批次或模組的其他陳述式中使用傳回值，則參數值必須被當做變數加以傳遞，例如，@parameter = @variable。您不可以針對未在模組中定義為 OUTPUT 參數的參數指定 OUTPUT，來執行模組。您不可以使用 OUTPUT，將常數傳遞到模組；傳回參數需要一個變數名稱。在執行該程序之前，必須先宣告該變數的資料類型，並且指定一值。

  當 EXECUTE 針對遠端預存程序使用時，或者針對連結伺服器執行傳遞命令時，OUTPUT 參數就不能是任何一種大型物件 (LOB) 資料類型。

  傳回參數可以是 LOB 資料類型以外的任何資料類型。

• DEFAULT
  提供模組所定義的參數預設值。如果該模組所預期的參數值並沒有定義的預設值，而且不是遺漏一個參數，就是指定了 DEFAULT 關鍵字，此時就會發生錯誤。

• WITH RECOMPILE
  在執行模組之後，強制編譯、使用和捨棄新計畫。如果該模組有現有的查詢計畫，這個計畫便會保留在快取中。

  如果您所提供的參數不合規則，或者如果資料已經大幅變更，請使用這個選項。這個選項不用於擴充預存程序。我們建議您少用這個選項，因為它的成本很高。

  [!附註]

  呼叫使用 OPENDATASOURCE 語法的預存程序時，您無法使用 WITH RECOMPILE。指定物件名稱四部分時，會忽略 WITH RECOMPILE 選項。

• @string\_variable
  這是區域變數的名稱。@string_variable 可以是任何 char、varchar、nchar 或 nvarchar 資料類型。其中包含 (max) 資料類型在內。

• [N] 'tsql_string'
  這是常數字串。tsql_string 可以是任何 nvarchar 或 varchar 資料類型。如果包含 N，則字串解譯為 nvarchar 資料類型。

• AS <context_specification>
  指定執行陳述式的內容。如需詳細資訊，請參閱＜瞭解執行內容＞。

• LOGIN
  指定您要模擬的內容是登入。模擬範圍是伺服器。

• USER
  指定您要模擬的內容是目前資料庫中的使用者。模擬範圍僅限於目前資料庫。通往資料庫使用者的內容切換，不會繼承該使用者的伺服器層級權限。

  重要事項
  如果通往資料庫使用者的內容切換在使用中，任何人想要存取資料庫以外的資源，都會導致陳述式失敗。其中包括 USE database 陳述式、分散式查詢以及使用三部分或四部分識別碼來參考另一個資料庫的查詢。若要擴充目前資料庫以外的內容切換範圍，請參閱＜使用 EXECUTE AS 擴充資料庫模擬＞。

• 'name'
  有效的使用者或登入名稱。name 必須是 sysadmin 固定伺服器角色的成員，或者以主體形式分別存在於 sys.database_principals 或 sys.server_principals 中。

  name 不可以是內建帳戶，例如 NT AUTHORITY\LocalService、NT AUTHORITY\NetworkService 或 NT AUTHORITY\LocalSystem。

  如需詳細資訊，請參閱本主題稍後的「指定使用者或登入名稱」。

• [N] 'command_string'
  這是包含要傳遞到連結伺服器之命令的常數字串。如果包含 N，則字串解譯為 nvarchar 資料類型。

• [?]
  指出為其在 EXEC('…', <arg-list>) AT <linkedsrv> 陳述式所使用之通過命令 <arg-list> 中提供值的參數。

• AT linked_server_name
  指定 command_string 是對 linked_server_name 執行，並且將結果 (如果有的話) 傳回用戶端。linked_server_name 必須參考本機伺服器中現有的連結伺服器定義。連結伺服器是利用 sp_addlinkedserver 所定義。

備註

您可以利用 value 或 @parameter\_name = value. 來提供參數。參數不是交易的一部分；因此，如果交易中的參數變更之後再回復，參數值並不會還原為之前的值。傳回呼叫者的值，一定是模組傳回時的值。

當一個模組呼叫另一個模組，或者參考 Common Language Runtime (CLR) 模組、使用者定義類型或彙總，來執行 Managed 程式碼時，就會產生巢狀結構。當被呼叫的模組或 Managed 程式碼參考開始執行時，巢狀層級便開始累加；而當被呼叫的模組或 Managed 程式碼參考完成時，就開始遞減。如果超過 32 個巢狀層級上限時，完整的呼叫鏈便會失敗。目前巢狀層級是儲存在 @@NESTLEVEL 系統函數中。

由於遠端預存程序和擴充預存程序不在交易範圍內 (除非在 BEGIN DISTRIBUTED TRANSACTION 陳述式中發出，或者搭配各種組態選項使用)，因此透過呼叫它們來執行的命令，是無法回復的。如需詳細資訊，請參閱＜系統預存程序 (Transact-SQL)＞和＜BEGIN DISTRIBUTED TRANSACTION (Transact-SQL)＞。

當您使用資料指標變數時，如果您執行的程序所傳遞的資料指標變數，配置了一個資料指標，此時就會發生錯誤。

在執行模組時，如果陳述式是批次中的第一個陳述式，則不必指定 EXECUTE 關鍵字。

搭配預存程序使用 EXECUTE

搭配字元字串使用 EXECUTE

USE master; EXEC ('USE AdventureWorks; SELECT EmployeeID, Title FROM HumanResources.Employee;');

內容切換

權限

執行 EXECUTE 陳述式不需要任何權限。不過，您必須對 EXECUTE 字串內所參考的安全性實體具備權限。例如，如果字串包含 INSERT 陳述式，EXECUTE 陳述式的呼叫者就必須有目標資料表的 INSERT 權限。發現 EXECUTE 陳述式時，會檢查權限，即使模組內包含 EXECUTE 陳述式也一樣。

模組的 EXECUTE 權限預設會授與模組的擁有者，這位擁有者可以將這些權限轉讓給其他使用者。當您執行某個執行字串的模組時，會檢查執行模組之使用者內容中的權限，不過不會檢查建立模組之使用者內容中的權限。然而，如果同一位使用者擁有呼叫模組，而該模組正被呼叫時，第兩個模組就不會再檢查一次 EXECUTE 權限。如需詳細資訊，請參閱＜擁有權鏈結＞。

如果模組要存取其他資料庫物件，只要您具有該模組的 EXECUTE 權限，而且下列一項為真，就可以順利執行：

• 模組被標示為 EXECUTE AS USER 或 SELF，而且模組擁有者具有參考物件的對應權限。

• 模組被標示為 EXECUTE AS CALLER，而且您具有物件的對應權限。

• 模組被標示為 EXECUTE AS user_name，而且 user_name 具有物件的對應權限。

內容切換權限

範例

A. 使用 EXECUTE 來傳遞單一參數

USE AdventureWorks;
GO
EXEC dbo.uspGetEmployeeManagers 6;
GO

EXEC dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

dbo.uspGetEmployeeManagers 6;
GO
--Or
dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

B. 使用多個參數

USE AdventureWorks;
GO
DECLARE @CheckDate datetime;
SET @CheckDate = GETDATE();
EXEC dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO

C. 搭配變數使用 EXECUTE 'tsql_string'

USE AdventureWorks;
GO
DECLARE tables_cursor CURSOR
   FOR
   SELECT s.name, t.name 
   FROM sys.objects AS t
   JOIN sys.schemas AS s ON s.schema_id = t.schema_id
   WHERE t.type = 'U';
OPEN tables_cursor;
DECLARE @schemaname sysname;
DECLARE @tablename sysname;
FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
WHILE (@@FETCH_STATUS <> -1)
BEGIN;
   EXECUTE ('ALTER INDEX ALL ON ' + @schemaname + '.' + @tablename + ' REBUILD;');
   FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
END;
PRINT 'The indexes on all tables have been rebuilt.';
CLOSE tables_cursor;
DEALLOCATE tables_cursor;
GO

D. 搭配遠端預存程序使用 EXECUTE

DECLARE @retstat int;
EXECUTE @retstat = SQLSERVER1.AdventureWorks.dbo.uspGetEmployeeManagers @EmployeeID = 6;

E. 搭配預存程序變數使用 EXECUTE

DECLARE @proc_name varchar(30);
SET @proc_name = 'sys.sp_who';
EXEC @proc_name;

F. 搭配 DEFAULT 使用 EXECUTE

USE AdventureWorks;
GO
IF OBJECT_ID(N'dbo.ProcTestDefaults', N'P')IS NOT NULL
   DROP PROCEDURE dbo.ProcTestDefaults;
GO
-- Create the stored procedure.
CREATE PROCEDURE dbo.ProcTestDefaults (
@p1 smallint = 42, 
@p2 char(1), 
@p3 varchar(8) = 'CAR')
AS 
   SET NOCOUNT ON;
   SELECT @p1, @p2, @p3
;
GO

-- Specifying a value only for one parameter (@p2).
EXECUTE dbo.ProcTestDefaults @p2 = 'A';
-- Specifying a value for the first two parameters.
EXECUTE dbo.ProcTestDefaults 68, 'B';
-- Specifying a value for all three parameters.
EXECUTE dbo.ProcTestDefaults 68, 'C', 'House';
-- Using the DEFAULT keyword for the first parameter.
EXECUTE dbo.ProcTestDefaults @p1 = DEFAULT, @p2 = 'D';
-- Specifying the parameters in an order different from the order defined in the procedure.
EXECUTE dbo.ProcTestDefaults DEFAULT, @p3 = 'Local', @p2 = 'E';
-- Using the DEFAULT keyword for the first and third parameters.
EXECUTE dbo.ProcTestDefaults DEFAULT, 'H', DEFAULT;
EXECUTE dbo.ProcTestDefaults DEFAULT, 'I', @p3 = DEFAULT;

G. 搭配 AT linked_server_name 使用 EXECUTE

EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
EXECUTE ( 'CREATE TABLE AdventureWorks.dbo.SalesTbl 
(SalesID int, SalesName varchar(10)) ; ' ) AT SeattleSales;
GO

H. 使用 EXECUTE WITH RECOMPILE

EXECUTE dbo.Proc_Test_Defaults @p2 = 'A' WITH RECOMPILE;
GO

I. 搭配使用者定義函數使用 EXECUTE

USE AdventureWorks;
GO
DECLARE @returnstatus nvarchar(15);
SET @returnstatus = NULL;
EXEC @returnstatus = dbo.ufnGetSalesOrderStatusText @Status = 2;
PRINT @returnstatus;
GO

J. 使用 EXECUTE 來查詢連結伺服器上的 Oracle 資料庫

-- Setup the linked server.
EXEC sp_addlinkedserver  
        @server='ORACLE',
        @srvproduct='Oracle',
        @provider='OraOLEDB.Oracle', 
        @datasrc='ORACLE10';

EXEC sp_addlinkedsrvlogin 
    @rmtsrvname='ORACLE',
    @useself='false', 
    @locallogin=null, 
    @rmtuser='scott', 
    @rmtpassword='tiger';
 
EXEC sp_serveroption 'ORACLE', 'rpc out', true;
GO
 
-- Execute several statements on the linked Oracle server.
EXEC ( 'SELECT * FROM scott.emp') AT ORACLE;
GO
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', 7902) AT ORACLE;
GO
DECLARE @v INT; 
SET @v = 7902;
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', @v) AT ORACLE;
GO

K. 使用 EXECUTE AS USER 將內容切換到另一位使用者

USE AdventureWorks;
GO
EXECUTE ('CREATE TABLE Sales.SalesTable (SalesID int, SalesName varchar(10));')
AS USER = 'User1';
GO

L. 對 EXECUTE 和 AT linked_server_name 使用參數

-- Setup the linked server.
EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
-- Execute the SELECT statement.
EXECUTE ('SELECT ProductID, Name 
    FROM AdventureWorks.Production.Product
    WHERE ProductID = ? ', 952) AT SeattleSales;
GO

請參閱

參考

概念