summary refs log tree commit diff
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2018-06-01 11:31:16 +0100
committerErik Johnston <erik@matrix.org>2018-06-01 11:31:16 +0100
commit80a877e9d9382dbc5980db57c7b3d9a5de57c121 (patch)
treecf34bb931edae8c30fa4670a1cca4b15d0d38c4d
parentUpdate docs for RoomStreamToken (diff)
downloadsynapse-80a877e9d9382dbc5980db57c7b3d9a5de57c121.tar.xz
Comment on stream vs topological vs depth ordering in schema
-rw-r--r--synapse/storage/schema/full_schemas/16/im.sql5
1 files changed, 5 insertions, 0 deletions
diff --git a/synapse/storage/schema/full_schemas/16/im.sql b/synapse/storage/schema/full_schemas/16/im.sql
index ba5346806e..4faf8562ad 100644
--- a/synapse/storage/schema/full_schemas/16/im.sql
+++ b/synapse/storage/schema/full_schemas/16/im.sql
@@ -14,7 +14,12 @@
  */
 
 CREATE TABLE IF NOT EXISTS events(
+    -- Defines an ordering used to stream new events to clients. Events
+    -- fetched via backfill have negative values.
     stream_ordering INTEGER PRIMARY KEY,
+    -- Defines a topological ordering of events within a chunk
+    -- (The concept of a chunk was added in later schemas, this used to
+    -- be set to the same value as the `depth` field in an event)
     topological_ordering BIGINT NOT NULL,
     event_id TEXT NOT NULL,
     type TEXT NOT NULL,