sp_getbindtoken (Transact-SQL)
返回事务的唯一标识符。 此唯一标识符是一个字符串，用来使用 sp_bindsession 绑定会话。
.gif "重要说明") 重要提示 |
|---|
后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。请改用多个活动结果集 (MARS) 或分布式事务。 有关详细信息，请参阅使用多个活动的结果集 (MARS)。 |
.gif "主题链接图标")
语法
sp_getbindtoken [@out_token =] 'return_value' OUTPUT
参数
- [@out_token= ]'return_value'
用于绑定会话的令牌。 return_value 的数据类型为 varchar(255)，无默认值。
返回代码值
无
结果集
无
注释
仅当在活动事务内部执行存储过程时，sp_getbindtoken 才返回有效令牌。 否则，数据库引擎将返回错误消息。 例如：
-- Declare a variable to hold the bind token.
-- No active transaction.
DECLARE @bind_token varchar(255);
-- Trying to get the bind token returns an error 3921.
EXECUTE sp_getbindtoken @bind_token OUTPUT;
Server: Msg 3921, Level 16, State 1, Procedure sp_getbindtoken, Line 4
Cannot get a transaction token if there is no transaction active.
Reissue the statement after a transaction has been started.
当 sp_getbindtoken 用于在打开的事务内登记分布式事务连接时，SQL Server 将返回同一个令牌。 例如：
USE AdventureWorks2012;
GO
DECLARE @bind_token varchar(255);
BEGIN TRAN;
EXECUTE sp_getbindtoken @bind_token OUTPUT;
SELECT @bind_token AS Token;
BEGIN DISTRIBUTED TRAN;
EXECUTE sp_getbindtoken @bind_token OUTPUT;
SELECT @bind_token AS Token;
两个 SELECT 语句都返回同一个令牌：
Token
-----
PKb'gN5<9aGEedk_16>8U=5---/5G=--
(1 row(s_) affected)
Token
-----
PKb'gN5<9aGEedk_16>8U=5---/5G=--
(1 row(s_) affected)
绑定令牌可以与 sp_bindsession 一起使用，将新会话绑定到同一事务上。 绑定令牌仅在每个数据库引擎实例的本地有效，不能由多个实例共享。
若要获得并传递绑定令牌，则必须在执行 sp_bindsession 之前运行 sp_getbindtoken，以共享同一锁空间。 如果获得绑定令牌，则 sp_bindsession 将正常运行。
.gif "注意") 注意 |
|---|
建议使用 srv_getbindtoken 开放式数据服务应用程序编程接口 (API) 从扩展存储过程获得要使用的绑定令牌。 |
权限
要求具有 public 角色的成员身份。
示例
下面的示例将获取一个绑定令牌并显示该绑定令牌的名称。
DECLARE @bind_token varchar(255);
BEGIN TRAN;
EXECUTE sp_getbindtoken @bind_token OUTPUT;
SELECT @bind_token AS Token;
下面是结果集：
Token
----------------------------------------------------------
\0]---5^PJK51bP<1F<-7U-]ANZ