electric-sql/electric

Feature request: document why a shape handle might get deleted

已关闭

#2,680 创建于 2025年5月6日

 (3 条评论) (1 个反应) (0 位负责人)Elixir (329 个派生)batch import
documentationgood first issuehelp wanted

仓库指标

星标
 (10,155 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

Is your feature request related to a problem? Please describe. People wonder why shapes get deleted. Especially if they have very large shapes as recreating and reloading them into clients can get expensive.

If they understand why it's happening, they might be able to reduce how often shapes are recreated by e.g. preserving their shapes logs when restarting their Electric instance.

Describe the solution you'd like Document the reasons for shape deletions:

  1. the server is restarted and loses all its shape logs
  2. pg has an error of some sort that isn't recoverable so electric deletes all the shapes
  3. probably most common, there's a schema change to the table the shape uses so the log is missing the new data

贡献者指南