Skip to content

Commit e2b9af5

Browse files
authored
add pg infr to the Readme (#1508)
1 parent 6dc6e6e commit e2b9af5

File tree

1 file changed

+25
-13
lines changed

1 file changed

+25
-13
lines changed

README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,47 @@
11
# NServiceBus.SqlServer
22

3-
NServiceBus.SqlServer provides support for sending messages using [Microsoft SQL Server](http://www.microsoft.com/sqlserver) without the use of a service broker.
3+
NServiceBus.SqlServer provides support for sending messages using [Microsoft SQL Server](http://www.microsoft.com/sqlserver) or [PostgreSQL](https://www.postgresql.org.pl/) without the use of a service broker.
44

55
It is part of the [Particular Service Platform](https://particular.net/service-platform), which includes [NServiceBus](https://particular.net/nservicebus) and tools to build, monitor, and debug distributed systems.
66

7-
See the [SQL Server transport documentation](https://docs.particular.net/transports/sql/) for more details on how to use it.
7+
See the [SQL Server transport documentation](https://docs.particular.net/transports/sql/) and [PostgreSQL transport documentation](https://docs.particular.net/transports/postgresql/) for more details on how to use it.
88

99
## Installation
1010

11-
Before doing anything else, make sure you have SQL Server up and running in your environment. Also make sure it is accessible from all the machines in your setup.
11+
### SQL Server
12+
13+
Before doing anything else, make sure you have SQL Server up and running in your environment. Also, make sure it is accessible from all the machines in your setup.
1214

1315
1. Choose which package you want to use:
1416
- [NServiceBus.Transport.SqlServer](https://www.nuget.org/packages/NServiceBus.Transport.SqlServer) — references [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient)
1517
- [NServiceBus.SqlServer](https://www.nuget.org/packages/NServiceBus.SqlServer) — references [System.Data.SqlClient](https://www.nuget.org/packages/System.Data.SqlClient)
16-
2. Add the package to your project(s).
17-
2. In your app.config make sure to provides the necessary connection information needed to communicate to SQL server. A typical setup would be:
18-
```xml
18+
1. Add the package to your project(s).
19+
1. In your code provide the necessary connection information to communicate with the SQL server instance. A typical setup would be:
20+
```csharp
1921
<connectionStrings>
2022
<add name="NServiceBus/Transport" connectionString="Data Source=.\SQLEXPRESS;Initial Catalog=nservicebus;Integrated Security=True;TrustServerCertificate=true"/>
2123
</connectionStrings>
2224
```
2325

24-
## Performance
26+
### PostgreSQL
27+
28+
1. Add [NServiceBus.Transport.PostgreSql](https://www.nuget.org/packages/NServiceBus.Transport.PostgreSql) the package to your project(s).
29+
1. In code [provide connection string information](https://docs.particular.net/transports/postgresql/connection-settings#connection-configuration) necessary to connect to the PostgreSQL database, e.g.:
30+
```csharp
31+
var transport = new PostgreSqlTransport("User ID=<user>;Password=<pwd>;Host=localhost;Port=5432;Database=nservicebus;Pooling=true;Connection Lifetime=0;");
32+
```
33+
34+
### Connection pooling
35+
36+
Deployments with multiple endpoints running on PostgreSQL require external connection pooling e.g. [using pgBouncer](/docs/postgre-with-pgbouncer.md)
2537

26-
Consider creating a RAM drive or using the temporary drive when running in a cloud vm and hosting your databases on it to reduce the time required to run acceptance tests.
38+
## Testing
2739

28-
## Running tests locally
40+
### Performance
41+
42+
Consider creating a RAM drive or using a temporary one when running in a cloud VM and hosting your databases to reduce the time required to run acceptance tests.
43+
44+
### Running tests locally
2945

3046
The tests expect a SQL Server instance to be available.
3147

@@ -42,7 +58,3 @@ All tests use the default connection string `Data Source=.\SQLEXPRESS;Initial Ca
4258
- `receiver` owner `db_owner`
4359
- `sender` owner `db_owner`
4460
- `db@` owner `db_owner`
45-
46-
## Connection pooling for PostgreSQL
47-
48-
Deployments with multiple endpoints running on PostgreSQL require external connection pooling e.g. [using pgBouncer](/docs/postgre-with-pgbouncer.md)

0 commit comments

Comments
 (0)