Scalable PostgreSQL connection pooler
Go to file
Andrey 29efc7812e Add cancel\rollback timeout 2020-02-10 11:19:42 +05:00
cmake Fix build on ubuntu (#90) 2019-12-27 16:57:26 +05:00
debian Debian package infrastructure 2017-08-21 15:18:28 +03:00
docker Implements SCRAM Authentication (#73) 2019-11-11 12:28:50 +03:00
documentation Implements SCRAM Authentication (#73) 2019-11-11 12:28:50 +03:00
scripts Update README.md (#83) 2019-12-09 23:15:14 +05:00
sources Add cancel\rollback timeout 2020-02-10 11:19:42 +05:00
stress Restore odyssey_stress 2019-04-29 14:01:15 +05:00
test Quantiles for transactions and queries (#95) 2020-01-24 17:31:15 +05:00
third_party Add application_name_add_host setting 2020-01-20 11:43:16 +05:00
.gitignore Add integration tests for SCRAM Authentication (#78) 2019-11-24 21:00:00 +05:00
.gitmodules odyssey: remove machinarium as submodule 2018-03-29 14:20:50 +03:00
.travis.yml Add integration tests for SCRAM Authentication (#78) 2019-11-24 21:00:00 +05:00
AUTHORS Implement SHOW POOLS command 2018-12-24 17:37:40 +05:00
CMakeLists.txt Use more hints to find PG libs 2019-12-24 15:31:22 +05:00
LICENSE odyssey: update LICENSE and AUTHORS 2018-05-21 17:39:43 +03:00
README.md Update README.md (#83) 2019-12-09 23:15:14 +05:00
odyssey.conf Enhance settings for replication support (#107) 2020-01-27 18:01:53 +05:00

README.md



Odyssey

Advanced multi-threaded PostgreSQL connection pooler and request router.

Project status

Odyssey is production-ready, it is being used in large production setups. We appreciate any kind of feedback and contribution to the project.

Design goals and main features

Multi-threaded processing

Odyssey can significantly scale processing performance by specifying a number of additional worker threads. Each worker thread is responsible for authentication and proxying client-to-server and server-to-client requests. All worker threads are sharing global server connection pools. Multi-threaded design plays important role in SSL/TLS performance.

Advanced transactional pooling

Odyssey tracks current transaction state and in case of unexpected client disconnection can emit automatic Cancel connection and do Rollback of abandoned transaction, before putting server connection back to the server pool for reuse. Additionally, last server connection owner client is remembered to reduce a need for setting up client options on each client-to-server assignment.

Better pooling control

Odyssey allows to define connection pools as a pair of Database and User. Each defined pool can have separate authentication, pooling mode and limits settings.

Authentication

Odyssey has full-featured SSL/TLS support and common authentication methods like: md5 and clear text both for client and server authentication. Additionally it allows to block each pool user separately.

Logging

Odyssey generates universally unique identifiers uuid for client and server connections. Any log events and client error responses include the id, which then can be used to uniquely identify client and track actions. Odyssey can save log events into log file and using system logger.

Architecture and internals

Odyssey has sophisticated asynchronous multi-threaded architecture which is driven by custom made coroutine engine: machinarium. Main idea behind coroutine design is to make event-driven asynchronous applications to look and feel like being written in synchronous-procedural manner instead of using traditional callback approach.

One of the main goal was to make code base understandable for new developers and to make an architecture easily extensible for future development.

More information: Architecture and internals.

Build instructions

Currently Odyssey runs only on Linux. Supported platforms are x86/x86_64.

To build you will need:

  • cmake >= 2.8
  • gcc >= 4.6
  • openssl
  • postgresql-server-dev-10
git clone git://github.com/yandex/odyssey.git
cd odyssey
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

Configuration reference

Service
Logging
Performance
System
Global limits
Listen
Routing
Storage
Database and user
Architecture and Internals