Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit dfbde60

Browse files
author
Alexander Korotkov
committed
Rename in_memory_engine GUC prefix to just in_memory
According to naming convention.
1 parent 1cb5e48 commit dfbde60

File tree

4 files changed

+38
-38
lines changed

4 files changed

+38
-38
lines changed

contrib/in_memory/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -64,19 +64,19 @@ In-memory таблица представляет собой index-organized tab
6464
(2 rows)
6565
```
6666

67-
In-memory таблицы хранятся в отдельной области разделяемой памяти, размер которой задаётся параметром `in_memory_engine.shared_pool_size`. Память в данной области разделяемой памяти выделяется страницами размером 1KB. Столь малый размер страницы обусловлен меньшей локальностью данных, которая требуется для эффективного доступа к памяти, по сравнению с жестким диском или SSD. На текущий момент in-memory таблицы не поддерживают TOAST или другой механизм хранения больших значений, в связи с чем на максимальную длину строки установлено ограничение 304 байта. Данное ограничение будет снято в будущих версиях.
67+
In-memory таблицы хранятся в отдельной области разделяемой памяти, размер которой задаётся параметром `in_memory.shared_pool_size`. Память в данной области разделяемой памяти выделяется страницами размером 1KB. Столь малый размер страницы обусловлен меньшей локальностью данных, которая требуется для эффективного доступа к памяти, по сравнению с жестким диском или SSD. На текущий момент in-memory таблицы не поддерживают TOAST или другой механизм хранения больших значений, в связи с чем на максимальную длину строки установлено ограничение 304 байта. Данное ограничение будет снято в будущих версиях.
6868

6969
```
7070
INSERT INTO im_test VALUES (1, repeat('x', 281));
7171
ERROR: tuple too large for in_memory table "im_test1"
7272
DETAIL: Tuple length 305 is too large for in memory table (max 304)
7373
```
7474

75-
При превышении данными размера `in_memory_engine.shared_pool_size`, возникает следующая ошибка.
75+
При превышении данными размера `in_memory.shared_pool_size`, возникает следующая ошибка.
7676
```
7777
ERROR: failed to get new page: shared pool size exceeded
7878
```
79-
Для её избежания нужно ограничить размер хранимых данных, либо увеличить значение параметра `in_memory_engine.shared_pool_size`.
79+
Для её избежания нужно ограничить размер хранимых данных, либо увеличить значение параметра `in_memory.shared_pool_size`.
8080

8181
Для того, чтобы получить статистику по используемым in_memory страницам, нужно воспользоваться функцией `in_memory_page_stats()`. Функция `in_memory_page_stats()` возвращает число занятых, свободных и всех in_memory страниц. Пример вызова `in_memory_page_stats()`.
8282
```
@@ -130,13 +130,13 @@ ROLLBACK
130130
(1 row)
131131
```
132132

133-
Для реализации MVCC модуль in_memory использует undo log. Размер undo log'а, задаётся с помощью опции `in_memory_engine.undo_size`. Undo log представляет собой циклический буфер в разделяемой памяти, в котором хранятся предыдущие версии записей и страниц. Если буфер успевает перекрутиться во время выполнения одной транзакции, то возникает следующуая ошибка.
133+
Для реализации MVCC модуль in_memory использует undo log. Размер undo log'а, задаётся с помощью опции `in_memory.undo_size`. Undo log представляет собой циклический буфер в разделяемой памяти, в котором хранятся предыдущие версии записей и страниц. Если буфер успевает перекрутиться во время выполнения одной транзакции, то возникает следующуая ошибка.
134134

135135
```
136136
ERROR: failed to add undo record: undo size exceeded
137137
```
138138

139-
В этом случае нужно либо уменьшить объёмы транзакций (разбить большие транзакции на более мелкие), либо увеличить значение опции `in_memory_engine.undo_size`.
139+
В этом случае нужно либо уменьшить объёмы транзакций (разбить большие транзакции на более мелкие), либо увеличить значение опции `in_memory.undo_size`.
140140

141141

142142
Возможна также ситуация, когда во время чтения нужная версия записи или страницы была уже затёрта более свежими данными в undo log. В этом случае возникает следующая ошибка.
@@ -145,7 +145,7 @@ ERROR: failed to add undo record: undo size exceeded
145145
ERROR: snapshot too old
146146
```
147147

