Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joncloud/sage-net
Cross platform app that hashes mssql query results for testing
https://github.com/joncloud/sage-net
hash json mssql query test
Last synced: about 1 month ago
JSON representation
Cross platform app that hashes mssql query results for testing
- Host: GitHub
- URL: https://github.com/joncloud/sage-net
- Owner: joncloud
- License: mit
- Created: 2018-03-29T16:16:14.000Z (over 6 years ago)
- Default Branch: publish
- Last Pushed: 2024-03-29T04:35:21.000Z (9 months ago)
- Last Synced: 2024-04-25T04:02:42.190Z (8 months ago)
- Topics: hash, json, mssql, query, test
- Language: C#
- Homepage:
- Size: 65.4 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Sage.NET
[](https://www.nuget.org/packages/sage/)
[](https://builtwithdot.net/project/489/sage-global-tool)
## Description
Sage.NET queries SQL Server databases and converts results into a hash.
## Licensing
Released under the MIT License. See the [LICENSE][] file for further details.
[license]: LICENSE.md
## Installation
Install `https` as a global .NET tool using
```bash
dotnet tool install --global sage --version 0.4.1
```
## Usage
Sage.NET accepts several different ways to represent queries, executes them, and then hashes all of the results.
### Simple Query
A single query can be executed with a simple string. These will be named `Query`.
```powershell
$Query = "SELECT 1 [Num]" | ConvertTo-Json
$ConnectionString = "Data Source=.;Initial Catalog=master;Integrated Security=true;"
$Query | sage tab $ConnectionString
Query 0x313EA196881D370AEEAF78E274B0D08541F6CBF0DDFC7BE57A4594AD0A752A5C
```
### Named Query
A single query can also be run by creating a JSON object with a name property.
```powershell
$Query = @{
name = "Query";
commandText = "SELECT 1 [Num]"
}
$Json = $Query | ConvertTo-Json
$ConnectionString = "Data Source=.;Initial Catalog=master;Integrated Security=true;"
$Json | sage tab $ConnectionString
Query 0x313EA196881D370AEEAF78E274B0D08541F6CBF0DDFC7BE57A4594AD0A752A5C
```
### Multiple Queries
Run multiple queries by creating an array of named queries.
```powershell
$Queries = @(
@{
name = "Query1";
commandText = "SELECT 1 [Num]"
},
@{
name = "Query2";
commandText = "SELECT 2 [Num]"
}
)
$Json = $Queries | ConvertTo-Json
$ConnectionString = "Data Source=.;Initial Catalog=master;Integrated Security=true;"
$Json | sage tab $ConnectionString
Query1 0x313EA196881D370AEEAF78E274B0D08541F6CBF0DDFC7BE57A4594AD0A752A5C
Query2 0x54CB67D1746CD42CA947F6CE705060D0FB5540E55D588F5726CDAD0B73F41618
```
Use the `--hash` flag to change the hashing algorithm. By default Sage uses `SHA256`. Sage supports
* MD5
* SHA1
* SHA256
* SHA384
* SHA512
```powershell
$Json | sage tab $ConnectionString --hash=MD5
Query1 0xF851F5BA5DEB579BBFE5D98E9CD268F6
Query2 0x048F9E6DEF2045421BC057264C16A042
```
Use the `--out-dir` flag in order to persist the information from the resulting query.
```powershell
$Json | sage tab $ConnectionString --out-dir=./
...
Get-Content ./Query1
1
Get-Content ./Query2
2
```
Use the `json` command to export the information as JSON instead of Tab-Delimited. Note that the hashes produced by JSON output vary from the Tab-Delimited output.
```powershell
$Json | sage json $ConnectionString --out-dir=./
...
Get-Content ./Query1
[
{
"Num":1
}
]
Get-Content ./Query2
[
{
"Num":2
}
]
```
Sage.NET will also report exceptions from query execution:
```powershell
$Query = @{
name = "Query";
commandText = "SELECT x [Num]"
}
$Json = $Query | ConvertTo-Json
$ConnectionString = "Data Source=.;Initial Catalog=master;Integrated Security=true;"
$Json | sage tab $ConnectionString
Query System.Data.SqlClient.SqlException (0x80131904): Invalid column name 'x'.
at System.Data.SqlClient.SqlConnection.OnError(SqlException exception, Boolean breakConnection, Action`1 wrapCloseInAction)
at System.Data.SqlClient.SqlInternalConnection.OnError(SqlException exception, Boolean breakConnection, Action`1 wrapCloseInAction)
at System.Data.SqlClient.TdsParser.ThrowExceptionAndWarning(TdsParserStateObject stateObj, Boolean callerHasConnectionLock, Boolean asyncClose)
at System.Data.SqlClient.TdsParser.TryRun(RunBehavior runBehavior, SqlCommand cmdHandler, SqlDataReader dataStream, BulkCopySimpleResultSet bulkCopyHandler, TdsParserStateObject stateObj, Boolean& dataReady)
at System.Data.SqlClient.SqlDataReader.TryConsumeMetaData()
at System.Data.SqlClient.SqlDataReader.get_MetaData()
at System.Data.SqlClient.SqlCommand.FinishExecuteReader(SqlDataReader ds, RunBehavior runBehavior, String resetOptionsString)
at System.Data.SqlClient.SqlCommand.RunExecuteReaderTds(CommandBehavior cmdBehavior, RunBehavior runBehavior, Boolean returnStream, Boolean async, Int32 timeout, Task& task, Boolean asyncWrite, SqlDataReader ds)
at System.Data.SqlClient.SqlCommand.RunExecuteReader(CommandBehavior cmdBehavior, RunBehavior runBehavior, Boolean returnStream, TaskCompletionSource`1 completion, Int32 timeout, Task& task, Boolean asyncWrite, String method)
at System.Data.SqlClient.SqlCommand.ExecuteReader(CommandBehavior behavior)
at System.Data.SqlClient.SqlCommand.ExecuteReader()
at Sage.Formatters.ReadDataTabDelimited(SqlCommand command, StreamWriter writer) in ./src/Sage/Formatters.cs:line 16
at Sage.Program.LoadData(String connectionString, String file, String commandText, Formatter fn) in ./src/Sage/Program.cs:line 210
at Sage.Program.ComputeHash(String connectionString, String name, String commandText, OutDir outDir, Formatter fn, HashAlgorithm algorithm) in ./src/Sage/Program.cs:line 180
at Rlx.Functions.<>c__DisplayClass35_0`7.b__0()
at Rlx.Attempt`1.Catch[TException]()
ClientConnectionId:f6663cff-34f2-49ba-8cad-326f3be6af17
Error Number:207,State:1,Class:16
```