2021-05-07 09:22:05 +00:00
|
|
|
# Copyright 2021 The Matrix.org Foundation C.I.C.
|
2016-06-29 10:41:20 +00:00
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
# limitations under the License.
|
|
|
|
|
2023-05-16 17:57:39 +00:00
|
|
|
SCHEMA_VERSION = 77 # remember to update the list below when updating
|
2021-06-11 13:45:53 +00:00
|
|
|
"""Represents the expectations made by the codebase about the database schema
|
|
|
|
|
|
|
|
This should be incremented whenever the codebase changes its requirements on the
|
|
|
|
shape of the database schema (even if those requirements are backwards-compatible with
|
|
|
|
older versions of Synapse).
|
|
|
|
|
2021-08-17 10:45:35 +00:00
|
|
|
See https://matrix-org.github.io/synapse/develop/development/database_schema.html
|
|
|
|
for more information on how this works.
|
2021-07-08 15:57:13 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 61:
|
|
|
|
- The `user_stats_historical` and `room_stats_historical` tables are not written and
|
|
|
|
are not read (previously, they were written but not read).
|
2021-09-24 22:09:12 +00:00
|
|
|
- MSC2716: Add `insertion_events` and `insertion_event_edges` tables to keep track
|
|
|
|
of insertion events in order to navigate historical chunks of messages.
|
|
|
|
- MSC2716: Add `chunk_events` table to track how the chunk is labeled and
|
|
|
|
determines which insertion event it points to.
|
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 62:
|
|
|
|
- MSC2716: Add `insertion_event_extremities` table that keeps track of which
|
|
|
|
insertion events need to be backfilled.
|
2021-08-17 13:02:50 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 63:
|
|
|
|
- The `public_room_list_stream` table is not written nor read to
|
|
|
|
(previously, it was written and read to, but not for any significant purpose).
|
|
|
|
https://github.com/matrix-org/synapse/pull/10565
|
2021-09-24 22:09:12 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 64:
|
|
|
|
- MSC2716: Rename related tables and columns from "chunks" to "batches".
|
2021-10-13 22:44:00 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 65:
|
|
|
|
- MSC2716: Remove unique event_id constraint from insertion_event_edges
|
|
|
|
because an insertion event can have multiple edges.
|
2021-11-13 00:47:56 +00:00
|
|
|
- Remove unused tables `user_stats_historical` and `room_stats_historical`.
|
2021-12-02 22:42:58 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 66:
|
|
|
|
- Queries on state_key columns are now disambiguated (ie, the codebase can handle
|
|
|
|
the `events` table having a `state_key` column).
|
2021-12-10 14:13:23 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 67:
|
|
|
|
- state_events.prev_state is no longer written to.
|
2022-01-21 09:18:10 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 68:
|
|
|
|
- event_reference_hashes is no longer read.
|
2022-01-21 12:21:28 +00:00
|
|
|
- `events` has `state_key` and `rejection_reason` columns, which are populated for
|
|
|
|
new events.
|
2022-04-01 13:33:25 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 69:
|
2022-04-04 14:25:20 +00:00
|
|
|
- We now write to `device_lists_changes_in_room` table.
|
2022-05-17 10:07:18 +00:00
|
|
|
- We now use a PostgreSQL sequence to generate future txn_ids for
|
|
|
|
`application_services_txns`. `application_services_state.last_txn` is no longer
|
|
|
|
updated.
|
2022-05-10 14:35:08 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 70:
|
|
|
|
- event_reference_hashes is no longer written to.
|
2022-05-31 12:51:49 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 71:
|
|
|
|
- event_edges.room_id is no longer read from.
|
2022-06-06 17:20:05 +00:00
|
|
|
- Tables related to groups are no longer accessed.
|
2022-06-15 11:29:42 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 72:
|
|
|
|
- event_edges.(room_id, is_state) are no longer written to.
|
2022-07-13 13:55:14 +00:00
|
|
|
- Tables related to groups are dropped.
|
2022-08-30 17:29:16 +00:00
|
|
|
- Unused column application_services_state.last_txn is dropped
|
2022-09-13 14:14:28 +00:00
|
|
|
- Cache invalidation stream id sequence now begins at 2 to match code expectation.
|
2022-09-14 17:11:16 +00:00
|
|
|
|
2023-02-09 15:28:26 +00:00
|
|
|
Changes in SCHEMA_VERSION = 73:
|
2022-09-14 17:11:16 +00:00
|
|
|
- thread_id column is added to event_push_actions, event_push_actions_staging
|
|
|
|
event_push_summary, receipts_linearized, and receipts_graph.
|
2022-09-14 18:57:50 +00:00
|
|
|
- Add table `event_failed_pull_attempts` to keep track when we fail to pull
|
|
|
|
events over federation.
|
2022-09-16 15:56:56 +00:00
|
|
|
- Add indexes to various tables (`event_failed_pull_attempts`, `insertion_events`,
|
|
|
|
`batch_events`) to make it easy to delete all associated rows when purging a room.
|
2022-10-03 17:44:44 +00:00
|
|
|
- `inserted_ts` column is added to `event_push_actions_staging` table.
|
2023-02-09 15:28:26 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 74:
|
|
|
|
- A query on `event_stream_ordering` column has now been disambiguated (i.e. the
|
|
|
|
codebase can handle the `current_state_events`, `local_current_memberships` and
|
|
|
|
`room_memberships` tables having an `event_stream_ordering` column).
|
2023-04-25 08:44:29 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 75:
|
|
|
|
- The `event_stream_ordering` column in membership tables (`current_state_events`,
|
|
|
|
`local_current_membership` & `room_memberships`) is now being populated for new
|
|
|
|
rows. When the background job to populate historical rows lands this will
|
|
|
|
become the compat schema version.
|
2023-04-26 23:03:26 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 76:
|
|
|
|
- Adds a full_user_id column to tables profiles and user_filters.
|
2023-05-16 17:57:39 +00:00
|
|
|
|
|
|
|
Changes in SCHEMA_VERSION = 77
|
|
|
|
- (Postgres) Add NOT VALID CHECK (full_user_id IS NOT NULL) to tables profiles and user_filters
|
2021-06-11 13:45:53 +00:00
|
|
|
"""
|
|
|
|
|
|
|
|
|
2021-11-13 00:47:56 +00:00
|
|
|
SCHEMA_COMPAT_VERSION = (
|
2023-04-25 08:44:29 +00:00
|
|
|
# Queries against `event_stream_ordering` columns in membership tables must
|
|
|
|
# be disambiguated.
|
2023-05-16 17:57:39 +00:00
|
|
|
#
|
|
|
|
# insertions to the column `full_user_id` of tables profiles and user_filters can no
|
|
|
|
# longer be null
|
|
|
|
76
|
2021-11-13 00:47:56 +00:00
|
|
|
)
|
2021-06-11 13:45:53 +00:00
|
|
|
"""Limit on how far the synapse codebase can be rolled back without breaking db compat
|
|
|
|
|
|
|
|
This value is stored in the database, and checked on startup. If the value in the
|
|
|
|
database is greater than SCHEMA_VERSION, then Synapse will refuse to start.
|
|
|
|
"""
|