使用SignalR和SQLTableDependency跟踪数据库中记录的变动

原文地址：查看

SqlTableDependency是一个组件用来接收数据库的通知，包含在数据表上该记录的值的Inserted、Deleted或者Update操作.

备注：原文提供示例代码下载，但是js写的有些问题（没有更新数据），可以参考下文代码修改一下，修改后的代码可以接收插入和更新两个，对删除没有处理。

介绍

SqlDependency 是用来接收数据表中指定的结果集在insert、update 或者delete 操作而发生变化的通知的一个类库.不过，这个类不会回送记录更改的值.所以，假如我想在web页面中展示股票的值，收到每个通知后，我们都需要执行一个新的查询来刷新缓存并刷新浏览器.如果我们股票值一发生变化浏览器就立马显示新的值，而不需要刷新浏览器，理想情况下我们想从web服务器中接收通知，而不是从浏览器进行轮询和从数据库拉取数据.

解决方案是使用SignalR结合SqlTableDependency来处理; SqlTableDependency从数据库获取通知，接着使用SignalR给web页面发送通知.

 

增强实现

TableDependency 是一个SQLDependency增强版的开源C#组件，当指定的表内容更改后用来发送事件。这个事件报告操作类型((INSERT/UPDATE/DELETE)以及变化删除、插入或修改的值。组件的实现包含：

• SqlTableDependency for SQL Server
• OracleTableDependency for Oracle

TableDependency可以通过Nuget来进行加载。

如何工作

当实例化时，动态生成组件对象用来监视数据表的所有数据库对象。在SqlTableDependency中，包含:

· Message Types

· Message Contract

· Queue

· Service Broker

· Table Trigger

· Stored Procedure

在应用程序突然退出情况下，用来清理创建的对象(也就是说，当应用程序终止时，没有处理SqlTableDependency对象)

数据库中生成的内容截图：

所有这些对象会在SqlTableDependency 释放的时候一次性释放.

监视器

SqlTableDependency 内有一个watchDogTimeOut 对象，负责在程序突然断开的时候移除对象。默认的超时时间是3分钟，在发布阶段，这个时间还可以增加

通过上述的一系列对象，当表内容变化时，SqlTableDependency 获取到通知并且发送包含记录值的通知到C#事件.

代码

假设有一个股票值的表，里面的股票价格会频繁变化：

CREATE TABLE [dbo].[Stocks](

[Code] [nvarchar](50) NULL,

[Name] [nvarchar](50) NULL,

[Price] [decimal](18, 0) NULL

) ON [PRIMARY]

我们把数据表的列映射到下面的model：

public class Stock
{
    public decimal Price { get; set; }
    public string Symbol { get; set; }
    public string Name { get; set; }
}

接下来，需要使用Nuget安装程序包：

PM> Install-Package SqlTableDependency

下一步，创建一个SignlaR的Hub类，继承与SignalR的Hub类：

 

[HubName("stockTicker")]
public class StockTickerHub : Hub
{
    private readonly StockTicker _stockTicker;

    public StockTickerHub() : this(StockTicker.Instance)
    {
    }

    public StockTickerHub(StockTicker stockTicker)
    {
        _stockTicker = stockTicker;
    }

    public IEnumerable<Stock> GetAllStocks()
    {
        return _stockTicker.GetAllStocks();
    }

    public void alertAll()
    {
        Clients.All.testSignalR();
    }
}

