https://github.com/no9/sqlcdcstream

A stream of SQL Server Change Events
https://github.com/no9/sqlcdcstream

Last synced: about 2 months ago
JSON representation

A stream of SQL Server Change Events

• Host: GitHub
• URL: https://github.com/no9/sqlcdcstream
• Owner: No9
• Created: 2012-09-29T18:16:43.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2013-01-22T01:52:34.000Z (almost 12 years ago)
• Last Synced: 2024-04-25T04:21:47.083Z (8 months ago)
• Language: JavaScript
• Size: 1.54 MB
• Stars: 11
• Watchers: 6
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# sqlcdcstream

Is a node.js module that enables changes made to data an Microsoft SQL Server Database Table to be converted to a stream.

It captures all CRUD operations on a table and utilises the built in [Change Data Capture](http://msdn.microsoft.com/en-us/library/bb522489.aspx) functionality of SQL Server.

## Install 

```

npm install sqlcdcstream

```

If your database server does not currently have sqlcdcstream schema do either of the following

```

> node node-modules\sqlcdcstream\install-database.js

```

Or run the script sql\installsqlcdc.sql on the database server

```

> osql -E -n-1 -i .\sql\installsqlcdc.sql -o install-database.log

```

This creates a database on the local instance to store the id of the latest record.

You will find the output of these commands in install-database.log

The script will not delete the database if it already exists.

## Configuration

Enable SQL Server Change Data Capture on the Database

```

> osql -E 

1> USE NAME_OF_YOUR_DATABASE

2> GO

1> EXEC sys.sp_cdc_enable_db

2> GO

```

Enable Change Data Capture on a Table

```

> osql -E 

1> USE NAME_OF_YOUR_DATABASE

2> GO

1> EXECUTE sys.sp_cdc_enable_table 

	@source_schema = N'SCHEMA NAME E.G. dbo', 

	@source_name = N'TABLE_NAME', 

	@capture_instance = N'SCHEMA_NAME_TABLE_NAME'";

2> GO

```

## Usage

Write a program to emit changes

```

var mystream = require('sqlcdc')

var connection =  "Driver={SQL Server Native Client 11.0};Server=(local);Database=DB_NAME;Trusted_Connection={Yes}"

var schema = "dbo"

var tablename = "NAME_OF_TABLE"

var interval = 1000 //frequency the table is polled

var stm = mystream.changes(connection, schema, tablename, interval);

stm.pipe(process.stdout);

```