-
Notifications
You must be signed in to change notification settings - Fork 9
Expand file tree
/
Copy pathdeveloper_guide.html
More file actions
5585 lines (5441 loc) · 275 KB
/
developer_guide.html
File metadata and controls
5585 lines (5441 loc) · 275 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>开发者指南 :: IvorySQL文档中心</title>
<link rel="canonical" href="https://docs.ivorysql.org/ivorysql-doc/master/developer_guide.html">
<link rel="prev" href="migration_guide.html">
<link rel="next" href="containerization/k8s_deployment.html">
<meta name="generator" content="Antora 3.1.7">
<link rel="stylesheet" href="../../_/css/site.css">
<script>var uiRootPath = '../../_'</script>
</head>
<body class="article">
<header class="header">
<nav class="navbar">
<div class="navbar-brand">
<a class="navbar-item" href="https://docs.ivorysql.org">IvorySQL文档中心</a>
<div class="navbar-item search hide-for-print">
<div id="search-field" class="field">
<input id="search-input" type="text" placeholder="Search the docs">
</div>
</div>
<button class="navbar-burger" data-target="topbar-nav">
<span></span>
<span></span>
<span></span>
</button>
</div>
<div id="topbar-nav" class="navbar-menu">
<div class="navbar-end">
<a class="navbar-item" href="https://www.ivorysql.org/">官方网站</a>
</div>
</div>
</nav>
</header>
<div class="body">
<div class="nav-container" data-component="ivorysql-doc" data-version="master">
<aside class="nav">
<div class="panels">
<div class="nav-panel-menu is-active" data-panel="menu">
<nav class="nav-menu">
<h3 class="title"><a href="welcome.html">文档中心</a></h3>
<ul class="nav-list">
<li class="nav-item" data-depth="0">
<ul class="nav-list">
<li class="nav-item" data-depth="1">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL</span>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
<a class="nav-link" href="welcome.html">欢迎</a>
</li>
<li class="nav-item" data-depth="2">
<a class="nav-link" href="release_notes.html">发行说明</a>
</li>
<li class="nav-item" data-depth="2">
<a class="nav-link" href="about_ivorysql.html">关于IvorySQL</a>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL入门</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<a class="nav-link" href="getting-started/quick_start.html">快速开始</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="getting-started/daily_monitoring.html">日常监控</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="getting-started/daily_maintenance.html">日常维护</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL高级</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<a class="nav-link" href="installation_guide.html">安装指南</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="cluster_setup.html">集群搭建</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="migration_guide.html">迁移指南</a>
</li>
<li class="nav-item is-current-page" data-depth="3">
<a class="nav-link" href="developer_guide.html">开发者指南</a>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">容器化指南</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="containerization/k8s_deployment.html">K8S部署</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="containerization/operator_deployment.html">Operator部署</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="containerization/docker_podman_deployment.html">Docker & Podman部署</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="containerization/docker_swarm_compose_deployment.html">Docker Swarm & Docker Compose部署</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="operation_guide.html">运维管理指南</a>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">云服务平台指南</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="cloud_platform/ivorysql_cloud_installation.html">IvorySQL Cloud安装</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="cloud_platform/ivorysql_cloud_usage.html">IvorySQL Cloud使用</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL生态</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<a class="nav-link" href="cpu_os_adaptation/cpu_architecture_adaptation.html">芯片架构适配</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="cpu_os_adaptation/os_architecture_adaptation.html">操作系统适配</a>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">生态组件适配</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/ecosystem_overview.html">概述</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/postgis.html">postgis</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgvector.html">pgvector</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgddl.html">pgddl(DDL Extractor)</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pg_cron.html">pg_cron</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgsql_http.html">pgsql-http</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/plpgsql_check.html">plpgsql_check</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pg_ai_query.html">pg_ai_query</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgroonga.html">pgroonga</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgaudit.html">pgaudit</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pgrouting.html">pgrouting</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/system_stats.html">system_stats</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/wal2json.html">wal2json</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="ecosystem_components/pg_stat_monitor.html">pg_stat_monitor</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL架构设计</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">查询处理</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="architecture/dual_parser.html">双parser</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">兼容框架</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="architecture/framework_design.html">框架设计</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="architecture/guc_framework.html">GUC框架</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="architecture/dual_mode_design.html">双模式设计</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="architecture/initdb_process.html">initdb过程</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">兼容特性</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/like_operator.html">like</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/rowid.html">RowID</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/out_parameter.html">OUT 参数</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/type_rowtype.html">%TYPE、%ROWTYPE</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/nls_parameter.html">NLS 参数</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/function_procedure.html">函数与存储过程</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/nested_function.html">嵌套子函数</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/force_view.html">Force View</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/case_conversion.html">大小写转换</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/sys_guid_function.html">sys_guid 函数</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/empty_string_to_null.html">空字符串转null</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="compatibility_features_design/call_into.html">CALL INTO</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="3">
<button class="nav-item-toggle"></button>
<span class="nav-text">内置函数</span>
<ul class="nav-list">
<li class="nav-item" data-depth="4">
<a class="nav-link" href="oracle_builtin_functions/sys_context.html">sys_context</a>
</li>
<li class="nav-item" data-depth="4">
<a class="nav-link" href="oracle_builtin_functions/userenv.html">userenv</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="gb18030.html">国标GB18030</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">Oracle兼容功能列表</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_case_conversion.html">1、大小写转换</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_like_operator.html">2、LIKE操作符</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/anonymous_block.html">3、匿名块</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_function_procedure.html">4、函数与存储过程</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/builtin_types_functions.html">5、内置数据类型与内置函数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/port_ip.html">6、端口与IP</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/xml_functions.html">7、XML函数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/sequence.html">8、sequence</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/package.html">9、包</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/invisible_column.html">10、不可见列</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_rowid.html">11、RowID</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_out_parameter.html">12、OUT 参数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_type_rowtype.html">13、%TYPE、%ROWTYPE</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_nls_parameter.html">14、NLS 参数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_force_view.html">15、Force View</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_nested_function.html">16、嵌套子函数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_sys_guid.html">17、sys_guid 函数</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_empty_string_to_null.html">18、空字符串转null</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="oracle_compatibility/compat_call_into.html">19、CALL INTO</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
<span class="nav-text">IvorySQL贡献指南</span>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
<a class="nav-link" href="contribution/community_contribution_guide.html">社区贡献指南</a>
</li>
<li class="nav-item" data-depth="3">
<a class="nav-link" href="contribution/asciidoc_syntax_reference.html">asciidoc语法快速参考</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
<a class="nav-link" href="tools_reference.html">工具参考</a>
</li>
<li class="nav-item" data-depth="2">
<a class="nav-link" href="contribution/faq.html">FAQ</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="1">
<button class="nav-item-toggle"></button>
<span class="nav-text">PostgreSQL</span>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
<a class="nav-link" href="pg_reference/pg_parameters_reference.html">PG参数参考手册</a>
</li>
<li class="nav-item" data-depth="2">
<a class="nav-link" href="pg_reference/pg_functions_reference.html">PG函数参考手册</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
</div>
<div class="nav-panel-explore" data-panel="explore">
<div class="context">
<span class="title">文档中心</span>
<span class="version">master</span>
</div>
<ul class="components">
<li class="component is-current">
<a class="title" href="welcome.html">文档中心</a>
<ul class="versions">
<li class="version is-current is-latest">
<a href="welcome.html">master</a>
</li>
<li class="version">
<a href="../v5.3/welcome.html">v5.3</a>
</li>
<li class="version">
<a href="../v5.1/welcome.html">v5.1</a>
</li>
<li class="version">
<a href="../v5.0/v5.0/welcome.html">v5.0</a>
</li>
<li class="version">
<a href="../v4.6/v4.6/welcome.html">v4.6</a>
</li>
<li class="version">
<a href="../v1.17/v1.17/welcome.html">v1.17</a>
</li>
</ul>
</li>
</ul>
</div>
</div>
</aside>
</div>
<main class="article">
<div class="toolbar" role="navigation">
<button class="nav-toggle"></button>
<nav class="breadcrumbs" aria-label="breadcrumbs">
<ul>
<li><a href="welcome.html">文档中心</a></li>
<li>IvorySQL</li>
<li>IvorySQL高级</li>
<li><a href="developer_guide.html">开发者指南</a></li>
</ul>
</nav>
<div class="page-versions">
<button class="version-menu-toggle" title="switch to English">CN</button>
<div class="version-menu">
<a class="version is-current" href="">CN</a>
<a class="version" href="../../../../en/ivorysql-doc/master/developer_guide.html">EN</a>
</div>
</div>
<div class="edit-this-page"><a href="https://github.com/IvorySQL/ivorysql_docs/edit/master/CN/modules/ROOT/pages/master/developer_guide.adoc">编辑此页面</a></div>
</div>
<div class="content">
<aside class="toc sidebar" data-title="目录" data-levels="2">
<div class="toc-menu"></div>
</aside>
<article class="doc">
<h1 class="page">开发者指南</h1>
<div class="sect1">
<h2 id="概览"><a class="anchor" href="#概览"></a>1. 概览</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IvorySQL在开源PostgreSQL数据库的基础上提供独特的附加功能。</p>
</div>
<div class="paragraph">
<p>IvorySQL致力于通过创新和建立在开源数据库解决方案之上为其终端用户提供价值。我们的目标是为中小型企业提供一个具有高性能、可扩展性、可靠性和易于使用的解决方案。</p>
</div>
<div class="paragraph">
<p>IvorySQL提供的扩展功能将使用户能够建立高性能和可扩展的PostgreSQL数据库集群，具有更好的数据库兼容性和管理。这简化了从其他DBMS迁移到PostgreSQL的过程，增强了数据库管理经验。</p>
</div>
<div class="sect2">
<h3 id="架构概述"><a class="anchor" href="#架构概述"></a>1.1. 架构概述</h3>
<div class="paragraph">
<p>在对原有的PostgreSQL改动最小的前提下，实现对Oracle的兼容。我们需要实现双parser、双端口、模式PL/pgSQL实现PL/iSQL的框架。实现流程图如下：</p>
</div>
<div class="imageblock">
<div class="content">
<img src="../_images/p4.png" alt="p4">
</div>
</div>
<div class="imageblock">
<div class="content">
<img src="../_images/p5.png" alt="p5">
</div>
</div>
</div>
<div class="sect2">
<h3 id="系统表的变化"><a class="anchor" href="#系统表的变化"></a>1.2. 系统表的变化</h3>
<div class="paragraph">
<p>下图描述了对PostgreSQL现有系统表的变化以及所做的补充。</p>
</div>
<div class="imageblock">
<div class="content">
<img src="../_images/p6.png" alt="p6">
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="数据库建模第一章创建库第二章创建表"><a class="anchor" href="#数据库建模第一章创建库第二章创建表"></a>2. 数据库建模（第一章创建库+第二章创建表）</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="创建一个数据库"><a class="anchor" href="#创建一个数据库"></a>2.1. 创建一个数据库</h3>
<div class="paragraph">
<p>看看你能否访问数据库服务器的第一个例子就是试着创建一个数据库。一台运行着的IvorySQL服务器可以管理许多数据库。通常我们会为每个项目和每个用户单独使用一个数据库。</p>
</div>
<div class="paragraph">
<p>你的站点管理员可能已经为你创建了可以使用的数据库。如果这样你就可以省略这一步，并且跳到下一节。</p>
</div>
<div class="paragraph">
<p>要创建一个新的数据库，在我们这个例子里叫`mydb`，你可以使用下面的命令：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">$ createdb mydb</code></pre>
</div>
</div>
<div class="paragraph">
<p>如果不产生任何响应则表示该步骤成功，你可以跳过本节的剩余部分。</p>
</div>
<div class="paragraph">
<p>如果你看到类似下面这样的信息：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">createdb: command not found</code></pre>
</div>
</div>
<div class="paragraph">
<p>那么就是IvorySQL没有安装好。或者是根本没安装，或者是你的shell搜索路径没有设置正确。尝试用绝对路径调用该命令试试：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">$ /usr/local/pgsql/bin/createdb mydb</code></pre>
</div>
</div>
<div class="paragraph">
<p>在你的站点上这个路径可能不一样。和你的站点管理员联系或者看看安装指导获取正确的位置。</p>
</div>
<div class="paragraph">
<p>另外一种响应可能是这样：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
Is the server running locally and accepting connections on that socket?</code></pre>
</div>
</div>
<div class="paragraph">
<p>这意味着该服务器没有启动，或者在`createdb`期望去连接它的时候没有在监听。同样，你也要查看安装指导或者咨询管理员。</p>
</div>
<div class="paragraph">
<p>另外一个响应可能是这样：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL: role "joe" does not exist</code></pre>
</div>
</div>
<div class="paragraph">
<p>在这里提到了你自己的登录名。如果管理员没有为你创建IvorySQL用户帐号，就会发生这些现象。（IvorySQL用户帐号和操作系统用户帐号是不同的。） 如果你是管理员，参阅 <a href="http://www.postgresql.org/docs/17/user-manag.html">第 22 章</a> 获取创建用户帐号的帮助。你需要变成安装IvorySQL的操作系统用户的身份（通常是 <code>postgres</code>）才能创建第一个用户帐号。也有可能是赋予你的IvorySQL用户名和你的操作系统用户名不同；这种情况下，你需要使用`-U`选项或者使用`PGUSER`环境变量指定你的IvorySQL用户名。</p>
</div>
<div class="paragraph">
<p>如果你有个数据库用户帐号，但是没有创建数据库所需要的权限，那么你会看到下面的信息：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">createdb: error: database creation failed: ERROR: permission denied to create database</code></pre>
</div>
</div>
<div class="paragraph">
<p>并非所有用户都被许可创建新数据库。如果IvorySQL拒绝为你创建数据库，那么你需要让站点管理员赋予你创建数据库的权限。出现这种情况时请咨询你的站点管理员。如果你自己安装了IvorySQL，那么你应该以你启动数据库服务器的用户身份登录然后参考手册完成权限的赋予工作。http://www.postgresql.org/docs/17/tutorial-createdb.html#ftn.id-1.4.3.4.10.4[[1\]]</p>
</div>
<div class="paragraph">
<p>你还可以用其它名字创建数据库。IvorySQL允许你在一个站点上创建任意数量的数据库。数据库名必须是以字母开头并且小于63个字符长。一个方便的做法是创建和你当前用户名同名的数据库。许多工具假设该数据库名为缺省数据库名，所以这样可以节省你的敲键。要创建这样的数据库，只需要键入：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">$ createdb</code></pre>
</div>
</div>
<div class="paragraph">
<p>如果你再也不想使用你的数据库了，那么你可以删除它。比如，如果你是数据库`mydb`的所有人（创建人），那么你就可以用下面的命令删除它：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">$ dropdb mydb</code></pre>
</div>
</div>
<div class="paragraph">
<p>（对于这条命令而言，数据库名不是缺省的用户名，因此你就必须声明它）。这个动作将在物理上把所有与该数据库相关的文件都删除并且不可取消，因此做这中操作之前一定要考虑清楚。</p>
</div>
<div class="paragraph">
<p>更多关于 <code>createdb</code> 和 <code>dropdb</code> 的信息可以分别在 <a href="http://www.postgresql.org/docs/17/app-createdb.html">createdb</a>和 <a href="http://www.postgresql.org/docs/17/app-dropdb.html">dropdb</a>中找到。</p>
</div>
</div>
<div class="sect2">
<h3 id="创建一个新表"><a class="anchor" href="#创建一个新表"></a>2.2. 创建一个新表</h3>
<div class="paragraph">
<p>你可以通过指定表的名字和所有列的名字及其类型来创建表∶</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">CREATE TABLE weather (
city varchar(80),
temp_lo int, -- 最低温度
temp_hi int, -- 最高温度
prcp real, -- 湿度
date date
);</code></pre>
</div>
</div>
<div class="paragraph">
<p>你可以在 <code>psql</code> 输入这些命令以及换行符。<code>psql</code> 可以识别该命令直到分号才结束。</p>
</div>
<div class="paragraph">
<p>你可以在SQL命令中自由使用空白（即空格、制表符和换行符）。这就意味着你可以用和上面不同的对齐方式键入命令，或者将命令全部放在一行中。两个划线（“<code>--</code>”）引入注释。任何跟在它后面直到行尾的东西都会被忽略。SQL是对关键字和标识符大小写不敏感的语言，只有在标识符用双引号包围时才能保留它们的大小写（上例没有这么做）。</p>
</div>
<div class="paragraph">
<p><code>varchar(80)</code> 指定了一个可以存储最长80个字符的任意字符串的数据类型。<code>int</code> 是普通的整数类型。<code>real</code> 是一种用于存储单精度浮点数的类型。<code>date</code> 类型应该可以自解释（没错，类型为`date`的列名字也是`date`。这么做可能比较方便或者容易让人混淆 — 你自己选择）。</p>
</div>
<div class="paragraph">
<p>IvorySQL支持标准的SQL类型`int`、<code>smallint</code>、<code>real</code>、<code>double precision</code>、<code>char(<strong>N</strong>)</code>、<code>varchar(<strong>N</strong>)</code>、<code>date</code>、<code>time</code>、<code>timestamp`和`interval</code>，还支持其他的通用功能的类型和丰富的几何类型。IvorySQL中可以定制任意数量的用户定义数据类型。因而类型名并不是语法关键字，除了SQL标准要求支持的特例外。</p>
</div>
<div class="paragraph">
<p>第二个例子将保存城市和它们相关的地理位置：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">CREATE TABLE cities (
name varchar(80),
location point
);</code></pre>
</div>
</div>
<div class="paragraph">
<p>类型`point`就是一种IvorySQL特有数据类型的例子。</p>
</div>
<div class="paragraph">
<p>最后，我们还要提到如果你不再需要某个表，或者你想以不同的形式重建它，那么你可以用下面的命令删除它：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">DROP TABLE tablename;</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="写入数据sql写入参考第-6-章-数据操纵"><a class="anchor" href="#写入数据sql写入参考第-6-章-数据操纵"></a>3. 写入数据（SQL写入）参考第 6 章 数据操纵</h2>
<div class="sectionbody">
<div class="paragraph">
<p>当一个表被创建后，它不包含任何数据。在数据库发挥作用之前，首先要做的是插入数据。一次插入一行数据。你也可以在一个命令中插入多行，但不能插入不完整的行。即使只知道其中一些列的值，也必须创建完整的行。</p>
</div>
<div class="paragraph">
<p>要创建一个新行，使用 <a href="http://www.postgresql.org/docs/17/sql-insert.html">INSERT</a>命令。这条命令要求提供表的名字和其中列的值。例如，考虑 <a href="http://www.postgresql.org/docs/17/ddl.html">第 5 章</a>中的产品表：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">CREATE TABLE products (
product_no integer,
name text,
price numeric
);
CREATE TABLE new_products (
product_no int ,
name varchar(255),
price DECIMAL(10, 2),
release_date DATE
);</code></pre>
</div>
</div>
<div class="paragraph">
<p>一个插入一行的命令将是：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products VALUES (1, 'Cheese', 9.99);</code></pre>
</div>
</div>
<div class="paragraph">
<p>数据的值是按照这些列在表中出现的顺序列出的，并且用逗号分隔。通常，数据的值是文字（常量），但也允许使用标量表达式。</p>
</div>
<div class="paragraph">
<p>上面的语法的缺点是你必须知道表中列的顺序。要避免这个问题，你也可以显式地列出列。例如，下面的两条命令都有和上文那条 命令一样的效果：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', 9.99);
INSERT INTO products (name, price, product_no) VALUES ('Cheese', 9.99, 1);</code></pre>
</div>
</div>
<div class="paragraph">
<p>许多用户认为明确列出列的名字是个好习惯。</p>
</div>
<div class="paragraph">
<p>如果你没有获得所有列的值，那么你可以省略其中的一些。在这种情况下，这些列将被填充为它们的缺省值。例如：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products (product_no, name) VALUES (1, 'Cheese');
INSERT INTO products VALUES (1, 'Cheese');</code></pre>
</div>
</div>
<div class="paragraph">
<p>第二种形式是IvorySQL的一个扩展。它从使用给出的值从左开始填充列，有多少个给出的列值就填充多少个列，其他列的将使用缺省值。</p>
</div>
<div class="paragraph">
<p>为了保持清晰，你也可以显式地要求缺省值，用于单个的列或者用于整个行：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', DEFAULT);
INSERT INTO products DEFAULT VALUES;</code></pre>
</div>
</div>
<div class="paragraph">
<p>你可以在一个命令中插入多行：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products (product_no, name, price) VALUES
(1, 'Cheese', 9.99),
(2, 'Bread', 1.99),
(3, 'Milk', 2.99);
INSERT INTO new_products (product_no, name, price, release_date) VALUES
(1, 'A', 100.00, '2025-05-29'),
(2, 'B', 150.50, '2024-11-20'),
(3, 'C', 200.75, '2025-05-29');</code></pre>
</div>
</div>
<div class="paragraph">
<p>也可以插入查询的结果（可能没有行、一行或多行）：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">INSERT INTO products (product_no, name, price)
SELECT product_no, name, price FROM new_products
WHERE release_date = '2025-05-29';</code></pre>
</div>
</div>
<div class="paragraph">
<p>这提供了用于计算要插入的行的SQL查询机制（ <a href="http://www.postgresql.org/docs/17/queries.html">第 7 章</a>）的全部功能。</p>
</div>
<div class="sidebarblock">
<div class="content">
<div class="title">提示</div>
<div class="paragraph">
<p>在一次性插入大量数据时，考虑使用 <a href="http://www.postgresql.org/docs/17/sql-copy.html">COPY</a>命令。它不如 <a href="http://www.postgresql.org/docs/17/sql-insert.html">INSERT</a>命令那么灵活，但是更高效。</p>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="查询数据-参考-第七章查询的组合查询-第十五章-并行查询"><a class="anchor" href="#查询数据-参考-第七章查询的组合查询-第十五章-并行查询"></a>4. 查询数据 参考 第七章查询的组合查询 第十五章 并行查询</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="组合查询"><a class="anchor" href="#组合查询"></a>4.1. 组合查询</h3>
<div class="paragraph">
<p>两个查询的结果可以用集合操作并、交、差进行组合。语法是:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">query1 UNION [ALL] query2
query1 INTERSECT [ALL] query2
query1 EXCEPT [ALL] query2</code></pre>
</div>
</div>
<div class="paragraph">
<p><strong><code>query1</code>*和</strong><code>query2</code>*都是可以使用以上所有特性的查询。集合操作也可以嵌套和级连，例如:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">query1 UNION query2 UNION query3</code></pre>
</div>
</div>
<div class="paragraph">
<p>实际执行的是：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">(query1 UNION query2) UNION query3</code></pre>
</div>
</div>
<div class="paragraph">
<p><code>UNION`有效地把*`query2</code><strong>的结果附加到</strong><code>query1</code>*的结果上（不过我们不能保证这就是这些行实际被返回的顺序）。此外，它将删除结果中所有重复的行，就像`DISTINCT`做的那样，除非你使用了`UNION ALL`。</p>
</div>
<div class="paragraph">
<p><code>INTERSECT`返回那些同时存在于*`query1</code><strong>和</strong><code>query2</code>*的结果中的行，除非声明了`INTERSECT ALL`，否则所有重复行都被消除。</p>
</div>
<div class="paragraph">
<p><code>EXCEPT`返回所有在*`query1</code><strong>的结果中但是不在</strong><code>query2</code><strong>的结果中的行（有时侯这叫做两个查询的*差</strong>）。同样的，除非声明了`EXCEPT ALL`，否则所有重复行都被消除。</p>
</div>
<div class="paragraph">
<p>为了计算两个查询的并、交、差，这两个查询必须是“并操作兼容的”，也就意味着它们都返回同样数量的列，并且对应的列有兼容的数据类型，如 <a href="http://www.postgresql.org/docs/17/typeconv-union-case.html">第 10.5 节</a>中描述的那样。</p>
</div>
</div>
<div class="sect2">
<h3 id="并行查询"><a class="anchor" href="#并行查询"></a>4.2. 并行查询</h3>
<div class="sect3">
<h4 id="并行查询如何工作"><a class="anchor" href="#并行查询如何工作"></a>4.2.1. 并行查询如何工作</h4>
<div class="paragraph">
<p>当优化器判断对于某一个特定的查询，并行查询是最快的执行策略时，优化器将创建一个查询计划。该计划包括一个 *Gather*或者*Gather Merge*节点。下面是一个简单的例子：</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">EXPLAIN SELECT * FROM pgbench_accounts WHERE filler LIKE '%x%';
QUERY PLAN
-------------------------------------------------------------------------------------
Gather (cost=1000.00..217018.43 rows=1 width=97)
Workers Planned: 2
-> Parallel Seq Scan on pgbench_accounts (cost=0.00..216018.33 rows=1 width=97)
Filter: (filler ~~ '%x%'::text)
(4 rows)</code></pre>
</div>
</div>
<div class="paragraph">
<p>在所有的情形下，`Gather`或*Gather Merge*节点都只有一个子计划，它是将被并行执行的计划的一部分。如果`Gather`或*Gather Merge*节点位于计划树的最顶层，那么整个查询将并行执行。如果它位于计划树的其他位置，那么只有查询中在它之下的那一部分会并行执行。在上面的例子中，查询只访问了一个表，因此除`Gather`节点本身之外只有一个计划节点。因为该计划节点是`Gather`节点的孩子节点，所以它会并行执行。</p>
</div>
<div class="paragraph">
<p><a href="http://www.postgresql.org/docs/17/using-explain.html">使用 EXPLAIN</a>命令, 你能看到规划器选择的工作者数量。当查询执行期间到达`Gather`节点时，实现用户会话的进程将会请求和规划器选中的工作者数量一样多的 <a href="http://www.postgresql.org/docs/17/bgworker.html">后台工作者进程</a>。规划器将考虑使用的后台工作者的数量被限制为最多 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-PARALLEL-WORKERS-PER-GATHER">max_parallel_workers_per_gather</a>个。任何时候能够存在的后台工作者进程的总数由 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</a>和 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-PARALLEL-WORKERS">max_parallel_workers</a>限制。因此，一个并行查询可能会使用比规划中少的工作者来运行，甚至有可能根本不使用工作者。最优的计划可能取决于可用的工作者的数量，因此这可能会导致不好的查询性能。如果这种情况经常发生，那么就应当考虑一下提高`max_worker_processes`和`max_parallel_workers`的值，这样更多的工作者可以同时运行；或者降低`max_parallel_workers_per_gather`，这样规划器会要求少一些的工作者。</p>
</div>
<div class="paragraph">
<p>为一个给定并行查询成功启动的后台工作者进程都将会执行计划的并行部分。这些工作者的领导者也将执行该计划，不过它还有一个额外的任务：它还必须读取所有由工作者产生的元组。当整个计划的并行部分只产生了少量元组时，领导者通常将表现为一个额外的加速查询执行的工作者。反过来，当计划的并行部分产生大量的元组时，领导者将几乎全用来读取由工作者产生的元组并且执行`Gather`或`Gather Merge`节点上层计划节点所要求的任何进一步处理。在这些情况下，领导者所作的执行并行部分的工作将会很少。</p>
</div>
<div class="paragraph">
<p>当计划的并行部分的顶层节点是`Gather Merge`而不是`Gather`时，它表示每个执行计划并行部分的进程会产生有序的元组，并且领导者执行一种保持顺序的合并。相反，`Gather`会以任何方便的顺序从工作者读取元组，这会破坏可能已经存在的排序顺序。</p>
</div>
</div>
<div class="sect3">
<h4 id="何时会用到并行查询"><a class="anchor" href="#何时会用到并行查询"></a>4.2.2. 何时会用到并行查询？</h4>
<div class="paragraph">
<p>有几种设置会导致查询规划器在任何情况下都不生成并行查询计划。为了让并行查询计划能够被生成，必须配置好下列设置。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-PARALLEL-WORKERS-PER-GATHER">max_parallel_workers_per_gather</a>必须被设置为大于零的值。这是一种特殊情况，更加普遍的原则是所用的工作者数量不能超过`max_parallel_workers_per_gather`所配置的数量。</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>此外，系统一定不能运行在单用户模式下。因为在单用户模式下，整个数据库系统运行在单个进程中，没有后台工作者进程可用。</p>
</div>
<div class="paragraph">
<p>如果下面的任一条件为真，即便对一个给定查询通常可以产生并行查询计划，规划器都不会为它产生并行查询计划：</p>
</div>
<div class="ulist">
<ul>
<li>
<p>查询要写任何数据或者锁定任何数据库行。如果一个查询在顶层或者CTE中包含了数据修改操作，那么不会为该查询产生并行计划。一种例外是，<code>CREATE TABLE …​ AS</code>、`SELECT INTO`以及`CREATE MATERIALIZED VIEW`这些创建新表并填充它的命令可以使用并行计划。</p>
</li>
<li>
<p>查询可能在执行过程中被暂停。只要在系统认为可能发生部分或者增量式执行，就不会产生并行计划。例如：用 <a href="http://www.postgresql.org/docs/17/sql-declare.html">DECLARE CURSOR</a>创建的游标将永远不会使用并行计划。类似地，一个`FOR x IN query LOOP .. END LOOP`形式的 PL/pgSQL 循环也永远不会使用并行计划，因为当并行查询进行时，并行查询系统无法验证循环中的代码执行起来是安全的。</p>
</li>
<li>
<p>使用了任何被标记为`PARALLEL UNSAFE`的函数的查询。大多数系统定义的函数都被标记为`PARALLEL SAFE`，但是用户定义的函数默认被标记为`PARALLEL UNSAFE`。参见 <a href="http://www.postgresql.org/docs/17/parallel-safety.html">第 15.4 节</a>中的讨论。</p>
</li>
<li>
<p>该查询运行在另一个已经存在的并行查询内部。例如，如果一个被并行查询调用的函数自己发出一个 SQL 查询，那么该查询将不会使用并行计划。这是当前实现的一个限制，但是或许不值得移除这个限制，因为它会导致单个查询使用大量的进程。</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>即使对于一个特定的查询已经产生了并行查询计划，在一些情况下执行时也不会并行执行该计划。如果发生这种情况，那么领导者将会自己执行该计划在`Gather`节点之下的部分，就好像`Gather`节点不存在一样。上述情况将在满足下面的任一条件时发生：</p>
</div>
<div class="ulist">
<ul>
<li>
<p>因为后台工作者进程的总数不能超过 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</a>，导致不能得到后台工作者进程。</p>
</li>
<li>
<p>由于为并行查询目的启动的后台工作者数量不能超过 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-PARALLEL-WORKERS">max_parallel_workers</a>这一限制而不能得到后台工作者。</p>
</li>
<li>
<p>客户端发送了一个执行消息，并且消息中要求取元组的数量不为零。执行消息可见 <a href="http://www.postgresql.org/docs/17/protocol-flow.html#PROTOCOL-FLOW-EXT-QUERY">扩展查询协议</a>中的讨论。因为 <a href="http://www.postgresql.org/docs/17/libpq.html">libpq</a>当前没有提供方法来发送这种消息，所以这种情况只可能发生在不依赖 libpq 的客户端中。如果这种情况经常发生，那在它可能发生的会话中设置 <a href="http://www.postgresql.org/docs/17/runtime-config-resource.html#GUC-MAX-PARALLEL-WORKERS-PER-GATHER">max_parallel_workers_per_gather</a>为零是一个很好的主意，这样可以避免产生连续运行时次优的查询计划。</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="并行计划"><a class="anchor" href="#并行计划"></a>4.2.3. 并行计划</h4>
<div class="paragraph">
<p>因为每个工作者只执行完成计划的并行部分，所以不可能简单地产生一个普通查询计划并使用多个工作者运行它。每个工作者都会产生输出结果集的一个完全，因而查询并不会比普通查询运行得更快甚至还会产生不正确的结果。相反，计划的并行部分一定被查询优化器在内部当作一个*部分计划*，即它必须被构建出来，这样每一个执行该计划的进程将以无重复地方式产生输出行的一个子集，即保证每一个所需要的输出行正好只被一个合作进程生成。通常，这意味着该查询的驱动表上的扫描必须是一种可并行的扫描。</p>
</div>
<div class="sect4">
<h5 id="并行扫描"><a class="anchor" href="#并行扫描"></a>4.2.3.1. 并行扫描</h5>
<div class="paragraph">
<p>当前支持下列可并行的表扫描。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>在一个<strong>*并行顺序扫描\</strong>*中，表块将在合作进程之间被划分。一次会分发一个块，这样对表的访问还是保持顺序方式。</p>
</li>
<li>
<p>在一个<strong>*并行位图堆扫描\</strong>*中，一个进程被选为领导者。这个进程执行对一个或者多个索引的扫描并且构建出一个位图指示需要访问哪些表块。这些表块接着会在合作进程之间划分（和并行顺序扫描中一样）。换句话说，堆扫描以并行方式进行但底层的索引扫描不是并行。</p>
</li>
<li>
<p>在一个<strong>*并行索引扫描\</strong>*或者<strong>*并行只用索引的扫描\</strong>*中，合作进程轮流从索引读取数据。当前，并行索引扫描仅有B-树索引支持。每一个进程将认领一个索引块并且扫描和返回该索引块引用的所有元组，其他进程可以同时地从一个不同的索引块返回元组。并行B-树扫描的结果会以每个工作者进程内的顺序返回。</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>其他扫描类型（例如非B-树索引的扫描）可能会在未来支持并行扫描。</p>
</div>
</div>
<div class="sect4">
<h5 id="并行连接"><a class="anchor" href="#并行连接"></a>4.2.3.2. 并行连接</h5>
<div class="paragraph">
<p>正如在非并行计划中那样，驱动表可能被使用嵌套循环、哈希连接或者归并连接连接到一个或者多个其他表。连接的内侧可以是任何类型的被规划器支持的非并行计划，假设它能够安全地在并行工作者中运行。根据连接类型，内侧还可以是一种并行计划。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>在一个<strong>*嵌套循环连接\</strong>*中，内侧总是非并行的。尽管它会被完全执行，如果内侧是一个索引扫描也会很高效，因为外侧元组以及在索引中查找值的循环会被划分到多个合作进程。</p>
</li>
<li>
<p>在一个<strong>*归并连接\</strong>*中，内侧总是一个非并行计划并且因此会被完全执行。这可能是不太高效的，特别是在排序必须被执行时，因为在每一个合作进程中工作数据和结果数据是重复的。</p>
</li>
<li>
<p>在一个<strong><strong>哈希连接\</strong></strong>（没有“并行”前缀）中，每个合作进程都会完全执行内侧以构建哈希表的相同。如果哈希表很大或者该计划开销很大，这种方式就很低效。在一个<strong><strong>并行哈希连接\</strong>*中，内侧是一个<strong>*并行哈希\</strong></strong>，它把构建共享哈希表的工作划分到多个合作进程。</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="并行聚集"><a class="anchor" href="#并行聚集"></a>4.2.3.3. 并行聚集</h5>
<div class="paragraph">
<p>IvorySQL通过按两个阶段进行聚集来支持并行聚集。首先，每个参与到查询并行部分的进程执行一个聚集步骤，为该进程注意到的每个分组产生一个部分结果。这在计划中反映为一个`Partial Aggregate`节点。然后，部分结果通过`Gather`或者`Gather Merge`被传输到领导者。最后，领导者对来自所有工作者的结果进行重新聚集得到最终的结果。这在计划中反映为一个`Finalize Aggregate`节点。</p>
</div>
<div class="paragraph">
<p>因为`Finalize Aggregate`节点运行在领导者进程上，如果查询产生的分组数相对于其输入行数来说比较大，则查询规划器不会喜欢它。例如，在最坏的情况下，`Finalize Aggregate`节点看到的分组数可能与所有工作者进程在`Partial Aggregate`阶段看到的输入行数一样多。对于这类情况，使用并行聚集显然得不到性能收益。查询规划器会在规划过程中考虑这一点并且不太会在这种情况下选择并行聚集。</p>
</div>
<div class="paragraph">
<p>并行聚集并非在所有情况下都被支持。每一个聚集都必须是对并行 <a href="http://www.postgresql.org/docs/17/parallel-safety.html">安全的</a>并且必须有一个组合函数。如果该聚集有一个类型为`internal`的转移状态，它必须有序列化和反序列化函数。更多细节请参考 <a href="http://www.postgresql.org/docs/17/sql-createaggregate.html">CREATE AGGREGATE</a>。如果任何聚集函数调用包含`DISTINCT`或`ORDER BY`子句，则不支持并行聚集。对于有序集聚集或者当查询涉及`GROUPING SETS`时，也不支持并行聚集。只有在查询中涉及的所有连接也是该计划并行部分的组成部分时，才能使用并行聚集。</p>
</div>
</div>
<div class="sect4">
<h5 id="并行append"><a class="anchor" href="#并行append"></a>4.2.3.4. 并行Append</h5>
<div class="paragraph">
<p>只要当IvorySQL需要从多个源中整合行到一个单一结果集时，它会使用`Append`或`MergeAppend`计划节点。在实现`UNION ALL`或扫描分区表时常常会发生这种情况。就像这些节点可以被用在任何其他计划中一样，它们可以被用在并行计划中。不过，在并行计划中，规划器使用的是`Parallel Append`节点。</p>
</div>
<div class="paragraph">
<p>当一个`Append`节点被用在并行计划中时，每个进程将按照子计划出现的顺序执行子计划，这样所有的参与进程会合作执行第一个子计划直到它被完成，然后同时移动到第二个计划。而在使用`Parallel Append`时，执行器将把它的子计划尽可能均匀地散布在参与进程中，这样多个子计划会被同时执行。这避免了竞争，也避免了子计划在那些不执行它的进程中产生启动代价。</p>
</div>
<div class="paragraph">
<p>此外，和常规的`Append`节点不同（在并行计划中使用时仅有部分子计划），<code>Parallel Append`节点既可以有部分子计划也可以有非部分子计划。非部分子计划将仅被单个进程扫描，因为扫描它们不止一次会产生重复的结果。因此涉及到追加多个结果集的计划即使在没有有效的部分计划可用时，也能实现粗粒度的并行。例如，考虑一个针对分区表的查询，它只能通过使用一个不支持并行扫描的索引来实现。规划器可能会选择常规`Index Scan`计划的`Parallel Append</code>。每个索引扫描必须被单一的进程执行完，但不同的扫描可以由不同的进程同时执行。</p>
</div>
<div class="paragraph">
<p><a href="http://www.postgresql.org/docs/17/runtime-config-query.html#GUC-ENABLE-PARALLEL-APPEND">enable_parallel_append</a>可以被用来禁用这种特性。</p>
</div>
</div>
<div class="sect4">
<h5 id="并行计划小贴士"><a class="anchor" href="#并行计划小贴士"></a>4.2.3.5. 并行计划小贴士</h5>
<div class="paragraph">
<p>如果我们想要一个查询能产生并行计划但事实上又没有产生，可以尝试减小 <a href="http://www.postgresql.org/docs/17/runtime-config-query.html#GUC-PARALLEL-SETUP-COST">parallel_setup_cost</a>或者 <a href="http://www.postgresql.org/docs/17/runtime-config-query.html#GUC-PARALLEL-TUPLE-COST">parallel_tuple_cost</a>。当然，这个计划可能比规划器优先产生的顺序计划还要慢，但也不总是如此。如果将这些设置为很小的值（例如把它们设置为零）也不能得到并行计划，那就可能是有某种原因导致查询规划器无法为你的查询产生并行计划。可能的原因可见 <a href="http://www.postgresql.org/docs/17/when-can-parallel-query-be-used.html">第 15.2 节</a>和 <a href="http://www.postgresql.org/docs/17/parallel-safety.html">第 15.4 节</a>。</p>
</div>
<div class="paragraph">
<p>在执行一个并行计划时，可以用`EXPLAIN (ANALYZE,VERBOSE)`来显示每个计划节点在每个工作者上的统计信息。这些信息有助于确定是否所有的工作被均匀地分发到所有计划节点以及从总体上理解计划的性能特点。</p>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="事务参考sql命令"><a class="anchor" href="#事务参考sql命令"></a>5. 事务（参考Sql命令）</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="abort-中止当前事务"><a class="anchor" href="#abort-中止当前事务"></a>5.1. ABORT — 中止当前事务</h3>
<div class="sect3">
<h4 id="大纲"><a class="anchor" href="#大纲"></a>5.1.1. 大纲</h4>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">ABORT [ WORK | TRANSACTION ] [ AND [ NO ] CHAIN ]</code></pre>
</div>
</div>
</div>
<div class="sect3">
<h4 id="描述"><a class="anchor" href="#描述"></a>5.1.2. 描述</h4>
<div class="paragraph">
<p><code>ABORT`回滚当前事务并且导致由该事务所作的所有更新被丢弃。这个命令的行为与标准SQL命令 <a href="http://www.postgresql.org/docs/17/sql-rollback.html">`ROLLBACK</code></a>的行为一样，并且只是为了历史原因存在。</p>
</div>
</div>
<div class="sect3">
<h4 id="参数"><a class="anchor" href="#参数"></a>5.1.3. 参数</h4>
<div class="ulist">
<ul>
<li>
<p><code>WORK</code> <code>TRANSACTION</code></p>
<div class="literalblock">
<div class="content">
<pre>可选关键词。它们没有效果。</pre>
</div>
</div>
</li>
<li>
<p><code>AND CHAIN</code></p>
<div class="literalblock">
<div class="content">
<pre>如果规定了`AND CHAIN` ，新事务立即启动，具有与刚刚完成的事务相同的事务特征(参见 http://www.postgresql.org/docs/17/sql-set-transaction.html[`SET TRANSACTION`])。否则，不会启动新事务。</pre>
</div>
</div>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="注解"><a class="anchor" href="#注解"></a>5.1.4. 注解</h4>
<div class="paragraph">
<p>使用 <a href="http://www.postgresql.org/docs/17/sql-commit.html"><code>COMMIT</code></a>成功地终止一个事务。</p>
</div>
<div class="paragraph">
<p>在一个事务块之外发出`ABORT`会发出一个警告消息并且不会产生效果。</p>
</div>
</div>
<div class="sect3">