148-
В таком случае нужно либо принять меры к тому, чтобы записи undo log не успевали перетереться пока используется один снапшот (использовать уровень изоляции READ COMMITTED, разбивать большой запрос на несколько мелких), либо увеличить значение опции `in_memory_engine.undo_size`.
148+
В таком случае нужно либо принять меры к тому, чтобы записи undo log не успевали перетереться пока используется один снапшот (использовать уровень изоляции READ COMMITTED, разбивать большой запрос на несколько мелких), либо увеличить значение опции `in_memory.undo_size`.
149149

150150

151151
Interface

contrib/in_memory/expected/btree_traverse.out

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Parsed test spec with 2 sessions
22

33
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get1 s2_ins2 s2_ins3 s2_ins4 s2_reset
4-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
4+
step s1_setup: SET in_memory.debug_slot_number = 1;
55
step s2_bp_end: SELECT set_breakpoint(16, 1);
66
set_breakpoint
77

@@ -25,7 +25,7 @@ id val
2525
1 2
2626

2727
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_bp_down s1_get1 s2_ins3 s2_ins4 s2_reset
28-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
28+
step s1_setup: SET in_memory.debug_slot_number = 1;
2929
step s2_bp_end: SELECT set_breakpoint(16, 1);
3030
set_breakpoint
3131

@@ -49,7 +49,7 @@ id val
4949
1 2
5050

5151
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_ins3 s2_bp_down s1_get1 s2_ins4 s2_reset
52-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
52+
step s1_setup: SET in_memory.debug_slot_number = 1;
5353
step s2_bp_end: SELECT set_breakpoint(16, 1);
5454
set_breakpoint
5555

@@ -73,7 +73,7 @@ id val
7373
1 2
7474

7575
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get1 s2_ins2 s2_ins3 s2_bp_down s2_ins4 s2_reset
76-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
76+
step s1_setup: SET in_memory.debug_slot_number = 1;
7777
step s2_bp_end: SELECT set_breakpoint(16, 1);
7878
set_breakpoint
7979

@@ -101,7 +101,7 @@ reset_breakpoint
101101
t
102102

103103
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get1 s2_ins4 s2_ins3 s2_bp_down s2_ins2 s2_reset
104-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
104+
step s1_setup: SET in_memory.debug_slot_number = 1;
105105
step s2_bp_end: SELECT set_breakpoint(16, 1);
106106
set_breakpoint
107107

@@ -129,7 +129,7 @@ reset_breakpoint
129129
t
130130

131131
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get2 s2_ins2 s2_ins3 s2_ins4 s2_reset
132-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
132+
step s1_setup: SET in_memory.debug_slot_number = 1;
133133
step s2_bp_end: SELECT set_breakpoint(16, 1);
134134
set_breakpoint
135135

@@ -153,7 +153,7 @@ id val
153153
201 202
154154

155155
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_bp_down s1_get2 s2_ins3 s2_ins4 s2_reset
156-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
156+
step s1_setup: SET in_memory.debug_slot_number = 1;
157157
step s2_bp_end: SELECT set_breakpoint(16, 1);
158158
set_breakpoint
159159

@@ -177,7 +177,7 @@ id val
177177
201 202
178178

179179
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_ins3 s2_bp_down s1_get2 s2_ins4 s2_reset
180-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
180+
step s1_setup: SET in_memory.debug_slot_number = 1;
181181
step s2_bp_end: SELECT set_breakpoint(16, 1);
182182
set_breakpoint
183183

@@ -201,7 +201,7 @@ id val
201201
201 202
202202

203203
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get2 s2_ins2 s2_ins3 s2_bp_down s2_ins4 s2_reset
204-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
204+
step s1_setup: SET in_memory.debug_slot_number = 1;
205205
step s2_bp_end: SELECT set_breakpoint(16, 1);
206206
set_breakpoint
207207

@@ -229,7 +229,7 @@ reset_breakpoint
229229
t
230230

231231
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get2 s2_ins4 s2_ins3 s2_bp_down s2_ins2 s2_reset
232-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
232+
step s1_setup: SET in_memory.debug_slot_number = 1;
233233
step s2_bp_end: SELECT set_breakpoint(16, 1);
234234
set_breakpoint
235235

@@ -257,7 +257,7 @@ reset_breakpoint
257257
t
258258

259259
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get3 s2_ins2 s2_ins3 s2_ins4 s2_reset
260-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
260+
step s1_setup: SET in_memory.debug_slot_number = 1;
261261
step s2_bp_end: SELECT set_breakpoint(16, 1);
262262
set_breakpoint
263263

@@ -281,7 +281,7 @@ id val
281281
513 514
282282

