> ## Documentation Index
> Fetch the complete documentation index at: https://xata.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.2.1

> pgstream v1.2.1 release notes

**Release Date:** July 20th, 2026

pgstream v1.2.1 is a patch release. It adds pipeline phase visibility through the health server and OpenTelemetry, fixes a btree index overflow that blocked snapshot requests covering many tables, and corrects three preflight and restore behaviours that reported problems where there were none. No migration is required.

## Pipeline Phase Visibility

[PR #1000](https://github.com/xataio/pgstream/pull/1000), contributed by [@Shaurya2k06](https://github.com/Shaurya2k06) in their first contribution.

A pipeline that is still snapshotting behaves differently from one that has moved on to replication, and there was no way to tell them apart from the outside. The health server now exposes `/status`, reporting the current phase — `snapshot` or `replication` — and the same value is published as an OpenTelemetry gauge, so the transition can be alerted on:

```yaml theme={null} theme={null}
health:
  enabled: true
  address: ":9910"
```

`/status` is served alongside the existing `/health` and `/ready` endpoints by the `run` and `snapshot` commands.

## Bug Fixes

* **Snapshot requests with many tables no longer overflow the btree index** ([PR #1013](https://github.com/xataio/pgstream/pull/1013)). The unique index on snapshot requests included `table_names` directly; a request listing enough tables exceeded the btree entry size limit and could not be recorded. The column is hashed in the index instead, which bounds the entry regardless of how many tables a request names.
* **Custom enums are no longer reported as unsupported types** ([PR #1005](https://github.com/xataio/pgstream/pull/1005)). Preflight schema validation flagged user-defined enum columns as incompatible on sources that replicate them without trouble.
* **Parsing of validated schema objects is deferred** ([PR #1003](https://github.com/xataio/pgstream/pull/1003)), by [@tsg](https://github.com/tsg).
* **A failed comment restore is a warning, not an error** ([PR #1009](https://github.com/xataio/pgstream/pull/1009)). `COMMENT ON` statements that fail during restore no longer abort it; a missing comment does not affect data or structure.

## New Contributors

* [@Shaurya2k06](https://github.com/Shaurya2k06) in [PR #1000](https://github.com/xataio/pgstream/pull/1000)

## Upgrade

No configuration changes are required. Replace the binary and restart pgstream.

## Support

* Issues: [https://github.com/xataio/pgstream/issues](https://github.com/xataio/pgstream/issues)
* Documentation: [https://github.com/xataio/pgstream/tree/main/docs](https://github.com/xataio/pgstream/tree/main/docs)
* Discussions: [https://github.com/xataio/pgstream/discussions](https://github.com/xataio/pgstream/discussions)