Add a basic README to synapse.storage

This commit is contained in:
Erik Johnston 2019-10-22 11:49:00 +01:00
parent 336eeea3ff
commit acf47c7698
2 changed files with 14 additions and 0 deletions

View File

@ -13,6 +13,7 @@ recursive-include synapse/storage *.sql.postgres
recursive-include synapse/storage *.sql.sqlite recursive-include synapse/storage *.sql.sqlite
recursive-include synapse/storage *.py recursive-include synapse/storage *.py
recursive-include synapse/storage *.txt recursive-include synapse/storage *.txt
recursive-include synapse/storage *.md
recursive-include docs * recursive-include docs *
recursive-include scripts * recursive-include scripts *

13
synapse/storage/README.md Normal file
View File

@ -0,0 +1,13 @@
Storage Layer
=============
The storage layer is split up into multiple parts to allow Synapse to run
against different configurations of databases (e.g. single or multiple
databases). The `data_stores` are classes that talk directly to a single
database and have associated schemas, background updates, etc. On top of those
there are (or will be) classes that provide high level interfaces that combine
calls to multiple `data_stores`.
There are also schemas that get applied to every database, regardless of the
data stores associated with them (e.g. the schema version tables), which are
stored in `synapse.storage.schema`.