283283
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_bp_down s1_get3 s2_ins3 s2_ins4 s2_reset
284-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
284+
step s1_setup: SET in_memory.debug_slot_number = 1;
285285
step s2_bp_end: SELECT set_breakpoint(16, 1);
286286
set_breakpoint
287287

@@ -305,7 +305,7 @@ id val
305305
513 514
306306

307307
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_ins3 s2_bp_down s1_get3 s2_ins4 s2_reset
308-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
308+
step s1_setup: SET in_memory.debug_slot_number = 1;
309309
step s2_bp_end: SELECT set_breakpoint(16, 1);
310310
set_breakpoint
311311

@@ -329,7 +329,7 @@ id val
329329
513 514
330330

331331
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get3 s2_ins2 s2_ins3 s2_bp_down s2_ins4 s2_reset
332-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
332+
step s1_setup: SET in_memory.debug_slot_number = 1;
333333
step s2_bp_end: SELECT set_breakpoint(16, 1);
334334
set_breakpoint
335335

@@ -357,7 +357,7 @@ reset_breakpoint
357357
t
358358

359359
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get3 s2_ins4 s2_ins3 s2_bp_down s2_ins2 s2_reset
360-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
360+
step s1_setup: SET in_memory.debug_slot_number = 1;
361361
step s2_bp_end: SELECT set_breakpoint(16, 1);
362362
set_breakpoint
363363

@@ -385,7 +385,7 @@ reset_breakpoint
385385
t
386386

387387
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get4 s2_ins2 s2_ins3 s2_ins4 s2_reset
388-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
388+
step s1_setup: SET in_memory.debug_slot_number = 1;
389389
step s2_bp_end: SELECT set_breakpoint(16, 1);
390390
set_breakpoint
391391

@@ -409,7 +409,7 @@ id val
409409
765 766
410410

411411
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_bp_down s1_get4 s2_ins3 s2_ins4 s2_reset
412-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
412+
step s1_setup: SET in_memory.debug_slot_number = 1;
413413
step s2_bp_end: SELECT set_breakpoint(16, 1);
414414
set_breakpoint
415415

@@ -433,7 +433,7 @@ id val
433433
765 766
434434

435435
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_ins3 s2_bp_down s1_get4 s2_ins4 s2_reset
436-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
436+
step s1_setup: SET in_memory.debug_slot_number = 1;
437437
step s2_bp_end: SELECT set_breakpoint(16, 1);
438438
set_breakpoint
439439

@@ -457,7 +457,7 @@ id val
457457
765 766
458458

459459
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get4 s2_ins2 s2_ins3 s2_bp_down s2_ins4 s2_reset
460-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
460+
step s1_setup: SET in_memory.debug_slot_number = 1;
461461
step s2_bp_end: SELECT set_breakpoint(16, 1);
462462
set_breakpoint
463463

@@ -485,7 +485,7 @@ reset_breakpoint
485485
t
486486

487487
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_down s1_get4 s2_ins4 s2_ins3 s2_bp_down s2_ins2 s2_reset
488-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
488+
step s1_setup: SET in_memory.debug_slot_number = 1;
489489
step s2_bp_end: SELECT set_breakpoint(16, 1);
490490
set_breakpoint
491491

@@ -513,7 +513,7 @@ reset_breakpoint
513513
t
514514

515515
starting permutation: s1_setup s2_bp_end s2_ins1 s2_bp_right s1_count s2_ins2 s2_bp_right s2_ins3 s2_bp_right s2_ins4 s2_reset
516-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
516+
step s1_setup: SET in_memory.debug_slot_number = 1;
517517
step s2_bp_end: SELECT set_breakpoint(16, 1);
518518
set_breakpoint
519519

@@ -545,7 +545,7 @@ count
545545
250
546546

547547
starting permutation: s1_setup s2_bp_end s2_ins4 s2_bp_right s1_count s2_ins3 s2_bp_right s2_ins2 s2_bp_right s2_ins1 s2_reset
548-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
548+
step s1_setup: SET in_memory.debug_slot_number = 1;
549549
step s2_bp_end: SELECT set_breakpoint(16, 1);
550550
set_breakpoint
551551

@@ -577,7 +577,7 @@ count
577577
250
578578

579579
starting permutation: s1_setup s2_bp_end s2_ins1 s2_ins2 s2_bp_right s1_count s2_ins3 s2_bp_right s2_ins4 s2_reset
580-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
580+
step s1_setup: SET in_memory.debug_slot_number = 1;
581581
step s2_bp_end: SELECT set_breakpoint(16, 1);
582582
set_breakpoint
583583

@@ -605,7 +605,7 @@ count
605605
500
606606