我们将使用SignalR Hub API来处理服务器端-客户端的交互。StockTickerHub 类派生自SignalR的Hub类，用来处理客户端的连接和方法调用。不能把这些方法放在Hub类里面，因为Hub 的实例的生命周期为transient（短暂的）。一个Hub 类会为每一个客户端连接和方法调用创建实例。所以要保存股票数据，更新价格和广播更新价格需要运行在一个独立的类，这里命名为StockTicker:

    public class StockTicker
    {
        // Singleton instance
        private readonly static Lazy<StockTicker> _instance = new Lazy<StockTicker>(
            () => new StockTicker(GlobalHost.ConnectionManager.GetHubContext<StockTickerHub>().Clients));

        private static SqlTableDependency<Stock> _tableDependency;

        private StockTicker(IHubConnectionContext<dynamic> clients)
        {
            Clients = clients;

            var mapper = new ModelToTableMapper<Stock>();
            mapper.AddMapping(s => s.Symbol, "Code");

            var connStr = ConfigurationManager.ConnectionStrings["connectionString"].ConnectionString;

            //此方法有11个重载,可以只指定连接字符串和表名
            _tableDependency = new SqlTableDependency<Stock>(connStr, "Stocks", mapper);

            _tableDependency.OnChanged += SqlTableDependency_Changed;
            _tableDependency.OnError += SqlTableDependency_OnError;
            _tableDependency.Start();
        }

        public static StockTicker Instance
        {
            get
            {
                return _instance.Value;
            }
        }

        private IHubConnectionContext<dynamic> Clients
        {
            get;
            set;
        }

        public IEnumerable<Stock> GetAllStocks()
        {
            var stockModel = new List<Stock>();

            var connectionString = ConfigurationManager.ConnectionStrings["connectionString"].ConnectionString;
            using (var sqlConnection = new SqlConnection(connectionString))
            {
                sqlConnection.Open();
                using (var sqlCommand = sqlConnection.CreateCommand())
                {
                    sqlCommand.CommandText = "SELECT * FROM [Stocks]";

                    using (var sqlDataReader = sqlCommand.ExecuteReader())
                    {
                        while (sqlDataReader.Read())
                        {
                            var code = sqlDataReader.GetString(sqlDataReader.GetOrdinal("Code"));
                            var name = sqlDataReader.GetString(sqlDataReader.GetOrdinal("Name"));
                            var price = sqlDataReader.GetDecimal(sqlDataReader.GetOrdinal("Price"));

                            stockModel.Add(new Stock { Symbol = code, Name = name, Price = price });
                        }
                    }
                }
            }

            return stockModel;
        }

        private void SqlTableDependency_OnError(object sender, ErrorEventArgs e)
        {
            throw e.Error;
        }

        /// <summary>
        /// Broadcast New Stock Price
        /// </summary>
        private void SqlTableDependency_Changed(object sender, RecordChangedEventArgs<Stock> e)
        {
            if (e.ChangeType != ChangeType.None)
            {
                BroadcastStockPrice(e.Entity);
            }
        }

        private void BroadcastStockPrice(Stock stock)
        {
            Clients.All.updateStockPrice(stock);
        }

        #region IDisposable Support

        private bool disposedValue = false; // To detect redundant calls

        protected virtual void Dispose(bool disposing)
        {
            if (!disposedValue)
            {
                if (disposing)
                {
                    _tableDependency.Stop();
                }

                disposedValue = true;
            }
        }

        ~StockTicker()
        {
            Dispose(false);
        }

        // This code added to correctly implement the disposable pattern.
        public void Dispose()
        {
            Dispose(true);
            GC.SuppressFinalize(this);
        }

        #endregion IDisposable Support
    }

现在来看一下HTML页面:

<!DOCTYPE html>
<html>
<head>
    <title>SqlTableDependencly with SignalR</title>
    <link href="StockTicker.css" rel="stylesheet" />
</head>
<body>
    <h1>SqlTableDependencly with SignalR</h1>

    <input type="button" value="测试SignalR" id="btnTest" />
    <div id="stockTable">
        <table border="1">
            <thead style="background-color:silver">
                <tr><th>Code</th><th>Name</th><th>Price</th></tr>
            </thead>
            <tbody>
                <tr class="loading"><td colspan="3">loading...</td></tr>
            </tbody>
        </table>
    </div>

    <script src="jquery-1.10.2.min.js"></script>
    <script src="jquery.color-2.1.2.min.js"></script>
    <script src="../Scripts/jquery.signalR-2.2.0.js"></script>
    <script src="../signalr/hubs"></script>
    <script src="SignalR.StockTicker.js"></script>
</body>
</html>

下面是js处理SignalR中方法调用和返回的数据的代码:

/// <reference path="../Scripts/jquery-1.10.2.js" />
/// <reference path="../Scripts/jquery.signalR-2.1.1.js" />

// Crockford's supplant method (poor man's templating)
if (!String.prototype.supplant) {
    String.prototype.supplant = function (o) {
        return this.replace(/{([^{}]*)}/g,
            function (a, b) {
                var r = o[b];
                return typeof r === 'string' || typeof r === 'number' ? r : a;
            }
        );
    };
}

$(function () {
    var ticker = $.connection.stockTicker; // the generated client-side hub proxy
    var $stockTable = $('#stockTable');
    var $stockTableBody = $stockTable.find('tbody');
    var rowTemplate = '<tr data-symbol="{Symbol}"><td>{Symbol}</td><td>{Name}</td><td>{Price}</td></tr>';

    $("#btnTest").click(function () {
        ticker.server.alertAll();
    });

    function formatStock(stock) {
        return $.extend(stock, {
            Price: stock.Price.toFixed(2)
        });
    }

    function init() {
        return ticker.server.getAllStocks().done(function (stocks) {
            $stockTableBody.empty();

            $.each(stocks, function () {
                var stock = formatStock(this);
                $stockTableBody.append(rowTemplate.supplant(stock));
            });
        });
    }

    // Add client-side hub methods that the server will call
    $.extend(ticker.client, {
        updateStockPrice: function (stock) {
            var displayStock = formatStock(stock);
            $row = $(rowTemplate.supplant(displayStock));
            var $oldRow = $stockTableBody.find('tr[data-symbol=' + stock.Symbol + ']');
            if ($oldRow.length) {
                $oldRow.replaceWith($row);
            } else {
                $stockTableBody.append($row);
            }
        }
    });

    $.extend(ticker.client, {
        testSignalR: function () {
            alert("服务器发通知了");
        }
    });

    // Start the connection
    $.connection.hub.start().then(init);
});

