Skip to content

Commit e9aec99

Browse files
authored
docs: remove _row_version from stream metadata (#2926)
* docs: remove _row_version from stream metadata * docs: realign stream output samples
1 parent 37da65c commit e9aec99

File tree

2 files changed

+33
-35
lines changed
  • docs
    • cn/guides/40-load-data/05-continuous-data-pipelines
    • en/guides/40-load-data/05-continuous-data-pipelines

2 files changed

+33
-35
lines changed

docs/cn/guides/40-load-data/05-continuous-data-pipelines/01-stream.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -241,7 +241,8 @@ INSERT INTO table SELECT * FROM stream;
241241
| \_origin_version | 标识该行最初创建时的表版本。 |
242242
| \_origin_block_id | 标识该行先前所属的数据块 ID。 |
243243
| \_origin_block_row_num | 标识该行在先前所属数据块中的行号。 |
244-
| \_row_version | 标识行版本号,从 0 开始,每次更新递增 1。 |
244+
245+
此前文档中的隐藏列 `_row_version` 已被移除,现已不可用。
245246

246247
要查看这些列的值,可使用 SELECT 语句:
247248

@@ -254,34 +255,32 @@ SELECT
254255
*,
255256
_origin_version,
256257
_origin_block_id,
257-
_origin_block_row_num,
258-
_row_version
258+
_origin_block_row_num
259259
FROM
260260
t;
261261

262-
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
263-
a _origin_version │ _origin_block_id │ _origin_block_row_num │ _row_version
264-
├─────────────────┼──────────────────┼──────────────────────────┼───────────────────────┼──────────────┤
265-
1 NULLNULL NULL 0
266-
2 NULLNULL NULL 0
267-
└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
262+
┌──────────────────────────────────────────────────────────────────────────┐
263+
│ a _origin_version │ _origin_block_id │ _origin_block_row_num │
264+
├───────────┼──────────────────┼──────────────────────┼───────────────────────┤
265+
1NULLNULLNULL
266+
2NULLNULLNULL
267+
└──────────────────────────────────────────────────────────────────────────┘
268268

269269
UPDATE t SET a = 3 WHERE a = 2;
270270
SELECT
271271
*,
272272
_origin_version,
273273
_origin_block_id,
274-
_origin_block_row_num,
275-
_row_version
274+
_origin_block_row_num
276275
FROM
277276
t;
278277

279-
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
280-
a _origin_version │ _origin_block_id │ _origin_block_row_num_row_version
281-
├─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┼──────────────┤
282-
3 2317132795849016460663684755265365603707394 0 1
283-
1 NULLNULL NULL 0
284-
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
278+
┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
279+
│ a │ _origin_version _origin_block_id _origin_block_row_num
280+
├───────────┼──────────────────┼────────────────────────────────────────────────────────────────────┤
281+
32317 132795849016460663684755265365603707394 0
282+
1NULLNULL NULL
283+
└─────────────────────────────────────────────────────────────────────────────────────────────────┘
285284
```
286285

287286
### 流专用列
@@ -450,4 +449,4 @@ WHEN stream_status('activities_stream') AS
450449
ON a.user_id = p.user_id
451450
-- 仅包含 INSERT 类型的变更行
452451
WHERE a.change$action = 'INSERT';
453-
```
452+
```

docs/en/guides/40-load-data/05-continuous-data-pipelines/01-stream.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -241,7 +241,8 @@ If this `INSERT` transaction commits, the stream is consumed.
241241
| \_origin_version | Identifies the table version in which this row was initially created. |
242242
| \_origin_block_id | Identifies the block ID to which this row belonged previously. |
243243
| \_origin_block_row_num | Identifies the row number within the block to which this row belonged previously. |
244-
| \_row_version | Identifies the row version, starting at 0 and incrementing by 1 with each update. |
244+
245+
The previously documented hidden column `_row_version` has been removed and is no longer available.
245246

246247
To display the values of these columns, use the SELECT statement:
247248

@@ -254,34 +255,32 @@ SELECT
254255
*,
255256
_origin_version,
256257
_origin_block_id,
257-
_origin_block_row_num,
258-
_row_version
258+
_origin_block_row_num
259259
FROM
260260
t;
261261

262-
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
263-
a _origin_version │ _origin_block_id │ _origin_block_row_num │ _row_version
264-
├─────────────────┼──────────────────┼──────────────────────────┼───────────────────────┼──────────────┤
265-
1 NULLNULL NULL 0
266-
2 NULLNULL NULL 0
267-
└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
262+
┌──────────────────────────────────────────────────────────────────────────┐
263+
│ a _origin_version │ _origin_block_id │ _origin_block_row_num │
264+
├───────────┼──────────────────┼──────────────────────┼───────────────────────┤
265+
1NULLNULLNULL
266+
2NULLNULLNULL
267+
└──────────────────────────────────────────────────────────────────────────┘
268268

269269
UPDATE t SET a = 3 WHERE a = 2;
270270
SELECT
271271
*,
272272
_origin_version,
273273
_origin_block_id,
274-
_origin_block_row_num,
275-
_row_version
274+
_origin_block_row_num
276275
FROM
277276
t;
278277

279-
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
280-
a _origin_version │ _origin_block_id │ _origin_block_row_num_row_version
281-
├─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┼──────────────┤
282-
3 2317132795849016460663684755265365603707394 0 1
283-
1 NULLNULL NULL 0
284-
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
278+
┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
279+
│ a │ _origin_version _origin_block_id _origin_block_row_num
280+
├───────────┼──────────────────┼────────────────────────────────────────────────────────────────────┤
281+
32317 132795849016460663684755265365603707394 0
282+
1NULLNULL NULL
283+
└─────────────────────────────────────────────────────────────────────────────────────────────────┘
285284
```
286285

287286
### Stream Columns

0 commit comments

Comments
 (0)