607607
starting permutation: s1_setup s2_bp_end s2_ins4 s2_ins3 s2_bp_right s1_count s2_ins2 s2_bp_right s2_ins1 s2_reset
608-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
608+
step s1_setup: SET in_memory.debug_slot_number = 1;
609609
step s2_bp_end: SELECT set_breakpoint(16, 1);
610610
set_breakpoint
611611

@@ -633,7 +633,7 @@ count
633633
500
634634

635635
starting permutation: s1_setup s2_ins1 s1_begin s1_delete s2_bp_right s2_bp_end s1_count s2_ins2 s2_bp_right s2_ins3 s2_bp_right s2_ins4 s2_reset s1_commit
636-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
636+
step s1_setup: SET in_memory.debug_slot_number = 1;
637637
step s2_ins1: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(1, 1000, 4) id);
638638
step s1_begin: BEGIN;
639639
step s1_delete: DELETE FROM im_btree_traverse WHERE id % 11 = 0;
@@ -668,7 +668,7 @@ count
668668
step s1_commit: COMMIT;
669669

670670
starting permutation: s1_setup s2_ins4 s1_begin s1_delete s2_bp_right s2_bp_end s1_count s2_ins3 s2_bp_right s2_ins2 s2_bp_right s2_ins1 s2_reset s1_commit
671-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
671+
step s1_setup: SET in_memory.debug_slot_number = 1;
672672
step s2_ins4: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(998, 1, -4) id);
673673
step s1_begin: BEGIN;
674674
step s1_delete: DELETE FROM im_btree_traverse WHERE id % 11 = 0;
@@ -703,7 +703,7 @@ count
703703
step s1_commit: COMMIT;
704704

705705
starting permutation: s1_setup s2_ins1 s2_ins2 s1_begin s1_delete s2_bp_right s2_bp_end s1_count s2_ins3 s2_bp_right s2_ins4 s2_reset s1_commit
706-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
706+
step s1_setup: SET in_memory.debug_slot_number = 1;
707707
step s2_ins1: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(1, 1000, 4) id);
708708
step s2_ins2: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(1000, 1, -4) id);
709709
step s1_begin: BEGIN;
@@ -734,7 +734,7 @@ count
734734
step s1_commit: COMMIT;
735735

736736
starting permutation: s1_setup s2_ins4 s2_ins3 s1_begin s1_delete s2_bp_right s2_bp_end s1_count s2_ins2 s2_bp_right s2_ins1 s2_reset s1_commit
737-
step s1_setup: SET in_memory_engine.debug_slot_number = 1;
737+
step s1_setup: SET in_memory.debug_slot_number = 1;
738738
step s2_ins4: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(998, 1, -4) id);
739739
step s2_ins3: INSERT INTO im_btree_traverse (SELECT id, id + 1 FROM generate_series(999, 1, -4) id);
740740
step s1_begin: BEGIN;

contrib/in_memory/in_memory.c

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ _PG_init(void)
108108
/*
109109
* Define (or redefine) custom GUC variables.
110110
*/
111-
DefineCustomIntVariable("in_memory_engine.shared_pool_size",
111+
DefineCustomIntVariable("in_memory.shared_pool_size",
112112
"Size of in_memory engine shared pool size.",
113113
NULL,
114114
&shared_pool_size_guc,
@@ -121,7 +121,7 @@ _PG_init(void)
121121
NULL,
122122
NULL);
123123

124-
DefineCustomIntVariable("in_memory_engine.undo_size",
124+
DefineCustomIntVariable("in_memory.undo_size",
125125
"Size of in_memory engine undo log size.",
126126
NULL,
127127
&undo_size_guc,
@@ -134,7 +134,7 @@ _PG_init(void)
134134
NULL,
135135
NULL);
136136

137-
DefineCustomIntVariable("in_memory_engine.debug_slot_number",
137+
DefineCustomIntVariable("in_memory.debug_slot_number",
138138
"Number of debug slot.",
139139
NULL,
140140
&debug_slot_number,

contrib/in_memory/specs/btree_traverse.spec

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ teardown
1515

1616
session "s1"
1717

18-
step "s1_setup" { SET in_memory_engine.debug_slot_number = 1; }
18+
step "s1_setup" { SET in_memory.debug_slot_number = 1; }
1919
step "s1_begin" { BEGIN; }
2020
step "s1_delete" { DELETE FROM im_btree_traverse WHERE id % 11 = 0; }
2121
step "s1_get1" { SELECT * FROM im_btree_traverse WHERE id = 1; }

0 commit comments

Comments
 (0)