最后，不要忘记在StartUp中注册SignalR的路由:

[assembly: OwinStartup(typeof(Stocks.Startup))]

namespace Stocks
{
    public static class Startup
    {
        public static void Configuration(IAppBuilder app)
        {
            app.MapSignalR();
        }
    }
}

如何测试

在附件中，包含一个简单的web应用，包含一个页面，用来展示股票价格变动的表格.

如果进行测试，按如下步骤操作:

· 首先为目标数据库执行语句：

ALTER DATABASE MyDatabase SET ENABLE_BROKER

· 创建数据表: 

CREATE TABLE [dbo].[Stocks](
[Code] [nvarchar](50) NOT NULL,
[Name] [nvarchar](50) NOT NULL,
[Price] [decimal](18, 0) NOT NULL
)

· 生成几条数据到数据库表.

· 运行web应用，打开 /SignalR.Sample/StockTicker.html 页面.

· 修改数据表中的数据，可以看到表格中的数据会随之更新.

补充

关于SqlTableDependency

微软本身提供了一个数据变动通知的实现：SqlDependency,但如作者所说，只能得到变动通知，并不知道发生了什么变化.SqlDependency支持的 SELECT 语句如下,详细介绍：查看

满足下列要求的 SELECT 语句支持查询通知：

· 必须显式说明 SELECT 语句中提取的列，并且表名必须限定为两部分组成的名称。注意，这意味着语句中引用的所有表都必须处于同一数据库中。

· 语句不能使用星号 (*) 或 table_name.* 语法指定列。

· 语句不能使用未命名列或重复的列名。

· 语句必须引用基表。

· 语句不能引用具有计算列的表。

· 在 SELECT 语句中提取的列不能包含聚合表达式，除非语句使用 GROUP BY 表达式。提供 GROUP BY 表达式时，选择列表便可以包含聚合函数 COUNT_BIG() 或 SUM()。但是，不能为可为空的列指定 SUM()。语句不能指定 HAVING、CUBE 或 ROLLUP。

· 在用作简单表达式的 SELECT 语句中提取的列不能多次显示。

· 语句不能包含 PIVOT 或 UNPIVOT 运算符。

· 语句不能包含 UNION、INTERSECT 或 EXCEPT 运算符。

· 语句不能引用视图。

· 语句不能包含下列任意一个：DISTINCT、COMPUTE、COMPUTE BY 或 INTO。

· 语句不能引用服务器全局变量 (@@variable_name)。

· 语句不能引用派生表、临时表或表变量。

· 语句不能从其他数据库或服务器中引用表或视图。

· 语句不能包含子查询、外部联接或自联接。

· 语句不能引用下列大型对象类型：text、ntext 和 image。

· 语句不能使用 CONTAINS 或 FREETEXT 全文谓词。

· 语句不能使用行集函数，包括 OPENROWSET 和 OPENQUERY。

· 语句不能使用下列任何一个聚合函数：AVG、COUNT(*)、MAX、MIN、STDEV、STDEVP、VAR 或 VARP。

· 语句不能使用任何具有不确定性的函数，包括排名函数和开窗函数。

· 语句不能包含用户定义聚合。

· 语句不能引用系统表或视图，包括目录视图和动态管理视图。

· 语句不能包含 FOR BROWSE 信息。

· 语句不能引用队列。

· 语句不能包含无法更改和无法返回结果的条件语句（如 WHERE 1=0）。

· 语句不能指定 READPAST 锁提示。

· 语句不能引用任何 Service Broker QUEUE。

· 语句不能引用同义词。

· 语句不能具有基于 double/real 数据类型的比较或表达式。

· 语句不得使用 TOP 表达式。

SqlTableDependency 是一个增强的.NET SqlDepenency其优势在于包含了Insert、Update以及Delete的记录的值，以及在表上执行的DML操作(Insert/Delete/Update)。这是与.NET SqlDepenency最大的差异,.NET SqlDepenency没有告诉你哪些数据在数据库上发生了更改。

PS: 如果想要使用数据库通知，必须在数据库中启用Server Broker服务，可以执行如下语句: ALTER DATABASE MyDatabase SET ENABLE_BROKER

使用SqlTableDependency 的步骤：

1.   创建一个SqlTableDependency 实例，并传入连接字符串、表名等参数

2.   订阅SqlTableDependency 的OnChange事件

3.   调用Start()方法开始接收通知

4.   调用Stop()方法停止接收通知

引用

· SignalR: http://www.asp.net/signalr/overview/getting-started/tutorial-server-broadcast-with-signalr

· SqlTableDependency: https://tabledependency.codeplex.com/

· MSDN 主题：

• SqlDependency： https://msdn.microsoft.com/zh-cn/library/system.data.sqlclient.sqldependency(v=vs.110).aspx

• SQL Server 中的查询通知：https://msdn.microsoft.com/zh-cn/library/t9x04ed2(v=vs.110).aspx
• 为通知创建查询：https://msdn.microsoft.com/zh-cn/library/ms181122(v=sql.105).aspx