Pgd 5.8

product_docs/docs/pgd/5.7/index.mdx → product_docs/docs/pgd/5.8/index.mdx

@@ -49,7 +49,7 @@ navigation:
   - reference
 pdf: true
 directoryDefaults:
-  version: "5.7.0"
+  version: "5.8.0"
 ---
 
 

product_docs/docs/pgd/5.7/reference/catalogs-internal.mdx → product_docs/docs/pgd/5.8/reference/catalogs-internal.mdx

@@ -308,4 +308,4 @@ table.
 | sync_start_ts  | timestamptz | Start timestamp of the sync request               |
 | sync_end_lsn   | pg_lsn      | End LSN of the sync request                       |
 | sync_end_ts    | timestamptz | End timestamp of the sync request                 |
-| sync_status    | text        | Status of the sync request                        |
+| sync_status    | text        | Status of the sync request                        |

product_docs/docs/pgd/5.7/reference/index.mdx → product_docs/docs/pgd/5.8/reference/index.mdx

@@ -373,6 +373,7 @@ The reference section is a definitive listing of all functions, views, and comma
  * [`bdr.extract_nodeid_from_timeshard`](sequences#bdrextract_nodeid_from_timeshard)
  * [`bdr.extract_localseqid_from_timeshard`](sequences#bdrextract_localseqid_from_timeshard)
  * [`bdr.timestamp_to_timeshard`](sequences#bdrtimestamp_to_timeshard)
+ * [`bdr.galloc_chunk_info`](sequences#bdrgalloc_chunk_info)
 ### [KSUUID v2 functions](sequences#ksuuid-v2-functions)
  * [`bdr.gen_ksuuid_v2`](sequences#bdrgen_ksuuid_v2)
  * [`bdr.ksuuid_v2_cmp`](sequences#bdrksuuid_v2_cmp)

product_docs/docs/pgd/5.7/reference/sequences.mdx → product_docs/docs/pgd/5.8/reference/sequences.mdx

@@ -224,6 +224,30 @@ bdr.timestamp_to_timeshard(ts timestamptz)
 
 This function executes only on the local node.
 
+### `bdr.galloc_chunk_info`
+
+This function retrieves the ranges allocated to a galloc sequence on the local
+node.
+
+An empty result set will be returned if the sequence has not yet been accessed
+on the local node.
+
+An ERROR will be raised if the provided sequence name is not a galloc sequence.
+
+#### Synopsis
+
+```sql
+bdr.galloc_chunk_info(seqname regclass)
+```
+
+#### Parameters
+
+- `seqname` - the name of the galloc sequence to query
+
+#### Notes
+
+This function executes only on the local node.
+
 ## KSUUID v2 functions
 
 Functions for working with `KSUUID` v2 data, K-Sortable UUID data. See also [KSUUID in the sequences documentation](../sequences/#ksuuids).

product_docs/docs/pgd/5.7/rel_notes/index.mdx → product_docs/docs/pgd/5.8/rel_notes/index.mdx

@@ -4,6 +4,7 @@ navTitle: Release notes
 description: Release notes for EDB Postgres Distributed 5 and later
 indexCards: none
 navigation:
+  - pgd_5.8.0_rel_notes
   - pgd_5.7.0_rel_notes
   - pgd_5.6.1_rel_notes
   - pgd_5.6.0_rel_notes
@@ -16,7 +17,7 @@ navigation:
   - pgd_5.1.0_rel_notes
   - pgd_5.0.1_rel_notes
   - pgd_5.0.0_rel_notes
-originalFilePath: product_docs/docs/pgd/5.7/rel_notes/src/meta.yml
+originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/meta.yml
 editTarget: originalFilePath
 ---
 
@@ -26,6 +27,7 @@ The EDB Postgres Distributed documentation describes the latest version of EDB P
 
 | Release Date | EDB Postgres Distributed | BDR extension | PGD CLI | PGD Proxy |
 |---|---|---|---|---|
+| 22 May 2025 | [5.8.0](./pgd_5.8.0_rel_notes) | 5.8.0 | 5.8.0 | 5.8.0 |
 | 25 Feb 2025 | [5.7.0](./pgd_5.7.0_rel_notes) | 5.7.0 | 5.7.0 | 5.7.0 |
 | 25 Nov 2024 | [5.6.1](./pgd_5.6.1_rel_notes) | 5.6.1 | 5.6.1 | 5.6.1 |
 | 15 Oct 2024 | [5.6.0](./pgd_5.6.0_rel_notes) | 5.6.0 | 5.6.0 | 5.6.0 |

product_docs/docs/pgd/5.7/rel_notes/pgd_5.6.0_rel_notes.mdx → product_docs/docs/pgd/5.8/rel_notes/pgd_5.6.0_rel_notes.mdx

@@ -1,7 +1,7 @@
 ---
 title: EDB Postgres Distributed 5.6.0 release notes
 navTitle: Version 5.6.0
-originalFilePath: product_docs/docs/pgd/5.7/rel_notes/src/relnote_5.6.0.yml
+originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.6.0.yml
 editTarget: originalFilePath
 ---
 

product_docs/docs/pgd/5.7/rel_notes/pgd_5.6.1_rel_notes.mdx → product_docs/docs/pgd/5.8/rel_notes/pgd_5.6.1_rel_notes.mdx

@@ -1,7 +1,7 @@
 ---
 title: EDB Postgres Distributed 5.6.1 release notes
 navTitle: Version 5.6.1
-originalFilePath: product_docs/docs/pgd/5.7/rel_notes/src/relnote_5.6.1.yml
+originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.6.1.yml
 editTarget: originalFilePath
 ---
 

product_docs/docs/pgd/5.7/rel_notes/pgd_5.7.0_rel_notes.mdx → product_docs/docs/pgd/5.8/rel_notes/pgd_5.7.0_rel_notes.mdx

@@ -1,7 +1,7 @@
 ---
 title: EDB Postgres Distributed 5.7.0 release notes
 navTitle: Version 5.7.0
-originalFilePath: product_docs/docs/pgd/5.7/rel_notes/src/relnote_5.7.0.yml
+originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.7.0.yml
 editTarget: originalFilePath
 ---
 

product_docs/docs/pgd/5.8/rel_notes/pgd_5.8.0_rel_notes.mdx

@@ -0,0 +1,22 @@
+---
+title: EDB Postgres Distributed 5.8.0 release notes
+navTitle: Version 5.8.0
+originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.8.0.yml
+editTarget: originalFilePath
+---
+
+Released: 22 May 2025
+
+EDB Postgres Distributed 5.8.0 includes a number of enhancements and bug fixes.
+
+## Highlights
+
+* Simpler sequence management with `bdr.galloc_chunk_info()`
+
+## Enhancements
+
+<table class="table w-100"><thead><tr><th>Component</th><th>Version</th><th>Description</th><th width="10%">Addresses</th></tr></thead><tbody>
+<tr><td>BDR</td><td>5.8.0</td><td>Added `bdr.galloc_chunk_info()` function to simplify sequences</td><td></td></tr>
+</tbody></table>
+
+

product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.8.0.yml

@@ -0,0 +1,29 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/EnterpriseDB/docs/refs/heads/develop/tools/automation/generators/relgen/relnote-schema.json
+product: EDB Postgres Distributed
+version: 5.8.0
+date: 22 May 2025
+components:
+  "BDR": 5.8.0
+  "PGD CLI": 5.8.0
+  "PGD Proxy": 5.8.0
+  "Utilities": 5.8.0
+intro: |
+ EDB Postgres Distributed 5.8.0 includes a number of enhancements and bug fixes.
+highlights: |
+  * Simpler sequence management with `bdr.galloc_chunk_info()`
+
+relnotes:
+- relnote: Added `bdr.galloc_chunk_info()` function to simplify sequences
+  description: |
+    The `bdr.galloc_chunk_info()` function provides information about the chunk
+    allocation for a given sequence. This function returns the chunk ID, the
+    sequence ID, and the chunk size. This function is useful for debugging and
+    understanding how sequences are allocated in BDR.
+  component: BDR
+  impact: Medium
+  jira: BDR-6144
+  addresses: ""
+  type: Enhancement
+
+
+

product_docs/docs/pgd/5.7/sequences.mdx → product_docs/docs/pgd/5.8/sequences.mdx

@@ -332,48 +332,30 @@ SELECT * FROM bdr.sequence_alloc
 (1 row)
 ```
 
-To see the ranges currently assigned to a given sequence on each node, use
-these queries:
+To see the ranges currently assigned to a given sequence on each node, execute the function
+[`bdr.galloc_chunk_info`](reference/sequences/#bdrgalloc_chunk_info).
 
-* Node `Node1` is using range from `333` to `2000333`.
+- Node `Node1` is using range from `334` to `2000333`.
 
 ```sql
-SELECT last_value AS range_start, log_cnt AS range_end
-    FROM categories_category_seq WHERE ctid = '(0,2)'; -- first range
- range_start | range_end
+SELECT * FROM bdr.galloc_chunk_info('categories_category_seq');
+ chunk_start | chunk_end
 -------------+-----------
          334 |   1000333
-(1 row)
-
-SELECT last_value AS range_start, log_cnt AS range_end
-    FROM categories_category_seq WHERE ctid = '(0,3)'; -- second range
- range_start | range_end
--------------+-----------
      1000334 |   2000333
-(1 row)
+(2 rows)
 ```
 
-* Node `Node2` is using range from `2000334` to `4000333`.
+- Node `Node2` is using range from `2000334` to `4000333`.
 
 ```sql
-SELECT last_value AS range_start, log_cnt AS range_end
-    FROM categories_category_seq WHERE ctid = '(0,2)'; -- first range
- range_start | range_end
+SELECT * FROM bdr.galloc_chunk_info('categories_category_seq');
+ chunk_start | chunk_end
 -------------+-----------
      2000334 |   3000333
-(1 row)
-
-SELECT last_value AS range_start, log_cnt AS range_end
-    FROM categories_category_seq WHERE ctid = '(0,3)'; -- second range
- range_start | range_end
--------------+-----------
      3000334 |   4000333
 ```
 
-!!! NOTE 
-    You can't combine it to a single query (like `WHERE ctid IN ('(0,2)', '(0,3)')`),
-    as that still shows only the first range.
-
 When a node finishes a chunk, it asks a consensus for a new one and gets the
 first available. In the example, it's from 4000334 to 5000333. This is
 the new reserved chunk and starts to consume the old reserved chunk.