├── .gitignore ├── .nojekyll ├── _images ├── alipay.png ├── pglogo.png └── wechat.png ├── _static ├── ajax-loader.gif ├── background_b01.png ├── basic.css ├── bizstyle.css ├── bizstyle.js ├── comment-bright.png ├── comment-close.png ├── comment.png ├── css3-mediaqueries.js ├── css3-mediaqueries_src.js ├── doctools.js ├── down-pressed.png ├── down.png ├── file.png ├── jquery-1.11.1.js ├── jquery.js ├── minus.png ├── plus.png ├── pygments.css ├── searchtools.js ├── translations.js ├── underscore-1.3.1.js ├── underscore.js ├── up-pressed.png ├── up.png └── websupport.js ├── change_log.html ├── donate.html ├── genindex.html ├── index.html ├── objects.inv ├── preface └── what-is-postgresql.html ├── search.html ├── searchindex.js ├── sponsor.html ├── sql ├── datatype.html ├── ddl.html └── dml.html └── tutorial ├── advanced-features.html ├── getting-started.html └── the-sql-language.html /.gitignore: -------------------------------------------------------------------------------- 1 | _build/ 2 | *.swp 3 | *.pyc 4 | .DS_Store 5 | -------------------------------------------------------------------------------- /.nojekyll: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/.nojekyll -------------------------------------------------------------------------------- /_images/alipay.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_images/alipay.png -------------------------------------------------------------------------------- /_images/pglogo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_images/pglogo.png -------------------------------------------------------------------------------- /_images/wechat.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_images/wechat.png -------------------------------------------------------------------------------- /_static/ajax-loader.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/ajax-loader.gif -------------------------------------------------------------------------------- /_static/background_b01.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/background_b01.png -------------------------------------------------------------------------------- /_static/basic.css: -------------------------------------------------------------------------------- 1 | /* 2 | * basic.css 3 | * ~~~~~~~~~ 4 | * 5 | * Sphinx stylesheet -- basic theme. 6 | * 7 | * :copyright: Copyright 2007-2015 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | /* -- main layout ----------------------------------------------------------- */ 13 | 14 | div.clearer { 15 | clear: both; 16 | } 17 | 18 | /* -- relbar ---------------------------------------------------------------- */ 19 | 20 | div.related { 21 | width: 100%; 22 | font-size: 90%; 23 | } 24 | 25 | div.related h3 { 26 | display: none; 27 | } 28 | 29 | div.related ul { 30 | margin: 0; 31 | padding: 0 0 0 10px; 32 | list-style: none; 33 | } 34 | 35 | div.related li { 36 | display: inline; 37 | } 38 | 39 | div.related li.right { 40 | float: right; 41 | margin-right: 5px; 42 | } 43 | 44 | /* -- sidebar --------------------------------------------------------------- */ 45 | 46 | div.sphinxsidebarwrapper { 47 | padding: 10px 5px 0 10px; 48 | } 49 | 50 | div.sphinxsidebar { 51 | float: left; 52 | width: 230px; 53 | margin-left: -100%; 54 | font-size: 90%; 55 | } 56 | 57 | div.sphinxsidebar ul { 58 | list-style: none; 59 | } 60 | 61 | div.sphinxsidebar ul ul, 62 | div.sphinxsidebar ul.want-points { 63 | margin-left: 20px; 64 | list-style: square; 65 | } 66 | 67 | div.sphinxsidebar ul ul { 68 | margin-top: 0; 69 | margin-bottom: 0; 70 | } 71 | 72 | div.sphinxsidebar form { 73 | margin-top: 10px; 74 | } 75 | 76 | div.sphinxsidebar input { 77 | border: 1px solid #98dbcc; 78 | font-family: sans-serif; 79 | font-size: 1em; 80 | } 81 | 82 | div.sphinxsidebar #searchbox input[type="text"] { 83 | width: 170px; 84 | } 85 | 86 | div.sphinxsidebar #searchbox input[type="submit"] { 87 | width: 30px; 88 | } 89 | 90 | img { 91 | border: 0; 92 | max-width: 100%; 93 | } 94 | 95 | /* -- search page ----------------------------------------------------------- */ 96 | 97 | ul.search { 98 | margin: 10px 0 0 20px; 99 | padding: 0; 100 | } 101 | 102 | ul.search li { 103 | padding: 5px 0 5px 20px; 104 | background-image: url(file.png); 105 | background-repeat: no-repeat; 106 | background-position: 0 7px; 107 | } 108 | 109 | ul.search li a { 110 | font-weight: bold; 111 | } 112 | 113 | ul.search li div.context { 114 | color: #888; 115 | margin: 2px 0 0 30px; 116 | text-align: left; 117 | } 118 | 119 | ul.keywordmatches li.goodmatch a { 120 | font-weight: bold; 121 | } 122 | 123 | /* -- index page ------------------------------------------------------------ */ 124 | 125 | table.contentstable { 126 | width: 90%; 127 | } 128 | 129 | table.contentstable p.biglink { 130 | line-height: 150%; 131 | } 132 | 133 | a.biglink { 134 | font-size: 1.3em; 135 | } 136 | 137 | span.linkdescr { 138 | font-style: italic; 139 | padding-top: 5px; 140 | font-size: 90%; 141 | } 142 | 143 | /* -- general index --------------------------------------------------------- */ 144 | 145 | table.indextable { 146 | width: 100%; 147 | } 148 | 149 | table.indextable td { 150 | text-align: left; 151 | vertical-align: top; 152 | } 153 | 154 | table.indextable dl, table.indextable dd { 155 | margin-top: 0; 156 | margin-bottom: 0; 157 | } 158 | 159 | table.indextable tr.pcap { 160 | height: 10px; 161 | } 162 | 163 | table.indextable tr.cap { 164 | margin-top: 10px; 165 | background-color: #f2f2f2; 166 | } 167 | 168 | img.toggler { 169 | margin-right: 3px; 170 | margin-top: 3px; 171 | cursor: pointer; 172 | } 173 | 174 | div.modindex-jumpbox { 175 | border-top: 1px solid #ddd; 176 | border-bottom: 1px solid #ddd; 177 | margin: 1em 0 1em 0; 178 | padding: 0.4em; 179 | } 180 | 181 | div.genindex-jumpbox { 182 | border-top: 1px solid #ddd; 183 | border-bottom: 1px solid #ddd; 184 | margin: 1em 0 1em 0; 185 | padding: 0.4em; 186 | } 187 | 188 | /* -- general body styles --------------------------------------------------- */ 189 | 190 | a.headerlink { 191 | visibility: hidden; 192 | } 193 | 194 | h1:hover > a.headerlink, 195 | h2:hover > a.headerlink, 196 | h3:hover > a.headerlink, 197 | h4:hover > a.headerlink, 198 | h5:hover > a.headerlink, 199 | h6:hover > a.headerlink, 200 | dt:hover > a.headerlink, 201 | caption:hover > a.headerlink, 202 | p.caption:hover > a.headerlink, 203 | div.code-block-caption:hover > a.headerlink { 204 | visibility: visible; 205 | } 206 | 207 | div.body p.caption { 208 | text-align: inherit; 209 | } 210 | 211 | div.body td { 212 | text-align: left; 213 | } 214 | 215 | .field-list ul { 216 | padding-left: 1em; 217 | } 218 | 219 | .first { 220 | margin-top: 0 !important; 221 | } 222 | 223 | p.rubric { 224 | margin-top: 30px; 225 | font-weight: bold; 226 | } 227 | 228 | img.align-left, .figure.align-left, object.align-left { 229 | clear: left; 230 | float: left; 231 | margin-right: 1em; 232 | } 233 | 234 | img.align-right, .figure.align-right, object.align-right { 235 | clear: right; 236 | float: right; 237 | margin-left: 1em; 238 | } 239 | 240 | img.align-center, .figure.align-center, object.align-center { 241 | display: block; 242 | margin-left: auto; 243 | margin-right: auto; 244 | } 245 | 246 | .align-left { 247 | text-align: left; 248 | } 249 | 250 | .align-center { 251 | text-align: center; 252 | } 253 | 254 | .align-right { 255 | text-align: right; 256 | } 257 | 258 | /* -- sidebars -------------------------------------------------------------- */ 259 | 260 | div.sidebar { 261 | margin: 0 0 0.5em 1em; 262 | border: 1px solid #ddb; 263 | padding: 7px 7px 0 7px; 264 | background-color: #ffe; 265 | width: 40%; 266 | float: right; 267 | } 268 | 269 | p.sidebar-title { 270 | font-weight: bold; 271 | } 272 | 273 | /* -- topics ---------------------------------------------------------------- */ 274 | 275 | div.topic { 276 | border: 1px solid #ccc; 277 | padding: 7px 7px 0 7px; 278 | margin: 10px 0 10px 0; 279 | } 280 | 281 | p.topic-title { 282 | font-size: 1.1em; 283 | font-weight: bold; 284 | margin-top: 10px; 285 | } 286 | 287 | /* -- admonitions ----------------------------------------------------------- */ 288 | 289 | div.admonition { 290 | margin-top: 10px; 291 | margin-bottom: 10px; 292 | padding: 7px; 293 | } 294 | 295 | div.admonition dt { 296 | font-weight: bold; 297 | } 298 | 299 | div.admonition dl { 300 | margin-bottom: 0; 301 | } 302 | 303 | p.admonition-title { 304 | margin: 0px 10px 5px 0px; 305 | font-weight: bold; 306 | } 307 | 308 | div.body p.centered { 309 | text-align: center; 310 | margin-top: 25px; 311 | } 312 | 313 | /* -- tables ---------------------------------------------------------------- */ 314 | 315 | table.docutils { 316 | border: 0; 317 | border-collapse: collapse; 318 | } 319 | 320 | table caption span.caption-number { 321 | font-style: italic; 322 | } 323 | 324 | table caption span.caption-text { 325 | } 326 | 327 | table.docutils td, table.docutils th { 328 | padding: 1px 8px 1px 5px; 329 | border-top: 0; 330 | border-left: 0; 331 | border-right: 0; 332 | border-bottom: 1px solid #aaa; 333 | } 334 | 335 | table.field-list td, table.field-list th { 336 | border: 0 !important; 337 | } 338 | 339 | table.footnote td, table.footnote th { 340 | border: 0 !important; 341 | } 342 | 343 | th { 344 | text-align: left; 345 | padding-right: 5px; 346 | } 347 | 348 | table.citation { 349 | border-left: solid 1px gray; 350 | margin-left: 1px; 351 | } 352 | 353 | table.citation td { 354 | border-bottom: none; 355 | } 356 | 357 | /* -- figures --------------------------------------------------------------- */ 358 | 359 | div.figure { 360 | margin: 0.5em; 361 | padding: 0.5em; 362 | } 363 | 364 | div.figure p.caption { 365 | padding: 0.3em; 366 | } 367 | 368 | div.figure p.caption span.caption-number { 369 | font-style: italic; 370 | } 371 | 372 | div.figure p.caption span.caption-text { 373 | } 374 | 375 | 376 | /* -- other body styles ----------------------------------------------------- */ 377 | 378 | ol.arabic { 379 | list-style: decimal; 380 | } 381 | 382 | ol.loweralpha { 383 | list-style: lower-alpha; 384 | } 385 | 386 | ol.upperalpha { 387 | list-style: upper-alpha; 388 | } 389 | 390 | ol.lowerroman { 391 | list-style: lower-roman; 392 | } 393 | 394 | ol.upperroman { 395 | list-style: upper-roman; 396 | } 397 | 398 | dl { 399 | margin-bottom: 15px; 400 | } 401 | 402 | dd p { 403 | margin-top: 0px; 404 | } 405 | 406 | dd ul, dd table { 407 | margin-bottom: 10px; 408 | } 409 | 410 | dd { 411 | margin-top: 3px; 412 | margin-bottom: 10px; 413 | margin-left: 30px; 414 | } 415 | 416 | dt:target, .highlighted { 417 | background-color: #fbe54e; 418 | } 419 | 420 | dl.glossary dt { 421 | font-weight: bold; 422 | font-size: 1.1em; 423 | } 424 | 425 | .field-list ul { 426 | margin: 0; 427 | padding-left: 1em; 428 | } 429 | 430 | .field-list p { 431 | margin: 0; 432 | } 433 | 434 | .optional { 435 | font-size: 1.3em; 436 | } 437 | 438 | .sig-paren { 439 | font-size: larger; 440 | } 441 | 442 | .versionmodified { 443 | font-style: italic; 444 | } 445 | 446 | .system-message { 447 | background-color: #fda; 448 | padding: 5px; 449 | border: 3px solid red; 450 | } 451 | 452 | .footnote:target { 453 | background-color: #ffa; 454 | } 455 | 456 | .line-block { 457 | display: block; 458 | margin-top: 1em; 459 | margin-bottom: 1em; 460 | } 461 | 462 | .line-block .line-block { 463 | margin-top: 0; 464 | margin-bottom: 0; 465 | margin-left: 1.5em; 466 | } 467 | 468 | .guilabel, .menuselection { 469 | font-family: sans-serif; 470 | } 471 | 472 | .accelerator { 473 | text-decoration: underline; 474 | } 475 | 476 | .classifier { 477 | font-style: oblique; 478 | } 479 | 480 | abbr, acronym { 481 | border-bottom: dotted 1px; 482 | cursor: help; 483 | } 484 | 485 | /* -- code displays --------------------------------------------------------- */ 486 | 487 | pre { 488 | overflow: auto; 489 | overflow-y: hidden; /* fixes display issues on Chrome browsers */ 490 | } 491 | 492 | td.linenos pre { 493 | padding: 5px 0px; 494 | border: 0; 495 | background-color: transparent; 496 | color: #aaa; 497 | } 498 | 499 | table.highlighttable { 500 | margin-left: 0.5em; 501 | } 502 | 503 | table.highlighttable td { 504 | padding: 0 0.5em 0 0.5em; 505 | } 506 | 507 | div.code-block-caption { 508 | padding: 2px 5px; 509 | font-size: small; 510 | } 511 | 512 | div.code-block-caption code { 513 | background-color: transparent; 514 | } 515 | 516 | div.code-block-caption + div > div.highlight > pre { 517 | margin-top: 0; 518 | } 519 | 520 | div.code-block-caption span.caption-number { 521 | padding: 0.1em 0.3em; 522 | font-style: italic; 523 | } 524 | 525 | div.code-block-caption span.caption-text { 526 | } 527 | 528 | div.literal-block-wrapper { 529 | padding: 1em 1em 0; 530 | } 531 | 532 | div.literal-block-wrapper div.highlight { 533 | margin: 0; 534 | } 535 | 536 | code.descname { 537 | background-color: transparent; 538 | font-weight: bold; 539 | font-size: 1.2em; 540 | } 541 | 542 | code.descclassname { 543 | background-color: transparent; 544 | } 545 | 546 | code.xref, a code { 547 | background-color: transparent; 548 | font-weight: bold; 549 | } 550 | 551 | h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { 552 | background-color: transparent; 553 | } 554 | 555 | .viewcode-link { 556 | float: right; 557 | } 558 | 559 | .viewcode-back { 560 | float: right; 561 | font-family: sans-serif; 562 | } 563 | 564 | div.viewcode-block:target { 565 | margin: -1px -10px; 566 | padding: 0 10px; 567 | } 568 | 569 | /* -- math display ---------------------------------------------------------- */ 570 | 571 | img.math { 572 | vertical-align: middle; 573 | } 574 | 575 | div.body div.math p { 576 | text-align: center; 577 | } 578 | 579 | span.eqno { 580 | float: right; 581 | } 582 | 583 | /* -- printout stylesheet --------------------------------------------------- */ 584 | 585 | @media print { 586 | div.document, 587 | div.documentwrapper, 588 | div.bodywrapper { 589 | margin: 0 !important; 590 | width: 100%; 591 | } 592 | 593 | div.sphinxsidebar, 594 | div.related, 595 | div.footer, 596 | #top-link { 597 | display: none; 598 | } 599 | } -------------------------------------------------------------------------------- /_static/bizstyle.css: -------------------------------------------------------------------------------- 1 | /* 2 | * bizstyle.css_t 3 | * ~~~~~~~~~~~~~~ 4 | * 5 | * Sphinx stylesheet -- business style theme. 6 | * 7 | * :copyright: Copyright 2011-2014 by Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | @import url("basic.css"); 13 | 14 | /* -- page layout ----------------------------------------------------------- */ 15 | 16 | body { 17 | font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 18 | 'Verdana', sans-serif; 19 | font-size: 14px; 20 | letter-spacing: -0.01em; 21 | line-height: 150%; 22 | text-align: center; 23 | background-color: white; 24 | background-image: url(background_b01.png); 25 | color: black; 26 | padding: 0; 27 | border-right: 1px solid #336699; 28 | border-left: 1px solid #336699; 29 | 30 | margin: 0px 40px 0px 40px; 31 | } 32 | 33 | div.document { 34 | background-color: white; 35 | text-align: left; 36 | background-repeat: repeat-x; 37 | 38 | -moz-box-shadow: 2px 2px 5px #000; 39 | -webkit-box-shadow: 2px 2px 5px #000; 40 | } 41 | 42 | div.bodywrapper { 43 | margin: 0 0 0 240px; 44 | border-left: 1px solid #ccc; 45 | } 46 | 47 | div.body { 48 | margin: 0; 49 | padding: 0.5em 20px 20px 20px; 50 | } 51 | 52 | div.related { 53 | font-size: 1em; 54 | 55 | -moz-box-shadow: 2px 2px 5px #000; 56 | -webkit-box-shadow: 2px 2px 5px #000; 57 | } 58 | 59 | div.related ul { 60 | background-color: #336699; 61 | height: 100%; 62 | overflow: hidden; 63 | border-top: 1px solid #ddd; 64 | border-bottom: 1px solid #ddd; 65 | } 66 | 67 | div.related ul li { 68 | color: white; 69 | margin: 0; 70 | padding: 0; 71 | height: 2em; 72 | float: left; 73 | } 74 | 75 | div.related ul li.right { 76 | float: right; 77 | margin-right: 5px; 78 | } 79 | 80 | div.related ul li a { 81 | margin: 0; 82 | padding: 0 5px 0 5px; 83 | line-height: 1.75em; 84 | color: #fff; 85 | } 86 | 87 | div.related ul li a:hover { 88 | color: #fff; 89 | text-decoration: underline; 90 | } 91 | 92 | div.sphinxsidebarwrapper { 93 | padding: 0; 94 | } 95 | 96 | div.sphinxsidebar { 97 | margin: 0; 98 | padding: 0.5em 12px 12px 12px; 99 | width: 210px; 100 | font-size: 1em; 101 | text-align: left; 102 | } 103 | 104 | div.sphinxsidebar h3, div.sphinxsidebar h4 { 105 | margin: 1em 0 0.5em 0; 106 | font-size: 1em; 107 | padding: 0.1em 0 0.1em 0.5em; 108 | color: white; 109 | border: 1px solid #336699; 110 | background-color: #336699; 111 | } 112 | 113 | div.sphinxsidebar h3 a { 114 | color: white; 115 | } 116 | 117 | div.sphinxsidebar ul { 118 | padding-left: 1.5em; 119 | margin-top: 7px; 120 | padding: 0; 121 | line-height: 130%; 122 | } 123 | 124 | div.sphinxsidebar ul ul { 125 | margin-left: 20px; 126 | } 127 | 128 | div.sphinxsidebar input { 129 | border: 1px solid #336699; 130 | } 131 | 132 | div.footer { 133 | background-color: white; 134 | color: #336699; 135 | padding: 3px 8px 3px 0; 136 | clear: both; 137 | font-size: 0.8em; 138 | text-align: right; 139 | border-bottom: 1px solid #336699; 140 | 141 | -moz-box-shadow: 2px 2px 5px #000; 142 | -webkit-box-shadow: 2px 2px 5px #000; 143 | } 144 | 145 | div.footer a { 146 | color: #336699; 147 | text-decoration: underline; 148 | } 149 | 150 | /* -- body styles ----------------------------------------------------------- */ 151 | 152 | p { 153 | margin: 0.8em 0 0.5em 0; 154 | } 155 | 156 | a { 157 | color: #336699; 158 | text-decoration: none; 159 | } 160 | 161 | a:hover { 162 | color: #336699; 163 | text-decoration: underline; 164 | } 165 | 166 | div.body a { 167 | text-decoration: underline; 168 | } 169 | 170 | h1, h2, h3 { 171 | color: #336699; 172 | } 173 | 174 | h1 { 175 | margin: 0; 176 | padding: 0.7em 0 0.3em 0; 177 | font-size: 1.5em; 178 | } 179 | 180 | h2 { 181 | margin: 1.3em 0 0.2em 0; 182 | font-size: 1.35em; 183 | padding-bottom: .5em; 184 | border-bottom: 1px solid #336699; 185 | } 186 | 187 | h3 { 188 | margin: 1em 0 -0.3em 0; 189 | font-size: 1.2em; 190 | padding-bottom: .3em; 191 | border-bottom: 1px solid #CCCCCC; 192 | } 193 | 194 | div.body h1 a, div.body h2 a, div.body h3 a, 195 | div.body h4 a, div.body h5 a, div.body h6 a { 196 | color: black!important; 197 | } 198 | 199 | h1 a.anchor, h2 a.anchor, h3 a.anchor, 200 | h4 a.anchor, h5 a.anchor, h6 a.anchor { 201 | display: none; 202 | margin: 0 0 0 0.3em; 203 | padding: 0 0.2em 0 0.2em; 204 | color: #aaa!important; 205 | } 206 | 207 | h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, 208 | h5:hover a.anchor, h6:hover a.anchor { 209 | display: inline; 210 | } 211 | 212 | h1 a.anchor:hover, h2 a.anchor:hover, h3 a.anchor:hover, h4 a.anchor:hover, 213 | h5 a.anchor:hover, h6 a.anchor:hover { 214 | color: #777; 215 | background-color: #eee; 216 | } 217 | 218 | a.headerlink { 219 | color: #c60f0f!important; 220 | font-size: 1em; 221 | margin-left: 6px; 222 | padding: 0 4px 0 4px; 223 | text-decoration: none!important; 224 | } 225 | 226 | a.headerlink:hover { 227 | background-color: #ccc; 228 | color: white!important; 229 | } 230 | 231 | cite, code, tt { 232 | font-family: 'Consolas', 'Deja Vu Sans Mono', 233 | 'Bitstream Vera Sans Mono', monospace; 234 | font-size: 0.95em; 235 | letter-spacing: 0.01em; 236 | } 237 | 238 | code { 239 | background-color: #F2F2F2; 240 | border-bottom: 1px solid #ddd; 241 | color: #333; 242 | } 243 | 244 | code.descname, code.descclassname, code.xref { 245 | border: 0; 246 | } 247 | 248 | hr { 249 | border: 1px solid #abc; 250 | margin: 2em; 251 | } 252 | 253 | a code { 254 | border: 0; 255 | color: #CA7900; 256 | } 257 | 258 | a code:hover { 259 | color: #2491CF; 260 | } 261 | 262 | pre { 263 | background-color: transparent !important; 264 | font-family: 'Consolas', 'Deja Vu Sans Mono', 265 | 'Bitstream Vera Sans Mono', monospace; 266 | font-size: 0.95em; 267 | letter-spacing: 0.015em; 268 | line-height: 120%; 269 | padding: 0.5em; 270 | border-right: 5px solid #ccc; 271 | border-left: 5px solid #ccc; 272 | } 273 | 274 | pre a { 275 | color: inherit; 276 | text-decoration: underline; 277 | } 278 | 279 | td.linenos pre { 280 | padding: 0.5em 0; 281 | } 282 | 283 | div.quotebar { 284 | background-color: #f8f8f8; 285 | max-width: 250px; 286 | float: right; 287 | padding: 2px 7px; 288 | border: 1px solid #ccc; 289 | } 290 | 291 | div.topic { 292 | background-color: #f8f8f8; 293 | } 294 | 295 | table { 296 | border-collapse: collapse; 297 | margin: 0 -0.5em 0 -0.5em; 298 | } 299 | 300 | table td, table th { 301 | padding: 0.2em 0.5em 0.2em 0.5em; 302 | } 303 | 304 | div.admonition { 305 | font-size: 0.9em; 306 | margin: 1em 0 1em 0; 307 | border: 3px solid #cccccc; 308 | background-color: #f7f7f7; 309 | padding: 0; 310 | } 311 | 312 | div.admonition p { 313 | margin: 0.5em 1em 0.5em 1em; 314 | padding: 0; 315 | } 316 | 317 | div.admonition li p { 318 | margin-left: 0; 319 | } 320 | 321 | div.admonition pre, div.warning pre { 322 | margin: 0; 323 | } 324 | 325 | div.highlight { 326 | margin: 0.4em 1em; 327 | } 328 | 329 | div.admonition p.admonition-title { 330 | margin: 0; 331 | padding: 0.1em 0 0.1em 0.5em; 332 | color: white; 333 | border-bottom: 3px solid #cccccc; 334 | font-weight: bold; 335 | background-color: #165e83; 336 | } 337 | 338 | div.danger { border: 3px solid #f0908d; background-color: #f0cfa0; } 339 | div.error { border: 3px solid #f0908d; background-color: #ede4cd; } 340 | div.warning { border: 3px solid #f8b862; background-color: #f0cfa0; } 341 | div.caution { border: 3px solid #f8b862; background-color: #ede4cd; } 342 | div.attention { border: 3px solid #f8b862; background-color: #f3f3f3; } 343 | div.important { border: 3px solid #f0cfa0; background-color: #ede4cd; } 344 | div.note { border: 3px solid #f0cfa0; background-color: #f3f3f3; } 345 | div.hint { border: 3px solid #bed2c3; background-color: #f3f3f3; } 346 | div.tip { border: 3px solid #bed2c3; background-color: #f3f3f3; } 347 | 348 | div.danger p.admonition-title, div.error p.admonition-title { 349 | background-color: #b7282e; 350 | border-bottom: 3px solid #f0908d; 351 | } 352 | 353 | div.caution p.admonition-title, 354 | div.warning p.admonition-title, 355 | div.attention p.admonition-title { 356 | background-color: #f19072; 357 | border-bottom: 3px solid #f8b862; 358 | } 359 | 360 | div.note p.admonition-title, div.important p.admonition-title { 361 | background-color: #f8b862; 362 | border-bottom: 3px solid #f0cfa0; 363 | } 364 | 365 | div.hint p.admonition-title, div.tip p.admonition-title { 366 | background-color: #7ebea5; 367 | border-bottom: 3px solid #bed2c3; 368 | } 369 | 370 | div.admonition ul, div.admonition ol, 371 | div.warning ul, div.warning ol { 372 | margin: 0.1em 0.5em 0.5em 3em; 373 | padding: 0; 374 | } 375 | 376 | div.versioninfo { 377 | margin: 1em 0 0 0; 378 | border: 1px solid #ccc; 379 | background-color: #DDEAF0; 380 | padding: 8px; 381 | line-height: 1.3em; 382 | font-size: 0.9em; 383 | } 384 | 385 | .viewcode-back { 386 | font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 387 | 'Verdana', sans-serif; 388 | } 389 | 390 | div.viewcode-block:target { 391 | background-color: #f4debf; 392 | border-top: 1px solid #ac9; 393 | border-bottom: 1px solid #ac9; 394 | } 395 | 396 | p.versionchanged span.versionmodified { 397 | font-size: 0.9em; 398 | margin-right: 0.2em; 399 | padding: 0.1em; 400 | background-color: #DCE6A0; 401 | } 402 | 403 | /* -- table styles ---------------------------------------------------------- */ 404 | 405 | table.docutils { 406 | margin: 1em 0; 407 | padding: 0; 408 | border: 1px solid white; 409 | background-color: #f7f7f7; 410 | } 411 | 412 | table.docutils td, table.docutils th { 413 | padding: 1px 8px 1px 5px; 414 | border-top: 0; 415 | border-left: 0; 416 | border-right: 1px solid white; 417 | border-bottom: 1px solid white; 418 | } 419 | 420 | table.docutils td p { 421 | margin-top: 0; 422 | margin-bottom: 0.3em; 423 | } 424 | 425 | table.field-list td, table.field-list th { 426 | border: 0 !important; 427 | word-break: break-word; 428 | } 429 | 430 | table.footnote td, table.footnote th { 431 | border: 0 !important; 432 | } 433 | 434 | th { 435 | color: white; 436 | text-align: left; 437 | padding-right: 5px; 438 | background-color: #82A0BE; 439 | } 440 | 441 | div.literal-block-wrapper div.code-block-caption { 442 | background-color: #EEE; 443 | border-style: solid; 444 | border-color: #CCC; 445 | border-width: 1px 5px; 446 | } 447 | 448 | /* WIDE DESKTOP STYLE */ 449 | @media only screen and (min-width: 1176px) { 450 | body { 451 | margin: 0 40px 0 40px; 452 | } 453 | } 454 | 455 | /* TABLET STYLE */ 456 | @media only screen and (min-width: 768px) and (max-width: 991px) { 457 | body { 458 | margin: 0 40px 0 40px; 459 | } 460 | } 461 | 462 | /* MOBILE LAYOUT (PORTRAIT/320px) */ 463 | @media only screen and (max-width: 767px) { 464 | body { 465 | margin: 0; 466 | } 467 | div.bodywrapper { 468 | margin: 0; 469 | width: 100%; 470 | border: none; 471 | } 472 | div.sphinxsidebar { 473 | display: none; 474 | } 475 | } 476 | 477 | /* MOBILE LAYOUT (LANDSCAPE/480px) */ 478 | @media only screen and (min-width: 480px) and (max-width: 767px) { 479 | body { 480 | margin: 0 20px 0 20px; 481 | } 482 | } 483 | 484 | /* RETINA OVERRIDES */ 485 | @media 486 | only screen and (-webkit-min-device-pixel-ratio: 2), 487 | only screen and (min-device-pixel-ratio: 2) { 488 | } 489 | 490 | /* -- end ------------------------------------------------------------------- */ -------------------------------------------------------------------------------- /_static/bizstyle.js: -------------------------------------------------------------------------------- 1 | // 2 | // bizstyle.js 3 | // ~~~~~~~~~~~ 4 | // 5 | // Sphinx javascript -- for bizstyle theme. 6 | // 7 | // This theme was created by referring to 'sphinxdoc' 8 | // 9 | // :copyright: Copyright 2012-2014 by Sphinx team, see AUTHORS. 10 | // :license: BSD, see LICENSE for details. 11 | // 12 | $(document).ready(function(){ 13 | if (navigator.userAgent.indexOf('iPhone') > 0 || 14 | navigator.userAgent.indexOf('Android') > 0) { 15 | $("li.nav-item-0 a").text("Top"); 16 | } 17 | 18 | $("div.related:first ul li:not(.right) a").slice(1).each(function(i, item){ 19 | if (item.text.length > 20) { 20 | var tmpstr = item.text 21 | $(item).attr("title", tmpstr); 22 | $(item).text(tmpstr.substr(0, 17) + "..."); 23 | } 24 | }); 25 | $("div.related:last ul li:not(.right) a").slice(1).each(function(i, item){ 26 | if (item.text.length > 20) { 27 | var tmpstr = item.text 28 | $(item).attr("title", tmpstr); 29 | $(item).text(tmpstr.substr(0, 17) + "..."); 30 | } 31 | }); 32 | }); 33 | 34 | $(window).resize(function(){ 35 | if ($(window).width() <= 776) { 36 | $("li.nav-item-0 a").text("Top"); 37 | } 38 | else { 39 | $("li.nav-item-0 a").text("PostgreSQL 数据库文档"); 40 | } 41 | }); -------------------------------------------------------------------------------- /_static/comment-bright.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/comment-bright.png -------------------------------------------------------------------------------- /_static/comment-close.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/comment-close.png -------------------------------------------------------------------------------- /_static/comment.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/comment.png -------------------------------------------------------------------------------- /_static/css3-mediaqueries.js: -------------------------------------------------------------------------------- 1 | if(typeof Object.create!=="function"){Object.create=function(e){function t(){}t.prototype=e;return new t}}var ua={toString:function(){return navigator.userAgent},test:function(e){return this.toString().toLowerCase().indexOf(e.toLowerCase())>-1}};ua.version=(ua.toString().toLowerCase().match(/[\s\S]+(?:rv|it|ra|ie)[\/: ]([\d.]+)/)||[])[1];ua.webkit=ua.test("webkit");ua.gecko=ua.test("gecko")&&!ua.webkit;ua.opera=ua.test("opera");ua.ie=ua.test("msie")&&!ua.opera;ua.ie6=ua.ie&&document.compatMode&&typeof document.documentElement.style.maxHeight==="undefined";ua.ie7=ua.ie&&document.documentElement&&typeof document.documentElement.style.maxHeight!=="undefined"&&typeof XDomainRequest==="undefined";ua.ie8=ua.ie&&typeof XDomainRequest!=="undefined";var domReady=function(){var e=[];var t=function(){if(!arguments.callee.done){arguments.callee.done=true;for(var t=0;t=200&&r.status<300||r.status===304||navigator.userAgent.indexOf("Safari")>-1&&typeof r.status==="undefined"){t(r.responseText)}else{n()}document.documentElement.style.cursor="";r=null}};r.send("")};var l=function(t){t=t.replace(e.REDUNDANT_COMPONENTS,"");t=t.replace(e.REDUNDANT_WHITESPACE,"$1");t=t.replace(e.WHITESPACE_IN_PARENTHESES,"($1)");t=t.replace(e.MORE_WHITESPACE," ");t=t.replace(e.FINAL_SEMICOLONS,"}");return t};var c={stylesheet:function(t){var n={};var r=[],i=[],s=[],o=[];var u=t.cssHelperText;var a=t.getAttribute("media");if(a){var f=a.toLowerCase().split(",")}else{var f=["all"]}for(var l=0;l-1&&a.href&&a.href.length!==0&&!a.disabled){r[r.length]=a}}if(r.length>0){var c=0;var d=function(){c++;if(c===r.length){i()}};var v=function(t){var n=t.href;f(n,function(r){r=l(r).replace(e.RELATIVE_URLS,"url("+n.substring(0,n.lastIndexOf("/"))+"/$1)");t.cssHelperText=r;d()},d)};for(u=0;u0){r.setAttribute("media",t.join(","))}document.getElementsByTagName("head")[0].appendChild(r);if(r.styleSheet){r.styleSheet.cssText=e}else{r.appendChild(document.createTextNode(e))}r.addedWithCssHelper=true;if(typeof n==="undefined"||n===true){cssHelper.parsed(function(t){var n=p(r,e);for(var i in n){if(n.hasOwnProperty(i)){g(i,n[i])}}a("newStyleParsed",r)})}else{r.parsingDisallowed=true}return r},removeStyle:function(e){return e.parentNode.removeChild(e)},parsed:function(e){if(n){s(e)}else{if(typeof t!=="undefined"){if(typeof e==="function"){e(t)}}else{s(e);d()}}},stylesheets:function(e){cssHelper.parsed(function(t){e(m.stylesheets||y("stylesheets"))})},mediaQueryLists:function(e){cssHelper.parsed(function(t){e(m.mediaQueryLists||y("mediaQueryLists"))})},rules:function(e){cssHelper.parsed(function(t){e(m.rules||y("rules"))})},selectors:function(e){cssHelper.parsed(function(t){e(m.selectors||y("selectors"))})},declarations:function(e){cssHelper.parsed(function(t){e(m.declarations||y("declarations"))})},properties:function(e){cssHelper.parsed(function(t){e(m.properties||y("properties"))})},broadcast:a,addListener:function(e,t){if(typeof t==="function"){if(!u[e]){u[e]={listeners:[]}}u[e].listeners[u[e].listeners.length]=t}},removeListener:function(e,t){if(typeof t==="function"&&u[e]){var n=u[e].listeners;for(var r=0;r=a||s&&l0}}else if("device-height"===e.substring(r-13,r)){c=screen.height;if(t!==null){if(u==="length"){return i&&c>=a||s&&c0}}else if("width"===e.substring(r-5,r)){l=document.documentElement.clientWidth||document.body.clientWidth;if(t!==null){if(u==="length"){return i&&l>=a||s&&l0}}else if("height"===e.substring(r-6,r)){c=document.documentElement.clientHeight||document.body.clientHeight;if(t!==null){if(u==="length"){return i&&c>=a||s&&c0}}else if("device-aspect-ratio"===e.substring(r-19,r)){return u==="aspect-ratio"&&screen.width*a[1]===screen.height*a[0]}else if("color-index"===e.substring(r-11,r)){var h=Math.pow(2,screen.colorDepth);if(t!==null){if(u==="absolute"){return i&&h>=a||s&&h0}}else if("color"===e.substring(r-5,r)){var p=screen.colorDepth;if(t!==null){if(u==="absolute"){return i&&p>=a||s&&p0}}else if("resolution"===e.substring(r-10,r)){var d;if(f==="dpcm"){d=o("1cm")}else{d=o("1in")}if(t!==null){if(u==="resolution"){return i&&d>=a||s&&d0}}else{return false}};var a=function(e){var t=e.getValid();var n=e.getExpressions();var r=n.length;if(r>0){for(var i=0;i0){u=false;for(var f=0;f0){l[c++]=","}l[c++]=h}}if(l.length>0){r[r.length]=cssHelper.addStyle("@media "+l.join("")+"{"+e.getCssText()+"}",t,false)}};var l=function(e,t){for(var n=0;n0}}var o=[],u=[];for(var f in i){if(i.hasOwnProperty(f)){o[o.length]=f;if(i[f]){u[u.length]=f}if(f==="all"){n=true}}}if(u.length>0){r[r.length]=cssHelper.addStyle(e.getCssText(),u,false)}var c=e.getMediaQueryLists();if(n){l(c)}else{l(c,o)}};var h=function(e){for(var t=0;td||Math.abs(s-t)>d){e=n;t=s;clearTimeout(r);r=setTimeout(function(){if(!i()){p()}else{cssHelper.broadcast("cssMediaQueriesTested")}},500)}};window.onresize=function(){var e=window.onresize||function(){};return function(){e();s()}}()};var m=document.documentElement;m.style.marginLeft="-32767px";setTimeout(function(){m.style.marginLeft=""},5e3);return function(){if(!i()){cssHelper.addListener("newStyleParsed",function(e){c(e.cssHelperParsed.stylesheet)});cssHelper.addListener("cssMediaQueriesTested",function(){if(ua.ie){m.style.width="1px"}setTimeout(function(){m.style.width="";m.style.marginLeft=""},0);cssHelper.removeListener("cssMediaQueriesTested",arguments.callee)});s();p()}else{m.style.marginLeft=""}v()}}());try{document.execCommand("BackgroundImageCache",false,true)}catch(e){} -------------------------------------------------------------------------------- /_static/doctools.js: -------------------------------------------------------------------------------- 1 | /* 2 | * doctools.js 3 | * ~~~~~~~~~~~ 4 | * 5 | * Sphinx JavaScript utilities for all documentation. 6 | * 7 | * :copyright: Copyright 2007-2015 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | /** 13 | * select a different prefix for underscore 14 | */ 15 | $u = _.noConflict(); 16 | 17 | /** 18 | * make the code below compatible with browsers without 19 | * an installed firebug like debugger 20 | if (!window.console || !console.firebug) { 21 | var names = ["log", "debug", "info", "warn", "error", "assert", "dir", 22 | "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", 23 | "profile", "profileEnd"]; 24 | window.console = {}; 25 | for (var i = 0; i < names.length; ++i) 26 | window.console[names[i]] = function() {}; 27 | } 28 | */ 29 | 30 | /** 31 | * small helper function to urldecode strings 32 | */ 33 | jQuery.urldecode = function(x) { 34 | return decodeURIComponent(x).replace(/\+/g, ' '); 35 | }; 36 | 37 | /** 38 | * small helper function to urlencode strings 39 | */ 40 | jQuery.urlencode = encodeURIComponent; 41 | 42 | /** 43 | * This function returns the parsed url parameters of the 44 | * current request. Multiple values per key are supported, 45 | * it will always return arrays of strings for the value parts. 46 | */ 47 | jQuery.getQueryParameters = function(s) { 48 | if (typeof s == 'undefined') 49 | s = document.location.search; 50 | var parts = s.substr(s.indexOf('?') + 1).split('&'); 51 | var result = {}; 52 | for (var i = 0; i < parts.length; i++) { 53 | var tmp = parts[i].split('=', 2); 54 | var key = jQuery.urldecode(tmp[0]); 55 | var value = jQuery.urldecode(tmp[1]); 56 | if (key in result) 57 | result[key].push(value); 58 | else 59 | result[key] = [value]; 60 | } 61 | return result; 62 | }; 63 | 64 | /** 65 | * highlight a given string on a jquery object by wrapping it in 66 | * span elements with the given class name. 67 | */ 68 | jQuery.fn.highlightText = function(text, className) { 69 | function highlight(node) { 70 | if (node.nodeType == 3) { 71 | var val = node.nodeValue; 72 | var pos = val.toLowerCase().indexOf(text); 73 | if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { 74 | var span = document.createElement("span"); 75 | span.className = className; 76 | span.appendChild(document.createTextNode(val.substr(pos, text.length))); 77 | node.parentNode.insertBefore(span, node.parentNode.insertBefore( 78 | document.createTextNode(val.substr(pos + text.length)), 79 | node.nextSibling)); 80 | node.nodeValue = val.substr(0, pos); 81 | } 82 | } 83 | else if (!jQuery(node).is("button, select, textarea")) { 84 | jQuery.each(node.childNodes, function() { 85 | highlight(this); 86 | }); 87 | } 88 | } 89 | return this.each(function() { 90 | highlight(this); 91 | }); 92 | }; 93 | 94 | /* 95 | * backward compatibility for jQuery.browser 96 | * This will be supported until firefox bug is fixed. 97 | */ 98 | if (!jQuery.browser) { 99 | jQuery.uaMatch = function(ua) { 100 | ua = ua.toLowerCase(); 101 | 102 | var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || 103 | /(webkit)[ \/]([\w.]+)/.exec(ua) || 104 | /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || 105 | /(msie) ([\w.]+)/.exec(ua) || 106 | ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || 107 | []; 108 | 109 | return { 110 | browser: match[ 1 ] || "", 111 | version: match[ 2 ] || "0" 112 | }; 113 | }; 114 | jQuery.browser = {}; 115 | jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; 116 | } 117 | 118 | /** 119 | * Small JavaScript module for the documentation. 120 | */ 121 | var Documentation = { 122 | 123 | init : function() { 124 | this.fixFirefoxAnchorBug(); 125 | this.highlightSearchWords(); 126 | this.initIndexTable(); 127 | }, 128 | 129 | /** 130 | * i18n support 131 | */ 132 | TRANSLATIONS : {}, 133 | PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, 134 | LOCALE : 'unknown', 135 | 136 | // gettext and ngettext don't access this so that the functions 137 | // can safely bound to a different name (_ = Documentation.gettext) 138 | gettext : function(string) { 139 | var translated = Documentation.TRANSLATIONS[string]; 140 | if (typeof translated == 'undefined') 141 | return string; 142 | return (typeof translated == 'string') ? translated : translated[0]; 143 | }, 144 | 145 | ngettext : function(singular, plural, n) { 146 | var translated = Documentation.TRANSLATIONS[singular]; 147 | if (typeof translated == 'undefined') 148 | return (n == 1) ? singular : plural; 149 | return translated[Documentation.PLURALEXPR(n)]; 150 | }, 151 | 152 | addTranslations : function(catalog) { 153 | for (var key in catalog.messages) 154 | this.TRANSLATIONS[key] = catalog.messages[key]; 155 | this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); 156 | this.LOCALE = catalog.locale; 157 | }, 158 | 159 | /** 160 | * add context elements like header anchor links 161 | */ 162 | addContextElements : function() { 163 | $('div[id] > :header:first').each(function() { 164 | $('\u00B6'). 165 | attr('href', '#' + this.id). 166 | attr('title', _('Permalink to this headline')). 167 | appendTo(this); 168 | }); 169 | $('dt[id]').each(function() { 170 | $('\u00B6'). 171 | attr('href', '#' + this.id). 172 | attr('title', _('Permalink to this definition')). 173 | appendTo(this); 174 | }); 175 | }, 176 | 177 | /** 178 | * workaround a firefox stupidity 179 | * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 180 | */ 181 | fixFirefoxAnchorBug : function() { 182 | if (document.location.hash) 183 | window.setTimeout(function() { 184 | document.location.href += ''; 185 | }, 10); 186 | }, 187 | 188 | /** 189 | * highlight the search words provided in the url in the text 190 | */ 191 | highlightSearchWords : function() { 192 | var params = $.getQueryParameters(); 193 | var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; 194 | if (terms.length) { 195 | var body = $('div.body'); 196 | if (!body.length) { 197 | body = $('body'); 198 | } 199 | window.setTimeout(function() { 200 | $.each(terms, function() { 201 | body.highlightText(this.toLowerCase(), 'highlighted'); 202 | }); 203 | }, 10); 204 | $('

' + _('Hide Search Matches') + '

') 206 | .appendTo($('#searchbox')); 207 | } 208 | }, 209 | 210 | /** 211 | * init the domain index toggle buttons 212 | */ 213 | initIndexTable : function() { 214 | var togglers = $('img.toggler').click(function() { 215 | var src = $(this).attr('src'); 216 | var idnum = $(this).attr('id').substr(7); 217 | $('tr.cg-' + idnum).toggle(); 218 | if (src.substr(-9) == 'minus.png') 219 | $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); 220 | else 221 | $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); 222 | }).css('display', ''); 223 | if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { 224 | togglers.click(); 225 | } 226 | }, 227 | 228 | /** 229 | * helper function to hide the search marks again 230 | */ 231 | hideSearchWords : function() { 232 | $('#searchbox .highlight-link').fadeOut(300); 233 | $('span.highlighted').removeClass('highlighted'); 234 | }, 235 | 236 | /** 237 | * make the url absolute 238 | */ 239 | makeURL : function(relativeURL) { 240 | return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; 241 | }, 242 | 243 | /** 244 | * get the current relative url 245 | */ 246 | getCurrentURL : function() { 247 | var path = document.location.pathname; 248 | var parts = path.split(/\//); 249 | $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { 250 | if (this == '..') 251 | parts.pop(); 252 | }); 253 | var url = parts.join('/'); 254 | return path.substring(url.lastIndexOf('/') + 1, path.length - 1); 255 | } 256 | }; 257 | 258 | // quick alias for translations 259 | _ = Documentation.gettext; 260 | 261 | $(document).ready(function() { 262 | Documentation.init(); 263 | }); 264 | -------------------------------------------------------------------------------- /_static/down-pressed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/down-pressed.png -------------------------------------------------------------------------------- /_static/down.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/down.png -------------------------------------------------------------------------------- /_static/file.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/file.png -------------------------------------------------------------------------------- /_static/minus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/minus.png -------------------------------------------------------------------------------- /_static/plus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/plus.png -------------------------------------------------------------------------------- /_static/pygments.css: -------------------------------------------------------------------------------- 1 | .highlight .hll { background-color: #ffffcc } 2 | .highlight { background: #eeffcc; } 3 | .highlight .c { color: #408090; font-style: italic } /* Comment */ 4 | .highlight .err { border: 1px solid #FF0000 } /* Error */ 5 | .highlight .k { color: #007020; font-weight: bold } /* Keyword */ 6 | .highlight .o { color: #666666 } /* Operator */ 7 | .highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ 8 | .highlight .cp { color: #007020 } /* Comment.Preproc */ 9 | .highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ 10 | .highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ 11 | .highlight .gd { color: #A00000 } /* Generic.Deleted */ 12 | .highlight .ge { font-style: italic } /* Generic.Emph */ 13 | .highlight .gr { color: #FF0000 } /* Generic.Error */ 14 | .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ 15 | .highlight .gi { color: #00A000 } /* Generic.Inserted */ 16 | .highlight .go { color: #333333 } /* Generic.Output */ 17 | .highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ 18 | .highlight .gs { font-weight: bold } /* Generic.Strong */ 19 | .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ 20 | .highlight .gt { color: #0044DD } /* Generic.Traceback */ 21 | .highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ 22 | .highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ 23 | .highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ 24 | .highlight .kp { color: #007020 } /* Keyword.Pseudo */ 25 | .highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ 26 | .highlight .kt { color: #902000 } /* Keyword.Type */ 27 | .highlight .m { color: #208050 } /* Literal.Number */ 28 | .highlight .s { color: #4070a0 } /* Literal.String */ 29 | .highlight .na { color: #4070a0 } /* Name.Attribute */ 30 | .highlight .nb { color: #007020 } /* Name.Builtin */ 31 | .highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ 32 | .highlight .no { color: #60add5 } /* Name.Constant */ 33 | .highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ 34 | .highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ 35 | .highlight .ne { color: #007020 } /* Name.Exception */ 36 | .highlight .nf { color: #06287e } /* Name.Function */ 37 | .highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ 38 | .highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ 39 | .highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ 40 | .highlight .nv { color: #bb60d5 } /* Name.Variable */ 41 | .highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ 42 | .highlight .w { color: #bbbbbb } /* Text.Whitespace */ 43 | .highlight .mb { color: #208050 } /* Literal.Number.Bin */ 44 | .highlight .mf { color: #208050 } /* Literal.Number.Float */ 45 | .highlight .mh { color: #208050 } /* Literal.Number.Hex */ 46 | .highlight .mi { color: #208050 } /* Literal.Number.Integer */ 47 | .highlight .mo { color: #208050 } /* Literal.Number.Oct */ 48 | .highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ 49 | .highlight .sc { color: #4070a0 } /* Literal.String.Char */ 50 | .highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ 51 | .highlight .s2 { color: #4070a0 } /* Literal.String.Double */ 52 | .highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ 53 | .highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ 54 | .highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ 55 | .highlight .sx { color: #c65d09 } /* Literal.String.Other */ 56 | .highlight .sr { color: #235388 } /* Literal.String.Regex */ 57 | .highlight .s1 { color: #4070a0 } /* Literal.String.Single */ 58 | .highlight .ss { color: #517918 } /* Literal.String.Symbol */ 59 | .highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ 60 | .highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ 61 | .highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ 62 | .highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ 63 | .highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ -------------------------------------------------------------------------------- /_static/searchtools.js: -------------------------------------------------------------------------------- 1 | /* 2 | * searchtools.js_t 3 | * ~~~~~~~~~~~~~~~~ 4 | * 5 | * Sphinx JavaScript utilties for the full-text search. 6 | * 7 | * :copyright: Copyright 2007-2015 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | 13 | /* Non-minified version JS is _stemmer.js if file is provided */ 14 | /** 15 | * Porter Stemmer 16 | */ 17 | var Stemmer = function() { 18 | 19 | var step2list = { 20 | ational: 'ate', 21 | tional: 'tion', 22 | enci: 'ence', 23 | anci: 'ance', 24 | izer: 'ize', 25 | bli: 'ble', 26 | alli: 'al', 27 | entli: 'ent', 28 | eli: 'e', 29 | ousli: 'ous', 30 | ization: 'ize', 31 | ation: 'ate', 32 | ator: 'ate', 33 | alism: 'al', 34 | iveness: 'ive', 35 | fulness: 'ful', 36 | ousness: 'ous', 37 | aliti: 'al', 38 | iviti: 'ive', 39 | biliti: 'ble', 40 | logi: 'log' 41 | }; 42 | 43 | var step3list = { 44 | icate: 'ic', 45 | ative: '', 46 | alize: 'al', 47 | iciti: 'ic', 48 | ical: 'ic', 49 | ful: '', 50 | ness: '' 51 | }; 52 | 53 | var c = "[^aeiou]"; // consonant 54 | var v = "[aeiouy]"; // vowel 55 | var C = c + "[^aeiouy]*"; // consonant sequence 56 | var V = v + "[aeiou]*"; // vowel sequence 57 | 58 | var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 59 | var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 60 | var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 61 | var s_v = "^(" + C + ")?" + v; // vowel in stem 62 | 63 | this.stemWord = function (w) { 64 | var stem; 65 | var suffix; 66 | var firstch; 67 | var origword = w; 68 | 69 | if (w.length < 3) 70 | return w; 71 | 72 | var re; 73 | var re2; 74 | var re3; 75 | var re4; 76 | 77 | firstch = w.substr(0,1); 78 | if (firstch == "y") 79 | w = firstch.toUpperCase() + w.substr(1); 80 | 81 | // Step 1a 82 | re = /^(.+?)(ss|i)es$/; 83 | re2 = /^(.+?)([^s])s$/; 84 | 85 | if (re.test(w)) 86 | w = w.replace(re,"$1$2"); 87 | else if (re2.test(w)) 88 | w = w.replace(re2,"$1$2"); 89 | 90 | // Step 1b 91 | re = /^(.+?)eed$/; 92 | re2 = /^(.+?)(ed|ing)$/; 93 | if (re.test(w)) { 94 | var fp = re.exec(w); 95 | re = new RegExp(mgr0); 96 | if (re.test(fp[1])) { 97 | re = /.$/; 98 | w = w.replace(re,""); 99 | } 100 | } 101 | else if (re2.test(w)) { 102 | var fp = re2.exec(w); 103 | stem = fp[1]; 104 | re2 = new RegExp(s_v); 105 | if (re2.test(stem)) { 106 | w = stem; 107 | re2 = /(at|bl|iz)$/; 108 | re3 = new RegExp("([^aeiouylsz])\\1$"); 109 | re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); 110 | if (re2.test(w)) 111 | w = w + "e"; 112 | else if (re3.test(w)) { 113 | re = /.$/; 114 | w = w.replace(re,""); 115 | } 116 | else if (re4.test(w)) 117 | w = w + "e"; 118 | } 119 | } 120 | 121 | // Step 1c 122 | re = /^(.+?)y$/; 123 | if (re.test(w)) { 124 | var fp = re.exec(w); 125 | stem = fp[1]; 126 | re = new RegExp(s_v); 127 | if (re.test(stem)) 128 | w = stem + "i"; 129 | } 130 | 131 | // Step 2 132 | re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; 133 | if (re.test(w)) { 134 | var fp = re.exec(w); 135 | stem = fp[1]; 136 | suffix = fp[2]; 137 | re = new RegExp(mgr0); 138 | if (re.test(stem)) 139 | w = stem + step2list[suffix]; 140 | } 141 | 142 | // Step 3 143 | re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; 144 | if (re.test(w)) { 145 | var fp = re.exec(w); 146 | stem = fp[1]; 147 | suffix = fp[2]; 148 | re = new RegExp(mgr0); 149 | if (re.test(stem)) 150 | w = stem + step3list[suffix]; 151 | } 152 | 153 | // Step 4 154 | re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; 155 | re2 = /^(.+?)(s|t)(ion)$/; 156 | if (re.test(w)) { 157 | var fp = re.exec(w); 158 | stem = fp[1]; 159 | re = new RegExp(mgr1); 160 | if (re.test(stem)) 161 | w = stem; 162 | } 163 | else if (re2.test(w)) { 164 | var fp = re2.exec(w); 165 | stem = fp[1] + fp[2]; 166 | re2 = new RegExp(mgr1); 167 | if (re2.test(stem)) 168 | w = stem; 169 | } 170 | 171 | // Step 5 172 | re = /^(.+?)e$/; 173 | if (re.test(w)) { 174 | var fp = re.exec(w); 175 | stem = fp[1]; 176 | re = new RegExp(mgr1); 177 | re2 = new RegExp(meq1); 178 | re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); 179 | if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) 180 | w = stem; 181 | } 182 | re = /ll$/; 183 | re2 = new RegExp(mgr1); 184 | if (re.test(w) && re2.test(w)) { 185 | re = /.$/; 186 | w = w.replace(re,""); 187 | } 188 | 189 | // and turn initial Y back to y 190 | if (firstch == "y") 191 | w = firstch.toLowerCase() + w.substr(1); 192 | return w; 193 | } 194 | } 195 | 196 | 197 | 198 | /** 199 | * Simple result scoring code. 200 | */ 201 | var Scorer = { 202 | // Implement the following function to further tweak the score for each result 203 | // The function takes a result array [filename, title, anchor, descr, score] 204 | // and returns the new score. 205 | /* 206 | score: function(result) { 207 | return result[4]; 208 | }, 209 | */ 210 | 211 | // query matches the full name of an object 212 | objNameMatch: 11, 213 | // or matches in the last dotted part of the object name 214 | objPartialMatch: 6, 215 | // Additive scores depending on the priority of the object 216 | objPrio: {0: 15, // used to be importantResults 217 | 1: 5, // used to be objectResults 218 | 2: -5}, // used to be unimportantResults 219 | // Used when the priority is not in the mapping. 220 | objPrioDefault: 0, 221 | 222 | // query found in title 223 | title: 15, 224 | // query found in terms 225 | term: 5 226 | }; 227 | 228 | 229 | /** 230 | * Search Module 231 | */ 232 | var Search = { 233 | 234 | _index : null, 235 | _queued_query : null, 236 | _pulse_status : -1, 237 | 238 | init : function() { 239 | var params = $.getQueryParameters(); 240 | if (params.q) { 241 | var query = params.q[0]; 242 | $('input[name="q"]')[0].value = query; 243 | this.performSearch(query); 244 | } 245 | }, 246 | 247 | loadIndex : function(url) { 248 | $.ajax({type: "GET", url: url, data: null, 249 | dataType: "script", cache: true, 250 | complete: function(jqxhr, textstatus) { 251 | if (textstatus != "success") { 252 | document.getElementById("searchindexloader").src = url; 253 | } 254 | }}); 255 | }, 256 | 257 | setIndex : function(index) { 258 | var q; 259 | this._index = index; 260 | if ((q = this._queued_query) !== null) { 261 | this._queued_query = null; 262 | Search.query(q); 263 | } 264 | }, 265 | 266 | hasIndex : function() { 267 | return this._index !== null; 268 | }, 269 | 270 | deferQuery : function(query) { 271 | this._queued_query = query; 272 | }, 273 | 274 | stopPulse : function() { 275 | this._pulse_status = 0; 276 | }, 277 | 278 | startPulse : function() { 279 | if (this._pulse_status >= 0) 280 | return; 281 | function pulse() { 282 | var i; 283 | Search._pulse_status = (Search._pulse_status + 1) % 4; 284 | var dotString = ''; 285 | for (i = 0; i < Search._pulse_status; i++) 286 | dotString += '.'; 287 | Search.dots.text(dotString); 288 | if (Search._pulse_status > -1) 289 | window.setTimeout(pulse, 500); 290 | } 291 | pulse(); 292 | }, 293 | 294 | /** 295 | * perform a search for something (or wait until index is loaded) 296 | */ 297 | performSearch : function(query) { 298 | // create the required interface elements 299 | this.out = $('#search-results'); 300 | this.title = $('

' + _('Searching') + '

').appendTo(this.out); 301 | this.dots = $('').appendTo(this.title); 302 | this.status = $('

').appendTo(this.out); 303 | this.output = $('
    ').appendTo(this.out); 304 | 305 | $('#search-progress').text(_('Preparing search...')); 306 | this.startPulse(); 307 | 308 | // index already loaded, the browser was quick! 309 | if (this.hasIndex()) 310 | this.query(query); 311 | else 312 | this.deferQuery(query); 313 | }, 314 | 315 | /** 316 | * execute search (requires search index to be loaded) 317 | */ 318 | query : function(query) { 319 | var i; 320 | var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; 321 | 322 | // stem the searchterms and add them to the correct list 323 | var stemmer = new Stemmer(); 324 | var searchterms = []; 325 | var excluded = []; 326 | var hlterms = []; 327 | var tmp = query.split(/\s+/); 328 | var objectterms = []; 329 | for (i = 0; i < tmp.length; i++) { 330 | if (tmp[i] !== "") { 331 | objectterms.push(tmp[i].toLowerCase()); 332 | } 333 | 334 | if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) || 335 | tmp[i] === "") { 336 | // skip this "word" 337 | continue; 338 | } 339 | // stem the word 340 | var word = stemmer.stemWord(tmp[i].toLowerCase()); 341 | var toAppend; 342 | // select the correct list 343 | if (word[0] == '-') { 344 | toAppend = excluded; 345 | word = word.substr(1); 346 | } 347 | else { 348 | toAppend = searchterms; 349 | hlterms.push(tmp[i].toLowerCase()); 350 | } 351 | // only add if not already in the list 352 | if (!$u.contains(toAppend, word)) 353 | toAppend.push(word); 354 | } 355 | var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); 356 | 357 | // console.debug('SEARCH: searching for:'); 358 | // console.info('required: ', searchterms); 359 | // console.info('excluded: ', excluded); 360 | 361 | // prepare search 362 | var terms = this._index.terms; 363 | var titleterms = this._index.titleterms; 364 | 365 | // array of [filename, title, anchor, descr, score] 366 | var results = []; 367 | $('#search-progress').empty(); 368 | 369 | // lookup as object 370 | for (i = 0; i < objectterms.length; i++) { 371 | var others = [].concat(objectterms.slice(0, i), 372 | objectterms.slice(i+1, objectterms.length)); 373 | results = results.concat(this.performObjectSearch(objectterms[i], others)); 374 | } 375 | 376 | // lookup as search terms in fulltext 377 | results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms)); 378 | 379 | // let the scorer override scores with a custom scoring function 380 | if (Scorer.score) { 381 | for (i = 0; i < results.length; i++) 382 | results[i][4] = Scorer.score(results[i]); 383 | } 384 | 385 | // now sort the results by score (in opposite order of appearance, since the 386 | // display function below uses pop() to retrieve items) and then 387 | // alphabetically 388 | results.sort(function(a, b) { 389 | var left = a[4]; 390 | var right = b[4]; 391 | if (left > right) { 392 | return 1; 393 | } else if (left < right) { 394 | return -1; 395 | } else { 396 | // same score: sort alphabetically 397 | left = a[1].toLowerCase(); 398 | right = b[1].toLowerCase(); 399 | return (left > right) ? -1 : ((left < right) ? 1 : 0); 400 | } 401 | }); 402 | 403 | // for debugging 404 | //Search.lastresults = results.slice(); // a copy 405 | //console.info('search results:', Search.lastresults); 406 | 407 | // print the results 408 | var resultCount = results.length; 409 | function displayNextItem() { 410 | // results left, load the summary and display it 411 | if (results.length) { 412 | var item = results.pop(); 413 | var listItem = $('
  • '); 414 | if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') { 415 | // dirhtml builder 416 | var dirname = item[0] + '/'; 417 | if (dirname.match(/\/index\/$/)) { 418 | dirname = dirname.substring(0, dirname.length-6); 419 | } else if (dirname == 'index/') { 420 | dirname = ''; 421 | } 422 | listItem.append($('').attr('href', 423 | DOCUMENTATION_OPTIONS.URL_ROOT + dirname + 424 | highlightstring + item[2]).html(item[1])); 425 | } else { 426 | // normal html builders 427 | listItem.append($('').attr('href', 428 | item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + 429 | highlightstring + item[2]).html(item[1])); 430 | } 431 | if (item[3]) { 432 | listItem.append($(' (' + item[3] + ')')); 433 | Search.output.append(listItem); 434 | listItem.slideDown(5, function() { 435 | displayNextItem(); 436 | }); 437 | } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { 438 | $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt', 439 | dataType: "text", 440 | complete: function(jqxhr, textstatus) { 441 | var data = jqxhr.responseText; 442 | if (data !== '' && data !== undefined) { 443 | listItem.append(Search.makeSearchSummary(data, searchterms, hlterms)); 444 | } 445 | Search.output.append(listItem); 446 | listItem.slideDown(5, function() { 447 | displayNextItem(); 448 | }); 449 | }}); 450 | } else { 451 | // no source available, just display title 452 | Search.output.append(listItem); 453 | listItem.slideDown(5, function() { 454 | displayNextItem(); 455 | }); 456 | } 457 | } 458 | // search finished, update title and status message 459 | else { 460 | Search.stopPulse(); 461 | Search.title.text(_('Search Results')); 462 | if (!resultCount) 463 | Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); 464 | else 465 | Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); 466 | Search.status.fadeIn(500); 467 | } 468 | } 469 | displayNextItem(); 470 | }, 471 | 472 | /** 473 | * search for object names 474 | */ 475 | performObjectSearch : function(object, otherterms) { 476 | var filenames = this._index.filenames; 477 | var objects = this._index.objects; 478 | var objnames = this._index.objnames; 479 | var titles = this._index.titles; 480 | 481 | var i; 482 | var results = []; 483 | 484 | for (var prefix in objects) { 485 | for (var name in objects[prefix]) { 486 | var fullname = (prefix ? prefix + '.' : '') + name; 487 | if (fullname.toLowerCase().indexOf(object) > -1) { 488 | var score = 0; 489 | var parts = fullname.split('.'); 490 | // check for different match types: exact matches of full name or 491 | // "last name" (i.e. last dotted part) 492 | if (fullname == object || parts[parts.length - 1] == object) { 493 | score += Scorer.objNameMatch; 494 | // matches in last name 495 | } else if (parts[parts.length - 1].indexOf(object) > -1) { 496 | score += Scorer.objPartialMatch; 497 | } 498 | var match = objects[prefix][name]; 499 | var objname = objnames[match[1]][2]; 500 | var title = titles[match[0]]; 501 | // If more than one term searched for, we require other words to be 502 | // found in the name/title/description 503 | if (otherterms.length > 0) { 504 | var haystack = (prefix + ' ' + name + ' ' + 505 | objname + ' ' + title).toLowerCase(); 506 | var allfound = true; 507 | for (i = 0; i < otherterms.length; i++) { 508 | if (haystack.indexOf(otherterms[i]) == -1) { 509 | allfound = false; 510 | break; 511 | } 512 | } 513 | if (!allfound) { 514 | continue; 515 | } 516 | } 517 | var descr = objname + _(', in ') + title; 518 | 519 | var anchor = match[3]; 520 | if (anchor === '') 521 | anchor = fullname; 522 | else if (anchor == '-') 523 | anchor = objnames[match[1]][1] + '-' + fullname; 524 | // add custom score for some objects according to scorer 525 | if (Scorer.objPrio.hasOwnProperty(match[2])) { 526 | score += Scorer.objPrio[match[2]]; 527 | } else { 528 | score += Scorer.objPrioDefault; 529 | } 530 | results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]); 531 | } 532 | } 533 | } 534 | 535 | return results; 536 | }, 537 | 538 | /** 539 | * search for full-text terms in the index 540 | */ 541 | performTermsSearch : function(searchterms, excluded, terms, titleterms) { 542 | var filenames = this._index.filenames; 543 | var titles = this._index.titles; 544 | 545 | var i, j, file; 546 | var fileMap = {}; 547 | var scoreMap = {}; 548 | var results = []; 549 | 550 | // perform the search on the required terms 551 | for (i = 0; i < searchterms.length; i++) { 552 | var word = searchterms[i]; 553 | var files = []; 554 | var _o = [ 555 | {files: terms[word], score: Scorer.term}, 556 | {files: titleterms[word], score: Scorer.title} 557 | ]; 558 | 559 | // no match but word was a required one 560 | if ($u.every(_o, function(o){return o.files === undefined;})) { 561 | break; 562 | } 563 | // found search word in contents 564 | $u.each(_o, function(o) { 565 | var _files = o.files; 566 | if (_files === undefined) 567 | return 568 | 569 | if (_files.length === undefined) 570 | _files = [_files]; 571 | files = files.concat(_files); 572 | 573 | // set score for the word in each file to Scorer.term 574 | for (j = 0; j < _files.length; j++) { 575 | file = _files[j]; 576 | if (!(file in scoreMap)) 577 | scoreMap[file] = {} 578 | scoreMap[file][word] = o.score; 579 | } 580 | }); 581 | 582 | // create the mapping 583 | for (j = 0; j < files.length; j++) { 584 | file = files[j]; 585 | if (file in fileMap) 586 | fileMap[file].push(word); 587 | else 588 | fileMap[file] = [word]; 589 | } 590 | } 591 | 592 | // now check if the files don't contain excluded terms 593 | for (file in fileMap) { 594 | var valid = true; 595 | 596 | // check if all requirements are matched 597 | if (fileMap[file].length != searchterms.length) 598 | continue; 599 | 600 | // ensure that none of the excluded terms is in the search result 601 | for (i = 0; i < excluded.length; i++) { 602 | if (terms[excluded[i]] == file || 603 | titleterms[excluded[i]] == file || 604 | $u.contains(terms[excluded[i]] || [], file) || 605 | $u.contains(titleterms[excluded[i]] || [], file)) { 606 | valid = false; 607 | break; 608 | } 609 | } 610 | 611 | // if we have still a valid result we can add it to the result list 612 | if (valid) { 613 | // select one (max) score for the file. 614 | // for better ranking, we should calculate ranking by using words statistics like basic tf-idf... 615 | var score = $u.max($u.map(fileMap[file], function(w){return scoreMap[file][w]})); 616 | results.push([filenames[file], titles[file], '', null, score]); 617 | } 618 | } 619 | return results; 620 | }, 621 | 622 | /** 623 | * helper function to return a node containing the 624 | * search summary for a given text. keywords is a list 625 | * of stemmed words, hlwords is the list of normal, unstemmed 626 | * words. the first one is used to find the occurance, the 627 | * latter for highlighting it. 628 | */ 629 | makeSearchSummary : function(text, keywords, hlwords) { 630 | var textLower = text.toLowerCase(); 631 | var start = 0; 632 | $.each(keywords, function() { 633 | var i = textLower.indexOf(this.toLowerCase()); 634 | if (i > -1) 635 | start = i; 636 | }); 637 | start = Math.max(start - 120, 0); 638 | var excerpt = ((start > 0) ? '...' : '') + 639 | $.trim(text.substr(start, 240)) + 640 | ((start + 240 - text.length) ? '...' : ''); 641 | var rv = $('
    ').text(excerpt); 642 | $.each(hlwords, function() { 643 | rv = rv.highlightText(this, 'highlighted'); 644 | }); 645 | return rv; 646 | } 647 | }; 648 | 649 | $(document).ready(function() { 650 | Search.init(); 651 | }); -------------------------------------------------------------------------------- /_static/translations.js: -------------------------------------------------------------------------------- 1 | Documentation.addTranslations({"locale": "zh_Hans_CN", "plural_expr": "0", "messages": {"Next topic": "\u4e0b\u4e00\u4e2a\u4e3b\u9898", "Index": "\u7d22\u5f15", "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "Welcome! This is": "\u6b22\u8fce\uff01\u8fd9\u662f", "Copyright": "\u7248\u6743\u6240\u6709", "C API changes": "C API \u66f4\u6539", "quick access to all modules": "\u5feb\u901f\u67e5\u770b\u6240\u6709\u7684\u6a21\u5757", "© Copyright %(copyright)s.": "© \u7248\u6743\u6240\u6709 %(copyright)s.", "Global Module Index": "\u5168\u5c40\u6a21\u5757\u7d22\u5f15", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u6ca1\u6709\u4efb\u4f55\u6587\u6863\u5339\u914d\u60a8\u7684\u641c\u7d22\u3002\u8bf7\u786e\u4fdd\u4f60\u8f93\u5165\u7684\u8bcd\u62fc\u5199\u6b63\u786e\u5e76\u9009\u62e9\u4e86\u5408\u9002\u7684\u5206\u7c7b\u3002", "Index – %(key)s": "\u7d22\u5f15 – %(key)s", "General Index": "\u603b\u76ee\u5f55", "next chapter": "\u4e0b\u4e00\u7ae0", "Search finished, found %s page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u6709 %s \u4e2a\u9875\u9762\u5339\u914d\u3002", "previous chapter": "\u4e0a\u4e00\u7ae0", "Permalink to this headline": "\u6c38\u4e45\u94fe\u63a5\u81f3\u6807\u9898", "About these documents": "\u5173\u4e8e\u8fd9\u4e9b\u6587\u6863", "Preparing search...": "\u51c6\u5907\u641c\u7d22\u2026\u2026", ", in ": "\uff0c\u5728", "Navigation": "\u5bfc\u822a", "Expand sidebar": "\u5c55\u5f00\u8fb9\u680f", "the documentation for": "\u8fd9\u4efd\u6587\u6863\u662f", "Complete Table of Contents": "\u5b8c\u6574\u7684\u5185\u5bb9\u8868", "Contents": "\u76ee\u5f55", "can be huge": "\u53ef\u80fd\u4f1a\u5f88\u591a", "Changes in Version %(version)s — %(docstitle)s": "\u66f4\u6539\u53d1\u751f\u5728\u7248\u672c %(version)s — %(docstitle)s", "Other changes": "\u5176\u4ed6\u66f4\u6539", "Hide Search Matches": "\u9690\u85cf\u641c\u7d22\u7ed3\u679c", "Quick search": "\u5feb\u901f\u641c\u7d22", "Show Source": "\u663e\u793a\u6e90\u4ee3\u7801", "Search": "\u641c\u7d22", "This Page": "\u672c\u9875", "From here you can search these documents. Enter your search\n words into the box below and click \"search\". Note that the search\n function will automatically search for all of the words. Pages\n containing fewer words won't appear in the result list.": "\u5728\u8fd9\u513f\uff0c\u4f60\u53ef\u4ee5\u5bf9\u8fd9\u4e9b\u6587\u6863\u8fdb\u884c\u641c\u7d22\u3002\u5411\u641c\u7d22\u6846\u4e2d\u8f93\u5165\u4f60\u6240\u8981\u641c\u7d22\u7684\u5173\u952e\u5b57\u5e76\u70b9\u51fb\u201c\u641c\u7d22\u201d\u3002\u6ce8\u610f\uff1a\u641c\u7d22\u5f15\u64ce\u4f1a\u81ea\u52a8\u641c\u7d22\u6240\u6709\u7684\u5173\u952e\u5b57\u3002\u5c06\u4e0d\u4f1a\u641c\u7d22\u5230\u90e8\u5206\u5173\u952e\u5b57\u7684\u9875\u9762.", "Created using     Sphinx %(sphinx_version)s.": "\u7531 Sphinx %(sphinx_version)s \u521b\u5efa\u3002", "last updated": "\u6700\u540e\u66f4\u65b0\u4e8e", "Collapse sidebar": "\u6298\u53e0\u8fb9\u680f", "Go": "\u8f6c\u5411", "Table Of Contents": "\u5167\u5bb9\u76ee\u5f55", "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u7d22", "all functions, classes, terms": "\u6240\u7684\u51fd\u6570\uff0c\u7c7b\uff0c\u672f\u8bed", "Please activate JavaScript to enable the search\n functionality.": "\u8bf7\u6fc0\u6d3b JavaScript \u4ee5\u5f00\u542f\u641c\u7d22\u529f\u80fd", "Indices and tables:": "\u7d22\u5f15\u548c\u8868\u683c\uff1a", "lists all sections and subsections": "\u5217\u51fa\u6240\u6709\u7684\u7ae0\u8282\u548c\u90e8\u5206", "Index pages by letter": "\u6309\u7167\u5b57\u6bcd\u7684\u7d22\u5f15\u9875", "search": "\u641c\u7d22", "Permalink to this definition": "\u6c38\u4e45\u94fe\u63a5\u81f3\u76ee\u6807", "Previous topic": "\u4e0a\u4e00\u4e2a\u4e3b\u9898", "Overview": "\u6982\u8ff0", "Last updated on %(last_updated)s.": "\u6700\u540e\u66f4\u65b0\u4e8e %(last_updated)s.", "Searching": "\u641c\u7d22\u4e2d", "search this documentation": "\u641c\u7d22\u6587\u6863", "Automatically generated list of changes in version %(version)s": "\u81ea\u52a8\u751f\u6210\u7684 %(version)s \u7248\u672c\u4e2d\u7684\u66f4\u6539\u5217\u8868", "Full index on one page": "\u4e00\u9875\u7684\u5168\u90e8\u7d22\u5f15", "Enter search terms or a module, class or function name.": "\u8f93\u5165\u76f8\u5173\u7684\u672f\u8bed\uff0c\u6a21\u5757\uff0c\u7c7b\u6216\u8005\u51fd\u6570\u540d\u79f0\u8fdb\u884c\u641c\u7d22", "© Copyright %(copyright)s.": "© \u7248\u6743\u6240\u6709 %(copyright)s.", "Library changes": "\u5e93\u66f4\u6539", "Search Page": "\u641c\u7d22\u9875\u9762", "Search Results": "\u641c\u7d22\u7ed3\u679c"}}); -------------------------------------------------------------------------------- /_static/underscore.js: -------------------------------------------------------------------------------- 1 | // Underscore.js 1.3.1 2 | // (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc. 3 | // Underscore is freely distributable under the MIT license. 4 | // Portions of Underscore are inspired or borrowed from Prototype, 5 | // Oliver Steele's Functional, and John Resig's Micro-Templating. 6 | // For all details and documentation: 7 | // http://documentcloud.github.com/underscore 8 | (function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source== 9 | c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c, 10 | h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var j=b.each= 11 | b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e2;a== 12 | null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect= 13 | function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e= 14 | e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck= 15 | function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;bd?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a, 17 | c,d){d||(d=b.identity);for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e=0;d--)b=[a[d].apply(this,b)];return b[0]}}; 24 | b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments, 25 | 1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)}; 26 | b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"}; 27 | b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a), 28 | function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return"',_.escape("+ 29 | u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]= 30 | function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain= 31 | true;return this};m.prototype.value=function(){return this._wrapped}}).call(this); 32 | -------------------------------------------------------------------------------- /_static/up-pressed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/up-pressed.png -------------------------------------------------------------------------------- /_static/up.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/_static/up.png -------------------------------------------------------------------------------- /_static/websupport.js: -------------------------------------------------------------------------------- 1 | /* 2 | * websupport.js 3 | * ~~~~~~~~~~~~~ 4 | * 5 | * sphinx.websupport utilties for all documentation. 6 | * 7 | * :copyright: Copyright 2007-2015 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | (function($) { 13 | $.fn.autogrow = function() { 14 | return this.each(function() { 15 | var textarea = this; 16 | 17 | $.fn.autogrow.resize(textarea); 18 | 19 | $(textarea) 20 | .focus(function() { 21 | textarea.interval = setInterval(function() { 22 | $.fn.autogrow.resize(textarea); 23 | }, 500); 24 | }) 25 | .blur(function() { 26 | clearInterval(textarea.interval); 27 | }); 28 | }); 29 | }; 30 | 31 | $.fn.autogrow.resize = function(textarea) { 32 | var lineHeight = parseInt($(textarea).css('line-height'), 10); 33 | var lines = textarea.value.split('\n'); 34 | var columns = textarea.cols; 35 | var lineCount = 0; 36 | $.each(lines, function() { 37 | lineCount += Math.ceil(this.length / columns) || 1; 38 | }); 39 | var height = lineHeight * (lineCount + 1); 40 | $(textarea).css('height', height); 41 | }; 42 | })(jQuery); 43 | 44 | (function($) { 45 | var comp, by; 46 | 47 | function init() { 48 | initEvents(); 49 | initComparator(); 50 | } 51 | 52 | function initEvents() { 53 | $(document).on("click", 'a.comment-close', function(event) { 54 | event.preventDefault(); 55 | hide($(this).attr('id').substring(2)); 56 | }); 57 | $(document).on("click", 'a.vote', function(event) { 58 | event.preventDefault(); 59 | handleVote($(this)); 60 | }); 61 | $(document).on("click", 'a.reply', function(event) { 62 | event.preventDefault(); 63 | openReply($(this).attr('id').substring(2)); 64 | }); 65 | $(document).on("click", 'a.close-reply', function(event) { 66 | event.preventDefault(); 67 | closeReply($(this).attr('id').substring(2)); 68 | }); 69 | $(document).on("click", 'a.sort-option', function(event) { 70 | event.preventDefault(); 71 | handleReSort($(this)); 72 | }); 73 | $(document).on("click", 'a.show-proposal', function(event) { 74 | event.preventDefault(); 75 | showProposal($(this).attr('id').substring(2)); 76 | }); 77 | $(document).on("click", 'a.hide-proposal', function(event) { 78 | event.preventDefault(); 79 | hideProposal($(this).attr('id').substring(2)); 80 | }); 81 | $(document).on("click", 'a.show-propose-change', function(event) { 82 | event.preventDefault(); 83 | showProposeChange($(this).attr('id').substring(2)); 84 | }); 85 | $(document).on("click", 'a.hide-propose-change', function(event) { 86 | event.preventDefault(); 87 | hideProposeChange($(this).attr('id').substring(2)); 88 | }); 89 | $(document).on("click", 'a.accept-comment', function(event) { 90 | event.preventDefault(); 91 | acceptComment($(this).attr('id').substring(2)); 92 | }); 93 | $(document).on("click", 'a.delete-comment', function(event) { 94 | event.preventDefault(); 95 | deleteComment($(this).attr('id').substring(2)); 96 | }); 97 | $(document).on("click", 'a.comment-markup', function(event) { 98 | event.preventDefault(); 99 | toggleCommentMarkupBox($(this).attr('id').substring(2)); 100 | }); 101 | } 102 | 103 | /** 104 | * Set comp, which is a comparator function used for sorting and 105 | * inserting comments into the list. 106 | */ 107 | function setComparator() { 108 | // If the first three letters are "asc", sort in ascending order 109 | // and remove the prefix. 110 | if (by.substring(0,3) == 'asc') { 111 | var i = by.substring(3); 112 | comp = function(a, b) { return a[i] - b[i]; }; 113 | } else { 114 | // Otherwise sort in descending order. 115 | comp = function(a, b) { return b[by] - a[by]; }; 116 | } 117 | 118 | // Reset link styles and format the selected sort option. 119 | $('a.sel').attr('href', '#').removeClass('sel'); 120 | $('a.by' + by).removeAttr('href').addClass('sel'); 121 | } 122 | 123 | /** 124 | * Create a comp function. If the user has preferences stored in 125 | * the sortBy cookie, use those, otherwise use the default. 126 | */ 127 | function initComparator() { 128 | by = 'rating'; // Default to sort by rating. 129 | // If the sortBy cookie is set, use that instead. 130 | if (document.cookie.length > 0) { 131 | var start = document.cookie.indexOf('sortBy='); 132 | if (start != -1) { 133 | start = start + 7; 134 | var end = document.cookie.indexOf(";", start); 135 | if (end == -1) { 136 | end = document.cookie.length; 137 | by = unescape(document.cookie.substring(start, end)); 138 | } 139 | } 140 | } 141 | setComparator(); 142 | } 143 | 144 | /** 145 | * Show a comment div. 146 | */ 147 | function show(id) { 148 | $('#ao' + id).hide(); 149 | $('#ah' + id).show(); 150 | var context = $.extend({id: id}, opts); 151 | var popup = $(renderTemplate(popupTemplate, context)).hide(); 152 | popup.find('textarea[name="proposal"]').hide(); 153 | popup.find('a.by' + by).addClass('sel'); 154 | var form = popup.find('#cf' + id); 155 | form.submit(function(event) { 156 | event.preventDefault(); 157 | addComment(form); 158 | }); 159 | $('#s' + id).after(popup); 160 | popup.slideDown('fast', function() { 161 | getComments(id); 162 | }); 163 | } 164 | 165 | /** 166 | * Hide a comment div. 167 | */ 168 | function hide(id) { 169 | $('#ah' + id).hide(); 170 | $('#ao' + id).show(); 171 | var div = $('#sc' + id); 172 | div.slideUp('fast', function() { 173 | div.remove(); 174 | }); 175 | } 176 | 177 | /** 178 | * Perform an ajax request to get comments for a node 179 | * and insert the comments into the comments tree. 180 | */ 181 | function getComments(id) { 182 | $.ajax({ 183 | type: 'GET', 184 | url: opts.getCommentsURL, 185 | data: {node: id}, 186 | success: function(data, textStatus, request) { 187 | var ul = $('#cl' + id); 188 | var speed = 100; 189 | $('#cf' + id) 190 | .find('textarea[name="proposal"]') 191 | .data('source', data.source); 192 | 193 | if (data.comments.length === 0) { 194 | ul.html('
  • No comments yet.
    • '); 195 | ul.data('empty', true); 196 | } else { 197 | // If there are comments, sort them and put them in the list. 198 | var comments = sortComments(data.comments); 199 | speed = data.comments.length * 100; 200 | appendComments(comments, ul); 201 | ul.data('empty', false); 202 | } 203 | $('#cn' + id).slideUp(speed + 200); 204 | ul.slideDown(speed); 205 | }, 206 | error: function(request, textStatus, error) { 207 | showError('Oops, there was a problem retrieving the comments.'); 208 | }, 209 | dataType: 'json' 210 | }); 211 | } 212 | 213 | /** 214 | * Add a comment via ajax and insert the comment into the comment tree. 215 | */ 216 | function addComment(form) { 217 | var node_id = form.find('input[name="node"]').val(); 218 | var parent_id = form.find('input[name="parent"]').val(); 219 | var text = form.find('textarea[name="comment"]').val(); 220 | var proposal = form.find('textarea[name="proposal"]').val(); 221 | 222 | if (text == '') { 223 | showError('Please enter a comment.'); 224 | return; 225 | } 226 | 227 | // Disable the form that is being submitted. 228 | form.find('textarea,input').attr('disabled', 'disabled'); 229 | 230 | // Send the comment to the server. 231 | $.ajax({ 232 | type: "POST", 233 | url: opts.addCommentURL, 234 | dataType: 'json', 235 | data: { 236 | node: node_id, 237 | parent: parent_id, 238 | text: text, 239 | proposal: proposal 240 | }, 241 | success: function(data, textStatus, error) { 242 | // Reset the form. 243 | if (node_id) { 244 | hideProposeChange(node_id); 245 | } 246 | form.find('textarea') 247 | .val('') 248 | .add(form.find('input')) 249 | .removeAttr('disabled'); 250 | var ul = $('#cl' + (node_id || parent_id)); 251 | if (ul.data('empty')) { 252 | $(ul).empty(); 253 | ul.data('empty', false); 254 | } 255 | insertComment(data.comment); 256 | var ao = $('#ao' + node_id); 257 | ao.find('img').attr({'src': opts.commentBrightImage}); 258 | if (node_id) { 259 | // if this was a "root" comment, remove the commenting box 260 | // (the user can get it back by reopening the comment popup) 261 | $('#ca' + node_id).slideUp(); 262 | } 263 | }, 264 | error: function(request, textStatus, error) { 265 | form.find('textarea,input').removeAttr('disabled'); 266 | showError('Oops, there was a problem adding the comment.'); 267 | } 268 | }); 269 | } 270 | 271 | /** 272 | * Recursively append comments to the main comment list and children 273 | * lists, creating the comment tree. 274 | */ 275 | function appendComments(comments, ul) { 276 | $.each(comments, function() { 277 | var div = createCommentDiv(this); 278 | ul.append($(document.createElement('li')).html(div)); 279 | appendComments(this.children, div.find('ul.comment-children')); 280 | // To avoid stagnating data, don't store the comments children in data. 281 | this.children = null; 282 | div.data('comment', this); 283 | }); 284 | } 285 | 286 | /** 287 | * After adding a new comment, it must be inserted in the correct 288 | * location in the comment tree. 289 | */ 290 | function insertComment(comment) { 291 | var div = createCommentDiv(comment); 292 | 293 | // To avoid stagnating data, don't store the comments children in data. 294 | comment.children = null; 295 | div.data('comment', comment); 296 | 297 | var ul = $('#cl' + (comment.node || comment.parent)); 298 | var siblings = getChildren(ul); 299 | 300 | var li = $(document.createElement('li')); 301 | li.hide(); 302 | 303 | // Determine where in the parents children list to insert this comment. 304 | for(i=0; i < siblings.length; i++) { 305 | if (comp(comment, siblings[i]) <= 0) { 306 | $('#cd' + siblings[i].id) 307 | .parent() 308 | .before(li.html(div)); 309 | li.slideDown('fast'); 310 | return; 311 | } 312 | } 313 | 314 | // If we get here, this comment rates lower than all the others, 315 | // or it is the only comment in the list. 316 | ul.append(li.html(div)); 317 | li.slideDown('fast'); 318 | } 319 | 320 | function acceptComment(id) { 321 | $.ajax({ 322 | type: 'POST', 323 | url: opts.acceptCommentURL, 324 | data: {id: id}, 325 | success: function(data, textStatus, request) { 326 | $('#cm' + id).fadeOut('fast'); 327 | $('#cd' + id).removeClass('moderate'); 328 | }, 329 | error: function(request, textStatus, error) { 330 | showError('Oops, there was a problem accepting the comment.'); 331 | } 332 | }); 333 | } 334 | 335 | function deleteComment(id) { 336 | $.ajax({ 337 | type: 'POST', 338 | url: opts.deleteCommentURL, 339 | data: {id: id}, 340 | success: function(data, textStatus, request) { 341 | var div = $('#cd' + id); 342 | if (data == 'delete') { 343 | // Moderator mode: remove the comment and all children immediately 344 | div.slideUp('fast', function() { 345 | div.remove(); 346 | }); 347 | return; 348 | } 349 | // User mode: only mark the comment as deleted 350 | div 351 | .find('span.user-id:first') 352 | .text('[deleted]').end() 353 | .find('div.comment-text:first') 354 | .text('[deleted]').end() 355 | .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id + 356 | ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id) 357 | .remove(); 358 | var comment = div.data('comment'); 359 | comment.username = '[deleted]'; 360 | comment.text = '[deleted]'; 361 | div.data('comment', comment); 362 | }, 363 | error: function(request, textStatus, error) { 364 | showError('Oops, there was a problem deleting the comment.'); 365 | } 366 | }); 367 | } 368 | 369 | function showProposal(id) { 370 | $('#sp' + id).hide(); 371 | $('#hp' + id).show(); 372 | $('#pr' + id).slideDown('fast'); 373 | } 374 | 375 | function hideProposal(id) { 376 | $('#hp' + id).hide(); 377 | $('#sp' + id).show(); 378 | $('#pr' + id).slideUp('fast'); 379 | } 380 | 381 | function showProposeChange(id) { 382 | $('#pc' + id).hide(); 383 | $('#hc' + id).show(); 384 | var textarea = $('#pt' + id); 385 | textarea.val(textarea.data('source')); 386 | $.fn.autogrow.resize(textarea[0]); 387 | textarea.slideDown('fast'); 388 | } 389 | 390 | function hideProposeChange(id) { 391 | $('#hc' + id).hide(); 392 | $('#pc' + id).show(); 393 | var textarea = $('#pt' + id); 394 | textarea.val('').removeAttr('disabled'); 395 | textarea.slideUp('fast'); 396 | } 397 | 398 | function toggleCommentMarkupBox(id) { 399 | $('#mb' + id).toggle(); 400 | } 401 | 402 | /** Handle when the user clicks on a sort by link. */ 403 | function handleReSort(link) { 404 | var classes = link.attr('class').split(/\s+/); 405 | for (var i=0; iThank you! Your comment will show up ' 558 | + 'once it is has been approved by a moderator.'); 559 | } 560 | // Prettify the comment rating. 561 | comment.pretty_rating = comment.rating + ' point' + 562 | (comment.rating == 1 ? '' : 's'); 563 | // Make a class (for displaying not yet moderated comments differently) 564 | comment.css_class = comment.displayed ? '' : ' moderate'; 565 | // Create a div for this comment. 566 | var context = $.extend({}, opts, comment); 567 | var div = $(renderTemplate(commentTemplate, context)); 568 | 569 | // If the user has voted on this comment, highlight the correct arrow. 570 | if (comment.vote) { 571 | var direction = (comment.vote == 1) ? 'u' : 'd'; 572 | div.find('#' + direction + 'v' + comment.id).hide(); 573 | div.find('#' + direction + 'u' + comment.id).show(); 574 | } 575 | 576 | if (opts.moderator || comment.text != '[deleted]') { 577 | div.find('a.reply').show(); 578 | if (comment.proposal_diff) 579 | div.find('#sp' + comment.id).show(); 580 | if (opts.moderator && !comment.displayed) 581 | div.find('#cm' + comment.id).show(); 582 | if (opts.moderator || (opts.username == comment.username)) 583 | div.find('#dc' + comment.id).show(); 584 | } 585 | return div; 586 | } 587 | 588 | /** 589 | * A simple template renderer. Placeholders such as <%id%> are replaced 590 | * by context['id'] with items being escaped. Placeholders such as <#id#> 591 | * are not escaped. 592 | */ 593 | function renderTemplate(template, context) { 594 | var esc = $(document.createElement('div')); 595 | 596 | function handle(ph, escape) { 597 | var cur = context; 598 | $.each(ph.split('.'), function() { 599 | cur = cur[this]; 600 | }); 601 | return escape ? esc.text(cur || "").html() : cur; 602 | } 603 | 604 | return template.replace(/<([%#])([\w\.]*)\1>/g, function() { 605 | return handle(arguments[2], arguments[1] == '%' ? true : false); 606 | }); 607 | } 608 | 609 | /** Flash an error message briefly. */ 610 | function showError(message) { 611 | $(document.createElement('div')).attr({'class': 'popup-error'}) 612 | .append($(document.createElement('div')) 613 | .attr({'class': 'error-message'}).text(message)) 614 | .appendTo('body') 615 | .fadeIn("slow") 616 | .delay(2000) 617 | .fadeOut("slow"); 618 | } 619 | 620 | /** Add a link the user uses to open the comments popup. */ 621 | $.fn.comment = function() { 622 | return this.each(function() { 623 | var id = $(this).attr('id').substring(1); 624 | var count = COMMENT_METADATA[id]; 625 | var title = count + ' comment' + (count == 1 ? '' : 's'); 626 | var image = count > 0 ? opts.commentBrightImage : opts.commentImage; 627 | var addcls = count == 0 ? ' nocomment' : ''; 628 | $(this) 629 | .append( 630 | $(document.createElement('a')).attr({ 631 | href: '#', 632 | 'class': 'sphinx-comment-open' + addcls, 633 | id: 'ao' + id 634 | }) 635 | .append($(document.createElement('img')).attr({ 636 | src: image, 637 | alt: 'comment', 638 | title: title 639 | })) 640 | .click(function(event) { 641 | event.preventDefault(); 642 | show($(this).attr('id').substring(2)); 643 | }) 644 | ) 645 | .append( 646 | $(document.createElement('a')).attr({ 647 | href: '#', 648 | 'class': 'sphinx-comment-close hidden', 649 | id: 'ah' + id 650 | }) 651 | .append($(document.createElement('img')).attr({ 652 | src: opts.closeCommentImage, 653 | alt: 'close', 654 | title: 'close' 655 | })) 656 | .click(function(event) { 657 | event.preventDefault(); 658 | hide($(this).attr('id').substring(2)); 659 | }) 660 | ); 661 | }); 662 | }; 663 | 664 | var opts = { 665 | processVoteURL: '/_process_vote', 666 | addCommentURL: '/_add_comment', 667 | getCommentsURL: '/_get_comments', 668 | acceptCommentURL: '/_accept_comment', 669 | deleteCommentURL: '/_delete_comment', 670 | commentImage: '/static/_static/comment.png', 671 | closeCommentImage: '/static/_static/comment-close.png', 672 | loadingImage: '/static/_static/ajax-loader.gif', 673 | commentBrightImage: '/static/_static/comment-bright.png', 674 | upArrow: '/static/_static/up.png', 675 | downArrow: '/static/_static/down.png', 676 | upArrowPressed: '/static/_static/up-pressed.png', 677 | downArrowPressed: '/static/_static/down-pressed.png', 678 | voting: false, 679 | moderator: false 680 | }; 681 | 682 | if (typeof COMMENT_OPTIONS != "undefined") { 683 | opts = jQuery.extend(opts, COMMENT_OPTIONS); 684 | } 685 | 686 | var popupTemplate = '\ 687 |
    \ 688 |

    \ 689 | Sort by:\ 690 | best rated\ 691 | newest\ 692 | oldest\ 693 |

    \ 694 |
    Comments
    \ 695 |
    \ 696 | loading comments...
    \ 697 |
      \ 698 |
      \ 699 |

      Add a comment\ 700 | (markup):

      \ 701 |
      \ 702 | reStructured text markup: *emph*, **strong**, \ 703 | ``code``, \ 704 | code blocks: :: and an indented block after blank line
      \ 705 |
      \ 706 | \ 707 |

      \ 708 | \ 709 | Propose a change ▹\ 710 | \ 711 | \ 712 | Propose a change ▿\ 713 | \ 714 |

      \ 715 | \ 717 | \ 718 | \ 719 | \ 720 |
      \ 721 |
      \ 722 |
      '; 723 | 724 | var commentTemplate = '\ 725 |
      \ 726 |
      \ 727 |
      \ 728 | \ 729 | \ 730 | \ 731 | \ 732 | \ 733 | \ 734 |
      \ 735 |
      \ 736 | \ 737 | \ 738 | \ 739 | \ 740 | \ 741 | \ 742 |
      \ 743 |
      \ 744 |
      \ 745 |

      \ 746 | <%username%>\ 747 | <%pretty_rating%>\ 748 | <%time.delta%>\ 749 |

      \ 750 |
      <#text#>
      \ 751 |

      \ 752 | \ 753 | reply ▿\ 754 | proposal ▹\ 755 | proposal ▿\ 756 | \ 757 | \ 760 |

      \ 761 | 
      \
762 | <#proposal_diff#>\
763 |
      \ 764 |
        \ 765 |
        \ 766 |
        \ 767 |
        \ 768 | '; 769 | 770 | var replyTemplate = '\ 771 |
      • \ 772 |
        \ 773 |
        \ 774 | \ 775 | \ 776 | \ 777 | \ 778 | \ 779 |
        \ 780 |
        \ 781 |
        • '; 782 | 783 | $(document).ready(function() { 784 | init(); 785 | }); 786 | })(jQuery); 787 | 788 | $(document).ready(function() { 789 | // add comment anchors for all paragraphs that are commentable 790 | $('.sphinx-has-comment').comment(); 791 | 792 | // highlight search words in search results 793 | $("div.context").each(function() { 794 | var params = $.getQueryParameters(); 795 | var terms = (params.q) ? params.q[0].split(/\s+/) : []; 796 | var result = $(this); 797 | $.each(terms, function() { 798 | result.highlightText(this.toLowerCase(), 'highlighted'); 799 | }); 800 | }); 801 | 802 | // directly open comment window if requested 803 | var anchor = document.location.hash; 804 | if (anchor.substring(0, 9) == '#comment-') { 805 | $('#ao' + anchor.substring(9)).click(); 806 | document.location.hash = '#s' + anchor.substring(9); 807 | } 808 | }); 809 | -------------------------------------------------------------------------------- /change_log.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 更新日志 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 34 | 35 | 36 | 45 | 79 | 80 |
        81 |
        82 |
        83 |
        84 | 85 |
        86 |

        更新日志

        87 |
        88 |

        2015 年 11 月 2 日

        89 |

        文档正式在 pgsqlcn.com 公开上线。

        90 |
        91 |
        92 |

        2015 年 10 月 25 日

        93 |

        完成 PostgreSQL 手册第一部分的翻译。

        94 |
        95 |
        96 |

        2015 年 10 月 2 日

        97 |

        创建本文档，并开始翻译 PostgreSQL 手册的第一部分。

        98 |
        99 |
        100 | 101 | 102 |
        103 |
        104 |
        105 |
        106 |
        107 | 116 | 120 | 121 | -------------------------------------------------------------------------------- /donate.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 向《PostgreSQL数据库文档》项目捐款 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 34 | 35 | 36 | 45 | 80 | 81 |
        82 |
        83 |
        84 |
        85 | 86 |
        87 |

        向《PostgreSQL数据库文档》项目捐款

        88 |
        89 |

        通过支付宝进行捐款

        90 |

        支付宝用户可以通过扫描以下二维码进行捐款。

        91 | _images/alipay.png 92 |
        93 |
        94 |

        通过微信进行捐款

        95 |

        微信用户可以通过扫描以下二维码来进行捐款。

        96 | _images/wechat.png 97 |
        98 |
        99 |

        出现在捐助者名单中

        100 |

        如果你希望在捐款之后， 101 | 让你的名字出现在下方的捐助者名单中， 102 | 那么你可以将你在捐款时使用的支付宝/微信账号、你的名字以及你的网站链接发送至 huangz1990@gmail.com ， 103 | 译者将在确认你的捐款信息之后， 104 | 将你的名字和网站链接添加到捐助者名单当中。

        105 |

        捐助者名单只会展示你给出的名字和网站链接， 106 | 捐款的具体数目不会公开。

        107 |
        108 |
        109 |

        捐助者名单

        110 |

        以下朋友通过捐款帮助了本项目， 111 | 感谢他们对本项目的支持：

        112 |
          113 |
        • N/A
          • 114 |
        115 |
        116 |
        117 | 118 | 119 |
        120 |
        121 |
        122 |
        123 |
        124 | 133 | 137 | 138 | -------------------------------------------------------------------------------- /genindex.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 索引 — PostgreSQL 数据库文档 12 | 13 | 14 | 15 | 16 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 35 | 36 | 37 | 46 | 66 | 67 |
        68 |
        69 |
        70 |
        71 | 72 | 73 |

        索引

        74 | 75 |
        76 | 77 |
        78 | 79 | 80 |
        81 |
        82 |
        83 |
        84 |
        85 | 94 | 98 | 99 | -------------------------------------------------------------------------------- /index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | PostgreSQL 数据库文档 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 35 | 36 | 37 | 49 | 87 | 88 |
        89 |
        90 |
        91 |
        92 | 93 |
        94 |

        PostgreSQL 数据库文档

        95 |

        本文档是 PostgreSQL 官方手册的中文翻译版本， 96 | 阅读这个文档可以让你学会如何安装、使用、操作和管理 PostgreSQL 。

        97 |

        本文档在演示时使用的 PostgreSQL 版本为 PostgreSQL 9.5 ， 98 | 也即是 PostgreSQL 的测试版本（beta）， 99 | 但是本文档介绍的绝大部分内容也适用于 PostgreSQL 的 9.3 、 9.4 等版本。

        100 |

        访问本文档时， 101 | 请记住本文档的网址为 pgsqlcn.com 。

        102 | _images/pglogo.png 103 |
        104 |

        前言

        105 |
        106 | 109 |
        110 |
        111 |
        112 |

        第 1 部分：使用教程

        113 |

        欢迎阅读 PostgreSQL 使用教程！ 114 | 本教程包含三个章节， 115 | 这些章节旨在帮助读者了解关于 PostgreSQL、关系式数据库概念以及 SQL 语言的一些基本知识。

        116 |

        本教程只要求读者具备基本的电脑使用常识， 117 | 但并不要求读者有 Unix 使用经验或者编程经验。

        118 |

        因为这个教程的主要目的在于向读者传授一些 PostgreSQL 系统关键部分的使用经验， 119 | 所以这个教程并不会对某些主题进行完整和深入的讨论， 120 | 这些讨论将留到文档后续的其他部分进行。

        121 |
        122 | 153 |
        154 |
        155 |
        156 |

        第 2 部分：SQL 语言

        157 |
        158 | 166 |
        167 |
        168 |
        169 |

        关于本文档

        170 |

        本文档由黄健宏（huangz）翻译， 171 | 版权所有， 172 | 未经允许， 173 | 请勿转载。

        174 |

        更新日志列出了本文档的主要更新细节， 175 | 你也可以通过关注文档的 github 项目来随时追踪文档的更新信息。

        176 |

        有任何问题、意见或建议， 177 | 请联系译者进行反馈。

        178 |

        喜欢这个文档的朋友可以通过捐款或者赞助来支持这个文档， 179 | 非常感谢各位对本文档的支持！

        180 |
        181 |
        182 | 183 | 184 |
        185 |
        186 |
        187 |
        188 |
        189 | 201 | 205 | 206 | -------------------------------------------------------------------------------- /objects.inv: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/huangzworks/pgsqlcn/a9b0f9dfecbdc86969254418b033ca86669141bd/objects.inv -------------------------------------------------------------------------------- /preface/what-is-postgresql.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | PostgreSQL 简介 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 36 | 37 | 38 | 53 | 83 | 84 |
        85 |
        86 |
        87 |
        88 | 89 |
        90 |

        PostgreSQL 简介

        91 |

        PostgreSQL 是一个对象关系数据库管理系统（object-relational DBMS）， 92 | 它最初是基于加利福利亚州 Berkeley 大学计算机分部开发的 POSTGRES 系统的 4.2 版本进行开发的。 93 | POSTGRES 率先开创了许多概念， 94 | 这些概念直到很久之后才出现在了某些商业数据库系统里面。

        95 |

        PostgreSQL 是原有的 Berkeley 代码的一个开源后继者， 96 | 它支持大部分 SQL 标准， 97 | 并提供了很多现代化的特性：

        98 |
          99 |
        • 复杂的查询语句
          • 100 |
        • 外部键（foreign keys）
          • 101 |
        • 触发器（triggers）
          • 102 |
        • 可更新的视图（views）
          • 103 |
        • 完整的事务支持
          • 104 |
        • 多版本并发控制（multiversion concurrency control，MVCC）
          • 105 |
        106 |

        除此之外， 107 | 用户还可以通过多种不同的方式对 PostgreSQL 进行扩展。 108 | 比如说， 109 | 用户可以添加新的……：

        110 |
          111 |
        • 数据类型
          • 112 |
        • 函数
          • 113 |
        • 操作符（operators）
          • 114 |
        • 聚合函数（aggregate functions）
          • 115 |
        • 索引方法（index methods）
          • 116 |
        • 过程式语言（procedural languages）
          • 117 |
        118 |

        并且根据 PostgreSQL 的自由许可证（liberal license）， 119 | 用户可以以任何目的， 120 | 免费地在私有、商业或者学术领域， 121 | 使用、修改或者分发 PostgreSQL 。

        122 |
        123 | 124 | 125 |
        126 |
        127 |
        128 |
        129 |
        130 | 145 | 149 | 150 | -------------------------------------------------------------------------------- /search.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 搜索 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 34 | 35 | 36 | 37 | 38 | 41 | 42 | 43 | 44 | 53 | 57 | 58 |
        59 |
        60 |
        61 |
        62 | 63 |

        搜索

        64 |
        65 | 66 |

        67 | 请激活 JavaScript 以开启搜索功能 68 |

        69 |
        70 |

        71 | 在这儿，你可以对这些文档进行搜索。向搜索框中输入你所要搜索的关键字并点击“搜索”。注意：搜索引擎会自动搜索所有的关键字。将不会搜索到部分关键字的页面. 72 |

        73 |
        74 | 75 | 76 | 77 |
        78 | 79 |
        80 | 81 |
        82 | 83 |
        84 |
        85 |
        86 |
        87 |
        88 | 97 | 101 | 102 | -------------------------------------------------------------------------------- /sponsor.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 成为《PostgreSQL数据库文档》的赞助商 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 34 | 35 | 36 | 45 | 69 | 70 |
        71 |
        72 |
        73 |
        74 | 75 |
        76 |

        成为《PostgreSQL数据库文档》的赞助商

        77 |

        公司或组织可以通过赞助本项目来成为本项目的赞助商， 78 | 从而为本项目的翻译工作提供有力的支持， 79 | 作为回报， 80 | 本项目将在页面中展示赞助商指定的宣传信息。

        81 |

        有意成为本项目赞助商的朋友， 82 | 请通过邮件 huangz1990@gmail.com 与本项目的译者取得联系。

        83 |
        84 | 85 | 86 |
        87 |
        88 |
        89 |
        90 |
        91 | 100 | 104 | 105 | -------------------------------------------------------------------------------- /sql/ddl.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 数据定义 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 34 | 35 | 36 | 45 | 78 | 79 |
        80 |
        81 |
        82 |
        83 | 84 |
        85 |

        数据定义

        86 |
        87 |

        表格基础知识

        88 |

        关系式数据库中的表格和纸上的表格非常相似： 89 | 它们都包含着行和列。 90 | 其中列的数量和排列顺序都是固定的， 91 | 并且每个列都有自己的名字； 92 | 而行的数量则是可变动的， 93 | 它取决于给定时刻上被储存的数据数量。 94 | SQL 并不保证表格中行的排列顺序。 95 | 当一个表格被读取的时候， 96 | 除非用户显式地使用了排序操作， 97 | 否则行将以未经指定的顺序出现， 98 | 本文档的第 7 章将对这方面做更多的说明。 99 | 此外， 100 | 因为 SQL 并不会向行分配唯一标识符， 101 | 所以同一个表格里面可能会出现完全相同的行。 102 | 这个问题是由 SQL 底层的数学模型造成的， 103 | 但我们通常并不想表格里面出现完全相同的行， 104 | 本章稍后的内容将介绍如何解决这个问题。

        105 |

        每个列都有自己的数据类型。 106 | 数据类型限制了可以赋予给列的可用值， 107 | 并为储存在列里面的数据赋予了语义， 108 | 使得这些数据可以被用于执行计算。 109 | 比如说， 110 | 一个被声明为由数字类型组成的列是无法储存任何文本字符串（text strings）的， 111 | 并且储存在这个列里面的数据可以用于进行数学计算。 112 | 与此相反， 113 | 如果一个列声明自己是由文字字符串（character string）类型组成的， 114 | 那么它将接受几乎任何类型的数据， 115 | 不过这个列将无法执行数学计算， 116 | 但是诸如字符串拼接这样的操作倒是没有问题的。

        117 |

        PostgreSQL 提供了数量可观的一系列内置数据类型， 118 | 这些数据类型可以适用于非常多应用程序。 119 | 除此之外， 120 | 用户也可以定义他们自己的数据类型。 121 | 大多数内置数据类型都有明显的名字和语义， 122 | 本文档将在第 8 章对这些内置类型进行详细的介绍。 123 | 其中最常用一些数据类型包括表示数字的 integer 类型， 124 | 表示分数的 numeric 类型， 125 | 表示文字字符串的的 text 类型， 126 | 表示日期的 date 类型， 127 | 表示一天中的时间的 time 类型， 128 | 以及包含着日期和时间两个值的 timestamp 类型。

        129 |

        通过使用 CREATE TABLE 命令， 130 | 用户可以创建一个新的表格。 131 | 在调用 CREATE TABLE 命令创建一个新表格时， 132 | 用户至少需要指定新表格的名字、各个列的名字以及各个列的数据类型， 133 | 就像这样：

        134 | 
        CREATE TABLE my_first_table (
135 |     first_column text,
136 |     second_column integer
137 | );
138 |
        139 |
        140 |

        这个命令将创建一个名为 my_first_table 的表格， 141 | 它包含两个列： 142 | 第一个列名为 first_column ， 143 | 数据类型为 text ； 144 | 而第二个列则名为 second_column ， 145 | 数据类型为 integer 。

        146 |

        表格的名字和列的名字需要遵循 4.1.1 节介绍的标识符语法。 147 | 类型名字通常也是标识符， 148 | 但并非所有类型名字也是如此。 149 | 最后需要注意的是， 150 | 列的定义由括号包围， 151 | 并且各个列之间需要用逗号隔开。

        152 |

        上面的表格定义示例有非常浓重的虚构成分。 153 | 在一般情况下， 154 | 我们都会根据表格和列储存的数据的种类来对它们进行命名。 155 | 以下是一个看上去更为真实的表格定义示例：

        156 | 
        CREATE TABLE products (
157 |     product_no integer,
158 |     name text,
159 |     price numeric
160 | );
161 |
        162 |
        163 |

        （numeric 类型可以储存分数， 164 | 这种数字类型通常被用于表示金钱的数量。）

        165 |

        一个表格能够包含的列是有限的： 166 | 根据列的类型不同， 167 | 一个表格最多能够包含的列将介于 250 个至 1600 个之间。 168 | 不过， 169 | 定义一个包含这么多列的表格并不常见， 170 | 而且这通常意味着一个有问题的设计。

        171 |

        当用户不在需要某个表格时， 172 | 他可以使用 DROP TABLE 命令去移除它。 173 | 就像这样：

        174 | 
        DROP TABLE my_first_table;
175 | DROP TABLE products;
176 |
        177 |
        178 |

        尝试删除一个不存在的表格将引发一个错误。 179 | 不过 SQL 脚本文件常常会在创建表格之前， 180 | 先删除可能存在的同名表格， 181 | 并忽略由此产生的所有错误信息， 182 | 从而保证脚本无论在表格是否存在的情况下都能够正常运作。 183 | （如果有需要的话， 184 | 读者可以使用 DROP TABLE 的 DROP TABLE IF EXISTS 变种去避免引发错误， 185 | 但这个变种并非标准的 SQL 命令。）

        186 |

        如果你需要修改一个已经存在的表格， 187 | 那么请看本章稍后 5.5 节介绍的内容。

        188 |

        通过使用上面介绍的工具， 189 | 读者现在已经可以创建出能够正常运作的表格了。 190 | 本章余下的内容将要介绍的是如何通过给表格定义添加额外的特性， 191 | 从而确保数据的完整性和安全性， 192 | 又或者仅仅为了让表格变得更加易于使用。 193 | 如果你现在就急切地想要学习使用数据去填充表格的方法， 194 | 那么可以先去阅读本文档的第 6 章， 195 | 之后再转过头来阅读本章剩余的内容。

        196 |
        197 |
        198 |

        默认值

        199 |

        在 PostgreSQL 中， 200 | 用户可以为列赋予一个默认值。 201 | 当用户创建一个新行， 202 | 但是并没有为其中的某些列指定值的时候， 203 | 那些列就会被赋予它们相应的默认值。 204 | 用户也可以通过数据操作命令（data manipulation command）， 205 | 明确地将一个列设置为它的默认值， 206 | 并且不需要知道哪个默认值到底是什么。 207 | （本文档的第 6 章将对数据操作命令做更详细的介绍。）

        208 |

        如果一个列没有设置默认值， 209 | 那么它的默认值就是控制。 210 | 这种行为一般都是有意义的， 211 | 因为一个空值可以用于表示未知的数据。

        212 |

        在一个表格定义里面， 213 | 默认值可以在列的数据类型之后列出。 214 | 就像这样：

        215 | 
        CREATE TABLE products (
216 |     product_no integer,
217 |     name text,
218 |     price numeric DEFAULT 9.99
219 | );
220 |
        221 |
        222 |

        默认值除了可以是常量之外， 223 | 还可以是一个表达式。 224 | 表达式默认值将在行插入到表格时被求值（而不是在创建表格时被求值）。 225 | 一个比较常见的例子就是， 226 | 通过将 CURRENT_TIMESTAMP 设置为 timestamp 列的默认值， 227 | 我们可以让行在插入到表格时， 228 | 将 timestamp 列的值设置为当时的时间戳。 229 | 使用表达式作为默认值的另一个常见例子， 230 | 是使用默认值去为每个行创建序列号（serial number）， 231 | 这种行为可以通过以下代码来实现：

        232 | 
        CREATE TABLE products (
233 |     product_no integer DEFAULT nextval('products_product_no_seq'),
234 |     ...
235 | );
236 |
        237 |
        238 |

        其中 nextval() 函数负责从序列对象（参见 9.16 节）中获取下一个序列号。 239 | 因为这种做法非常常见， 240 | 所以 PostgreSQL 为其提供了一种等效的快捷方式：

        241 | 
        CREATE TABLE products (
242 |     product_no SERIAL,
243 |     ...
244 | );
245 |
        246 |
        247 |

        本文档的 8.1.4 节将介绍更多关于 SERIAL 的信息。

        248 |
        249 |
        250 | 251 | 252 |
        253 |
        254 |
        255 |
        256 |
        257 | 266 | 270 | 271 | -------------------------------------------------------------------------------- /sql/dml.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 数据操作 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 35 | 36 | 37 | 49 | 86 | 87 |
        88 |
        89 |
        90 |
        91 | 92 |
        93 |

        数据操作

        94 |

        前面的章节介绍了创建表格和其他结构的方法， 95 | 并说明了如何使用这些表格和结构去储存数据， 96 | 现在是时候考虑怎样使用数据去填充表格了。 97 | 本章将介绍插入、更新和删除表格数据的方法， 98 | 而之后的一章将介绍如何从表格里面获取已有的数据。

        99 |
        100 |

        插入数据

        101 |

        一个新创建的表格是不包含任何数据的。 102 | 为了让一个数据库能够发挥它的实际作用， 103 | 我们必须向数据库里面插入数据。 104 | 插入操作是以行为单位进行的： 105 | 尽管用户可以一次插入多个行， 106 | 但是却不能插入少于一个行的数据 —— 107 | 即使用户在执行插入操作时只给出了某些列的值， 108 | 数据库也会为这个插入操作创建一个完整的行。

        109 |

        INSERT 命令接受表格的名字和列的值作为参数， 110 | 并在表格里面创建一个新行。 111 | 举个例子， 112 | 对于第 5 章介绍的 products 表格来说：

        113 | 
        CREATE TABLE products (
114 |     product_no integer,
115 |     name text,
116 |     price numeric
117 | );
118 |
        119 |
        120 |

        以下是一个使用 INSERT 命令去插入新行的例子：

        121 | 
        INSERT INTO products VALUES (1, 'Cheese', 9.99);
122 |
        123 |
        124 |

        用户需要根据列在表格中的次序， 125 | 逐一列出每个数据值， 126 | 并在每个数据值之间使用逗号进行分割。 127 | 通常情况下， 128 | 数据值都是字面量（literals，也即是常量）， 129 | 但使用标量（scalar）作为数据值也是可行的。

        130 |

        上面展示的 INSERT 语法有一个缺点， 131 | 它要求用户记住各个列在表格中的次序， 132 | 不过这个问题可以通过显式地列出各个列来解决。 133 | 举个例子， 134 | 以下两个命令将产生完全相同的效果：

        135 | 
        INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', 9.99);
136 | INSERT INTO products (name, price, product_no) VALUES ('Cheese', 9.99, 1);
137 |
        138 |
        139 |

        很多用户都认为总是列出各个列的名字是一种更好的编程风格。

        140 |

        如果你在插入行的时候， 141 | 缺少某个列的值， 142 | 那么你可以在执行 INSERT 命令时省略那些没有值的域。 143 | 在这种情况下， 144 | 那些没有被设置值的列将被默认值填充。 145 | 就像这样：

        146 | 
        INSERT INTO products (product_no, name) VALUES (1, 'Cheese');
147 | INSERT INTO products VALUES (1, 'Cheese');
148 |
        149 |
        150 |

        第二种语法是 PostgreSQL 的扩展语法： 151 | 这种语法会按照给定值的数量， 152 | 从左到右地填充行的各个列， 153 | 而那些没有给出值的行则使用默认值进行填充。

        154 |

        为了保证清晰性， 155 | 用户也可以显式地要求使用默认值去填充某个单独的列或者整个行：

        156 | 
        INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', DEFAULT);
157 | INSERT INTO products DEFAULT VALUES;
158 |
        159 |
        160 |

        用户也可以在一条命令里面插入多个行：

        161 | 
        INSERT INTO products (product_no, name, price) VALUES
162 |     (1, 'Cheese', 9.99),
163 |     (2, 'Bread', 1.99),
164 |     (3, 'Milk', 2.99);
165 |
        166 |
        167 |
        168 |
        169 |

        更新数据

        170 |

        对已经存在于数据库中的数据进行修改， 171 | 这一操作被称为更新操作。 172 | 用户可以更新表格中的某个行， 173 | 又或者所有行， 174 | 又或者其中一部分行。 175 | 每个列可以单独被更新， 176 | 其他列不会受到影响。

        177 |

        UPDATE 命令可以对一个已经存在的行进行更新， 178 | 这个命令需要三方面的信息：

        179 |
          180 |
        1. 需要更新的表格的名字以及列的名字。
          2. 181 |
        2. 设置给列的新值。
          3. 182 |
        3. 指定需要更新的行。
          4. 183 |
        184 |

        本文档的第 5 章曾经说过， 185 | 在通常情况下， 186 | SQL 并不会为每个行都提供一个唯一标识符。 187 | 由于这个原因， 188 | 用户有时候并不能直接指定需要更新的行； 189 | 而是要指定一些条件， 190 | 并通过这些条件来决定表格中的哪些行将被更新。

        191 |

        只有当用户拥有了表格中某个行的主键时， 192 | 他才能够通过选择一个与主键相匹配的条件， 193 | 确实地对某个单独的行进行更新。 194 | 图形数据库访问工具通常会利用这个原理来实现单独更新某个列的功能。

        195 |

        举个例子， 196 | 以下这个语句将从 products 表格里面找出所有 price 值为 5 的行， 197 | 并把它们的 price 值修改为 10 ：

        198 | 
        UPDATE products SET price = 10 WHERE price = 5;
199 |
        200 |
        201 |

        这个命令可能会造成零个、一个或者很多个行被更新。 202 | 执行一个没有实际效果的更新操作并不会引起错误。

        203 |

        让我们来详细地分析上面的这个命令。 204 | 首先， 205 | 跟在关键字 UPDATE 之后的是表格的名字。 206 | As usual, 207 | the table name can be schema-qualified, 208 | otherwise it is looked up in the path. 209 | 接着， 210 | 跟着关键字 SET 之后的是列的名字， 211 | 一个等号， 212 | 以及要设置给列的新值。 213 | 列的新值既可以是任何标量表达式（scalar expression）， 214 | 也可以是一个常量。 215 | 比如说， 216 | 如果你想要将所有产品的价格都提高 10% ， 217 | 那么可以执行以下命令：

        218 | 
        UPDATE products SET price = price * 1.10;
219 |
        220 |
        221 |

        如你所见， 222 | 一个表达式可以通过引用行里面已有的值去构建新值。 223 | 上面展示的 UPDATE 命令都没有用到 WHERE 语句： 224 | 如果用户在执行 UPDATE 命令时没有给定 WHERE 语句， 225 | 那么表格中的所有行都将被更新； 226 | 另一方面， 227 | 如果用户给定了 WHERE 语句， 228 | 那么只有那些符合 WHERE 语句中指定条件的语句会被更新。 229 | 一个需要注意的地方是， 230 | 当等号出现在 SET 语句里面时， 231 | 它表示的是一个赋值操作； 232 | 而当等号出现在 WHERE 语句里面时， 233 | 它表示的是一次对比操作； 234 | 这两种操作是完全不同的两种操作。 235 | 另外需要注意的一点是， 236 | 虽然 WHERE 语句中的表达式需要计算出一个布尔值结果， 237 | 但这个表达式并不总是为一个相等测试条件： 238 | 除了等号之外， 239 | PostgreSQL 还提供了很多操作符可供使用， 240 | 具体的信息将在本文档的第 9 章进行介绍。

        241 |

        通过在 SET 语句里面列出多个赋值等式， 242 | 用户可以在一条 UPDATE 命令里面对多个列进行更新。 243 | 就像这样：

        244 | 
        UPDATE mytable SET a = 5, b = 3, c = 1 WHERE a > 0;
245 |
        246 |
        247 |
        248 |
        249 |

        删除数据

        250 |

        到目前为止， 251 | 我们学习了将数据添加到表格里面的方法， 252 | 以及对表格里面的数据进行修改的方法， 253 | 那么我们剩下要学习的自然就是移除表格中无用数据的方法了。

        254 |

        就像添加数据时需要将整个行添加到表格里面一样， 255 | 要从表格里面移除数据， 256 | 我们也必须移除整个行。 257 | 上一节曾经提到过， 258 | SQL 并没有提供能够直接访问某个单独的行的方法。 259 | 因此， 260 | 行的移除操作只能通过指定与被移除行相匹配的条件来完成。

        261 |

        如果你拥有表格中某个行的主键的话， 262 | 那么你可以通过那个主键来精确地移除那个行。 263 | 除此之外， 264 | 你也可以通过指定条件来删除一组与条件相匹配的行， 265 | 又或者直接一次性地移除表格中的所有行。

        266 |

        删除行需要用到 DELETE 命令， 267 | 这个命令的语法和 UPDATE 命令非常相似。 268 | 举个例子， 269 | 通过执行以下命令， 270 | 我们可以从 products 表格里面移除价格等于 10 的所有行：

        271 | 
        DELETE FROM products WHERE price = 10;
272 |
        273 |
        274 |

        另一方面， 275 | 如果我们直接执行以下命令：

        276 | 
        DELETE FROM products;
277 |
        278 |
        279 |

        那么 products 表格中的所有行都将被删除！ 280 | 请谨慎地使用这个命令。

        281 |
        282 |
        283 | 284 | 285 |
        286 |
        287 |
        288 |
        289 |
        290 | 302 | 306 | 307 | -------------------------------------------------------------------------------- /tutorial/getting-started.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 入门须知 — PostgreSQL 数据库文档 11 | 12 | 13 | 14 | 15 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 36 | 37 | 38 | 53 | 94 | 95 |
        96 |
        97 |
        98 |
        99 | 100 |
        101 |

        入门须知

        102 |
        103 |

        安装 PostgreSQL

        104 |

        在使用 PostgreSQL 之前， 105 | 我们必须确保 PostgreSQL 已经被安装到了电脑上面。 106 | 在有些情况下， 107 | 某些操作系统发行版可能已经自带了 PostgreSQL ， 108 | 又或者你的系统管理员可能已经帮你安装好了 PostgreSQL ， 109 | 这时你就需要从操作系统手册或者系统管理员那里获取访问 PostgreSQL 所需的信息。

        110 |

        如果你无法确认 PostgreSQL 是否已经安装， 111 | 又或者不确定已有的 PostgreSQL 能否满足你的实验要求， 112 | 那么你可以自己动手安装 PostgreSQL 。 113 | 安装 PostgreSQL 并不困难， 114 | 并且还是一个非常好的练习。 115 | 安装 PostgreSQL 并不需要超级用户（superuser，root）访问权限， 116 | 所以任何非特权（unprivileged）用户都可以自行安装 PostgreSQL 。

        117 |

        如果你需要自行安装 PostgreSQL ， 118 | 那么请查看本文档第 15 章中介绍的安装方法， 119 | 并在安装完成之后再转过头来阅读这一章。 120 | 在阅读安装方法的过程中， 121 | 请特别注意文中关于设置正确的环境变量的那一节。

        122 |

        如果系统管理员没有按照默认的方法对 PostgreSQL 进行设置， 123 | 那么你可能就需要做一些额外的工作。 124 | 比如说， 125 | 如果数据库服务器是一个远程服务器， 126 | 那么你就需要将 PGHOST 环境变量设置为那个数据库服务器的名字， 127 | 并将 PGPORT 环境变量设置为那个服务器的端口号。

        128 |

        关于服务器设置的一个底线是： 129 | 如果你在尝试启动一个应用程序的时候， 130 | 该程序向你抱怨它无法连接到服务器， 131 | 那么你就应该联系你的管理员； 132 | 如果你的服务器是由你自己管理的， 133 | 那么你就应该去阅读相关的文档， 134 | 确保相关的环境已经被正确地设置。

        135 |
        136 |
        137 |

        基本架构

        138 |

        在学习如何操作 PostgreSQL 之前， 139 | 我们需要先了解一下 PostgreSQL 系统的基本架构。 140 | 理解 PostgreSQL 的各个部分是如何进行交互的， 141 | 将有助于我们学习本章接下来要介绍的知识。

        142 |

        用数据库的行话来讲， 143 | PostgreSQL 使用的是客户端/服务器模型。 144 | 一个 PostgreSQL 会话（session）由以下协作进程（程序）组成：

        145 |
          146 |
        • 一个服务器进程， 147 | 它负责管理数据库文件、接受客户端程序对数据库的连接请求， 148 | 并对数据库执行客户端指定的动作。 149 | 这个数据库服务器程序的名字叫做 postgres 。
          • 150 |
        151 |
          152 |
        • 客户端（又称“前端”）程序， 153 | 用户使用这些程序来指定对数据库的操作。 154 | 客户端程序在本质上可以是非常多样的： 155 | 一个客户端可以是一个文本工具、 156 | 一个图形程序、 157 | 一个通过访问数据库来显示网页的 web 服务器， 158 | 又或者是一个专门的数据库维护工具。 159 | 某些客户端程序是跟着 PostgreSQL 一起发行的， 160 | 而其他大部分客户端则是由用户自己开发的。
          • 161 |
        162 |

        跟典型的客户端/服务器程序一样， 163 | PostgreSQL 的客户端和服务器双方可以运行在不同的主机（host）上面。 164 | 在这种情况下， 165 | 客户端和服务器将通过 TCP/IP 网络连接进行通讯。 166 | 读者应该牢牢记住这一点， 167 | 因为在客户端主机上能够访问的文件， 168 | 在服务器主机上并不一定能够访问 169 | （又或者需要以不同的名字来访问）。

        170 |

        PostgreSQL 服务器能够并发地处理来自多个客户端的多个连接。 171 | 为了做到这一点， 172 | 服务器会为每个连接都启动（或者说，fork）一个新的进程。 173 | 在此之后， 174 | 客户端和新进程就可以直接进行通讯， 175 | 而不必担心被原来的 postgres 进程打扰。 176 | 因此， 177 | 主服务器进程将一直运行， 178 | 等待客户端的连接请求； 179 | 与此相反， 180 | 客户端和与之相关联的服务器进程则会不断地出现和消逝。 181 | （当然， 182 | 以上这些操作对于用户来说都是透明的， 183 | 在这里提及这些知识只是为了完整性考虑。）

        184 |
        185 |
        186 |

        创建数据库

        187 |

        为了判断我们能否访问数据库服务器， 188 | 我们首先要做的一个测试就是尝试去创建一个数据库。 189 | 一个运行中的 PostgreSQL 服务器可以管理多个数据库。 190 | 一般来说， 191 | 每个用户都会为自己的每个项目独立使用一个数据库。

        192 |

        如果你的系统管理员已经帮你创建好了数据库， 193 | 并且他已经把属于你的数据库的名字告诉了你， 194 | 那么你就可以跳过本节介绍的步骤， 195 | 直接阅读下一节。

        196 |

        举个例子， 197 | 要创建一个名为 mydb 的新数据库， 198 | 你可以使用以下命令：

        199 | 
        $ createdb mydb
200 |
        201 |
        202 |

        如果这个操作没有返回任何响应信息， 203 | 那么说明操作成功， 204 | 请跳过本节余下的部分， 205 | 直接阅读下一节。

        206 |

        如果你看见了一条类似这样的信息：

        207 | 
        createdb: command not found
208 |
        209 |
        210 |

        那么说明 PostgreSQL 并未被正确地安装。 211 | 一个可能是 PostgreSQL 并未被安装， 212 | 而另一个可能则是终端没有在搜索路径里面包含 PostgreSQL 所在的位置。 213 | 你可以尝试通过绝对路径直接执行命令：

        214 | 
        $ /usr/local/pgsql/bin/createdb mydb
215 |
        216 |
        217 |

        在不同的机器上面， 218 | PostgreSQL 所在的路径可能会有所不同。 219 | 请联系你的系统管理员， 220 | 又或者根据安装手册的指示改正执行命令时的路径。

        221 |

        执行 createdb 命令可能得到的另一个回复是：

        222 | 
        createdb: could not connect to database postgres: could not connect to server: No such file or directory
223 |         Is the server running locally and accepting
224 |         connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
225 |
        226 |
        227 |

        这个回复表示服务器并未启动， 228 | 又或者它并未以 createdb 期待的方式启动。 229 | 同样地， 230 | 在遇到这个问题时， 231 | 请检查安装手册， 232 | 或者联系你的系统管理员。

        233 |

        除了以上两种情况之外， 234 | createdb 还可能会回复一条包含了你的 PostgreSQL 用户名的错误信息：

        235 | 
        createdb: could not connect to database postgres: FATAL:  role "joe" does not exist
236 |
        237 |
        238 |

        当你的系统管理员没有为你创建 PostgreSQL 用户账号的时候， 239 | 这种回复就会出现。 240 | （注意， 241 | PostgreSQL 的用户账号和操作系统的用户账号并不是一回事。）

        242 |

        如果你就是系统管理员， 243 | 那么请查看本文档的第 20 章， 244 | 学习创建用户的具体步骤。 245 | 为了创建第一个 PostgreSQL 用户账号， 246 | 你将需要成为安装了 PostgreSQL 的那个操作系统用户组属下的用户（这个用户组通常被命名为 postgres ）。

        247 |

        还有一种可能出现的情况， 248 | 就是分配给你的 PostgreSQL 用户名和你的操作系统用户名并不相同； 249 | 在这种情况下， 250 | 你就需要使用 -U 去切换或者设置 PGUSER 环境变量， 251 | 从而指定你的 PostgreSQL 用户名。

        252 |

        如果你拥有了一个账号， 253 | 但该账号并不具备创建数据库所需的权限， 254 | 那么你将看见以下信息：

        255 | 
        createdb: database creation failed: ERROR:  permission denied to create database
256 |
        257 |
        258 |

        如果你遇到了这种情况， 259 | 那么说明你并不具备创建新数据库所需的权限。 260 | 为此， 261 | 你需要联系系统管理员， 262 | 让他授予（grant）你创建数据库的权力。 263 | 如果你是自己安装 PostgreSQL 的， 264 | 那么为了执行这个教程里面展示的操作， 265 | 你需要登录启动 PostgreSQL 服务器时使用的那个账号。

        266 |

        PostgreSQL 允许用户在同一台机器上面创建任意数量的数据库， 267 | 因此除了上面提到的 mydb 之外， 268 | 用户还可以创建其他不同名字的数据库。 269 | 数据库名字必须以英文字母开头， 270 | 并且长度不能超过 63 个字节。 271 | 一种常见的做法是创建一个与当前用户名字相同的数据库。 272 | 很多工具都会假设用户的名字就是数据库的名字， 273 | 并通过这一假设来减少用户需要输入的字符数量。 274 | 要创建一个与用户名同名的数据库， 275 | 用户只需要直接执行以下命令就可以了：

        276 | 
        $ createdb
277 |
        278 |
        279 |

        当你不再想要使用数据库的时候， 280 | 你可以考虑移除它。 281 | 比如说， 282 | 如果你是 mydb 数据库的拥有者（创建者）， 283 | 那么你可以使用以下命令来销毁它：

        284 | 
        $ dropdb mydb
285 |
        286 |
        287 |

        dropdb 命令将从物理上移除与 mydb 数据库有关的所有文件， 288 | 并且这个操作是无法撤销的， 289 | 因此你在执行 dropdb 的时候一定要三思而后行。 290 | 跟 createdb 命令一样， 291 | 如果被移除的数据库跟用户名同名， 292 | 那么用户只需要执行 dropdb 就可以直接删除与用户名同名的那个数据库。

        293 |

        要了解关于 createdb 命令和 dropdb 命令的更多信息， 294 | 请参考 createdb 的文档和 dropdb 的文档。

        295 |
        296 |
        297 |

        访问数据库

        298 |

        在创建了数据库之后， 299 | 我们就可以通过以下几种方法去访问数据库：

        300 |
          301 |
        • 运行名为 psql 的 PostgreSQL 交互终端程序， 302 | 这个程序允许用户交互式地输入、编辑和执行 SQL 命令。
          • 303 |
        • 使用类似 pgAdmin 这样的图形前端工具， 304 | 又或者带有 ODBC 或 JDBC 支持的 office 套件来创建和操作数据库。
          • 305 |
        • 在多种可用的语言绑定（bindings）里面， 306 | 选择一种去编写一个定制的程序。 307 | 本文档的第 4 章列出了所有可选的语言绑定。
          • 308 |
        309 |

        本教程将使用 psql 程序来展示如何执行数据库命令。 310 | 要通过 psql 程序来访问 mydb 数据库， 311 | 我们可以执行以下命令：

        312 | 
        $ psql mydb
313 |
        314 |
        315 |

        跟之前介绍的 createdb 程序一样， 316 | 如果用户在执行 psql 程序的时候， 317 | 没有指定要访问的数据库， 318 | 那么 psql 将访问与用户的用户名同名的数据库。

        319 |

        在进入 psql 程序之后， 320 | 你将看到以下信息：

        321 | 
        psql (9.5beta1)
322 | Type "help" for help.
323 | 
324 | mydb=>
325 |
        326 |
        327 |

        在某些情况下， 328 | 消息的最后一行也可能是这样的：

        329 | 
        mydb=#
330 |
        331 |
        332 |

        这意味着你是数据库的超级用户。 333 | 如果你是自己亲自安装 PostgreSQL 的话， 334 | 那么你通常就会是这种超级用户。

        335 |

        成为超级管理员意味着你将不受制于访问控制规则， 336 | 但对于本教程要展示的内容来说， 337 | 用户是否超级管理员并不重要。

        338 |

        如果你在启动 psql 程序的时候遇上了问题， 339 | 那么请阅读前一个小节。 340 | 因为 createdb 和 psql 可能遇上的问题都是相似的， 341 | 所以如果 createdb 能够成功运作， 342 | 那么 psql 一般也不会出现什么问题。

        343 |

        psql 打印的最后一行为提示符（prompt）， 344 | 它意味着 psql 正在等候你的指示， 345 | 这时你就可以将 SQL 查询语句键入到 psql 维护的工作空间（work space）当中。 346 | 你可以尝试键入以下语句：

        347 | 
        mydb=> SELECT version();
348 |                                                     version
349 | -----------------------------------------------------------------------------------------------------------------
350 | PostgreSQL 9.5beta1 on x86_64-apple-darwin15.0.0, compiled by Apple LLVM version 7.0.0 (clang-700.1.76), 64-bit
351 | (1 row)
352 | 
353 | mydb=> SELECT current_date;
354 |     date
355 | ------------
356 |  2015-11-02
357 | (1 row)
358 | 
359 | mydb=> SELECT 2 + 2;
360 |  ?column?
361 | ----------
362 |         4
363 | (1 row)
364 |
        365 |
        366 |

        psql 程序提供了一些不属于 SQL 命令的内部命令， 367 | 这些命令都以反斜线符号 "\" 开头。 368 | 举个例子， 369 | 你可以通过输入以下命令来获得关于不同的 PostgreSQL SQL 命令的语法帮助信息：

        370 | 
        mydb=> \h
371 |
        372 |
        373 |

        要退出 psql ， 374 | 你可以输入：

        375 | 
        mydb=> \q
376 |
        377 |
        378 |

        然后 psql 就会退出并返回至你原来的命令行。 379 | （要了解更多内部命令， 380 | 请在 psql 提示符中输入 \? 。） 381 | psql 的文档 记录了 psql 的各项特性， 382 | 本文档并不会显式地使用这些特性， 383 | 但你可以在需要的时候自行使用它们。

        384 |
        385 |
        386 | 387 | 388 |
        389 |
        390 |
        391 |
        392 |
        393 | 408 | 412 | 413 | --------------------------------------------------------------------------------