0000: 44 20 32 30 31 38 2d 30 39 2d 30 36 54 30 39 3a D 2018-09-06T09:
0010: 30 33 3a 31 31 2e 38 35 34 0a 4c 20 53 74 6f 72 03:11.854.L Stor
0020: 65 64 5c 73 50 72 6f 63 65 64 75 72 65 73 0a 50 ed\sProcedures.P
0030: 20 38 65 31 31 31 34 65 64 35 30 65 33 30 32 39 8e1114ed50e3029
0040: 34 36 35 38 34 37 33 61 61 61 34 61 62 35 66 66 4658473aaa4ab5ff
0050: 33 33 34 61 34 37 31 32 37 0a 55 20 73 61 6e 64 334a47127.U sand
0060: 72 6f 0a 57 20 34 39 30 30 31 0a 3c 74 61 62 6c ro.W 49001.<tabl
0070: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 31 e cellspacing="1
0080: 32 22 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 2" width="100%">
0090: 0d 0a 3c 74 72 3e 3c 74 64 20 63 6f 6c 73 70 61 ..<tr><td colspa
00a0: 6e 3d 22 32 22 3e 0d 0a 3c 74 61 62 6c 65 20 77 n="2">..<table w
00b0: 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 6f idth="100%" bgco
00c0: 6c 6f 72 3d 22 23 66 30 66 30 66 38 22 3e 0d 0a lor="#f0f0f8">..
00d0: 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 <tr><td align="c
00e0: 65 6e 74 65 72 22 3e 0d 0a 3c 2f 74 64 3e 3c 2f enter">..</td></
00f0: 74 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 74 61 tr></table>..<ta
0100: 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 22 ble width="100%"
0110: 3e 3c 74 72 3e 0d 0a 3c 74 64 20 77 69 64 74 68 ><tr>..<td width
0120: 3d 22 33 33 25 22 20 61 6c 69 67 6e 3d 22 6c 65 ="33%" align="le
0130: 66 74 22 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 61 ft"></td>..<td a
0140: 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 3c 61 lign="center"><a
0150: 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 href="https://w
0160: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 ww.gaia-gis.it/f
0170: 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c ossil/libspatial
0180: 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e ite/wiki?name=4.
0190: 33 2e 30 2b 64 6f 63 22 3e 62 61 63 6b 20 74 6f 3.0+doc">back to
01a0: 20 69 6e 64 65 78 3c 2f 61 3e 3c 2f 74 64 3e 0d index</a></td>.
01b0: 0a 3c 74 64 20 77 69 64 74 68 3d 22 33 33 25 22 .<td width="33%"
01c0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 3c align="right"><
01d0: 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 3c 2f 74 61 62 /td>..</tr></tab
01e0: 6c 65 3e 0d 0a 3c 68 31 3e 53 51 4c 20 50 72 6f le>..<h1>SQL Pro
01f0: 63 65 64 75 72 65 73 2c 20 53 74 6f 72 65 64 20 cedures, Stored
0200: 50 72 6f 63 65 64 75 72 65 73 20 61 6e 64 20 53 Procedures and S
0210: 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 73 3a tored Variables:
0220: 20 61 20 71 75 69 63 6b 20 69 6e 74 72 6f 3c 2f a quick intro</
0230: 68 31 3e 0d 0a 53 74 61 72 74 69 6e 67 20 77 69 h1>..Starting wi
0240: 74 68 20 76 65 72 73 69 6f 6e 20 3c 62 3e 35 2e th version <b>5.
0250: 30 2e 30 3c 2f 62 3e 2c 20 53 70 61 74 69 61 4c 0.0</b>, SpatiaL
0260: 69 74 65 20 73 75 70 70 6f 72 74 73 20 61 6e 20 ite supports an
0270: 61 64 76 61 6e 63 65 64 20 6d 65 63 68 61 6e 69 advanced mechani
0280: 73 6d 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 sm intended to s
0290: 69 67 6e 69 66 69 63 61 6e 74 6c 79 20 65 78 74 ignificantly ext
02a0: 65 6e 64 20 74 68 65 20 73 63 72 69 70 74 69 6e end the scriptin
02b0: 67 20 74 65 63 68 6e 69 71 75 65 73 20 61 6c 6c g techniques all
02c0: 6f 77 69 6e 67 20 66 6f 72 20 61 20 70 6f 77 65 owing for a powe
02d0: 72 66 75 6c 20 61 6e 64 20 66 6c 65 78 69 62 6c rful and flexibl
02e0: 65 20 61 75 74 6f 6d 61 74 69 6f 6e 20 6f 66 20 e automation of
02f0: 63 6f 6d 70 6c 65 78 20 77 6f 72 6b 66 6c 6f 77 complex workflow
0300: 73 2e 3c 62 72 3e 0d 0a 54 68 69 6e 6b 20 6f 66 s.<br>..Think of
0310: 20 74 68 65 20 6e 69 63 65 20 66 6c 65 78 69 62 the nice flexib
0320: 69 6c 69 74 79 20 70 6f 73 73 69 62 6c 65 2c 20 ility possible,
0330: 62 79 20 6d 69 78 69 6e 67 20 73 74 61 6e 64 61 by mixing standa
0340: 72 64 20 3c 62 3e 3c 69 3e 53 51 4c 20 73 63 72 rd <b><i>SQL scr
0350: 69 70 74 73 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 ipts</i></b> and
0360: 20 3c 62 3e 3c 69 3e 56 61 72 69 61 62 6c 65 73 <b><i>Variables
0370: 3c 2f 69 3e 3c 2f 62 3e 20 77 68 69 63 68 20 61 </i></b> which a
0380: 72 65 20 72 65 70 6c 61 63 65 64 20 62 65 66 6f re replaced befo
0390: 72 65 20 62 65 69 6e 67 20 65 78 65 63 75 74 65 re being execute
03a0: 64 2e 0d 0a 4e 6f 74 20 6f 6e 6c 79 20 74 68 61 d...Not only tha
03b0: 74 2c 20 62 75 74 20 74 68 69 6e 6b 20 6f 66 20 t, but think of
03c0: 74 68 65 20 6d 61 6e 79 20 77 6f 6e 64 65 72 66 the many wonderf
03d0: 75 6c 20 6f 70 70 6f 72 74 75 6e 69 74 69 65 73 ul opportunities
03e0: 20 6f 66 66 65 72 65 64 20 62 79 20 70 65 72 6d offered by perm
03f0: 61 6e 65 6e 74 6c 79 20 73 74 6f 72 69 6e 67 2c anently storing,
0400: 20 77 69 74 68 69 6e 20 61 20 64 61 74 61 62 61 within a databa
0410: 73 65 2c 20 3c 62 3e 3c 69 3e 53 51 4c 20 53 63 se, <b><i>SQL Sc
0420: 72 69 70 74 73 20 77 69 74 68 20 56 61 72 69 61 ripts with Varia
0430: 62 6c 65 73 3c 2f 69 3e 3c 2f 62 3e 2c 20 73 69 bles</i></b>, si
0440: 6d 70 6c 69 66 79 69 6e 67 20 63 6f 6d 6d 6f 6e mplifying common
0450: 20 61 75 74 6f 6d 61 74 65 64 20 77 6f 72 6b 66 automated workf
0460: 6c 6f 77 73 20 74 68 61 74 20 61 72 65 20 72 65 lows that are re
0470: 70 65 61 74 65 64 6c 79 20 65 78 65 63 75 74 65 peatedly execute
0480: 64 2e 20 54 68 69 73 20 69 73 20 65 78 61 63 74 d. This is exact
0490: 6c 79 20 74 68 65 20 69 6e 74 65 6e 64 65 64 20 ly the intended
04a0: 73 63 6f 70 65 20 6f 66 20 74 68 69 73 20 6e 65 scope of this ne
04b0: 77 20 6d 6f 64 75 6c 65 2e 3c 62 72 3e 3c 62 72 w module.<br><br
04c0: 3e 0d 0a 57 65 27 6c 6c 20 73 74 61 72 74 20 66 >..We'll start f
04d0: 69 72 73 74 20 62 79 20 64 65 66 69 6e 69 6e 67 irst by defining
04e0: 20 61 20 66 65 77 20 62 61 73 69 63 20 63 6f 6e a few basic con
04f0: 63 65 70 74 73 20 61 6e 64 20 6f 62 6a 65 63 74 cepts and object
0500: 69 76 65 73 2c 20 73 6f 20 61 73 20 74 6f 20 61 ives, so as to a
0510: 76 6f 69 64 20 61 6e 79 20 70 6f 73 73 69 62 6c void any possibl
0520: 65 20 63 6f 6e 66 75 73 69 6f 6e 2e 3c 62 72 3e e confusion.<br>
0530: 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32 3e <br>..<hr>..<h2>
0540: 42 61 73 69 63 20 44 65 66 69 6e 69 74 69 6f 6e Basic Definition
0550: 73 20 61 6e 64 20 43 6f 6e 63 65 70 74 73 3c 2f s and Concepts</
0560: 68 32 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 0d h2>..<ol>..<li>.
0570: 0a 3c 68 34 3e 53 51 4c 20 53 74 61 74 65 6d 65 .<h4>SQL Stateme
0580: 6e 74 3c 2f 68 34 3e 0d 0a 54 68 65 20 6d 69 6e nt</h4>..The min
0590: 69 6d 61 6c 20 65 78 65 63 75 74 69 6f 6e 20 75 imal execution u
05a0: 6e 69 74 20 61 6c 6c 6f 77 65 64 20 62 79 20 53 nit allowed by S
05b0: 51 4c 20 73 79 6e 74 61 78 3b 20 61 20 73 74 61 QL syntax; a sta
05c0: 6e 64 2d 61 6c 6f 6e 65 20 53 51 4c 20 64 69 72 nd-alone SQL dir
05d0: 65 63 74 69 76 65 20 74 6f 20 62 65 20 61 74 6f ective to be ato
05e0: 6d 69 63 61 6c 6c 79 20 65 78 65 63 75 74 65 64 mically executed
05f0: 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 73 74 65 in a single ste
0600: 70 2e 20 3c 62 72 3e 0d 0a 53 61 6d 70 6c 65 73 p. <br>..Samples
0610: 3a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 :..<verbatim>..S
0620: 45 4c 45 43 54 20 69 64 2c 20 6e 61 6d 65 2c 20 ELECT id, name,
0630: 6d 65 61 73 75 72 65 20 46 52 4f 4d 20 73 6f 6d measure FROM som
0640: 65 5f 74 61 62 6c 65 3b 0d 0a 2d 2d 2d 2d 2d 2d e_table;..------
0650: 2d 2d 2d 2d 2d 2d 0d 0a 44 45 4c 45 54 45 20 46 ------..DELETE F
0660: 52 4f 4d 20 73 6f 6d 65 5f 74 61 62 6c 65 20 57 ROM some_table W
0670: 48 45 52 45 20 6d 65 61 73 75 72 65 20 3e 20 31 HERE measure > 1
0680: 30 30 30 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 000;..----------
0690: 2d 2d 0d 0a 55 50 44 41 54 45 20 73 6f 6d 65 5f --..UPDATE some_
06a0: 74 61 62 6c 65 20 53 45 54 20 6d 65 61 73 75 72 table SET measur
06b0: 65 20 3d 20 6d 65 61 73 75 72 65 20 2f 20 31 30 e = measure / 10
06c0: 2e 30 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d .0..</verbatim>.
06d0: 0a 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3a 20 53 51 .<u>Note</u>: SQ
06e0: 4c 20 53 74 61 74 65 6d 65 6e 74 73 20 61 72 65 L Statements are
06f0: 20 75 73 75 61 6c 6c 79 20 65 78 70 65 63 74 65 usually expecte
0700: 64 20 74 6f 20 62 65 20 65 78 70 6c 69 63 69 74 d to be explicit
0710: 6c 79 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79 ly terminated by
0720: 20 61 20 3c 62 3e 3c 69 3e 73 65 6d 69 63 6f 6c a <b><i>semicol
0730: 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 28 3c 62 3e 3c on</i></b> (<b><
0740: 69 3e 3b 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c 62 72 i>;</i></b>).<br
0750: 3e 0d 0a 54 68 65 20 73 65 6d 69 63 6f 6c 6f 6e >..The semicolon
0760: 20 74 65 72 6d 69 6e 61 74 6f 72 20 63 61 6e 20 terminator can
0770: 62 65 20 73 61 66 65 6c 79 20 73 75 70 70 72 65 be safely suppre
0780: 73 73 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 74 ssed only when t
0790: 68 65 20 53 51 4c 20 53 74 61 74 65 6d 65 6e 74 he SQL Statement
07a0: 20 69 73 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 is immediately
07b0: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 73 74 followed by a st
07c0: 72 69 6e 67 20 74 65 72 6d 69 6e 61 74 6f 72 20 ring terminator
07d0: 28 6c 65 61 64 69 6e 67 20 61 6e 64 20 74 72 61 (leading and tra
07e0: 69 6c 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20 iling sequences
07f0: 6f 66 20 61 6c 6c 20 3c 62 3e 3c 69 3e 62 6c 61 of all <b><i>bla
0800: 6e 6b 73 3c 2f 69 3e 3c 2f 62 3e 20 77 69 6c 6c nks</i></b> will
0810: 20 62 65 20 61 6c 77 61 79 73 20 69 67 6e 6f 72 be always ignor
0820: 65 64 29 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 3c 68 ed)...<br><br><h
0830: 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d r>..</li>..<li>.
0840: 0a 3c 68 34 3e 53 51 4c 20 53 63 72 69 70 74 3c .<h4>SQL Script<
0850: 2f 68 34 3e 0d 0a 41 20 6d 6f 72 65 20 6f 72 20 /h4>..A more or
0860: 6c 65 73 73 20 63 6f 6d 70 6c 65 78 20 63 6f 6c less complex col
0870: 6c 65 63 74 69 6f 6e 20 6f 66 20 3c 62 3e 3c 69 lection of <b><i
0880: 3e 53 51 4c 20 53 74 61 74 65 6d 65 6e 74 73 3c >SQL Statements<
0890: 2f 69 3e 3c 2f 62 3e 2c 20 70 6f 73 73 69 62 6c /i></b>, possibl
08a0: 79 20 69 6e 63 6c 75 64 69 6e 67 20 69 6e 74 65 y including inte
08b0: 72 6c 65 61 76 65 64 20 3c 62 3e 3c 69 3e 43 6f rleaved <b><i>Co
08c0: 6d 6d 65 6e 74 73 3c 2f 69 3e 3c 2f 62 3e 20 61 mments</i></b> a
08d0: 6e 64 2f 6f 72 20 3c 62 3e 3c 69 3e 44 6f 74 20 nd/or <b><i>Dot
08e0: 4d 61 63 72 6f 73 3c 2f 69 3e 3c 2f 62 3e 2e 3c Macros</i></b>.<
08f0: 62 72 3e 0d 0a 53 51 4c 20 53 63 72 69 70 74 73 br>..SQL Scripts
0900: 20 61 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f are intended to
0910: 20 62 65 20 65 78 65 63 75 74 65 64 20 69 6e 20 be executed in
0920: 61 20 73 69 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 a single monolit
0930: 68 69 63 20 70 61 73 73 20 28 61 74 6f 6d 69 63 hic pass (atomic
0940: 61 6c 6c 79 20 6f 72 20 6e 6f 74 2c 20 64 65 70 ally or not, dep
0950: 65 6e 64 69 6e 67 20 6f 6e 20 69 6e 74 65 72 6e ending on intern
0960: 61 6c 20 3c 62 3e 3c 69 3e 54 72 61 6e 73 61 63 al <b><i>Transac
0970: 74 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 68 61 6e tion</i></b> han
0980: 64 6c 69 6e 67 29 2e 20 45 78 61 6d 70 6c 65 3a dling). Example:
0990: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2e 65 ..<verbatim>...e
09a0: 63 68 6f 20 6f 6e 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d cho on....--..--
09b0: 20 73 74 61 72 74 69 6e 67 20 61 20 54 72 61 6e starting a Tran
09c0: 73 61 63 74 69 6f 6e 0d 0a 2d 2d 0d 0a 42 45 47 saction..--..BEG
09d0: 49 4e 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 63 72 IN;....--..-- cr
09e0: 65 61 74 69 6e 67 20 61 20 74 61 62 6c 65 0d 0a eating a table..
09f0: 2d 2d 0d 0a 43 52 45 41 54 45 20 54 41 42 4c 45 --..CREATE TABLE
0a00: 20 65 78 61 6d 70 6c 65 20 28 0d 0a 20 20 69 64 example (.. id
0a10: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 INTEGER PRIMARY
0a20: 20 4b 45 59 20 41 55 54 4f 49 4e 43 52 45 4d 45 KEY AUTOINCREME
0a30: 4e 54 2c 0d 0a 20 20 6e 61 6d 65 20 54 45 58 54 NT,.. name TEXT
0a40: 20 4e 4f 54 20 4e 55 4c 4c 2c 0d 0a 20 20 76 61 NOT NULL,.. va
0a50: 6c 75 65 20 44 4f 55 42 4c 45 29 3b 0d 0a 0d 0a lue DOUBLE);....
0a60: 2d 2d 0d 0a 2d 2d 20 70 6f 70 75 6c 61 74 69 6e --..-- populatin
0a70: 67 20 74 68 65 20 74 61 62 6c 65 0d 0a 2d 2d 0d g the table..--.
0a80: 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 65 78 61 .INSERT INTO exa
0a90: 6d 70 6c 65 20 28 69 64 2c 20 6e 61 6d 65 2c 20 mple (id, name,
0aa0: 76 61 6c 75 65 29 20 56 41 4c 55 45 53 20 28 4e value) VALUES (N
0ab0: 55 4c 4c 2c 20 27 66 69 72 73 74 27 2c 20 31 32 ULL, 'first', 12
0ac0: 2e 33 34 29 3b 0d 0a 49 4e 53 45 52 54 20 49 4e .34);..INSERT IN
0ad0: 54 4f 20 65 78 61 6d 70 6c 65 20 28 69 64 2c 20 TO example (id,
0ae0: 6e 61 6d 65 2c 20 76 61 6c 75 65 29 20 56 41 4c name, value) VAL
0af0: 55 45 53 20 28 4e 55 4c 4c 2c 20 27 73 65 63 6f UES (NULL, 'seco
0b00: 6e 64 27 2c 20 35 36 2e 37 38 29 3b 0d 0a 49 4e nd', 56.78);..IN
0b10: 53 45 52 54 20 49 4e 54 4f 20 65 78 61 6d 70 6c SERT INTO exampl
0b20: 65 20 28 69 64 2c 20 6e 61 6d 65 2c 20 76 61 6c e (id, name, val
0b30: 75 65 29 20 56 41 4c 55 45 53 20 28 4e 55 4c 4c ue) VALUES (NULL
0b40: 2c 20 27 74 68 69 72 64 27 2c 20 4e 55 4c 4c 29 , 'third', NULL)
0b50: 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 63 6f 6d 6d ;....--..-- comm
0b60: 69 74 74 69 6e 67 20 74 68 65 20 70 65 6e 64 69 itting the pendi
0b70: 6e 67 20 54 72 61 6e 73 61 63 74 69 6f 6e 0d 0a ng Transaction..
0b80: 2d 2d 0d 0a 43 4f 4d 4d 49 54 3b 0d 0a 0d 0a 2e --..COMMIT;.....
0b90: 71 75 69 74 0d 0a 3c 2f 76 65 72 62 61 74 69 6d quit..</verbatim
0ba0: 3e 0d 0a 3c 68 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a >..<hr>..</li>..
0bb0: 3c 6c 69 3e 0d 0a 3c 68 34 3e 53 51 4c 20 56 61 <li>..<h4>SQL Va
0bc0: 72 69 61 62 6c 65 3c 2f 68 34 3e 0d 0a 41 20 3c riable</h4>..A <
0bd0: 62 3e 3c 69 3e 53 51 4c 20 56 61 72 69 61 62 6c b><i>SQL Variabl
0be0: 65 3c 2f 69 3e 3c 2f 62 3e 20 69 73 20 6a 75 73 e</i></b> is jus
0bf0: 74 20 61 20 70 6c 61 63 65 68 6f 6c 64 65 72 20 t a placeholder
0c00: 73 79 6d 62 6f 6c 2c 20 74 68 61 74 20 6c 61 74 symbol, that lat
0c10: 65 72 20 6d 75 73 74 20 62 65 20 72 65 73 6f 6c er must be resol
0c20: 76 65 64 2c 20 65 6e 63 6c 6f 73 65 64 20 62 65 ved, enclosed be
0c30: 74 77 65 65 6e 20 74 77 6f 20 3c 69 3e 3c 75 3e tween two <i><u>
0c40: 73 70 65 63 69 61 6c 20 6d 61 72 6b 65 72 73 3c special markers<
0c50: 2f 75 3e 3c 2f 69 3e 20 28 3c 62 3e 3c 69 3e 40 /u></i> (<b><i>@
0c60: 3c 2f 69 3e 3c 2f 62 3e 20 6f 72 20 3c 62 3e 3c </i></b> or <b><
0c70: 69 3e 24 3c 2f 69 3e 3c 2f 62 3e 29 2e 20 45 78 i>$</i></b>). Ex
0c80: 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 61 74 amples:..<verbat
0c90: 69 6d 3e 0d 0a 40 74 61 62 6c 65 5f 6e 61 6d 65 im>..@table_name
0ca0: 40 0d 0a 40 63 6f 6c 5f 6e 61 6d 65 40 0d 0a 24 @..@col_name@..$
0cb0: 76 61 6c 75 65 24 0d 0a 24 72 61 64 69 75 73 24 value$..$radius$
0cc0: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c ..</verbatim>..<
0cd0: 75 3e 4e 6f 74 65 3c 2f 75 3e 3a 20 75 73 69 6e u>Note</u>: usin
0ce0: 67 20 74 68 65 20 3c 62 3e 3c 69 3e 40 3c 2f 69 g the <b><i>@</i
0cf0: 3e 3c 2f 62 3e 20 6f 72 20 74 68 65 20 3c 62 3e ></b> or the <b>
0d00: 3c 69 3e 24 3c 2f 69 3e 3c 2f 62 3e 20 6d 61 72 <i>$</i></b> mar
0d10: 6b 65 72 73 20 69 73 20 6a 75 73 74 20 61 20 3c kers is just a <
0d20: 69 3e 3c 75 3e 6d 61 74 74 65 72 20 6f 66 20 63 i><u>matter of c
0d30: 68 6f 69 63 65 3c 2f 75 3e 3c 2f 69 3e 3b 20 62 hoice</u></i>; b
0d40: 6f 74 68 20 68 61 76 65 20 69 64 65 6e 74 69 63 oth have identic
0d50: 61 6c 20 6d 65 61 6e 69 6e 67 20 61 6e 64 20 70 al meaning and p
0d60: 72 61 63 74 69 63 61 6c 20 65 66 66 65 63 74 2e ractical effect.
0d70: 0d 0a 3c 62 72 3e 3c 62 72 3e 3c 68 72 3e 0d 0a ..<br><br><hr>..
0d80: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 </li>..<li>..<h4
0d90: 3e 53 51 4c 20 42 6f 64 79 3c 2f 68 34 3e 0d 0a >SQL Body</h4>..
0da0: 41 20 3c 62 3e 3c 69 3e 53 51 4c 20 53 63 72 69 A <b><i>SQL Scri
0db0: 70 74 3c 2f 69 3e 3c 2f 62 3e 20 74 68 61 74 20 pt</i></b> that
0dc0: 69 6e 74 65 72 6e 61 6c 6c 79 20 75 73 65 73 20 internally uses
0dd0: 3c 62 3e 3c 69 3e 56 61 72 69 61 62 6c 65 73 3c <b><i>Variables<
0de0: 2f 69 3e 3c 2f 62 3e 2e 20 45 78 61 6d 70 6c 65 /i></b>. Example
0df0: 3a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2e :..<verbatim>...
0e00: 65 63 68 6f 20 6f 6e 0d 0a 0d 0a 2d 2d 0d 0a 2d echo on....--..-
0e10: 2d 20 73 74 61 72 74 69 6e 67 20 61 20 54 72 61 - starting a Tra
0e20: 6e 73 61 63 74 69 6f 6e 0d 0a 2d 2d 0d 0a 42 45 nsaction..--..BE
0e30: 47 49 4e 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 63 GIN;....--..-- c
0e40: 72 65 61 74 69 6e 67 20 61 20 74 61 62 6c 65 0d reating a table.
0e50: 0a 2d 2d 0d 0a 43 52 45 41 54 45 20 54 41 42 4c .--..CREATE TABL
0e60: 45 20 40 74 61 62 6c 65 40 20 28 0d 0a 20 20 40 E @table@ (.. @
0e70: 70 6b 40 20 49 4e 54 45 47 45 52 20 50 52 49 4d pk@ INTEGER PRIM
0e80: 41 52 59 20 4b 45 59 20 41 55 54 4f 49 4e 43 52 ARY KEY AUTOINCR
0e90: 45 4d 45 4e 54 2c 0d 0a 20 20 40 63 6f 6c 31 40 EMENT,.. @col1@
0ea0: 20 54 45 58 54 20 4e 4f 54 20 4e 55 4c 4c 2c 0d TEXT NOT NULL,.
0eb0: 0a 20 20 40 63 6f 6c 32 40 20 44 4f 55 42 4c 45 . @col2@ DOUBLE
0ec0: 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 70 6f 70 );....--..-- pop
0ed0: 75 6c 61 74 69 6e 67 20 74 68 65 20 74 61 62 6c ulating the tabl
0ee0: 65 0d 0a 2d 2d 0d 0a 49 4e 53 45 52 54 20 49 4e e..--..INSERT IN
0ef0: 54 4f 20 40 74 61 62 6c 65 40 20 28 40 70 6b 40 TO @table@ (@pk@
0f00: 2c 20 40 63 6f 6c 31 40 2c 20 40 63 6f 6c 32 40 , @col1@, @col2@
0f10: 29 20 56 41 4c 55 45 53 20 28 4e 55 4c 4c 2c 20 ) VALUES (NULL,
0f20: 27 66 69 72 73 74 27 2c 20 31 32 2e 33 34 29 3b 'first', 12.34);
0f30: 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 40 74 ..INSERT INTO @t
0f40: 61 62 6c 65 40 20 28 40 70 6b 40 2c 20 40 63 6f able@ (@pk@, @co
0f50: 6c 31 40 2c 20 40 63 6f 6c 32 40 29 20 56 41 4c l1@, @col2@) VAL
0f60: 55 45 53 20 28 4e 55 4c 4c 2c 20 27 73 65 63 6f UES (NULL, 'seco
0f70: 6e 64 27 2c 20 35 36 2e 37 38 29 3b 0d 0a 49 4e nd', 56.78);..IN
0f80: 53 45 52 54 20 49 4e 54 4f 20 40 74 61 62 6c 65 SERT INTO @table
0f90: 40 20 28 40 70 6b 40 2c 20 40 63 6f 6c 32 40 2c @ (@pk@, @col2@,
0fa0: 20 40 63 6f 6c 32 40 29 20 56 41 4c 55 45 53 20 @col2@) VALUES
0fb0: 28 4e 55 4c 4c 2c 20 27 74 68 69 72 64 27 2c 20 (NULL, 'third',
0fc0: 4e 55 4c 4c 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d NULL);....--..--
0fd0: 20 63 6f 6d 6d 69 74 74 69 6e 67 20 74 68 65 20 committing the
0fe0: 70 65 6e 64 69 6e 67 20 54 72 61 6e 73 61 63 74 pending Transact
0ff0: 69 6f 6e 0d 0a 2d 2d 0d 0a 43 4f 4d 4d 49 54 3b ion..--..COMMIT;
1000: 0d 0a 0d 0a 2e 71 75 69 74 0d 0a 3c 2f 76 65 72 .....quit..</ver
1010: 62 61 74 69 6d 3e 0d 0a 3c 75 3e 4e 6f 74 65 3c batim>..<u>Note<
1020: 2f 75 3e 3a 20 74 68 69 73 20 73 65 63 6f 6e 64 /u>: this second
1030: 20 76 65 72 73 69 6f 6e 20 69 73 20 6f 62 76 69 version is obvi
1040: 6f 75 73 6c 79 20 6d 6f 72 65 20 66 6c 65 78 69 ously more flexi
1050: 62 6c 65 20 74 68 61 6e 20 74 68 65 20 69 6e 69 ble than the ini
1060: 74 69 61 6c 20 53 51 4c 20 73 63 72 69 70 74 2c tial SQL script,
1070: 20 62 65 63 61 75 73 65 20 74 68 65 20 74 61 62 because the tab
1080: 6c 65 2d 6e 61 6d 65 73 20 61 6e 64 20 63 6f 6c le-names and col
1090: 75 6d 6e 2d 6e 61 6d 65 73 20 61 72 65 20 6e 6f umn-names are no
10a0: 20 6c 6f 6e 67 65 72 20 3c 75 3e 3c 69 3e 68 61 longer <u><i>ha
10b0: 72 64 63 6f 64 65 64 3c 2f 69 3e 3c 2f 75 3e 2c rdcoded</i></u>,
10c0: 20 62 75 74 20 3c 75 3e 3c 69 3e 64 79 6e 61 6d but <u><i>dynam
10d0: 69 63 3c 2f 69 3e 3c 2f 75 3e 2e 3c 62 72 3e 0d ic</i></u>.<br>.
10e0: 0a 53 6f 20 77 65 20 61 72 65 20 6e 6f 77 20 66 .So we are now f
10f0: 72 65 65 20 74 6f 20 72 65 75 73 65 20 74 68 69 ree to reuse thi
1100: 73 20 53 51 4c 20 42 6f 64 79 2c 20 69 6e 20 61 s SQL Body, in a
1110: 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6e 74 65 different conte
1120: 78 74 20 61 66 74 65 72 20 73 65 74 74 69 6e 67 xt after setting
1130: 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 the appropriate
1140: 20 56 61 72 69 61 62 6c 65 20 56 61 6c 75 65 73 Variable Values
1150: 20 62 65 66 6f 72 65 20 65 78 65 63 75 74 69 6f before executio
1160: 6e 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c n.<br><br>..<b><
1170: 69 3e 53 51 4c 20 42 6f 64 69 65 73 3c 2f 69 3e i>SQL Bodies</i>
1180: 3c 2f 62 3e 20 65 78 69 73 74 20 69 6e 20 74 77 </b> exist in tw
1190: 6f 20 64 69 66 66 65 72 65 6e 74 20 66 6f 72 6d o different form
11a0: 73 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 s:..<ul>..<li><b
11b0: 3e 72 61 77 3c 2f 62 3e 3a 20 63 6f 6e 74 61 69 >raw</b>: contai
11c0: 6e 69 6e 67 20 74 68 65 20 73 79 6d 62 6f 6c 69 ning the symboli
11d0: 63 20 56 61 72 69 61 62 6c 65 73 2e 3c 2f 6c 69 c Variables.</li
11e0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 63 6f 6f 6b 65 64 >..<li><b>cooked
11f0: 3c 2f 62 3e 3a 20 77 69 74 68 20 74 68 65 20 73 </b>: with the s
1200: 79 6d 62 6f 6c 69 63 20 56 61 72 69 61 62 6c 65 ymbolic Variable
1210: 73 20 70 72 6f 70 65 72 6c 79 20 72 65 70 6c 61 s properly repla
1220: 63 65 64 20 62 79 20 74 68 65 20 61 63 74 75 61 ced by the actua
1230: 6c 20 76 61 6c 75 65 73 2e 3c 62 72 3e 0d 0a 4f l values.<br>..O
1240: 62 76 69 6f 75 73 6c 79 2c 20 6f 6e 6c 79 20 74 bviously, only t
1250: 68 65 20 3c 62 3e 3c 69 3e 63 6f 6f 6b 65 64 3c he <b><i>cooked<
1260: 2f 69 3e 3c 2f 62 3e 20 66 6f 72 6d 20 63 61 6e /i></b> form can
1270: 20 62 65 20 73 75 63 63 65 73 73 66 75 6c 6c 79 be successfully
1280: 20 65 78 65 63 75 74 65 64 2e 3c 2f 6c 69 3e 0d executed.</li>.
1290: 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 3c 68 72 3e .</ul>..<br><hr>
12a0: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c ..</li>..<li>..<
12b0: 68 34 3e 53 51 4c 20 50 72 6f 63 65 64 75 72 65 h4>SQL Procedure
12c0: 20 42 4c 4f 42 20 6f 62 6a 65 63 74 3c 2f 68 34 BLOB object</h4
12d0: 3e 0d 0a 54 68 69 73 20 73 69 6d 70 6c 79 20 69 >..This simply i
12e0: 73 20 61 20 3c 62 3e 3c 69 3e 42 4c 4f 42 20 65 s a <b><i>BLOB e
12f0: 6e 63 6f 64 65 64 3c 2f 69 3e 3c 2f 62 3e 20 77 ncoded</i></b> w
1300: 69 74 68 20 74 68 65 20 70 72 65 2d 63 6f 6d 70 ith the pre-comp
1310: 69 6c 65 64 20 27 3c 75 3e 3c 69 3e 72 61 77 3c iled '<u><i>raw<
1320: 2f 69 3e 3c 2f 75 3e 27 20 3c 62 3e 3c 69 3e 53 /i></u>' <b><i>S
1330: 51 4c 20 42 6f 64 79 3c 2f 69 3e 3c 2f 62 3e 2c QL Body</i></b>,
1340: 20 77 68 69 63 68 20 77 69 6c 6c 20 62 65 20 75 which will be u
1350: 73 65 64 20 62 79 20 20 70 72 61 63 74 69 63 61 sed by practica
1360: 6c 6c 79 20 61 6c 6c 20 53 51 4c 20 66 75 6e 63 lly all SQL func
1370: 74 69 6f 6e 73 20 73 75 70 70 6f 72 74 69 6e 67 tions supporting
1380: 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 Stored Procedur
1390: 65 73 2e 20 0d 0a 3c 62 72 3e 3c 62 72 3e 3c 68 es. ..<br><br><h
13a0: 72 3e 20 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e r> ..</li>..<li>
13b0: 0d 0a 3c 68 34 3e 53 74 6f 72 65 64 20 50 72 6f ..<h4>Stored Pro
13c0: 63 65 64 75 72 65 3c 2f 68 34 3e 0d 0a 41 20 3c cedure</h4>..A <
13d0: 62 3e 3c 69 3e 53 51 4c 20 50 72 6f 63 65 64 75 b><i>SQL Procedu
13e0: 72 65 20 42 4c 4f 42 20 6f 62 6a 65 63 74 3c 2f re BLOB object</
13f0: 69 3e 3c 2f 62 3e 20 74 68 61 74 20 69 73 20 70 i></b> that is p
1400: 65 72 6d 61 6e 65 6e 74 6c 79 20 73 74 6f 72 65 ermanently store
1410: 64 20 69 6e 74 6f 20 61 20 64 61 74 61 62 61 73 d into a databas
1420: 65 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 6d 61 6b e.<br>..This mak
1430: 65 73 20 69 74 20 65 61 73 69 65 72 20 74 6f 20 es it easier to
1440: 75 73 65 20 69 6e 20 61 20 61 75 74 6f 6d 61 74 use in a automat
1450: 65 64 20 20 77 6f 72 6b 66 6c 6f 77 2c 20 70 65 ed workflow, pe
1460: 72 68 61 70 73 20 74 6f 20 62 65 20 69 6d 70 6c rhaps to be impl
1470: 65 6d 65 6e 74 65 64 20 61 73 20 61 20 72 6f 75 emented as a rou
1480: 74 69 6e 65 6c 79 20 70 65 72 69 6f 64 69 63 20 tinely periodic
1490: 74 61 73 6b 20 28 64 61 69 6c 79 20 2f 20 77 65 task (daily / we
14a0: 65 6b 6c 79 20 2f 20 6d 6f 6e 74 68 6c 79 20 61 ekly / monthly a
14b0: 6e 64 20 73 6f 20 6f 6e 29 2e 3c 62 72 3e 0d 0a nd so on).<br>..
14c0: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
14d0: 73 20 61 6c 77 61 79 73 20 63 6f 6e 74 61 69 6e s always contain
14e0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 the following e
14f0: 6c 65 6d 65 6e 74 73 3a 0d 0a 3c 75 6c 3e 0d 0a lements:..<ul>..
1500: 3c 6c 69 3e 61 20 3c 62 3e 6e 61 6d 65 3c 2f 62 <li>a <b>name</b
1510: 3e 2c 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 >, intended to b
1520: 65 20 61 6e 20 75 6e 69 71 75 65 20 69 64 65 6e e an unique iden
1530: 74 69 66 69 65 72 20 28 3c 62 3e 3c 69 3e 50 72 tifier (<b><i>Pr
1540: 69 6d 61 72 79 20 4b 65 79 3c 2f 69 3e 3c 2f 62 imary Key</i></b
1550: 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 >).</li>..<li>a
1560: 3c 62 3e 74 69 74 6c 65 3c 2f 62 3e 2c 20 69 2e <b>title</b>, i.
1570: 65 2e 20 61 20 73 68 6f 72 74 20 64 65 73 63 72 e. a short descr
1580: 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 69 6e iption of the in
1590: 74 65 6e 64 65 64 20 73 63 6f 70 65 20 6f 66 20 tended scope of
15a0: 74 68 65 20 53 74 6f 72 65 64 20 50 72 6f 63 65 the Stored Proce
15b0: 64 75 72 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e dure.</li>..<li>
15c0: 61 20 3c 62 3e 53 51 4c 20 50 72 6f 63 65 64 75 a <b>SQL Procedu
15d0: 72 65 20 42 4c 4f 42 20 4f 62 6a 65 63 74 3c 2f re BLOB Object</
15e0: 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d b>.</li>..</ul>.
15f0: 0a 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 2f 6c 69 3e .<br><hr>..</li>
1600: 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 3e 56 61 72 69 ..<li>..<h4>Vari
1610: 61 62 6c 65 20 77 69 74 68 20 56 61 6c 75 65 20 able with Value
1620: 73 74 72 69 6e 67 73 3c 2f 68 34 3e 0d 0a 42 65 strings</h4>..Be
1630: 66 6f 72 65 20 65 78 65 63 75 74 69 6e 67 20 61 fore executing a
1640: 20 27 3c 69 3e 72 61 77 3c 2f 69 3e 27 20 3c 62 '<i>raw</i>' <b
1650: 3e 3c 69 3e 53 51 4c 20 42 6f 64 79 3c 2f 69 3e ><i>SQL Body</i>
1660: 3c 2f 62 3e 20 28 77 69 74 68 20 70 6c 61 63 65 </b> (with place
1670: 68 6f 6c 64 65 72 20 3c 62 3e 3c 69 3e 56 61 72 holder <b><i>Var
1680: 69 61 62 6c 65 73 3c 2f 69 3e 3c 2f 62 3e 29 2c iables</i></b>),
1690: 20 74 68 65 73 65 20 56 61 72 69 61 62 6c 65 73 these Variables
16a0: 20 6e 65 65 64 20 74 6f 20 62 65 20 72 65 70 6c need to be repl
16b0: 61 63 65 64 20 28 27 3c 69 3e 63 6f 6f 6b 65 64 aced ('<i>cooked
16c0: 3c 2f 69 3e 27 29 20 77 69 74 68 20 74 68 65 20 </i>') with the
16d0: 61 70 70 72 6f 70 72 69 61 74 65 20 3c 62 3e 3c appropriate <b><
16e0: 69 3e 56 61 6c 75 65 73 3c 2f 69 3e 3c 2f 62 3e i>Values</i></b>
16f0: 2c 20 74 68 69 73 20 70 72 6f 70 65 72 6c 79 20 , this properly
1700: 74 72 61 6e 73 66 6f 72 6d 69 6e 67 20 61 20 27 transforming a '
1710: 3c 62 3e 72 61 77 3c 2f 62 3e 27 20 53 51 4c 20 <b>raw</b>' SQL
1720: 42 6f 64 79 20 69 6e 74 6f 20 61 20 27 3c 62 3e Body into a '<b>
1730: 63 6f 6f 6b 65 64 3c 2f 62 3e 27 20 53 51 4c 20 cooked</b>' SQL
1740: 42 6f 64 79 2e 3c 62 72 3e 0d 0a 41 20 3c 62 3e Body.<br>..A <b>
1750: 3c 69 3e 56 61 72 69 61 62 6c 65 20 77 69 74 68 <i>Variable with
1760: 20 56 61 6c 75 65 3c 2f 69 3e 3c 2f 62 3e 20 73 Value</i></b> s
1770: 74 72 69 6e 67 20 73 69 6d 70 6c 79 20 69 73 20 tring simply is
1780: 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 6c 79 an appropriately
1790: 20 77 65 6c 6c 2d 66 6f 72 6d 61 74 74 65 64 20 well-formatted
17a0: 54 65 78 74 20 73 74 72 69 6e 67 20 64 65 63 6c Text string decl
17b0: 61 72 69 6e 67 20 62 6f 74 68 20 74 68 65 20 53 aring both the S
17c0: 79 6d 62 6f 6c 20 61 6e 64 20 74 68 65 20 63 6f ymbol and the co
17d0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 72 65 70 6c rresponding repl
17e0: 61 63 65 6d 65 6e 74 20 56 61 6c 75 65 20 28 65 acement Value (e
17f0: 78 70 72 65 73 73 65 64 20 69 6e 20 69 74 73 20 xpressed in its
1800: 74 65 78 74 75 61 6c 20 72 65 70 72 65 73 65 6e textual represen
1810: 74 61 74 69 6f 6e 29 2e 20 45 78 61 6d 70 6c 65 tation). Example
1820: 73 3a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a s:..<verbatim>..
1830: 40 76 61 6c 75 65 5f 31 40 3d 31 32 33 34 20 20 @value_1@=1234
1840: 20 20 20 20 20 20 20 20 20 20 2d 2d 20 69 6e 74 -- int
1850: 65 67 65 72 20 76 61 6c 75 65 0d 0a 40 76 61 6c eger value..@val
1860: 75 65 5f 32 40 3d 31 32 2e 33 34 20 20 20 20 20 ue_2@=12.34
1870: 20 20 20 20 20 20 2d 2d 20 64 6f 75 62 6c 65 20 -- double
1880: 76 61 6c 75 65 0d 0a 40 76 61 6c 75 65 5f 33 40 value..@value_3@
1890: 3d 4e 65 77 20 59 6f 72 6b 20 43 69 74 79 20 20 =New York City
18a0: 20 2d 2d 20 74 65 78 74 20 76 61 6c 75 65 0d 0a -- text value..
18b0: 40 76 61 6c 75 65 5f 34 40 3d 78 27 30 31 32 33 @value_4@=x'0123
18c0: 61 62 63 64 27 20 20 20 20 20 2d 2d 20 62 6c 6f abcd' -- blo
18d0: 62 20 76 61 6c 75 65 0d 0a 40 76 61 6c 75 65 5f b value..@value_
18e0: 35 40 3d 4e 55 4c 4c 20 20 20 20 20 20 20 20 20 5@=NULL
18f0: 20 20 20 2d 2d 20 6e 75 6c 6c 20 76 61 6c 75 65 -- null value
1900: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c ..</verbatim>..<
1910: 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 table bgcolor="#
1920: 66 38 66 38 64 38 22 20 63 65 6c 6c 70 61 64 64 f8f8d8" cellpadd
1930: 69 6e 67 3d 22 36 22 20 63 65 6c 6c 73 70 61 63 ing="6" cellspac
1940: 69 6e 67 3d 22 38 22 3e 3c 74 72 3e 3c 74 64 3e ing="8"><tr><td>
1950: 0d 0a 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3a 20 72 ..<u>Note</u>: r
1960: 65 70 6c 61 63 69 6e 67 20 56 61 72 69 61 62 6c eplacing Variabl
1970: 65 73 20 77 69 74 68 20 74 68 65 20 61 63 74 75 es with the actu
1980: 61 6c 20 56 61 6c 75 65 73 20 69 73 20 61 20 62 al Values is a b
1990: 6c 69 6e 64 20 70 72 6f 63 65 73 73 20 63 6f 6d lind process com
19a0: 70 6c 65 74 65 6c 79 20 69 6e 73 65 6e 73 69 62 pletely insensib
19b0: 6c 65 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 le to the specif
19c0: 69 63 20 73 79 6e 74 61 63 74 69 63 20 63 6f 6e ic syntactic con
19d0: 74 65 78 74 2e 3c 62 72 3e 0d 0a 59 6f 75 20 61 text.<br>..You a
19e0: 72 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 re responsible f
19f0: 6f 72 20 74 68 65 20 63 6f 72 72 65 63 74 20 61 or the correct a
1a00: 70 70 6c 69 63 61 74 69 6f 6e 20 6f 66 20 73 69 pplication of si
1a10: 6e 67 6c 65 2d 20 6f 72 20 64 6f 75 62 6c 65 2d ngle- or double-
1a20: 71 75 6f 74 69 6e 67 2c 20 72 65 71 75 69 72 65 quoting, require
1a30: 64 20 62 79 20 74 68 65 20 53 51 4c 20 73 79 6e d by the SQL syn
1a40: 74 61 78 20 72 75 6c 65 73 2e 0d 0a 3c 2f 74 64 tax rules...</td
1a50: 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a ></tr></table>..
1a60: 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 2f 6c 69 3e 0d <br><hr>..</li>.
1a70: 0a 3c 6c 69 3e 0d 0a 3c 68 34 3e 53 74 6f 72 65 .<li>..<h4>Store
1a80: 64 20 56 61 72 69 61 62 6c 65 3c 2f 68 34 3e 0d d Variable</h4>.
1a90: 0a 41 20 3c 62 3e 3c 69 3e 56 61 72 69 61 62 6c .A <b><i>Variabl
1aa0: 65 20 77 69 74 68 20 56 61 6c 75 65 3c 2f 69 3e e with Value</i>
1ab0: 3c 2f 62 3e 20 70 65 72 6d 61 6e 65 6e 74 6c 79 </b> permanently
1ac0: 20 73 74 6f 72 65 64 20 69 6e 74 6f 20 61 20 64 stored into a d
1ad0: 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 53 74 atabase.<br>..St
1ae0: 6f 72 65 64 20 56 61 72 69 61 62 6c 65 73 20 61 ored Variables a
1af0: 6c 77 61 79 73 20 63 6f 6e 74 61 69 6e 20 74 68 lways contain th
1b00: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 6c 65 6d e following elem
1b10: 65 6e 74 73 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 ents:..<ul>..<li
1b20: 3e 61 20 3c 62 3e 6e 61 6d 65 3c 2f 62 3e 2c 20 >a <b>name</b>,
1b30: 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 61 intended to be a
1b40: 6e 20 75 6e 69 71 75 65 20 69 64 65 6e 74 69 66 n unique identif
1b50: 69 65 72 20 28 3c 62 3e 3c 69 3e 50 72 69 6d 61 ier (<b><i>Prima
1b60: 72 79 20 4b 65 79 3c 2f 69 3e 3c 2f 62 3e 29 2e ry Key</i></b>).
1b70: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 3c 62 3e </li>..<li>a <b>
1b80: 74 69 74 6c 65 3c 2f 62 3e 2c 20 69 2e 65 2e 20 title</b>, i.e.
1b90: 61 20 73 68 6f 72 74 20 64 65 73 63 72 69 70 74 a short descript
1ba0: 69 6f 6e 20 6f 66 20 74 68 65 20 69 6e 74 65 6e ion of the inten
1bb0: 64 65 64 20 73 63 6f 70 65 20 6f 66 20 74 68 65 ded scope of the
1bc0: 20 53 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 Stored Variable
1bd0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 3c 62 .</li>..<li>a <b
1be0: 3e 56 61 6c 75 65 20 73 74 72 69 6e 67 3c 2f 62 >Value string</b
1bf0: 3e 2e 3c 2f 6c 69 3e 3c 62 72 3e 0d 0a 3c 2f 75 >.</li><br>..</u
1c00: 6c 3e 3c 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 l><table bgcolor
1c10: 3d 22 23 66 38 66 38 64 38 22 20 63 65 6c 6c 70 ="#f8f8d8" cellp
1c20: 61 64 64 69 6e 67 3d 22 36 22 20 63 65 6c 6c 73 adding="6" cells
1c30: 70 61 63 69 6e 67 3d 22 38 22 3e 3c 74 72 3e 3c pacing="8"><tr><
1c40: 74 64 3e 0d 0a 3c 75 3e 4e 6f 74 65 3c 2f 75 3e td>..<u>Note</u>
1c50: 3a 20 74 68 65 20 69 6e 74 65 6e 64 65 64 20 73 : the intended s
1c60: 63 6f 70 65 20 6f 66 20 3c 62 3e 53 74 6f 72 65 cope of <b>Store
1c70: 64 20 56 61 72 69 61 62 6c 65 73 3c 2f 62 3e 20 d Variables</b>
1c80: 69 73 20 74 6f 20 64 65 66 69 6e 65 20 61 70 70 is to define app
1c90: 72 6f 70 72 69 61 74 65 20 64 65 66 61 75 6c 74 ropriate default
1ca0: 20 76 61 6c 75 65 73 2e 3c 62 72 3e 0d 0a 49 66 values.<br>..If
1cb0: 20 61 20 67 69 76 65 6e 20 3c 62 3e 56 61 72 69 a given <b>Vari
1cc0: 61 62 6c 65 3c 2f 62 3e 20 69 73 20 62 65 69 6e able</b> is bein
1cd0: 67 20 75 73 65 64 20 77 69 74 68 69 6e 20 61 20 g used within a
1ce0: 3c 69 3e 72 61 77 3c 2f 69 3e 20 53 51 4c 20 42 <i>raw</i> SQL B
1cf0: 6f 64 79 20 74 6f 20 62 65 20 65 78 65 63 75 74 ody to be execut
1d00: 65 64 2c 20 61 6e 64 20 61 20 63 6f 72 72 65 73 ed, and a corres
1d10: 70 6f 6e 64 69 6e 67 20 3c 62 3e 56 61 72 69 61 ponding <b>Varia
1d20: 62 6c 65 20 77 69 74 68 20 56 61 6c 75 65 3c 2f ble with Value</
1d30: 62 3e 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 b> has not been
1d40: 72 65 73 6f 6c 76 65 64 2c 20 74 68 65 6e 20 61 resolved, then a
1d50: 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 n attempt will b
1d60: 65 20 61 6c 77 61 79 73 20 6d 61 64 65 20 74 6f e always made to
1d70: 20 72 65 73 6f 6c 76 65 20 69 74 20 62 79 20 73 resolve it by s
1d80: 65 61 72 63 68 69 6e 67 20 66 6f 72 20 61 20 63 earching for a c
1d90: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 62 3e orresponding <b>
1da0: 53 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 3c Stored Variable<
1db0: 2f 62 3e 20 62 79 20 6e 61 6d 65 20 28 69 66 20 /b> by name (if
1dc0: 69 74 20 65 78 69 73 74 73 29 2e 3c 62 72 3e 0d it exists).<br>.
1dd0: 0a 41 6e 20 65 78 70 6c 69 63 69 74 6c 79 20 64 .An explicitly d
1de0: 65 66 69 6e 65 64 20 3c 62 3e 56 61 72 69 61 62 efined <b>Variab
1df0: 6c 65 20 77 69 74 68 20 56 61 6c 75 65 3c 2f 62 le with Value</b
1e00: 3e 20 61 72 67 75 6d 65 6e 74 20 77 69 6c 6c 20 > argument will
1e10: 61 6c 77 61 79 73 20 74 61 6b 65 20 70 72 65 63 always take prec
1e20: 65 64 65 6e 63 65 20 6f 76 65 72 20 74 68 65 20 edence over the
1e30: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 62 corresponding <b
1e40: 3e 53 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 >Stored Variable
1e50: 3c 2f 62 3e 3b 20 69 6e 20 6f 74 68 65 72 20 77 </b>; in other w
1e60: 6f 72 64 73 20 61 20 3c 62 3e 53 74 6f 72 65 64 ords a <b>Stored
1e70: 20 56 61 72 69 61 62 6c 65 3c 2f 62 3e 20 28 69 Variable</b> (i
1e80: 66 20 64 65 66 69 6e 65 64 29 20 77 69 6c 6c 20 f defined) will
1e90: 6a 75 73 74 20 62 65 20 63 6f 6e 73 69 64 65 72 just be consider
1ea0: 65 64 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 ed the default v
1eb0: 61 6c 75 65 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 alue...</td></tr
1ec0: 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c ></table>..<br><
1ed0: 68 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e hr>..</li>..<li>
1ee0: 0d 0a 3c 68 34 3e 53 51 4c 20 4c 6f 67 66 69 6c ..<h4>SQL Logfil
1ef0: 65 3c 2f 68 34 3e 0d 0a 53 51 4c 20 71 75 65 72 e</h4>..SQL quer
1f00: 69 65 73 20 77 69 6c 6c 20 75 73 75 61 6c 6c 79 ies will usually
1f10: 20 72 65 74 75 72 6e 20 73 6f 6d 65 20 3c 62 3e return some <b>
1f20: 72 65 73 75 6c 74 73 65 74 3c 2f 62 3e 20 70 6f resultset</b> po
1f30: 74 65 6e 74 69 61 6c 6c 79 20 63 6f 6e 74 61 69 tentially contai
1f40: 6e 69 6e 67 20 75 73 65 66 75 6c 20 69 6e 66 6f ning useful info
1f50: 72 6d 61 74 69 6f 6e 2e 3c 62 72 3e 0d 0a 42 75 rmation.<br>..Bu
1f60: 74 20 65 78 65 63 75 74 69 6e 67 20 61 20 3c 62 t executing a <b
1f70: 3e 53 51 4c 20 50 72 6f 63 65 64 75 72 65 3c 2f >SQL Procedure</
1f80: 62 3e 20 6f 72 20 3c 62 3e 53 74 6f 72 65 64 20 b> or <b>Stored
1f90: 50 72 6f 63 65 64 75 72 65 3c 2f 62 3e 20 77 69 Procedure</b> wi
1fa0: 6c 6c 20 62 65 20 73 65 65 6e 20 62 79 20 53 51 ll be seen by SQ
1fb0: 4c 69 74 65 20 6a 75 73 74 20 61 73 20 61 20 73 Lite just as a s
1fc0: 69 6d 70 6c 65 20 53 51 4c 20 66 75 6e 63 74 69 imple SQL functi
1fd0: 6f 6e 20 63 61 6c 6c 20 73 69 6d 70 6c 79 20 72 on call simply r
1fe0: 65 74 75 72 6e 69 6e 67 20 61 20 66 69 6e 61 6c eturning a final
1ff0: 20 73 75 63 63 65 73 73 20 6f 72 20 66 61 69 6c success or fail
2000: 75 72 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ure return code.
2010: 3c 62 72 3e 0d 0a 41 6e 79 20 69 6e 66 6f 72 6d <br>..Any inform
2020: 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 6c 6c 20 ation about all
2030: 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65 the intermediate
2040: 20 72 65 73 75 6c 74 73 65 74 73 2c 20 69 6e 74 resultsets, int
2050: 65 72 6e 61 6c 6c 79 20 70 72 6f 64 75 63 65 64 ernally produced
2060: 20 64 75 72 69 6e 67 20 74 68 65 20 65 78 65 63 during the exec
2070: 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 50 72 6f ution of the Pro
2080: 63 65 64 75 72 65 2c 20 77 69 6c 6c 20 62 65 20 cedure, will be
2090: 6c 6f 73 74 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 54 lost.<br><br>..T
20a0: 6f 20 61 76 6f 69 64 20 74 68 69 73 2c 20 79 6f o avoid this, yo
20b0: 75 20 63 61 6e 20 63 6f 6e 66 69 67 75 72 65 20 u can configure
20c0: 61 6e 20 65 78 74 65 72 6e 61 6c 20 3c 62 3e 53 an external <b>S
20d0: 51 4c 20 4c 6f 67 66 69 6c 65 3c 2f 62 3e 20 74 QL Logfile</b> t
20e0: 6f 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 73 74 o permanently st
20f0: 6f 72 65 20 61 6c 6c 20 69 6e 74 65 72 6d 65 64 ore all intermed
2100: 69 61 74 65 20 72 65 73 75 6c 74 73 65 74 73 20 iate resultsets
2110: 69 6e 74 6f 20 61 6e 20 6f 72 64 69 6e 61 72 79 into an ordinary
2120: 20 74 65 78 74 20 66 69 6c 65 2e 20 54 68 65 20 text file. The
2130: 53 51 4c 20 4c 6f 67 66 69 6c 65 20 73 75 70 70 SQL Logfile supp
2140: 6f 72 74 73 20 74 77 6f 20 64 69 66 66 65 72 65 orts two differe
2150: 6e 74 20 6d 6f 64 65 73 3a 0d 0a 3c 75 6c 3e 0d nt modes:..<ul>.
2160: 0a 3c 6c 69 3e 3c 62 3e 54 72 75 6e 63 61 74 65 .<li><b>Truncate
2170: 3c 2f 62 3e 3a 20 74 68 65 20 4c 6f 67 66 69 6c </b>: the Logfil
2180: 65 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 e will be automa
2190: 74 69 63 61 6c 6c 79 20 63 72 65 61 74 65 64 20 tically created
21a0: 77 68 65 6e 20 6e 6f 74 20 61 6c 72 65 61 64 79 when not already
21b0: 20 65 78 69 73 74 69 6e 67 2c 20 61 6e 64 20 69 existing, and i
21c0: 74 20 77 69 6c 6c 20 62 65 20 61 6c 77 61 79 73 t will be always
21d0: 20 74 72 75 6e 63 61 74 65 64 20 62 65 66 6f 72 truncated befor
21e0: 65 20 73 74 61 72 74 69 6e 67 20 61 6e 20 65 78 e starting an ex
21f0: 65 63 75 74 69 6f 6e 20 75 6e 69 74 3b 20 69 6e ecution unit; in
2200: 20 6f 74 68 65 72 20 77 6f 72 64 73 20 69 74 20 other words it
2210: 77 69 6c 6c 20 61 6c 77 61 79 73 20 70 72 65 73 will always pres
2220: 65 72 76 65 20 6a 75 73 74 20 74 68 65 20 72 65 erve just the re
2230: 73 75 6c 74 73 65 74 73 20 70 72 6f 64 75 63 65 sultsets produce
2240: 64 20 62 79 20 74 68 65 20 6d 6f 73 74 20 72 65 d by the most re
2250: 63 65 6e 74 20 65 78 65 63 75 74 69 6f 6e 20 75 cent execution u
2260: 6e 69 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c nit.</li>..<li><
2270: 62 3e 41 70 70 65 6e 64 3c 2f 62 3e 3a 20 74 68 b>Append</b>: th
2280: 65 20 4c 6f 67 66 69 6c 65 20 77 69 6c 6c 20 62 e Logfile will b
2290: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 e automatically
22a0: 63 72 65 61 74 65 64 20 77 68 65 6e 20 6e 6f 74 created when not
22b0: 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 69 6e already existin
22c0: 67 2c 20 61 6e 64 20 69 74 20 77 69 6c 6c 20 62 g, and it will b
22d0: 65 20 6e 65 76 65 72 20 74 72 75 6e 63 61 74 65 e never truncate
22e0: 64 20 62 65 66 6f 72 65 20 73 74 61 72 74 69 6e d before startin
22f0: 67 20 61 6e 20 65 78 65 63 75 74 69 6f 6e 20 75 g an execution u
2300: 6e 69 74 3b 20 69 6e 20 6f 74 68 65 72 20 77 6f nit; in other wo
2310: 72 64 73 20 69 74 20 77 69 6c 6c 20 70 72 6f 67 rds it will prog
2320: 72 65 73 73 69 76 65 6c 79 20 67 72 6f 77 20 73 ressively grow s
2330: 6f 20 74 6f 20 73 74 6f 72 65 20 61 6c 6c 20 74 o to store all t
2340: 68 65 20 72 65 73 75 6c 74 73 65 74 73 20 70 72 he resultsets pr
2350: 6f 64 75 63 65 64 20 62 79 20 66 6f 6c 6c 6f 77 oduced by follow
2360: 69 6e 67 20 65 78 65 63 75 74 69 6f 6e 20 75 6e ing execution un
2370: 69 74 73 2e 3c 62 72 3e 0d 0a 3c 75 3e 4e 6f 74 its.<br>..<u>Not
2380: 65 3c 2f 75 3e 3a 20 79 6f 75 27 6c 6c 20 62 65 e</u>: you'll be
2390: 20 6f 62 76 69 6f 75 73 6c 79 20 72 65 71 75 69 obviously requi
23a0: 72 65 64 20 74 6f 20 66 6c 75 73 68 20 74 68 65 red to flush the
23b0: 20 4c 6f 67 66 69 6c 65 20 66 72 6f 6d 20 74 69 Logfile from ti
23c0: 6d 65 20 74 6f 20 74 69 6d 65 20 73 6f 20 74 6f me to time so to
23d0: 20 73 61 66 65 6c 79 20 61 76 6f 69 64 20 74 6f safely avoid to
23e0: 20 63 6f 6e 73 75 6d 65 20 74 6f 6f 20 6d 75 63 consume too muc
23f0: 68 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 2e h storage space.
2400: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f </li>..</ul>..</
2410: 6c 69 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c li>..</li>..</ol
2420: 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 32 ><br>..<hr>..<h2
2430: 3e 46 61 6d 69 6c 69 61 72 69 7a 69 6e 67 20 77 >Familiarizing w
2440: 69 74 68 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e ith SQL Function
2450: 73 3c 2f 68 32 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c s</h2>..<ol>..<l
2460: 69 3e 0d 0a 3c 68 34 3e 48 61 6e 64 6c 69 6e 67 i>..<h4>Handling
2470: 20 53 51 4c 20 50 72 6f 63 65 64 75 72 65 20 42 SQL Procedure B
2480: 4c 4f 42 20 6f 62 6a 65 63 74 73 3c 2f 68 34 3e LOB objects</h4>
2490: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
24a0: 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 46 72 6f LECT SqlProc_Fro
24b0: 6d 54 65 78 74 28 27 53 45 4c 45 43 54 20 40 63 mText('SELECT @c
24c0: 6f 6c 40 20 46 52 4f 4d 20 40 74 62 6c 40 27 29 ol@ FROM @tbl@')
24d0: 3b 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 ;....SELECT SqlP
24e0: 72 6f 63 5f 46 72 6f 6d 46 69 6c 65 28 27 2f 68 roc_FromFile('/h
24f0: 6f 6d 65 2f 6a 6f 65 2f 74 65 6d 70 6c 61 74 65 ome/joe/template
2500: 2e 74 78 74 27 2c 20 43 50 31 32 35 32 27 29 3b .txt', CP1252');
2510: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c ..</verbatim>..<
2520: 75 6c 3e 0d 0a 3c 6c 69 3e 79 6f 75 20 63 61 6e ul>..<li>you can
2530: 20 63 72 65 61 74 65 20 61 20 53 51 4c 20 50 72 create a SQL Pr
2540: 6f 63 65 64 75 72 65 20 42 4c 4f 42 20 6f 62 6a ocedure BLOB obj
2550: 65 63 74 20 62 79 20 64 69 72 65 63 74 6c 79 20 ect by directly
2560: 70 61 73 73 69 6e 67 20 61 20 54 65 78 74 20 53 passing a Text S
2570: 51 4c 20 42 6f 64 79 2e 3c 2f 6c 69 3e 0d 0a 3c QL Body.</li>..<
2580: 6c 69 3e 6f 72 20 61 6c 74 65 72 6e 61 74 69 76 li>or alternativ
2590: 65 6c 79 20 79 6f 75 20 63 61 6e 20 6c 6f 61 64 ely you can load
25a0: 20 74 68 65 20 53 51 4c 20 42 6f 64 79 20 66 72 the SQL Body fr
25b0: 6f 6d 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 66 om an external f
25c0: 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 75 3e 4e 6f 74 ile.<br>..<u>Not
25d0: 65 3c 2f 75 3e 3a 20 74 68 69 73 20 69 73 20 61 e</u>: this is a
25e0: 20 73 65 63 75 72 69 74 79 20 73 65 6e 73 69 62 security sensib
25f0: 6c 65 20 6f 70 65 72 61 74 69 6f 6e 2c 20 73 6f le operation, so
2600: 20 79 6f 75 20 61 6c 77 61 79 73 20 6e 65 65 64 you always need
2610: 20 74 6f 20 73 65 74 20 61 6e 20 65 78 70 6c 69 to set an expli
2620: 63 69 74 20 61 75 74 68 6f 72 69 7a 61 74 69 6f cit authorizatio
2630: 6e 20 62 79 20 64 65 66 69 6e 69 6e 67 20 3c 62 n by defining <b
2640: 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 >SPATIALITE_SECU
2650: 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e RITY=relaxed</b>
2660: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 42 6f 74 68 .</li>..<li>Both
2670: 20 66 75 6e 63 74 69 6f 6e 73 20 61 63 63 65 70 functions accep
2680: 74 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 3c 62 t an optional <b
2690: 3e 63 68 61 72 73 65 74 20 65 6e 63 6f 64 69 6e >charset encodin
26a0: 67 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 3b 20 g</b> argument;
26b0: 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 in this case the
26c0: 20 53 51 4c 20 42 6f 64 79 20 77 69 6c 6c 20 62 SQL Body will b
26d0: 65 20 61 70 70 72 6f 70 72 69 61 74 65 6c 79 20 e appropriately
26e0: 63 6f 6e 76 65 72 74 65 64 20 66 72 6f 6d 20 74 converted from t
26f0: 68 65 20 67 69 76 65 6e 20 63 68 61 72 73 65 74 he given charset
2700: 20 69 6e 74 6f 20 3c 62 3e 55 54 46 2d 38 3c 2f into <b>UTF-8</
2710: 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d b>.</li>..</ul>.
2720: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c .<verbatim>..SEL
2730: 45 43 54 20 53 71 6c 50 72 6f 63 5f 49 73 56 61 ECT SqlProc_IsVa
2740: 6c 69 64 20 28 20 53 71 6c 50 72 6f 63 5f 46 72 lid ( SqlProc_Fr
2750: 6f 6d 54 65 78 74 28 27 53 45 4c 45 43 54 20 40 omText('SELECT @
2760: 63 6f 6c 40 20 46 52 4f 4d 20 40 74 62 6c 40 27 col@ FROM @tbl@'
2770: 29 20 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a ) );..-----..1..
2780: 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 ..SELECT SqlProc
2790: 5f 49 73 56 61 6c 69 64 20 28 20 4d 61 6b 65 50 _IsValid ( MakeP
27a0: 6f 69 6e 74 28 31 31 2e 35 2c 20 34 32 2e 35 2c oint(11.5, 42.5,
27b0: 20 34 33 32 36 29 20 29 3b 0d 0a 2d 2d 2d 2d 2d 4326) );..-----
27c0: 0d 0a 30 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e ..0..</verbatim>
27d0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 79 6f 75 20 ..<ul>..<li>you
27e0: 63 61 6e 20 75 73 65 20 3c 62 3e 53 71 6c 50 72 can use <b>SqlPr
27f0: 6f 63 5f 49 73 56 61 6c 69 64 3c 2f 62 3e 20 69 oc_IsValid</b> i
2800: 6e 20 6f 72 64 65 72 20 74 6f 20 63 68 65 63 6b n order to check
2810: 20 69 66 20 61 20 67 65 6e 65 72 69 63 20 42 4c if a generic BL
2820: 4f 42 20 72 65 61 6c 6c 79 20 69 73 20 61 20 76 OB really is a v
2830: 61 6c 69 64 20 53 51 4c 20 50 72 6f 63 65 64 75 alid SQL Procedu
2840: 72 65 20 42 4c 4f 42 20 4f 62 6a 65 63 74 2e 0d re BLOB Object..
2850: 0a 3c 2f 75 6c 3e 0d 0a 3c 76 65 72 62 61 74 69 .</ul>..<verbati
2860: 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 m>..SELECT SqlPr
2870: 6f 63 5f 4e 75 6d 56 61 72 69 61 62 6c 65 73 20 oc_NumVariables
2880: 28 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 54 65 ( SqlProc_FromTe
2890: 78 74 28 27 53 45 4c 45 43 54 20 40 63 6f 6c 40 xt('SELECT @col@
28a0: 20 46 52 4f 4d 20 40 74 62 6c 40 27 29 20 29 3b FROM @tbl@') );
28b0: 0d 0a 2d 2d 2d 2d 2d 0d 0a 32 0d 0a 0d 0a 53 45 ..-----..2....SE
28c0: 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 56 61 72 LECT SqlProc_Var
28d0: 69 61 62 6c 65 4e 20 28 53 71 6c 50 72 6f 63 5f iableN (SqlProc_
28e0: 46 72 6f 6d 54 65 78 74 28 27 53 45 4c 45 43 54 FromText('SELECT
28f0: 20 40 63 6f 6c 40 20 46 52 4f 4d 20 40 74 62 6c @col@ FROM @tbl
2900: 40 27 29 2c 20 30 29 3b 0d 0a 2d 2d 2d 2d 2d 0d @'), 0);..-----.
2910: 0a 40 63 6f 6c 40 0d 0a 0d 0a 53 45 4c 45 43 54 .@col@....SELECT
2920: 20 53 71 6c 50 72 6f 63 5f 56 61 72 69 61 62 6c SqlProc_Variabl
2930: 65 4e 20 28 53 71 6c 50 72 6f 63 5f 46 72 6f 6d eN (SqlProc_From
2940: 54 65 78 74 28 27 53 45 4c 45 43 54 20 40 63 6f Text('SELECT @co
2950: 6c 40 20 46 52 4f 4d 20 40 74 62 6c 40 27 29 2c l@ FROM @tbl@'),
2960: 20 31 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 40 74 62 1);..-----..@tb
2970: 6c 40 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c l@....SELECT Sql
2980: 50 72 6f 63 5f 41 6c 6c 56 61 72 69 61 62 6c 65 Proc_AllVariable
2990: 73 20 28 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 54 s (SqlProc_FromT
29a0: 65 78 74 28 27 53 45 4c 45 43 54 20 40 63 6f 6c ext('SELECT @col
29b0: 40 20 46 52 4f 4d 20 40 74 62 6c 40 27 29 20 29 @ FROM @tbl@') )
29c0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 40 63 6f 6c 40 20 ;..-----..@col@
29d0: 40 74 62 6c 40 0d 0a 3c 2f 76 65 72 62 61 74 69 @tbl@..</verbati
29e0: 6d 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 79 6f m>..<ul>..<li>yo
29f0: 75 20 63 61 6e 20 75 73 65 20 3c 62 3e 53 71 6c u can use <b>Sql
2a00: 50 72 6f 63 5f 4e 75 6d 56 61 72 69 61 62 6c 65 Proc_NumVariable
2a10: 73 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 s</b> in order t
2a20: 6f 20 63 68 65 63 6b 20 68 6f 77 20 6d 61 6e 79 o check how many
2a30: 20 56 61 72 69 61 62 6c 65 73 20 61 72 65 20 64 Variables are d
2a40: 65 66 69 6e 65 64 20 62 79 20 61 20 53 51 4c 20 efined by a SQL
2a50: 50 72 6f 63 65 64 75 72 65 20 42 4c 4f 42 20 4f Procedure BLOB O
2a60: 62 6a 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 bject.</li>..<li
2a70: 3e 61 6e 64 20 79 6f 75 20 63 61 6e 20 75 73 65 >and you can use
2a80: 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 56 61 72 69 <b>SqlProc_Vari
2a90: 61 62 6c 65 4e 3c 2f 62 3e 20 69 6e 20 6f 72 64 ableN</b> in ord
2aa0: 65 72 20 74 6f 20 72 65 74 72 69 65 76 65 20 61 er to retrieve a
2ab0: 20 56 61 72 69 61 62 6c 65 20 4e 61 6d 65 20 62 Variable Name b
2ac0: 79 20 73 70 65 63 69 66 79 69 6e 67 20 69 74 73 y specifying its
2ad0: 20 72 65 6c 61 74 69 76 65 20 3c 62 3e 49 6e 64 relative <b>Ind
2ae0: 65 78 3c 2f 62 3e 20 28 46 69 72 73 74 20 56 61 ex</b> (First Va
2af0: 72 69 61 62 6c 65 20 61 6c 77 61 79 73 20 63 6f riable always co
2b00: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 3c 62 3e rresponds to <b>
2b10: 49 6e 64 65 78 3d 30 3c 2f 62 3e 29 2e 3c 2f 6c Index=0</b>).</l
2b20: 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 66 69 6e 61 i>..<li>and fina
2b30: 6c 6c 79 20 79 6f 75 20 63 61 6e 20 75 73 65 20 lly you can use
2b40: 3c 62 3e 53 71 6c 50 72 6f 63 5f 41 6c 6c 56 61 <b>SqlProc_AllVa
2b50: 72 69 61 62 6c 65 73 3c 2f 62 3e 20 69 6e 20 6f riables</b> in o
2b60: 72 64 65 72 20 74 6f 20 64 69 72 65 63 74 6c 79 rder to directly
2b70: 20 67 65 74 20 61 6c 6c 20 56 61 72 69 61 62 6c get all Variabl
2b80: 65 20 4e 61 6d 65 73 20 66 6f 72 6d 61 74 74 65 e Names formatte
2b90: 64 20 61 73 20 61 20 73 70 61 63 65 2d 73 65 70 d as a space-sep
2ba0: 61 72 61 74 65 64 20 6c 69 73 74 2e 3c 2f 6c 69 arated list.</li
2bb0: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 3c 68 >..</ul>..<br><h
2bc0: 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d r>..</li>..<li>.
2bd0: 0a 3c 68 34 3e 45 72 72 6f 72 20 68 61 6e 64 6c .<h4>Error handl
2be0: 69 6e 67 3c 2f 68 34 3e 0d 0a 3c 76 65 72 62 61 ing</h4>..<verba
2bf0: 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c tim>..SELECT Sql
2c00: 50 72 6f 63 5f 47 65 74 4c 61 73 74 45 72 72 6f Proc_GetLastErro
2c10: 72 28 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d r();..</verbatim
2c20: 3e 0d 0a 41 6c 6c 20 74 68 65 73 65 20 66 75 6e >..All these fun
2c30: 63 74 69 6f 6e 73 20 77 69 6c 6c 20 72 61 69 73 ctions will rais
2c40: 65 20 61 6e 20 45 78 63 65 70 74 69 6f 6e 20 6f e an Exception o
2c50: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 n invalid argume
2c60: 6e 74 73 20 6f 72 20 65 72 72 6f 72 73 2e 3c 62 nts or errors.<b
2c70: 72 3e 0d 0a 42 79 20 63 61 6c 6c 69 6e 67 20 3c r>..By calling <
2c80: 62 3e 53 71 6c 50 72 6f 63 5f 47 65 74 4c 61 73 b>SqlProc_GetLas
2c90: 74 45 72 72 6f 72 3c 2f 62 3e 20 79 6f 75 27 6c tError</b> you'l
2ca0: 6c 20 75 73 75 61 6c 6c 79 20 67 65 74 20 61 20 l usually get a
2cb0: 6d 6f 72 65 20 64 65 74 61 69 6c 65 64 20 65 78 more detailed ex
2cc0: 70 6c 61 6e 61 74 69 6f 6e 20 61 62 6f 75 74 20 planation about
2cd0: 74 68 65 20 73 70 65 63 69 66 69 63 20 63 61 75 the specific cau
2ce0: 73 65 20 61 63 63 6f 75 6e 74 69 6e 67 20 66 6f se accounting fo
2cf0: 72 20 74 68 65 20 66 61 69 6c 75 72 65 2e 0d 0a r the failure...
2d00: 3c 62 72 3e 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 2f <br><br><hr>..</
2d10: 6c 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 3e 43 li>..<li>..<h4>C
2d20: 72 65 61 74 69 6e 67 20 56 61 72 69 61 62 6c 65 reating Variable
2d30: 73 20 77 69 74 68 20 56 61 6c 75 65 73 3c 2f 68 s with Values</h
2d40: 34 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 4>..<verbatim>..
2d50: 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 56 SELECT SqlProc_V
2d60: 61 72 56 61 6c 75 65 20 28 27 76 61 72 27 2c 20 arValue ('var',
2d70: 4e 55 4c 4c 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 40 NULL);..-----..@
2d80: 76 61 72 40 3d 4e 55 4c 4c 0d 0a 0d 0a 53 45 4c var@=NULL....SEL
2d90: 45 43 54 20 53 71 6c 50 72 6f 63 5f 56 61 72 56 ECT SqlProc_VarV
2da0: 61 6c 75 65 20 28 27 76 61 72 27 2c 20 31 29 3b alue ('var', 1);
2db0: 0d 0a 2d 2d 2d 2d 2d 0d 0a 40 76 61 72 40 3d 31 ..-----..@var@=1
2dc0: 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 ....SELECT SqlPr
2dd0: 6f 63 5f 56 61 72 56 61 6c 75 65 20 28 27 76 61 oc_VarValue ('va
2de0: 72 27 2c 20 31 30 2e 35 29 3b 0d 0a 2d 2d 2d 2d r', 10.5);..----
2df0: 2d 0d 0a 40 76 61 72 40 3d 31 30 2e 35 30 30 30 -..@var@=10.5000
2e00: 30 30 30 30 30 30 0d 0a 0d 0a 53 45 4c 45 43 54 000000....SELECT
2e10: 20 53 71 6c 50 72 6f 63 5f 56 61 72 56 61 6c 75 SqlProc_VarValu
2e20: 65 20 28 27 76 61 72 27 2c 20 27 61 6c 70 68 61 e ('var', 'alpha
2e30: 20 62 65 74 61 27 29 3b 0d 0a 2d 2d 2d 2d 2d 0d beta');..-----.
2e40: 0a 40 76 61 72 40 3d 61 6c 70 68 61 20 62 65 74 .@var@=alpha bet
2e50: 61 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 a....SELECT SqlP
2e60: 72 6f 63 5f 56 61 72 56 61 6c 75 65 20 28 27 76 roc_VarValue ('v
2e70: 61 72 27 2c 20 4d 61 6b 65 50 6f 69 6e 74 28 31 ar', MakePoint(1
2e80: 31 2e 35 2c 20 34 32 2e 35 2c 20 34 33 32 36 29 1.5, 42.5, 4326)
2e90: 20 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 40 76 61 72 );..-----..@var
2ea0: 40 3d 78 27 30 30 30 31 45 36 31 30 30 30 30 30 @=x'0001E6100000
2eb0: 30 30 30 30 30 30 30 30 30 30 30 30 32 37 34 30 0000000000002740
2ec0: 30 30 30 30 30 30 30 30 30 30 34 30 34 35 34 30 0000000000404540
2ed0: 30 30 30 30 30 30 30 30 30 30 30 30 32 37 34 30 0000000000002740
2ee0: 30 30 30 30 30 30 30 30 30 30 34 30 34 35 34 30 0000000000404540
2ef0: 37 43 30 31 30 30 30 30 30 30 30 30 30 30 30 30 7C01000000000000
2f00: 30 30 30 30 30 30 32 37 34 30 30 30 30 30 30 30 0000002740000000
2f10: 30 30 30 30 34 30 34 35 34 30 46 45 27 0d 0a 3c 0000404540FE'..<
2f20: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 3e 4e /verbatim>..<u>N
2f30: 6f 74 65 3c 2f 75 3e 3a 20 68 61 6e 64 20 77 72 ote</u>: hand wr
2f40: 69 74 69 6e 67 20 56 61 72 69 61 62 6c 65 20 77 iting Variable w
2f50: 69 74 68 20 56 61 6c 75 65 20 73 74 72 69 6e 67 ith Value string
2f60: 73 20 69 73 20 61 20 72 61 74 68 65 72 20 74 72 s is a rather tr
2f70: 69 76 69 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2c ivial operation,
2f80: 20 73 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 so calling this
2f90: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 SQL function is
2fa0: 20 6f 66 74 65 6e 20 6b 69 6e 64 20 6f 66 20 61 often kind of a
2fb0: 6e 20 6f 76 65 72 6b 69 6c 6c 2e 20 45 78 63 65 n overkill. Exce
2fc0: 70 74 2c 20 6d 61 79 20 62 65 2c 20 69 6e 20 74 pt, may be, in t
2fd0: 68 65 20 63 61 73 65 20 6f 66 20 42 4c 4f 42 20 he case of BLOB
2fe0: 76 61 6c 75 65 73 2e 0d 0a 3c 62 72 3e 3c 62 72 values...<br><br
2ff0: 3e 3c 68 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c ><hr>..</li>..<l
3000: 69 3e 0d 0a 3c 68 34 3e 52 61 77 20 61 6e 64 20 i>..<h4>Raw and
3010: 43 6f 6f 6b 65 64 20 53 51 4c 20 2d 20 72 65 70 Cooked SQL - rep
3020: 6c 61 63 69 6e 67 20 53 79 6d 62 6f 6c 73 20 77 lacing Symbols w
3030: 69 74 68 20 74 68 65 69 72 20 61 63 74 75 61 6c ith their actual
3040: 20 56 61 6c 75 65 73 3c 2f 68 34 3e 0d 0a 3c 76 Values</h4>..<v
3050: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 erbatim>..SELECT
3060: 20 53 71 6c 50 72 6f 63 5f 52 61 77 53 51 4c 20 SqlProc_RawSQL
3070: 28 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 54 65 ( SqlProc_FromTe
3080: 78 74 28 27 53 45 4c 45 43 54 20 40 63 6f 6c 40 xt('SELECT @col@
3090: 20 46 52 4f 4d 20 40 74 62 6c 40 3b 27 29 20 29 FROM @tbl@;') )
30a0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 53 45 4c 45 43 54 ;..-----..SELECT
30b0: 20 40 63 6f 6c 40 20 46 52 4f 4d 20 40 74 62 6c @col@ FROM @tbl
30c0: 40 3b 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c @;....SELECT Sql
30d0: 50 72 6f 63 5f 43 6f 6f 6b 65 64 53 51 4c 20 28 Proc_CookedSQL (
30e0: 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 54 65 78 SqlProc_FromTex
30f0: 74 28 27 53 45 4c 45 43 54 20 40 63 6f 6c 40 20 t('SELECT @col@
3100: 46 52 4f 4d 20 40 74 62 6c 40 3b 27 29 2c 0d 0a FROM @tbl@;'),..
3110: 20 20 20 20 27 40 63 6f 6c 40 3d 66 69 72 73 74 '@col@=first
3120: 5f 6e 61 6d 65 27 2c 0d 0a 20 20 20 20 27 40 74 _name',.. '@t
3130: 62 6c 40 3d 70 68 6f 6e 65 5f 62 6f 6f 6b 27 20 bl@=phone_book'
3140: 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 53 45 4c 45 43 );..-----..SELEC
3150: 54 20 66 69 72 73 74 5f 6e 61 6d 65 20 46 52 4f T first_name FRO
3160: 4d 20 70 68 6f 6e 65 5f 62 6f 6f 6b 3b 0d 0a 3c M phone_book;..<
3170: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e /verbatim>..<ul>
3180: 0d 0a 3c 6c 69 3e 79 6f 75 20 63 61 6e 20 75 73 ..<li>you can us
3190: 65 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 52 61 77 e <b>SqlProc_Raw
31a0: 53 51 4c 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 SQL</b> in order
31b0: 20 74 6f 20 64 69 72 65 63 74 6c 79 20 63 68 65 to directly che
31c0: 63 6b 20 74 68 65 20 53 51 4c 20 42 6f 64 79 20 ck the SQL Body
31d0: 65 6e 63 61 70 73 75 6c 61 74 65 64 20 69 6e 74 encapsulated int
31e0: 6f 20 61 20 53 51 4c 20 50 72 6f 63 65 64 75 72 o a SQL Procedur
31f0: 65 20 42 4c 4f 42 20 4f 62 6a 65 63 74 3b 20 61 e BLOB Object; a
3200: 6c 6c 20 69 6e 69 74 69 61 6c 20 56 61 72 69 61 ll initial Varia
3210: 62 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 ble definitions
3220: 77 69 6c 6c 20 62 65 20 63 61 72 65 66 75 6c 6c will be carefull
3230: 79 20 70 72 65 73 65 72 76 65 64 2e 3c 2f 6c 69 y preserved.</li
3240: 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 79 6f 75 20 63 >..<li>and you c
3250: 61 6e 20 75 73 65 20 3c 62 3e 53 71 6c 50 72 6f an use <b>SqlPro
3260: 63 5f 43 6f 6f 6b 65 64 53 51 4c 3c 2f 62 3e 20 c_CookedSQL</b>
3270: 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 69 72 65 in order to dire
3280: 63 74 6c 79 20 63 68 65 63 6b 20 74 68 65 20 53 ctly check the S
3290: 51 4c 20 42 6f 64 79 20 61 73 20 69 74 20 61 63 QL Body as it ac
32a0: 74 75 61 6c 6c 79 20 61 70 70 65 61 72 73 20 61 tually appears a
32b0: 66 74 65 72 20 72 65 70 6c 61 63 69 6e 67 20 61 fter replacing a
32c0: 6c 6c 20 72 65 71 75 69 72 65 64 20 56 61 72 69 ll required Vari
32d0: 61 62 6c 65 20 56 61 6c 75 65 73 2e 3c 2f 6c 69 able Values.</li
32e0: 3e 0d 0a 3c 6c 69 3e 42 6f 74 68 20 66 75 6e 63 >..<li>Both func
32f0: 74 69 6f 6e 73 20 61 72 65 20 6d 61 69 6e 6c 79 tions are mainly
3300: 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 73 75 intended for su
3310: 70 70 6f 72 74 69 6e 67 20 64 65 62 75 67 67 69 pporting debuggi
3320: 6e 67 20 61 63 74 69 76 69 74 69 65 73 2c 20 73 ng activities, s
3330: 6f 20 74 6f 20 6d 61 6b 65 20 61 73 20 65 61 73 o to make as eas
3340: 79 20 61 73 20 70 6f 73 73 69 62 6c 65 20 69 64 y as possible id
3350: 65 6e 74 69 66 79 69 6e 67 20 65 76 65 6e 74 75 entifying eventu
3360: 61 6c 20 65 72 72 6f 72 73 2e 3c 2f 6c 69 3e 0d al errors.</li>.
3370: 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 61 62 .</ul><br>..<tab
3380: 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 le bgcolor="#f8f
3390: 38 64 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 8d8" cellpadding
33a0: 3d 22 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 ="6" cellspacing
33b0: 3d 22 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c ="8"><tr><td>..<
33c0: 75 3e 4e 6f 74 65 3c 2f 75 3e 3a 20 3c 62 3e 53 u>Note</u>: <b>S
33d0: 71 6c 50 72 6f 63 5f 43 6f 6f 6b 65 64 53 51 4c qlProc_CookedSQL
33e0: 3c 2f 62 3e 20 77 69 6c 6c 20 61 63 63 65 70 74 </b> will accept
33f0: 20 61 6e 20 61 72 62 69 74 72 61 72 79 20 6c 69 an arbitrary li
3400: 73 74 20 6f 66 20 3c 62 3e 56 61 72 69 61 62 6c st of <b>Variabl
3410: 65 20 77 69 74 68 20 56 61 6c 75 65 3c 2f 62 3e e with Value</b>
3420: 20 61 72 67 75 6d 65 6e 74 73 2e 0d 0a 3c 75 6c arguments...<ul
3430: 3e 0d 0a 3c 6c 69 3e 61 6e 20 65 6d 70 74 79 20 >..<li>an empty
3440: 6c 69 73 74 20 28 6e 6f 20 56 61 72 69 61 62 6c list (no Variabl
3450: 65 73 20 77 69 74 68 20 56 61 6c 75 65 73 20 61 es with Values a
3460: 74 20 61 6c 6c 29 20 69 73 20 61 20 70 65 72 66 t all) is a perf
3470: 65 63 74 6c 79 20 6c 65 67 61 6c 20 63 6f 6e 64 ectly legal cond
3480: 69 74 69 6f 6e 20 28 63 6f 75 6c 64 20 65 76 65 ition (could eve
3490: 6e 74 75 61 6c 6c 79 20 6c 65 61 64 20 74 6f 20 ntually lead to
34a0: 61 6e 20 69 6e 76 61 6c 69 64 20 43 6f 6f 6b 65 an invalid Cooke
34b0: 64 20 53 51 4c 20 42 6f 64 79 2c 20 73 65 65 20 d SQL Body, see
34c0: 62 65 6c 6f 77 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c below).</li>..<l
34d0: 69 3e 61 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 i>all arguments
34e0: 66 72 6f 6d 20 74 68 65 20 73 65 63 6f 6e 64 20 from the second
34f0: 74 69 6c 6c 20 74 68 65 20 6c 61 73 74 20 61 72 till the last ar
3500: 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 e expected to be
3510: 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 56 61 72 well-formed Var
3520: 69 61 62 6c 65 73 20 77 69 74 68 20 56 61 6c 75 iables with Valu
3530: 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 79 6f es.</li>..<li>yo
3540: 75 20 63 61 6e 20 64 65 66 69 6e 65 20 75 70 20 u can define up
3550: 74 6f 20 3c 62 3e 31 36 3c 2f 62 3e 20 64 69 66 to <b>16</b> dif
3560: 66 65 72 65 6e 74 20 56 61 72 69 61 62 6c 65 73 ferent Variables
3570: 20 77 69 74 68 20 56 61 6c 75 65 73 2e 3c 2f 6c with Values.</l
3580: 69 3e 0d 0a 3c 6c 69 3e 61 6e 79 20 61 74 74 65 i>..<li>any atte
3590: 6d 70 74 20 74 6f 20 72 65 2d 64 65 66 69 6e 65 mpt to re-define
35a0: 20 74 68 65 20 73 61 6d 65 20 56 61 72 69 61 62 the same Variab
35b0: 6c 65 20 77 69 74 68 20 61 6e 6f 74 68 65 72 20 le with another
35c0: 56 61 6c 75 65 20 77 69 6c 6c 20 62 65 20 61 6c Value will be al
35d0: 77 61 79 73 20 63 6f 6e 73 69 64 65 72 65 64 20 ways considered
35e0: 61 73 20 61 20 66 61 74 61 6c 20 65 72 72 6f 72 as a fatal error
35f0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 79 20 .</li>..<li>any
3600: 6f 66 20 74 68 65 20 56 61 72 69 61 62 6c 65 20 of the Variable
3610: 61 72 67 75 6d 65 6e 74 73 20 6e 6f 74 20 63 6f arguments not co
3620: 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 3c ntained in the <
3630: 69 3e 72 61 77 3c 2f 69 3e 20 53 51 4c 20 42 6f i>raw</i> SQL Bo
3640: 64 79 20 77 69 6c 6c 20 62 65 20 69 67 6e 6f 72 dy will be ignor
3650: 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 ed.</li>..<li>if
3660: 20 61 20 56 61 72 69 61 62 6c 65 20 64 65 66 69 a Variable defi
3670: 6e 65 64 20 69 6e 20 74 68 65 20 72 61 77 20 53 ned in the raw S
3680: 51 4c 20 42 6f 64 79 20 64 6f 65 73 20 6e 6f 74 QL Body does not
3690: 20 6d 61 74 63 68 65 73 20 61 20 63 6f 72 72 65 matches a corre
36a0: 73 70 6f 6e 64 69 6e 67 20 56 61 72 69 61 62 6c sponding Variabl
36b0: 65 20 61 72 67 75 6d 65 6e 74 20 74 68 65 6e 20 e argument then
36c0: 69 74 20 77 69 6c 6c 20 62 65 20 73 65 74 20 77 it will be set w
36d0: 69 74 68 20 61 20 27 3c 62 3e 4e 55 4c 4c 3c 2f ith a '<b>NULL</
36e0: 62 3e 27 20 73 74 72 69 6e 67 2e 3c 2f 6c 69 3e b>' string.</li>
36f0: 0d 0a 3c 6c 69 3e 74 68 65 20 73 61 6d 65 20 69 ..<li>the same i
3700: 64 65 6e 74 69 63 61 6c 20 72 75 6c 65 73 20 66 dentical rules f
3710: 6f 72 20 70 61 73 73 69 6e 67 20 56 61 72 69 61 or passing Varia
3720: 62 6c 65 2d 56 61 6c 75 65 20 61 72 67 75 6d 65 ble-Value argume
3730: 6e 74 73 20 61 70 70 6c 79 20 74 6f 20 3c 62 3e nts apply to <b>
3740: 53 71 6c 50 72 6f 63 5f 43 6f 6f 6b 65 64 53 51 SqlProc_CookedSQ
3750: 4c 3c 2f 62 3e 2c 20 3c 62 3e 53 71 6c 50 72 6f L</b>, <b>SqlPro
3760: 63 5f 45 78 65 63 75 74 65 3c 2f 62 3e 20 61 6e c_Execute</b> an
3770: 64 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 5f d <b>StoredProc_
3780: 45 78 65 63 75 74 65 3c 2f 62 3e 2e 3c 2f 6c 69 Execute</b>.</li
3790: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c >..</ul>..</td><
37a0: 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e /tr></table><br>
37b0: 0d 0a 3c 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 ..<table bgcolor
37c0: 3d 22 23 66 38 63 38 63 38 22 20 63 65 6c 6c 70 ="#f8c8c8" cellp
37d0: 61 64 64 69 6e 67 3d 22 36 22 20 63 65 6c 6c 73 adding="6" cells
37e0: 70 61 63 69 6e 67 3d 22 38 22 3e 3c 74 72 3e 3c pacing="8"><tr><
37f0: 74 64 3e 0d 0a 3c 75 3e 57 61 72 6e 69 6e 67 3c td>..<u>Warning<
3800: 2f 75 3e 3a 20 72 65 66 65 72 65 6e 63 69 6e 67 /u>: referencing
3810: 20 61 20 56 61 72 69 61 62 6c 65 20 66 72 6f 6d a Variable from
3820: 20 77 69 74 68 69 6e 20 61 6e 6f 74 68 65 72 20 within another
3830: 56 61 72 69 61 62 6c 65 20 69 73 20 6e 6f 74 20 Variable is not
3840: 70 65 72 6d 69 74 74 65 64 2e 0d 0a 3c 76 65 72 permitted...<ver
3850: 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 batim>..SELECT S
3860: 71 6c 50 72 6f 63 5f 43 6f 6f 6b 65 64 53 51 4c qlProc_CookedSQL
3870: 20 28 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 54 ( SqlProc_FromT
3880: 65 78 74 28 27 53 45 4c 45 43 54 20 40 63 6f 6c ext('SELECT @col
3890: 40 20 46 52 4f 4d 20 40 74 62 6c 40 3b 27 29 2c @ FROM @tbl@;'),
38a0: 0d 0a 20 20 20 20 27 40 63 6f 6c 40 3d 66 69 72 .. '@col@=fir
38b0: 73 74 5f 6e 61 6d 65 27 2c 0d 0a 20 20 20 20 27 st_name',.. '
38c0: 40 63 6f 75 6e 74 72 79 40 3d 69 74 61 6c 79 27 @country@=italy'
38d0: 2c 0d 0a 20 20 20 20 27 40 74 62 6c 40 3d 40 63 ,.. '@tbl@=@c
38e0: 6f 75 6e 74 72 79 40 5f 70 68 6f 6e 65 5f 62 6f ountry@_phone_bo
38f0: 6f 6b 27 20 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 ok' );..</verbat
3900: 69 6d 3e 0d 0a 49 6e 20 74 68 65 20 61 62 6f 76 im>..In the abov
3910: 65 20 65 78 61 6d 70 6c 65 20 74 68 65 20 3c 62 e example the <b
3920: 3e 40 63 6f 75 6e 74 72 79 40 3c 2f 62 3e 20 74 >@country@</b> t
3930: 65 72 6d 20 69 6e 74 6f 20 74 68 65 20 56 61 6c erm into the Val
3940: 75 65 20 73 74 72 69 6e 67 20 3c 69 3e 27 40 63 ue string <i>'@c
3950: 6f 75 6e 74 72 79 40 5f 70 68 6f 6e 65 5f 62 6f ountry@_phone_bo
3960: 6f 6b 27 3c 2f 69 3e 20 77 69 6c 6c 20 6e 6f 74 ok'</i> will not
3970: 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 61 be considered a
3980: 73 20 61 20 56 61 72 69 61 62 6c 65 20 61 6e 64 s a Variable and
3990: 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 72 65 70 will not be rep
39a0: 6c 61 63 65 64 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 laced...</td></t
39b0: 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e r></table>..<br>
39c0: 3c 68 72 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 <hr>..</li>..<li
39d0: 3e 0d 0a 3c 68 34 3e 45 78 65 63 75 74 69 6e 67 >..<h4>Executing
39e0: 20 61 20 53 51 4c 20 50 72 6f 63 65 64 75 72 65 a SQL Procedure
39f0: 3c 2f 68 34 3e 0d 0a 3c 76 65 72 62 61 74 69 6d </h4>..<verbatim
3a00: 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f >..SELECT SqlPro
3a10: 63 5f 45 78 65 63 75 74 65 20 28 53 71 6c 50 72 c_Execute (SqlPr
3a20: 6f 63 5f 46 72 6f 6d 54 65 78 74 28 27 53 45 4c oc_FromText('SEL
3a30: 45 43 54 20 40 63 6f 6c 40 20 46 52 4f 4d 20 40 ECT @col@ FROM @
3a40: 74 62 6c 40 3b 27 29 2c 0d 0a 20 20 20 20 27 40 tbl@;'),.. '@
3a50: 63 6f 6c 40 3d 66 69 72 73 74 5f 6e 61 6d 65 27 col@=first_name'
3a60: 2c 0d 0a 20 20 20 20 27 40 74 62 6c 40 3d 70 68 ,.. '@tbl@=ph
3a70: 6f 6e 65 5f 62 6f 6f 6b 27 20 29 3b 0d 0a 2d 2d one_book' );..--
3a80: 2d 2d 2d 0d 0a 53 71 6c 50 72 6f 63 20 65 78 63 ---..SqlProc exc
3a90: 65 70 74 69 6f 6e 20 2d 20 61 20 66 61 74 61 6c eption - a fatal
3aa0: 20 53 51 4c 20 65 72 72 6f 72 20 77 61 73 20 65 SQL error was e
3ab0: 6e 63 6f 75 6e 74 65 72 65 64 2e 0d 0a 0d 0a 53 ncountered.....S
3ac0: 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 47 65 ELECT SqlProc_Ge
3ad0: 74 4c 61 73 74 45 72 72 6f 72 28 29 3b 0d 0a 2d tLastError();..-
3ae0: 2d 2d 2d 2d 0d 0a 67 61 69 61 5f 73 71 6c 5f 70 ----..gaia_sql_p
3af0: 72 6f 63 5f 65 78 65 63 75 74 65 3a 20 6e 6f 20 roc_execute: no
3b00: 73 75 63 68 20 74 61 62 6c 65 3a 20 70 68 6f 6e such table: phon
3b10: 65 5f 62 6f 6f 6b 0d 0a 3c 2f 76 65 72 62 61 74 e_book..</verbat
3b20: 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 73 65 im>..you can use
3b30: 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 45 78 65 63 <b>SqlProc_Exec
3b40: 75 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 ute</b> in order
3b50: 20 74 6f 20 64 69 72 65 63 74 6c 79 20 65 78 65 to directly exe
3b60: 63 75 74 65 20 74 68 65 20 77 68 6f 6c 65 20 53 cute the whole S
3b70: 51 4c 20 42 6f 64 79 20 61 73 20 61 20 73 69 6e QL Body as a sin
3b80: 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 75 gle monolithic u
3b90: 6e 69 74 2e 3c 62 72 3e 0d 0a 41 74 20 74 68 65 nit.<br>..At the
3ba0: 20 65 6e 64 20 6f 66 20 74 68 65 20 70 72 6f 63 end of the proc
3bb0: 65 73 73 20 3c 62 3e 31 3c 2f 62 3e 20 28 61 6b ess <b>1</b> (ak
3bc0: 61 20 3c 62 3e 54 72 75 65 3c 2f 62 3e 29 20 77 a <b>True</b>) w
3bd0: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
3be0: 6f 6e 20 66 75 6c 6c 20 73 75 63 63 65 73 73 3b on full success;
3bf0: 20 61 6e 20 45 78 63 65 70 74 69 6f 6e 20 77 69 an Exception wi
3c00: 6c 6c 20 62 65 20 72 61 69 73 65 64 20 6f 6e 20 ll be raised on
3c10: 66 61 69 6c 75 72 65 2c 20 61 73 20 77 69 6c 6c failure, as will
3c20: 20 68 61 70 70 65 6e 73 20 69 6e 20 74 68 69 73 happens in this
3c30: 20 73 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 6e sample, you can
3c40: 20 74 68 65 6e 20 75 73 65 20 3c 62 3e 53 71 6c then use <b>Sql
3c50: 50 72 6f 63 5f 47 65 74 4c 61 73 74 45 72 72 6f Proc_GetLastErro
3c60: 72 3c 2f 62 3e 20 74 6f 20 72 65 74 72 69 65 76 r</b> to retriev
3c70: 65 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 e the correspond
3c80: 69 6e 67 20 53 51 4c 20 65 72 72 6f 72 20 6d 65 ing SQL error me
3c90: 73 73 61 67 65 2e 0d 0a 3c 62 72 3e 3c 62 72 3e ssage...<br><br>
3ca0: 0d 0a 3c 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 ..<table bgcolor
3cb0: 3d 22 23 66 38 66 38 64 38 22 20 63 65 6c 6c 70 ="#f8f8d8" cellp
3cc0: 61 64 64 69 6e 67 3d 22 36 22 20 63 65 6c 6c 73 adding="6" cells
3cd0: 70 61 63 69 6e 67 3d 22 38 22 3e 3c 74 72 3e 3c pacing="8"><tr><
3ce0: 74 64 3e 0d 0a 3c 75 3e 4e 6f 74 65 3c 2f 75 3e td>..<u>Note</u>
3cf0: 3a 20 61 6c 6c 20 3c 62 3e 44 6f 74 20 4d 61 63 : all <b>Dot Mac
3d00: 72 6f 73 3c 2f 62 3e 20 66 6f 75 6e 64 20 77 69 ros</b> found wi
3d10: 74 68 69 6e 20 74 68 65 20 53 51 4c 20 42 6f 64 thin the SQL Bod
3d20: 79 20 62 65 69 6e 67 20 65 78 65 63 75 74 65 64 y being executed
3d30: 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 will always be
3d40: 69 67 6e 6f 72 65 64 2e 3c 62 72 3e 0d 0a 54 68 ignored.<br>..Th
3d50: 65 20 73 61 6d 65 20 72 75 6c 65 20 61 70 70 6c e same rule appl
3d60: 69 65 73 20 74 6f 20 3c 62 3e 53 74 6f 72 65 64 ies to <b>Stored
3d70: 50 72 6f 63 5f 45 78 65 63 75 74 65 3c 2f 62 3e Proc_Execute</b>
3d80: 20 61 73 20 77 65 6c 6c 2e 3c 2f 62 3e 0d 0a 3c as well.</b>..<
3d90: 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 /td></tr></table
3da0: 3e 0d 0a 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 2f 6c >..<br><hr>..</l
3db0: 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 3e 48 61 i>..<li>..<h4>Ha
3dc0: 6e 64 6c 69 6e 67 20 53 51 4c 20 53 74 6f 72 65 ndling SQL Store
3dd0: 64 20 50 72 6f 63 65 64 75 72 65 73 3c 2f 68 34 d Procedures</h4
3de0: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
3df0: 45 4c 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 ELECT StoredProc
3e00: 5f 43 72 65 61 74 65 54 61 62 6c 65 73 28 29 3b _CreateTables();
3e10: 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 ..-----..1..</ve
3e20: 72 62 61 74 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e rbatim>..you can
3e30: 20 75 73 65 20 3c 62 3e 53 74 6f 72 65 64 50 72 use <b>StoredPr
3e40: 6f 63 5f 43 72 65 61 74 65 54 61 62 6c 65 73 3c oc_CreateTables<
3e50: 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 /b> in order to
3e60: 63 72 65 61 74 65 2c 20 77 69 74 68 69 6e 20 79 create, within y
3e70: 6f 75 72 20 63 75 72 72 65 6e 74 6c 79 20 63 6f our currently co
3e80: 6e 6e 65 63 74 65 64 20 64 61 74 61 62 61 73 65 nnected database
3e90: 2c 20 61 6c 6c 20 3c 62 3e 6d 65 74 61 74 61 62 , all <b>metatab
3ea0: 6c 65 73 3c 2f 62 3e 20 72 65 71 75 69 72 65 64 les</b> required
3eb0: 20 74 6f 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 to permanently
3ec0: 72 65 67 69 73 74 65 72 20 53 74 6f 72 65 64 20 register Stored
3ed0: 50 72 6f 63 65 64 75 72 65 73 20 61 6e 64 20 53 Procedures and S
3ee0: 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 73 2e tored Variables.
3ef0: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 <br><br>..<table
3f00: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 38 64 bgcolor="#f8f8d
3f10: 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 8" cellpadding="
3f20: 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 6" cellspacing="
3f30: 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 8"><tr><td>..<u>
3f40: 4e 6f 74 65 3c 2f 75 3e 3a 20 61 6e 79 20 6e 65 Note</u>: any ne
3f50: 77 20 64 61 74 61 62 61 73 65 20 63 72 65 61 74 w database creat
3f60: 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 74 65 ed by SpatiaLite
3f70: 20 35 2e 30 2e 30 20 28 61 6e 64 20 73 75 62 73 5.0.0 (and subs
3f80: 65 71 75 65 6e 74 20 76 65 72 73 69 6f 6e 73 29 equent versions)
3f90: 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 will automatica
3fa0: 6c 6c 79 20 73 75 70 70 6f 72 74 20 74 68 65 20 lly support the
3fb0: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
3fc0: 73 20 6d 65 74 61 74 61 62 6c 65 73 2e 20 45 78 s metatables. Ex
3fd0: 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c 69 6e 67 plicitly calling
3fe0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
3ff0: 73 20 6d 61 69 6e 6c 79 20 75 73 65 64 20 69 6e s mainly used in
4000: 20 6f 72 64 65 72 20 74 6f 20 61 64 64 20 53 74 order to add St
4010: 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 73 20 ored Procedures
4020: 73 75 70 70 6f 72 74 20 6f 6e 20 61 6c 72 65 61 support on alrea
4030: 64 79 20 65 78 69 73 74 69 6e 67 20 64 61 74 61 dy existing data
4040: 62 61 73 65 73 20 63 72 65 61 74 65 64 20 62 79 bases created by
4050: 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f previous versio
4060: 6e 73 2e 20 43 61 6c 6c 69 6e 67 20 3c 62 3e 53 ns. Calling <b>S
4070: 74 6f 72 65 64 50 72 6f 63 5f 43 72 65 61 74 65 toredProc_Create
4080: 54 61 62 6c 65 73 3c 2f 62 3e 20 6f 6e 20 62 65 Tables</b> on be
4090: 68 61 6c 66 20 6f 66 20 61 20 64 61 74 61 62 61 half of a databa
40a0: 73 65 20 61 6c 72 65 61 64 79 20 73 75 70 70 6f se already suppo
40b0: 72 74 69 6e 67 20 74 68 65 20 53 74 6f 72 65 64 rting the Stored
40c0: 20 50 72 6f 63 65 64 75 72 65 73 20 6d 65 74 61 Procedures meta
40d0: 74 61 62 6c 65 20 69 73 20 61 6e 20 68 61 72 6d table is an harm
40e0: 6c 65 73 73 20 6f 70 65 72 61 74 69 6f 6e 20 73 less operation s
40f0: 69 6d 70 6c 79 20 72 65 74 75 72 6e 69 6e 67 20 imply returning
4100: 3c 62 3e 31 3c 2f 62 3e 20 28 66 75 6c 6c 20 73 <b>1</b> (full s
4110: 75 63 63 65 73 73 29 2e 0d 0a 3c 2f 74 64 3e 3c uccess)...</td><
4120: 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 76 /tr></table>..<v
4130: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 erbatim>..SELECT
4140: 20 53 74 6f 72 65 64 50 72 6f 63 5f 52 65 67 69 StoredProc_Regi
4150: 73 74 65 72 20 28 20 27 73 70 5f 31 27 2c 20 27 ster ( 'sp_1', '
4160: 61 20 73 61 6d 70 6c 65 20 53 74 6f 72 65 64 20 a sample Stored
4170: 50 72 6f 63 65 64 75 72 65 20 66 6f 72 20 74 65 Procedure for te
4180: 73 74 69 6e 67 27 2c 20 53 71 6c 50 72 6f 63 5f sting', SqlProc_
4190: 46 72 6f 6d 54 65 78 74 28 27 53 45 4c 45 43 54 FromText('SELECT
41a0: 20 40 63 6f 6c 40 20 46 52 4f 4d 20 40 74 62 6c @col@ FROM @tbl
41b0: 40 3b 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a @;' ));..-----..
41c0: 31 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 1..</verbatim>..
41d0: 79 6f 75 20 63 61 6e 20 75 73 65 20 3c 62 3e 53 you can use <b>S
41e0: 74 6f 72 65 64 50 72 6f 63 5f 52 65 67 69 73 74 toredProc_Regist
41f0: 65 72 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 er</b> in order
4200: 74 6f 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 72 to permanently r
4210: 65 67 69 73 74 65 72 20 61 20 53 74 6f 72 65 64 egister a Stored
4220: 20 50 72 6f 63 65 64 75 72 65 2e 0d 0a 3c 76 65 Procedure...<ve
4230: 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 rbatim>..SELECT
4240: 53 74 6f 72 65 64 50 72 6f 63 5f 44 65 6c 65 74 StoredProc_Delet
4250: 65 20 28 20 27 73 70 5f 31 27 20 29 3b 0d 0a 2d e ( 'sp_1' );..-
4260: 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 62 61 ----..1..</verba
4270: 74 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 73 tim>..you can us
4280: 65 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 5f e <b>StoredProc_
4290: 44 65 6c 65 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 Delete</b> in or
42a0: 64 65 72 20 74 6f 20 70 65 72 6d 61 6e 65 6e 74 der to permanent
42b0: 6c 79 20 72 65 6d 6f 76 65 20 61 20 70 72 65 76 ly remove a prev
42c0: 69 6f 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 iously registere
42d0: 64 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 d Stored Procedu
42e0: 72 65 2e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d re...<verbatim>.
42f0: 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f .SELECT SqlProc_
4300: 52 61 77 53 51 4c 20 28 20 53 74 6f 72 65 64 50 RawSQL ( StoredP
4310: 72 6f 63 5f 47 65 74 20 28 20 27 73 70 5f 31 27 roc_Get ( 'sp_1'
4320: 20 29 20 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 53 45 ) );..-----..SE
4330: 4c 45 43 54 20 40 63 6f 6c 40 20 46 52 4f 4d 20 LECT @col@ FROM
4340: 40 74 62 6c 40 3b 0d 0a 3c 2f 76 65 72 62 61 74 @tbl@;..</verbat
4350: 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 73 65 im>..you can use
4360: 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 5f 47 <b>StoredProc_G
4370: 65 74 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 et</b> in order
4380: 74 6f 20 72 65 74 72 69 65 76 65 20 74 68 65 20 to retrieve the
4390: 53 51 4c 20 50 72 6f 63 65 64 75 72 65 20 42 4c SQL Procedure BL
43a0: 4f 42 20 4f 62 6a 65 63 74 20 66 72 6f 6d 20 61 OB Object from a
43b0: 20 72 65 67 69 73 74 65 72 65 64 20 53 74 6f 72 registered Stor
43c0: 65 64 20 50 72 6f 63 65 64 75 72 65 2e 0d 0a 3c ed Procedure...<
43d0: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
43e0: 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 55 70 64 T StoredProc_Upd
43f0: 61 74 65 54 69 74 6c 65 20 28 20 27 73 70 5f 31 ateTitle ( 'sp_1
4400: 27 2c 20 27 74 68 69 73 20 54 69 74 6c 65 20 77 ', 'this Title w
4410: 61 73 20 63 68 61 6e 67 65 64 27 20 29 3b 0d 0a as changed' );..
4420: 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 62 -----..1..</verb
4430: 61 74 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 atim>..you can u
4440: 73 65 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 se <b>StoredProc
4450: 5f 55 70 64 61 74 65 54 69 74 6c 65 3c 2f 62 3e _UpdateTitle</b>
4460: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6d 6f 64 in order to mod
4470: 69 66 79 20 74 68 65 20 54 69 74 6c 65 20 6f 66 ify the Title of
4480: 20 61 6e 20 61 6c 72 65 61 64 79 20 72 65 67 69 an already regi
4490: 73 74 65 72 65 64 20 53 74 6f 72 65 64 20 50 72 stered Stored Pr
44a0: 6f 63 65 64 75 72 65 2e 0d 0a 3c 76 65 72 62 61 ocedure...<verba
44b0: 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 74 6f tim>..SELECT Sto
44c0: 72 65 64 50 72 6f 63 5f 55 70 64 61 74 65 53 71 redProc_UpdateSq
44d0: 6c 42 6f 64 79 20 28 20 27 73 70 5f 31 27 2c 20 lBody ( 'sp_1',
44e0: 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 46 69 6c 65 SqlProc_FromFile
44f0: 28 27 2f 68 6f 6d 65 2f 6a 6f 65 2f 73 71 6c 5f ('/home/joe/sql_
4500: 73 63 72 69 70 74 73 2f 73 74 6f 72 65 64 5f 70 scripts/stored_p
4510: 72 6f 63 5f 74 65 73 74 5f 76 32 2e 74 78 74 27 roc_test_v2.txt'
4520: 20 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c );..-----..1..<
4530: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 79 6f 75 20 /verbatim>..you
4540: 63 61 6e 20 75 73 65 20 3c 62 3e 53 74 6f 72 65 can use <b>Store
4550: 64 50 72 6f 63 5f 55 70 64 61 74 65 53 71 6c 42 dProc_UpdateSqlB
4560: 6f 64 79 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 ody</b> in order
4570: 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 53 to modify the S
4580: 71 6c 20 42 6f 64 79 20 6f 66 20 61 6e 20 61 6c ql Body of an al
4590: 72 65 61 64 79 20 72 65 67 69 73 74 65 72 65 64 ready registered
45a0: 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 Stored Procedur
45b0: 65 20 28 65 2e 67 2e 20 62 65 63 61 75 73 65 20 e (e.g. because
45c0: 79 6f 75 27 76 65 20 64 69 73 63 6f 76 65 72 65 you've discovere
45d0: 64 20 61 6e 64 20 66 69 78 65 64 20 73 6f 6d 65 d and fixed some
45e0: 20 62 75 67 20 61 66 66 65 63 74 69 6e 67 20 74 bug affecting t
45f0: 68 65 20 70 72 65 76 69 6f 75 73 20 53 51 4c 20 he previous SQL
4600: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 29 2e implementation).
4610: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 <verbatim>..SELE
4620: 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 45 78 CT StoredProc_Ex
4630: 65 63 75 74 65 20 28 20 27 73 70 5f 31 27 2c 0d ecute ( 'sp_1',.
4640: 0a 20 20 20 20 27 40 63 6f 6c 40 3d 73 72 69 64 . '@col@=srid
4650: 27 2c 0d 0a 20 20 20 20 27 40 74 62 6c 40 3d 73 ',.. '@tbl@=s
4660: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 27 20 patial_ref_sys'
4670: 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f );..-----..1..</
4680: 76 65 72 62 61 74 69 6d 3e 0d 0a 61 6e 64 20 66 verbatim>..and f
4690: 69 6e 61 6c 6c 79 20 79 6f 75 20 63 61 6e 20 75 inally you can u
46a0: 73 65 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 se <b>StoredProc
46b0: 5f 45 78 65 63 75 74 65 3c 2f 62 3e 20 69 6e 20 _Execute</b> in
46c0: 6f 72 64 65 72 20 74 6f 20 64 69 72 65 63 74 6c order to directl
46d0: 79 20 65 78 65 63 75 74 65 20 61 20 53 74 6f 72 y execute a Stor
46e0: 65 64 20 50 72 6f 63 65 64 75 72 65 20 61 73 20 ed Procedure as
46f0: 61 20 73 69 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 a single monolit
4700: 68 69 63 20 75 6e 69 74 2e 3c 62 72 3e 0d 0a 3c hic unit.<br>..<
4710: 62 72 3e 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 2f 6c br><br><hr>..</l
4720: 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 3e 48 61 i>..<li>..<h4>Ha
4730: 6e 64 6c 69 6e 67 20 53 51 4c 20 53 74 6f 72 65 ndling SQL Store
4740: 64 20 56 61 72 69 61 62 6c 65 73 3c 2f 68 34 3e d Variables</h4>
4750: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
4760: 4c 45 43 54 20 53 74 6f 72 65 64 56 61 72 5f 52 LECT StoredVar_R
4770: 65 67 69 73 74 65 72 20 28 20 27 70 69 27 2c 20 egister ( 'pi',
4780: 27 61 6e 20 75 6e 69 76 65 72 73 61 6c 6c 79 20 'an universally
4790: 75 73 65 66 75 6c 20 63 6f 6e 73 74 61 6e 74 27 useful constant'
47a0: 2c 20 27 33 2e 31 34 27 20 29 3b 0d 0a 2d 2d 2d , '3.14' );..---
47b0: 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 62 61 74 69 --..1..</verbati
47c0: 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 73 65 20 m>..you can use
47d0: 3c 62 3e 53 74 6f 72 65 64 56 61 72 5f 52 65 67 <b>StoredVar_Reg
47e0: 69 73 74 65 72 3c 2f 62 3e 20 69 6e 20 6f 72 64 ister</b> in ord
47f0: 65 72 20 74 6f 20 70 65 72 6d 61 6e 65 6e 74 6c er to permanentl
4800: 79 20 72 65 67 69 73 74 65 72 20 61 20 53 74 6f y register a Sto
4810: 72 65 64 20 56 61 72 69 61 62 6c 65 2e 0d 0a 3c red Variable...<
4820: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
4830: 54 20 53 74 6f 72 65 64 56 61 72 5f 44 65 6c 65 T StoredVar_Dele
4840: 74 65 20 28 20 27 70 69 27 20 29 3b 0d 0a 2d 2d te ( 'pi' );..--
4850: 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 62 61 74 ---..1..</verbat
4860: 69 6d 3e 0d 0a 79 6f 75 20 63 61 6e 20 75 73 65 im>..you can use
4870: 20 3c 62 3e 53 74 6f 72 65 64 56 61 72 5f 44 65 <b>StoredVar_De
4880: 6c 65 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 lete</b> in orde
4890: 72 20 74 6f 20 70 65 72 6d 61 6e 65 6e 74 6c 79 r to permanently
48a0: 20 72 65 6d 6f 76 65 20 61 20 70 72 65 76 69 6f remove a previo
48b0: 75 73 6c 79 20 72 65 67 69 73 74 65 72 65 64 20 usly registered
48c0: 53 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 2e Stored Variable.
48d0: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
48e0: 4c 45 43 54 20 53 74 6f 72 65 64 56 61 72 5f 47 LECT StoredVar_G
48f0: 65 74 20 28 20 27 70 69 27 20 29 3b 0d 0a 2d 2d et ( 'pi' );..--
4900: 2d 2d 2d 0d 0a 40 50 49 40 3d 33 2e 31 34 0d 0a ---..@PI@=3.14..
4910: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 79 6f 75 </verbatim>..you
4920: 20 63 61 6e 20 75 73 65 20 3c 62 3e 53 74 6f 72 can use <b>Stor
4930: 65 64 56 61 72 5f 47 65 74 3c 2f 62 3e 20 69 6e edVar_Get</b> in
4940: 20 6f 72 64 65 72 20 74 6f 20 72 65 74 72 69 65 order to retrie
4950: 76 65 20 74 68 65 20 56 61 72 69 61 62 6c 65 20 ve the Variable
4960: 77 69 74 68 20 56 61 6c 75 65 20 73 74 72 69 6e with Value strin
4970: 67 20 66 72 6f 6d 20 61 20 72 65 67 69 73 74 65 g from a registe
4980: 72 65 64 20 53 74 6f 72 65 64 20 56 61 72 69 61 red Stored Varia
4990: 62 6c 65 2e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e ble...<verbatim>
49a0: 0d 0a 53 45 4c 45 43 54 20 53 74 6f 72 65 64 56 ..SELECT StoredV
49b0: 61 72 5f 55 70 64 61 74 65 54 69 74 6c 65 20 28 ar_UpdateTitle (
49c0: 20 27 70 69 27 2c 20 27 50 49 20 2d 20 74 68 65 'pi', 'PI - the
49d0: 20 6d 61 67 69 63 20 6e 75 6d 62 65 72 27 20 29 magic number' )
49e0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 ;..-----..1..</v
49f0: 65 72 62 61 74 69 6d 3e 0d 0a 79 6f 75 20 63 61 erbatim>..you ca
4a00: 6e 20 75 73 65 20 3c 62 3e 53 74 6f 72 65 64 56 n use <b>StoredV
4a10: 61 72 5f 55 70 64 61 74 65 54 69 74 6c 65 3c 2f ar_UpdateTitle</
4a20: 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6d b> in order to m
4a30: 6f 64 69 66 79 20 74 68 65 20 54 69 74 6c 65 20 odify the Title
4a40: 6f 66 20 61 6e 20 61 6c 72 65 61 64 79 20 72 65 of an already re
4a50: 67 69 73 74 65 72 65 64 20 53 74 6f 72 65 64 20 gistered Stored
4a60: 50 72 6f 63 65 64 75 72 65 2e 0d 0a 3c 76 65 72 Procedure...<ver
4a70: 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 batim>..SELECT S
4a80: 74 6f 72 65 64 56 61 72 5f 55 70 64 61 74 65 56 toredVar_UpdateV
4a90: 61 6c 75 65 20 28 20 27 70 69 27 2c 20 27 33 2e alue ( 'pi', '3.
4aa0: 31 34 31 35 39 32 36 35 33 35 27 20 29 3b 0d 0a 1415926535' );..
4ab0: 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 62 -----..1..</verb
4ac0: 61 74 69 6d 3e 0d 0a 61 6e 64 20 66 69 6e 61 6c atim>..and final
4ad0: 6c 79 20 79 6f 75 20 63 61 6e 20 75 73 65 20 3c ly you can use <
4ae0: 62 3e 53 74 6f 72 65 64 56 61 72 5f 55 70 64 61 b>StoredVar_Upda
4af0: 74 65 56 61 6c 75 65 3c 2f 62 3e 20 69 6e 20 6f teValue</b> in o
4b00: 72 64 65 72 20 74 6f 20 6d 6f 64 69 66 79 20 74 rder to modify t
4b10: 68 65 20 56 61 72 69 61 62 6c 65 20 77 69 74 68 he Variable with
4b20: 20 56 61 6c 75 65 20 6f 66 20 61 6e 20 61 6c 72 Value of an alr
4b30: 65 61 64 79 20 72 65 67 69 73 74 65 72 65 64 20 eady registered
4b40: 53 74 6f 72 65 64 20 56 61 72 69 61 62 6c 65 2e Stored Variable.
4b50: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c ..</li>..<li>..<
4b60: 68 34 3e 53 71 6c 2f 53 74 6f 72 65 64 20 50 72 h4>Sql/Stored Pr
4b70: 6f 63 65 64 75 72 65 73 20 61 73 20 72 65 61 6c ocedures as real
4b80: 20 46 75 6e 63 74 69 6f 6e 73 3c 2f 68 34 3e 0d Functions</h4>.
4b90: 0a 41 6e 20 53 71 6c 20 6f 72 20 53 74 6f 72 65 .An Sql or Store
4ba0: 64 20 50 72 6f 63 65 64 75 72 65 20 63 61 6e 20 d Procedure can
4bb0: 65 66 66 65 63 74 69 76 65 6c 79 20 61 63 74 20 effectively act
4bc0: 61 73 20 61 20 67 65 6e 75 69 6e 65 20 46 75 6e as a genuine Fun
4bd0: 63 74 69 6f 6e 20 62 79 20 61 70 70 72 6f 70 72 ction by appropr
4be0: 69 61 74 65 6c 79 20 63 61 6c 6c 69 6e 67 20 3c iately calling <
4bf0: 62 3e 53 71 6c 50 72 6f 63 5f 52 65 74 75 72 6e b>SqlProc_Return
4c00: 28 29 3c 2f 62 3e 20 28 6f 72 20 3c 62 3e 53 74 ()</b> (or <b>St
4c10: 6f 72 65 64 50 72 6f 63 5f 52 65 74 75 72 6e 28 oredProc_Return(
4c20: 29 3c 2f 62 3e 2c 20 74 68 61 74 20 73 69 6d 70 )</b>, that simp
4c30: 6c 79 20 69 73 20 61 6e 20 3c 69 3e 61 6c 69 61 ly is an <i>alia
4c40: 73 20 6e 61 6d 65 3c 2f 69 3e 20 66 6f 72 20 74 s name</i> for t
4c50: 68 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e he same function
4c60: 29 2e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a )...<verbatim>..
4c70: 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 52 SELECT SqlProc_R
4c80: 65 74 75 72 6e 20 28 20 4e 55 4c 4c 20 29 3b 0d eturn ( NULL );.
4c90: 0a 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 45 .------..1....SE
4ca0: 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 52 65 74 LECT SqlProc_Ret
4cb0: 75 72 6e 20 28 20 31 32 33 34 35 20 29 3b 0d 0a urn ( 12345 );..
4cc0: 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 45 4c ------..1....SEL
4cd0: 45 43 54 20 53 71 6c 50 72 6f 63 5f 52 65 74 75 ECT SqlProc_Retu
4ce0: 72 6e 20 28 20 31 32 33 2e 34 35 20 29 3b 0d 0a rn ( 123.45 );..
4cf0: 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 45 4c ------..1....SEL
4d00: 45 43 54 20 53 71 6c 50 72 6f 63 5f 52 65 74 75 ECT SqlProc_Retu
4d10: 72 6e 20 28 20 27 74 68 69 73 20 69 73 20 61 20 rn ( 'this is a
4d20: 76 61 6c 75 65 27 20 29 3b 0d 0a 2d 2d 2d 2d 2d value' );..-----
4d30: 2d 0d 0a 31 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 -..1....SELECT S
4d40: 71 6c 50 72 6f 63 5f 52 65 74 75 72 6e 20 28 20 qlProc_Return (
4d50: 7a 65 72 6f 62 6c 6f 62 28 31 30 29 20 29 3b 0d zeroblob(10) );.
4d60: 0a 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 .------..1..</ve
4d70: 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d 0a 3c rbatim>..<ul>..<
4d80: 6c 69 3e 54 68 69 73 20 66 75 6e 63 74 69 6f 6e li>This function
4d90: 20 73 74 6f 70 73 20 61 73 20 73 6f 6f 6e 20 61 stops as soon a
4da0: 73 20 70 6f 73 73 69 62 6c 65 20 74 68 65 20 65 s possible the e
4db0: 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 xecution of the
4dc0: 63 75 72 72 65 6e 74 20 53 51 4c 20 42 6f 64 79 current SQL Body
4dd0: 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 , then returning
4de0: 20 61 20 3c 62 3e 76 61 6c 75 65 3c 2f 62 3e 20 a <b>value</b>
4df0: 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 2e 3c 62 to the caller.<b
4e00: 72 3e 0d 0a 54 68 65 20 3c 62 3e 52 65 74 75 72 r>..The <b>Retur
4e10: 6e 20 56 61 6c 75 65 3c 2f 62 3e 20 64 65 66 69 n Value</b> defi
4e20: 6e 65 64 20 62 79 20 3c 62 3e 53 71 6c 50 72 6f ned by <b>SqlPro
4e30: 63 5f 52 65 74 75 72 6e 28 29 3c 2f 62 3e 20 63 c_Return()</b> c
4e40: 61 6e 20 66 72 65 65 6c 79 20 62 65 20 6f 66 20 an freely be of
4e50: 61 6e 79 20 70 6f 73 73 69 62 6c 65 20 64 61 74 any possible dat
4e60: 61 2d 74 79 70 65 3a 20 4e 55 4c 4c 2c 20 49 4e a-type: NULL, IN
4e70: 54 45 47 45 52 2c 20 44 4f 55 42 4c 45 2c 20 54 TEGER, DOUBLE, T
4e80: 45 58 54 20 6f 72 20 42 4c 4f 42 2e 3c 2f 6c 69 EXT or BLOB.</li
4e90: 3e 0d 0a 3c 6c 69 3e 3c 75 3e 4e 6f 74 65 3c 2f >..<li><u>Note</
4ea0: 75 3e 3a 20 69 74 27 73 20 6e 6f 74 20 61 6e 20 u>: it's not an
4eb0: 65 78 61 63 74 20 65 71 75 69 76 61 6c 65 6e 74 exact equivalent
4ec0: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 75 73 75 of the most usu
4ed0: 61 6c 20 3c 62 3e 52 45 54 55 52 4e 3c 2f 62 3e al <b>RETURN</b>
4ee0: 20 73 74 61 74 65 6d 65 6e 74 20 64 65 66 69 6e statement defin
4ef0: 65 64 20 62 79 20 6d 61 6e 79 20 63 6f 6d 6d 6f ed by many commo
4f00: 6e 20 6c 61 6e 67 75 61 67 65 73 3a 0d 0a 3c 75 n languages:..<u
4f10: 6c 3e 0d 0a 3c 6c 69 3e 4a 75 73 74 20 63 61 6c l>..<li>Just cal
4f20: 6c 69 6e 67 20 3c 62 3e 53 71 6c 50 72 6f 63 5f ling <b>SqlProc_
4f30: 52 65 74 75 72 6e 28 29 3c 2f 62 3e 20 77 69 6c Return()</b> wil
4f40: 6c 20 6e 6f 74 20 63 61 75 73 65 20 74 68 65 20 l not cause the
4f50: 65 78 65 63 75 74 69 6f 6e 20 74 6f 20 69 6d 6d execution to imm
4f60: 65 64 69 61 74 65 6c 79 20 73 74 6f 70 3b 20 74 ediately stop; t
4f70: 68 69 73 20 63 6f 75 6c 64 20 65 61 73 69 6c 79 his could easily
4f80: 20 62 65 20 61 20 64 65 66 65 72 72 65 64 20 61 be a deferred a
4f90: 63 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ction.</li>..<li
4fa0: 3e 57 68 61 74 20 3c 62 3e 53 71 6c 50 72 6f 63 >What <b>SqlProc
4fb0: 5f 52 65 74 75 72 6e 28 29 3c 2f 62 3e 20 72 65 _Return()</b> re
4fc0: 61 6c 6c 79 20 64 6f 65 73 20 69 73 20 3c 69 3e ally does is <i>
4fd0: 62 6f 6f 6b 69 6e 67 3c 2f 69 3e 20 74 68 65 20 booking</i> the
4fe0: 74 65 72 6d 69 6e 61 74 69 6f 6e 20 6f 66 20 74 termination of t
4ff0: 68 65 20 63 75 72 72 65 6e 74 20 53 51 4c 20 42 he current SQL B
5000: 6c 6f 63 6b 2c 20 62 75 74 20 74 68 65 20 63 75 lock, but the cu
5010: 72 72 65 6e 74 20 53 51 4c 20 73 74 61 74 65 6d rrent SQL statem
5020: 65 6e 74 20 62 65 69 6e 67 20 65 78 65 63 75 74 ent being execut
5030: 65 64 20 28 74 68 65 20 6f 6e 65 20 69 6e 63 6c ed (the one incl
5040: 75 64 69 6e 67 20 74 68 65 20 53 71 6c 50 72 6f uding the SqlPro
5050: 63 5f 52 65 74 75 72 6e 28 29 20 63 61 6c 6c 29 c_Return() call)
5060: 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 will continue t
5070: 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 75 6e o be executed un
5080: 74 69 6c 20 69 74 73 20 6e 61 74 75 72 61 6c 20 til its natural
5090: 63 6f 6d 70 6c 65 74 69 6f 6e 2e 3c 2f 6c 69 3e completion.</li>
50a0: 0d 0a 3c 6c 69 3e 4f 6e 6c 79 20 61 74 20 74 68 ..<li>Only at th
50b0: 69 73 20 70 6f 69 6e 74 20 3c 62 3e 53 71 6c 50 is point <b>SqlP
50c0: 72 6f 63 5f 45 78 65 63 75 74 65 28 29 3c 2f 62 roc_Execute()</b
50d0: 3e 20 28 6f 72 20 3c 62 3e 53 74 6f 72 65 64 50 > (or <b>StoredP
50e0: 72 6f 63 5f 45 78 65 63 75 74 65 29 3c 2f 62 3e roc_Execute)</b>
50f0: 20 77 69 6c 6c 20 72 65 61 6c 6c 79 20 73 74 6f will really sto
5100: 70 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20 p executing the
5110: 63 75 72 72 65 6e 74 20 53 51 4c 20 42 6c 6f 63 current SQL Bloc
5120: 6b 20 69 6d 65 64 69 61 74 65 6c 79 20 72 65 74 k imediately ret
5130: 75 72 6e 69 6e 67 20 74 68 65 20 65 78 65 63 75 urning the execu
5140: 74 69 6f 6e 20 63 6f 6e 74 72 6f 6c 20 74 6f 20 tion control to
5150: 74 68 65 20 63 61 6c 6c 65 72 20 61 6e 64 20 70 the caller and p
5160: 61 73 73 69 6e 67 20 62 61 63 6b 20 74 6f 20 69 assing back to i
5170: 74 20 74 68 65 20 3c 62 3e 52 65 74 75 72 6e 20 t the <b>Return
5180: 56 61 6c 75 65 3c 2f 62 3e 20 73 70 65 66 69 66 Value</b> spefif
5190: 69 65 64 20 62 79 20 3c 62 3e 53 71 6c 50 72 6f ied by <b>SqlPro
51a0: 63 5f 52 65 74 75 72 6e 28 29 3c 2f 62 3e 2e 3c c_Return()</b>.<
51b0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e /li>..</ul></li>
51c0: 0d 0a 3c 6c 69 3e 3c 75 3e 49 6d 70 6f 72 74 61 ..<li><u>Importa
51d0: 6e 74 20 6e 6f 74 69 63 65 3c 2f 75 3e 3a 20 61 nt notice</u>: a
51e0: 6e 20 53 51 4c 20 42 6f 64 79 20 74 65 72 6d 69 n SQL Body termi
51f0: 6e 61 74 69 6e 67 20 77 69 74 68 6f 75 74 20 65 nating without e
5200: 78 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c 69 6e xplicitly callin
5210: 67 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 52 65 74 g <b>SqlProc_Ret
5220: 75 72 6e 28 29 3c 2f 62 3e 20 77 69 6c 6c 20 62 urn()</b> will b
5230: 65 68 61 76 65 20 65 78 61 63 74 6c 79 20 61 73 ehave exactly as
5240: 20 69 66 20 68 61 64 20 69 6d 70 6c 69 63 69 74 if had implicit
5250: 6c 79 20 63 61 6c 6c 65 64 20 3c 62 3e 53 71 6c ly called <b>Sql
5260: 50 72 6f 63 5f 52 65 74 75 72 6e 28 4e 55 4c 4c Proc_Return(NULL
5270: 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 75 3e ).</li>..<li><u>
5280: 57 61 72 6e 69 6e 67 3c 2f 75 3e 3a 20 61 6e 79 Warning</u>: any
5290: 20 63 61 6c 6c 20 74 6f 20 3c 62 3e 53 71 6c 50 call to <b>SqlP
52a0: 72 6f 63 5f 52 65 74 75 72 6e 28 29 3c 2f 62 3e roc_Return()</b>
52b0: 20 6f 75 74 73 69 64 65 20 74 68 65 20 65 78 65 outside the exe
52c0: 63 75 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20 6f cution context o
52d0: 66 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 45 78 65 f <b>SqlProc_Exe
52e0: 63 75 74 65 28 29 3c 2f 62 3e 20 28 6f 72 20 3c cute()</b> (or <
52f0: 62 3e 53 74 6f 72 65 64 50 72 6f 63 5f 45 78 65 b>StoredProc_Exe
5300: 63 75 74 65 3c 2f 62 3e 29 20 77 69 6c 6c 20 62 cute</b>) will b
5310: 65 20 73 69 6d 70 6c 79 20 63 6f 6e 73 69 64 65 e simply conside
5320: 72 65 64 20 61 73 20 61 6e 20 65 66 66 65 63 74 red as an effect
5330: 6c 65 73 73 20 3c 62 3e 6e 6f 2d 6f 70 3c 2f 62 less <b>no-op</b
5340: 3e 2e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d >...</ul>..<br>.
5350: 0a 4a 75 73 74 20 66 65 77 20 62 61 73 69 63 20 .Just few basic
5360: 65 78 61 6d 70 6c 65 73 20 61 62 6f 75 74 20 53 examples about S
5370: 71 6c 20 50 72 6f 63 65 64 75 72 65 73 20 61 63 ql Procedures ac
5380: 74 69 6e 67 20 61 73 20 72 65 61 6c 20 46 75 6e ting as real Fun
5390: 63 74 69 6f 6e 73 2e 3c 62 72 3e 3c 62 72 3e 0d ctions.<br><br>.
53a0: 0a 3c 62 3e 45 78 61 6d 70 6c 65 20 23 31 3c 2f .<b>Example #1</
53b0: 62 3e 3a 20 61 20 70 73 65 75 64 6f 2d 66 75 6e b>: a pseudo-fun
53c0: 63 74 69 6f 6e 20 72 65 74 75 72 6e 69 6e 67 20 ction returning
53d0: 74 68 65 20 73 75 6d 20 6f 66 20 74 77 6f 20 49 the sum of two I
53e0: 6e 74 65 67 65 72 73 2e 0d 0a 3c 76 65 72 62 61 ntegers...<verba
53f0: 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c tim>..SELECT Sql
5400: 50 72 6f 63 5f 45 78 65 63 75 74 65 28 53 71 6c Proc_Execute(Sql
5410: 50 72 6f 63 5f 46 72 6f 6d 54 65 78 74 28 0d 0a Proc_FromText(..
5420: 20 20 20 20 20 20 20 27 53 45 4c 45 43 54 20 53 'SELECT S
5430: 71 6c 50 72 6f 63 5f 52 65 74 75 72 6e 28 40 61 qlProc_Return(@a
5440: 72 67 31 40 20 2b 20 40 61 72 67 32 40 29 27 29 rg1@ + @arg2@)')
5450: 2c 20 0d 0a 20 20 20 20 20 20 20 27 40 61 72 67 , .. '@arg
5460: 31 40 3d 31 30 30 30 27 2c 20 27 40 61 72 67 32 1@=1000', '@arg2
5470: 40 3d 32 35 27 29 3b 20 0d 0a 2d 2d 2d 2d 2d 2d @=25'); ..------
5480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5490: 2d 2d 2d 0d 0a 31 30 32 35 0d 0a 3c 2f 76 65 72 ---..1025..</ver
54a0: 62 61 74 69 6d 3e 0d 0a 3c 62 3e 45 78 61 6d 70 batim>..<b>Examp
54b0: 6c 65 20 23 32 3c 2f 62 3e 3a 20 61 20 70 73 65 le #2</b>: a pse
54c0: 75 64 6f 2d 66 75 6e 63 74 69 6f 6e 20 72 65 74 udo-function ret
54d0: 75 72 6e 69 6e 67 20 74 68 65 20 70 72 6f 64 75 urning the produ
54e0: 63 74 20 6f 66 20 74 77 6f 20 44 6f 75 62 6c 65 ct of two Double
54f0: 73 2e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a s...<verbatim>..
5500: 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 45 SELECT SqlProc_E
5510: 78 65 63 75 74 65 28 53 71 6c 50 72 6f 63 5f 46 xecute(SqlProc_F
5520: 72 6f 6d 54 65 78 74 28 0d 0a 20 20 20 20 20 20 romText(..
5530: 20 27 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 'SELECT SqlProc
5540: 5f 52 65 74 75 72 6e 28 40 61 72 67 31 40 20 2a _Return(@arg1@ *
5550: 20 40 61 72 67 32 40 29 27 29 2c 20 0d 0a 20 20 @arg2@)'), ..
5560: 20 20 20 20 20 27 40 61 72 67 31 40 3d 33 2e 32 '@arg1@=3.2
5570: 35 27 2c 20 27 40 61 72 67 32 40 3d 31 30 30 2e 5', '@arg2@=100.
5580: 30 27 29 3b 20 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 0'); ..---------
5590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
55a0: 0d 0a 33 32 35 2e 30 30 30 30 30 30 0d 0a 3c 2f ..325.000000..</
55b0: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 62 3e 45 78 verbatim>..<b>Ex
55c0: 61 6d 70 6c 65 20 23 33 3c 2f 62 3e 3a 20 61 20 ample #3</b>: a
55d0: 70 73 65 75 64 6f 2d 66 75 6e 63 74 69 6f 6e 20 pseudo-function
55e0: 72 65 74 75 72 6e 69 6e 67 20 74 68 65 20 63 6f returning the co
55f0: 6e 63 61 74 65 6e 61 74 69 6f 6e 20 6f 66 20 74 ncatenation of t
5600: 77 6f 20 54 65 78 74 20 53 74 72 69 6e 67 73 2e wo Text Strings.
5610: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
5620: 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 45 78 65 LECT SqlProc_Exe
5630: 63 75 74 65 28 53 71 6c 50 72 6f 63 5f 46 72 6f cute(SqlProc_Fro
5640: 6d 54 65 78 74 28 0d 0a 20 20 20 20 20 20 20 27 mText(.. '
5650: 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 52 SELECT SqlProc_R
5660: 65 74 75 72 6e 28 40 73 74 72 31 40 20 7c 7c 20 eturn(@str1@ ||
5670: 27 27 20 27 27 20 7c 7c 20 40 73 74 72 32 40 29 '' '' || @str2@)
5680: 27 29 2c 20 0d 0a 20 20 20 20 20 20 20 27 40 73 '), .. '@s
5690: 74 72 31 40 3d 27 27 4c 69 6e 75 73 20 54 6f 72 tr1@=''Linus Tor
56a0: 76 61 6c 64 73 27 27 27 2c 20 27 40 73 74 72 32 valds''', '@str2
56b0: 40 3d 27 27 69 73 20 74 68 65 20 61 75 74 68 6f @=''is the autho
56c0: 72 20 6f 66 20 4c 69 6e 75 78 27 27 27 29 3b 20 r of Linux''');
56d0: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
56e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4c 69 6e -----------..Lin
56f0: 75 73 20 54 6f 72 76 61 6c 64 73 20 69 73 20 74 us Torvalds is t
5700: 68 65 20 61 75 74 68 6f 72 20 6f 66 20 4c 69 6e he author of Lin
5710: 75 78 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d ux..</verbatim>.
5720: 0a 3c 62 3e 45 78 61 6d 70 6c 65 20 23 34 3c 2f .<b>Example #4</
5730: 62 3e 3a 20 61 20 70 73 65 75 64 6f 2d 66 75 6e b>: a pseudo-fun
5740: 63 74 69 6f 6e 20 72 65 74 75 72 6e 69 6e 67 20 ction returning
5750: 61 20 42 4c 4f 42 20 47 65 6f 6d 65 74 72 79 2e a BLOB Geometry.
5760: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
5770: 4c 45 43 54 20 41 73 45 57 4b 54 28 53 71 6c 50 LECT AsEWKT(SqlP
5780: 72 6f 63 5f 45 78 65 63 75 74 65 28 53 71 6c 50 roc_Execute(SqlP
5790: 72 6f 63 5f 46 72 6f 6d 54 65 78 74 28 0d 0a 20 roc_FromText(..
57a0: 20 20 20 20 20 20 27 53 45 4c 45 43 54 20 53 71 'SELECT Sq
57b0: 6c 50 72 6f 63 5f 52 65 74 75 72 6e 28 4d 61 6b lProc_Return(Mak
57c0: 65 50 6f 69 6e 74 28 40 78 40 2c 20 40 79 40 2c ePoint(@x@, @y@,
57d0: 20 40 73 72 69 64 40 29 29 27 29 2c 20 0d 0a 20 @srid@))'), ..
57e0: 20 20 20 20 20 20 27 40 78 40 3d 31 30 27 2c 20 '@x@=10',
57f0: 27 40 79 40 3d 32 30 27 2c 20 27 40 73 72 69 64 '@y@=20', '@srid
5800: 40 3d 34 33 32 36 27 29 29 3b 20 0d 0a 2d 2d 2d @=4326')); ..---
5810: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5820: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 34 33 32 ------..SRID=432
5830: 36 3b 50 4f 49 4e 54 28 31 30 20 32 30 29 0d 0a 6;POINT(10 20)..
5840: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 2f 6c </verbatim>..</l
5850: 69 3e 3c 6c 69 3e 0d 0a 3c 68 34 3e 53 71 6c 2f i><li>..<h4>Sql/
5860: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
5870: 73 20 69 74 65 72 61 74 69 76 65 20 65 78 65 63 s iterative exec
5880: 75 74 69 6f 6e 3c 2f 68 34 3e 0d 0a 3c 62 3e 53 ution</h4>..<b>S
5890: 71 6c 50 72 6f 63 5f 45 78 65 63 75 74 65 4c 6f qlProc_ExecuteLo
58a0: 6f 70 28 29 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e op()</b> and <b>
58b0: 53 74 6f 72 65 64 50 72 6f 63 5f 45 78 65 63 75 StoredProc_Execu
58c0: 74 65 4c 6f 6f 70 28 29 3c 2f 62 3e 20 61 72 65 teLoop()</b> are
58d0: 20 76 65 72 79 20 73 69 6d 69 6c 61 72 20 72 65 very similar re
58e0: 73 70 65 63 74 69 76 65 6c 79 20 74 6f 20 3c 62 spectively to <b
58f0: 3e 53 71 6c 50 72 6f 63 5f 45 78 65 63 75 74 65 >SqlProc_Execute
5900: 28 29 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 53 74 ()</b> and <b>St
5910: 6f 72 65 64 50 72 6f 63 5f 45 78 65 63 75 74 65 oredProc_Execute
5920: 28 29 3c 2f 62 3e 3b 20 74 68 65 20 73 69 67 6e ()</b>; the sign
5930: 61 74 75 72 65 20 6f 66 20 74 68 65 73 65 20 53 ature of these S
5940: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 70 61 69 72 QL function pair
5950: 73 20 69 73 20 65 78 61 63 74 6c 79 20 74 68 65 s is exactly the
5960: 20 73 61 6d 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a same.<br><br>..
5970: 42 75 74 20 74 68 65 72 65 20 69 73 20 61 20 76 But there is a v
5980: 65 72 79 20 72 65 6c 65 76 61 6e 74 20 64 69 66 ery relevant dif
5990: 66 65 72 65 6e 63 65 20 69 6e 20 74 68 65 69 72 ference in their
59a0: 20 72 65 73 70 65 63 74 69 76 65 20 62 65 68 61 respective beha
59b0: 76 69 6f 72 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 vior:..<ul>..<li
59c0: 3e 61 73 20 77 65 20 68 61 76 65 20 61 6c 72 65 >as we have alre
59d0: 61 64 79 20 73 65 65 6e 2c 20 62 6f 74 68 20 3c ady seen, both <
59e0: 62 3e 53 71 6c 50 72 6f 63 5f 45 78 65 63 75 74 b>SqlProc_Execut
59f0: 65 28 29 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 53 e()</b> and <b>S
5a00: 74 6f 72 65 64 50 72 6f 63 5f 45 78 65 63 75 74 toredProc_Execut
5a10: 65 28 29 3c 2f 62 3e 20 72 75 6e 20 6a 75 73 74 e()</b> run just
5a20: 20 6f 6e 63 65 2c 20 74 68 65 6e 20 72 65 74 75 once, then retu
5a30: 72 6e 69 6e 67 20 74 6f 20 74 68 65 20 63 61 6c rning to the cal
5a40: 6c 65 72 20 74 68 65 20 3c 62 3e 72 65 74 75 72 ler the <b>retur
5a50: 6e 20 76 61 6c 75 65 3c 2f 62 3e 20 69 6d 70 6c n value</b> impl
5a60: 69 63 69 74 6c 79 20 6f 72 20 65 78 70 6c 69 63 icitly or explic
5a70: 69 74 6c 79 20 73 65 74 20 62 79 20 3c 62 3e 53 itly set by <b>S
5a80: 71 6c 50 72 6f 63 5f 52 65 74 75 72 6e 28 29 3c qlProc_Return()<
5a90: 2f 62 3e 20 6f 72 20 3c 62 3e 53 74 6f 72 65 64 /b> or <b>Stored
5aa0: 50 72 6f 63 5f 52 65 74 75 72 6e 28 29 3c 2f 62 Proc_Return()</b
5ab0: 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 62 6f 74 >.</li>..<li>bot
5ac0: 68 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 45 78 65 h <b>SqlProc_Exe
5ad0: 63 75 74 65 4c 6f 6f 70 28 29 3c 2f 62 3e 20 61 cuteLoop()</b> a
5ae0: 6e 64 20 3c 62 3e 53 74 6f 72 65 64 50 72 6f 63 nd <b>StoredProc
5af0: 5f 45 78 65 63 75 74 65 4c 6f 6f 70 28 29 3c 2f _ExecuteLoop()</
5b00: 62 3e 20 77 69 6c 6c 20 69 6e 73 74 65 61 64 20 b> will instead
5b10: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 74 automatically it
5b20: 65 72 61 74 65 20 61 73 20 6d 61 6e 79 20 74 69 erate as many ti
5b30: 6d 65 73 20 61 73 20 72 65 71 75 69 72 65 64 20 mes as required
5b40: 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 the execution of
5b50: 20 74 68 65 69 72 20 3c 62 3e 53 51 4c 20 42 6f their <b>SQL Bo
5b60: 64 79 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 54 68 65 dy</b>.<br>..The
5b70: 20 6c 6f 6f 70 20 77 69 6c 6c 20 62 72 65 61 6b loop will break
5b80: 20 6f 6e 6c 79 20 77 68 65 6e 20 74 68 65 20 6c only when the l
5b90: 61 73 74 20 69 74 65 72 61 74 69 6f 6e 20 77 69 ast iteration wi
5ba0: 6c 6c 20 66 69 6e 61 6c 6c 79 20 72 65 74 75 72 ll finally retur
5bb0: 6e 20 61 20 3c 62 3e 6e 65 67 61 74 69 76 65 3c n a <b>negative<
5bc0: 2f 62 3e 20 6f 72 20 3c 62 3e 7a 65 72 6f 3c 2f /b> or <b>zero</
5bd0: 62 3e 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 b> integer value
5be0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c .</li>..<li><b><
5bf0: 75 3e 57 61 72 6e 69 6e 67 3c 2f 75 3e 3c 2f 62 u>Warning</u></b
5c00: 3e 3a 20 61 20 62 61 64 6c 79 20 69 6d 70 6c 65 >: a badly imple
5c10: 6d 65 6e 74 65 64 20 69 74 65 72 61 74 69 6f 6e mented iteration
5c20: 20 63 61 6e 20 65 61 73 69 6c 79 20 63 61 75 73 can easily caus
5c30: 65 20 61 20 6e 61 73 74 79 20 3c 61 20 68 72 65 e a nasty <a hre
5c40: 66 3d 22 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 f="https://en.wi
5c50: 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 kipedia.org/wiki
5c60: 2f 49 6e 66 69 6e 69 74 65 5f 6c 6f 6f 70 22 3e /Infinite_loop">
5c70: 65 6e 64 6c 65 73 73 20 6c 6f 6f 70 3c 2f 61 3e endless loop</a>
5c80: 3b 20 62 65 77 61 72 65 20 61 6e 64 20 62 65 20 ; beware and be
5c90: 76 65 72 79 20 63 61 75 74 69 6f 75 73 2e 3c 2f very cautious.</
5ca0: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a li>..</ul><br>..
5cb0: 3c 62 3e 45 78 61 6d 70 6c 65 3c 2f 62 3e 0d 0a <b>Example</b>..
5cc0: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 0d 0a <verbatim>..--..
5cd0: 2d 2d 20 63 72 65 61 74 69 6e 67 20 61 20 74 65 -- creating a te
5ce0: 73 74 20 74 61 62 6c 65 0d 0a 2d 2d 0d 0a 43 52 st table..--..CR
5cf0: 45 41 54 45 20 54 41 42 4c 45 20 49 46 20 4e 4f EATE TABLE IF NO
5d00: 54 20 45 58 49 53 54 53 20 6c 6f 6f 70 69 6e 67 T EXISTS looping
5d10: 20 28 0d 0a 20 20 20 20 69 64 20 49 4e 54 45 47 (.. id INTEG
5d20: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 41 ER PRIMARY KEY A
5d30: 55 54 4f 49 4e 43 52 45 4d 45 4e 54 2c 0d 0a 20 UTOINCREMENT,..
5d40: 20 20 20 63 6f 6c 69 6e 74 20 49 4e 54 45 47 45 colint INTEGE
5d50: 52 20 4e 4f 54 20 4e 55 4c 4c 2c 0d 0a 20 20 20 R NOT NULL,..
5d60: 20 63 6f 6c 73 74 72 20 54 45 58 54 20 4e 4f 54 colstr TEXT NOT
5d70: 20 4e 55 4c 4c 2c 0d 0a 20 20 20 20 74 6d 73 74 NULL,.. tmst
5d80: 61 6d 70 20 54 45 58 54 20 4e 4f 54 20 4e 55 4c amp TEXT NOT NUL
5d90: 4c 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 69 6e L);....--..-- in
5da0: 73 65 72 74 69 6e 67 20 61 20 72 61 6e 64 6f 6d serting a random
5db0: 20 72 6f 77 0d 0a 2d 2d 0d 0a 49 4e 53 45 52 54 row..--..INSERT
5dc0: 20 49 4e 54 4f 20 6c 6f 6f 70 69 6e 67 20 28 69 INTO looping (i
5dd0: 64 2c 20 63 6f 6c 69 6e 74 2c 20 63 6f 6c 73 74 d, colint, colst
5de0: 72 2c 20 74 6d 73 74 61 6d 70 29 0d 0a 20 20 20 r, tmstamp)..
5df0: 20 56 41 4c 55 45 53 20 28 4e 55 4c 4c 2c 20 72 VALUES (NULL, r
5e00: 61 6e 64 6f 6d 28 29 2c 20 68 65 78 28 72 61 6e andom(), hex(ran
5e10: 64 6f 6d 62 6c 6f 62 28 31 36 29 29 2c 20 64 61 domblob(16)), da
5e20: 74 65 74 69 6d 65 28 27 6e 6f 77 27 29 29 3b 0d tetime('now'));.
5e30: 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 73 65 74 74 69 6e ...--..-- settin
5e40: 67 20 75 70 20 61 20 72 65 74 75 72 6e 20 76 61 g up a return va
5e50: 6c 75 65 0d 0a 2d 2d 0d 0a 53 45 4c 45 43 54 20 lue..--..SELECT
5e60: 43 41 53 45 20 63 6f 75 6e 74 28 2a 29 20 3e 3d CASE count(*) >=
5e70: 20 40 4c 49 4d 49 54 40 20 57 48 45 4e 20 31 20 @LIMIT@ WHEN 1
5e80: 54 48 45 4e 20 53 71 6c 50 72 6f 63 5f 52 65 74 THEN SqlProc_Ret
5e90: 75 72 6e 28 30 29 0d 0a 20 20 20 20 20 20 20 45 urn(0).. E
5ea0: 4c 53 45 20 53 71 6c 50 72 6f 63 5f 52 65 74 75 LSE SqlProc_Retu
5eb0: 72 6e 28 31 29 20 45 4e 44 20 46 52 4f 4d 20 6c rn(1) END FROM l
5ec0: 6f 6f 70 69 6e 67 3b 0d 0a 3c 2f 76 65 72 62 61 ooping;..</verba
5ed0: 74 69 6d 3e 0d 0a 54 68 69 73 20 73 61 6d 70 6c tim>..This sampl
5ee0: 65 20 53 51 4c 20 42 6f 64 79 20 28 3c 62 3e 6c e SQL Body (<b>l
5ef0: 6f 6f 70 2e 73 71 6c 3c 2f 62 3e 29 20 77 69 6c oop.sql</b>) wil
5f00: 6c 20 74 61 6b 65 20 74 68 65 20 66 6f 6c 6c 6f l take the follo
5f10: 77 69 6e 67 20 61 63 74 69 6f 6e 73 3a 0d 0a 3c wing actions:..<
5f20: 6f 6c 3e 0d 0a 3c 6c 69 3e 66 69 72 73 74 20 69 ol>..<li>first i
5f30: 74 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 63 72 t will try to cr
5f40: 65 61 74 65 20 61 20 74 61 62 6c 65 3b 20 69 66 eate a table; if
5f50: 20 74 68 65 20 74 61 62 6c 65 20 61 6c 72 65 64 the table alred
5f60: 79 20 65 78 69 73 74 73 20 61 6e 79 20 65 72 72 y exists any err
5f70: 6f 72 20 77 69 6c 6c 20 62 65 20 73 69 6c 65 6e or will be silen
5f80: 74 6c 79 20 69 67 6e 6f 72 65 64 2e 3c 2f 6c 69 tly ignored.</li
5f90: 3e 0d 0a 3c 6c 69 3e 74 68 65 6e 20 69 74 20 77 >..<li>then it w
5fa0: 69 6c 6c 20 49 4e 53 45 52 54 20 61 20 72 61 6e ill INSERT a ran
5fb0: 64 6f 6d 20 72 6f 77 20 69 6e 20 74 68 69 73 20 dom row in this
5fc0: 74 61 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 table.</li>..<li
5fd0: 3e 61 6e 64 20 66 69 6e 61 6c 6c 79 20 69 66 20 >and finally if
5fe0: 77 69 6c 6c 20 63 68 65 63 6b 20 68 6f 77 20 6d will check how m
5ff0: 61 6e 79 20 72 6f 77 73 20 68 61 76 65 20 62 65 any rows have be
6000: 65 6e 20 61 6c 72 65 61 64 79 20 69 6e 73 65 72 en already inser
6010: 74 65 64 20 69 6e 20 74 68 65 20 74 61 62 6c 65 ted in the table
6020: 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 74 68 65 20 .<br>..When the
6030: 70 72 65 64 65 66 69 6e 65 64 20 6c 69 6d 69 74 predefined limit
6040: 20 77 69 6c 6c 20 62 65 20 72 65 61 63 68 65 64 will be reached
6050: 2c 20 74 68 65 20 6c 6f 6f 70 20 77 69 6c 6c 20 , the loop will
6060: 74 65 72 6d 69 6e 61 74 65 2e 3c 2f 6c 69 3e 0d terminate.</li>.
6070: 0a 3c 2f 6f 6c 3e 0d 0a 3c 76 65 72 62 61 74 69 .</ol>..<verbati
6080: 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 m>..SELECT SqlPr
6090: 6f 63 5f 45 78 65 63 75 74 65 4c 6f 6f 70 28 53 oc_ExecuteLoop(S
60a0: 71 6c 50 72 6f 63 5f 46 72 6f 6d 46 69 6c 65 28 qlProc_FromFile(
60b0: 27 2e 2f 6c 6f 6f 70 2e 73 71 6c 27 29 2c 20 27 './loop.sql'), '
60c0: 40 4c 49 4d 49 54 40 3d 31 30 30 30 27 29 3b 0d @LIMIT@=1000');.
60d0: 0a 0d 0a 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d ...SELECT * FROM
60e0: 20 6c 6f 6f 70 69 6e 67 3b 0d 0a 3c 2f 76 65 72 looping;..</ver
60f0: 62 61 74 69 6d 3e 0d 0a 41 73 20 79 6f 75 20 63 batim>..As you c
6100: 61 6e 20 65 61 73 69 6c 79 20 63 68 65 63 6b 2c an easily check,
6110: 20 74 68 65 20 69 74 65 72 61 74 69 76 65 20 65 the iterative e
6120: 78 65 63 75 74 69 6f 6e 20 6f 66 20 3c 62 3e 6c xecution of <b>l
6130: 6f 6f 70 2e 73 71 6c 3c 2f 62 3e 20 68 61 73 20 oop.sql</b> has
6140: 6a 75 73 74 20 63 72 65 61 74 65 64 20 74 68 65 just created the
6150: 20 74 61 72 67 65 74 20 74 61 62 6c 65 20 69 6e target table in
6160: 73 65 72 74 69 6e 67 20 74 68 6f 75 73 61 6e 64 serting thousand
6170: 20 72 6f 77 73 20 69 6e 74 6f 20 69 74 2e 0d 0a rows into it...
6180: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 0d 0a 3c 68 34 </li>..<li>..<h4
6190: 3e 48 61 6e 64 6c 69 6e 67 20 74 68 65 20 53 51 >Handling the SQ
61a0: 4c 20 4c 6f 67 66 69 6c 65 3c 2f 68 34 3e 0d 0a L Logfile</h4>..
61b0: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 <verbatim>..SELE
61c0: 43 54 20 53 71 6c 50 72 6f 63 5f 53 65 74 4c 6f CT SqlProc_SetLo
61d0: 67 66 69 6c 65 20 28 20 27 2f 68 6f 6d 65 2f 73 gfile ( '/home/s
61e0: 61 6e 64 72 6f 2f 73 71 6c 5f 6c 6f 67 2e 74 78 andro/sql_log.tx
61f0: 74 27 20 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d t' );..-----..1.
6200: 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f ...SELECT SqlPro
6210: 63 5f 53 65 74 4c 6f 67 66 69 6c 65 20 28 20 27 c_SetLogfile ( '
6220: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 73 71 6c /home/sandro/sql
6230: 5f 6c 6f 67 2e 74 78 74 27 2c 20 31 29 3b 0d 0a _log.txt', 1);..
6240: 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 45 4c 45 -----..1....SELE
6250: 43 54 20 53 71 6c 50 72 6f 63 5f 53 65 74 4c 6f CT SqlProc_SetLo
6260: 67 66 69 6c 65 20 28 20 4e 55 4c 4c 20 29 3b 0d gfile ( NULL );.
6270: 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 72 .-----..1..</ver
6280: 62 61 74 69 6d 3e 0d 0a 59 6f 75 20 63 61 6e 20 batim>..You can
6290: 75 73 65 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 53 use <b>SqlProc_S
62a0: 65 74 4c 6f 67 66 69 6c 65 28 29 3c 2f 62 3e 20 etLogfile()</b>
62b0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 in order to enab
62c0: 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68 le or disable th
62d0: 65 20 53 51 4c 20 4c 6f 67 66 69 6c 65 3a 0d 0a e SQL Logfile:..
62e0: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 66 69 <ul>..<li>the fi
62f0: 72 73 74 20 66 6f 72 6d 20 28 73 69 6e 67 6c 65 rst form (single
6300: 20 61 72 67 75 6d 65 6e 74 29 20 6a 75 73 74 20 argument) just
6310: 72 65 71 75 69 72 65 73 20 74 6f 20 64 65 66 69 requires to defi
6320: 6e 65 20 74 68 65 20 3c 62 3e 61 62 73 6f 6c 75 ne the <b>absolu
6330: 74 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 72 65 6c te</b> or <b>rel
6340: 61 74 69 76 65 20 70 61 74 68 6e 61 6d 65 3c 2f ative pathname</
6350: 62 3e 20 6f 66 20 74 68 65 20 69 6e 74 65 6e 64 b> of the intend
6360: 65 64 20 4c 6f 67 66 69 6c 65 2e 3c 62 72 3e 0d ed Logfile.<br>.
6370: 0a 41 20 4c 6f 67 66 69 6c 65 20 64 65 66 69 6e .A Logfile defin
6380: 65 64 20 69 6e 20 73 75 63 68 20 61 20 77 61 79 ed in such a way
6390: 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 6f 70 65 will always ope
63a0: 72 61 74 65 20 69 6e 20 3c 62 3e 54 72 75 6e 63 rate in <b>Trunc
63b0: 61 74 65 3c 2f 62 3e 20 6d 6f 64 65 2e 3c 2f 6c ate</b> mode.</l
63c0: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 73 65 63 6f i>..<li>the seco
63d0: 6e 64 20 66 6f 72 6d 20 28 74 77 6f 20 61 72 67 nd form (two arg
63e0: 75 6d 65 6e 74 73 29 20 73 75 70 70 6f 72 74 73 uments) supports
63f0: 20 61 20 66 75 72 74 68 65 72 20 3c 62 3e 6d 6f a further <b>mo
6400: 64 65 3c 2f 62 3e 20 61 72 67 75 6d 65 6e 74 3a de</b> argument:
6410: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 66 20 73 ..<ul>..<li>if s
6420: 65 74 20 74 6f 20 3c 62 3e 46 41 4c 53 45 3c 2f et to <b>FALSE</
6430: 62 3e 20 28 3c 62 3e 30 3c 2f 62 3e 2c 20 64 65 b> (<b>0</b>, de
6440: 66 61 75 6c 74 20 76 61 6c 75 65 29 20 74 68 65 fault value) the
6450: 20 4c 6f 67 66 69 6c 65 20 77 69 6c 6c 20 6f 70 Logfile will op
6460: 65 72 61 74 65 20 69 6e 20 3c 62 3e 54 72 75 6e erate in <b>Trun
6470: 63 61 74 65 3c 2f 62 3e 20 6d 6f 64 65 2e 3c 2f cate</b> mode.</
6480: 6c 69 3e 0d 0a 3c 6c 69 3e 69 66 20 73 65 74 20 li>..<li>if set
6490: 74 6f 20 3c 62 3e 54 52 55 45 3c 2f 62 3e 20 28 to <b>TRUE</b> (
64a0: 61 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 65 20 any other value
64b0: 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 3c different from <
64c0: 62 3e 30 3c 2f 62 3e 29 20 74 68 65 20 4c 6f 67 b>0</b>) the Log
64d0: 66 69 6c 65 20 77 69 6c 6c 20 6f 70 65 72 61 74 file will operat
64e0: 65 20 69 6e 20 3c 62 3e 41 70 70 65 6e 64 3c 2f e in <b>Append</
64f0: 62 3e 20 6d 6f 64 65 2e 3c 2f 6c 69 3e 0d 0a 3c b> mode.</li>..<
6500: 2f 75 6c 3e 0d 0a 3c 6c 69 3e 66 69 6e 61 6c 6c /ul>..<li>finall
6510: 79 2c 20 79 6f 75 20 63 61 6e 20 70 61 73 73 20 y, you can pass
6520: 61 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 70 61 a <b>NULL</b> pa
6530: 74 68 20 61 72 67 75 6d 65 6e 74 20 69 6e 20 6f th argument in o
6540: 72 64 65 72 20 74 6f 20 69 6d 6d 65 64 69 61 74 rder to immediat
6550: 65 6c 79 20 64 69 73 61 62 6c 65 20 74 68 65 20 ely disable the
6560: 4c 6f 67 66 69 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c Logfile.</li>..<
6570: 2f 75 6c 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e /ul>..<verbatim>
6580: 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 ..SELECT SqlProc
6590: 5f 47 65 74 4c 6f 67 66 69 6c 65 28 29 3b 0d 0a _GetLogfile();..
65a0: 2d 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e -----../home/san
65b0: 64 72 6f 2f 73 71 6c 5f 6c 6f 67 2e 74 78 74 0d dro/sql_log.txt.
65c0: 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f ...SELECT SqlPro
65d0: 63 5f 47 65 74 4c 6f 67 66 69 6c 65 28 29 3b 0d c_GetLogfile();.
65e0: 0a 2d 2d 2d 2d 2d 0d 0a 4e 55 4c 4c 0d 0a 3c 2f .-----..NULL..</
65f0: 76 65 72 62 61 74 69 6d 3e 0d 0a 59 6f 75 20 63 verbatim>..You c
6600: 61 6e 20 75 73 65 20 3c 62 3e 53 71 6c 50 72 6f an use <b>SqlPro
6610: 63 5f 47 65 74 4c 6f 67 66 69 6c 65 28 29 3c 2f c_GetLogfile()</
6620: 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 b> in order to c
6630: 68 65 63 6b 20 69 66 20 74 68 65 20 63 75 72 72 heck if the curr
6640: 65 6e 74 20 44 42 2d 63 6f 6e 6e 65 63 74 69 6f ent DB-connectio
6650: 6e 20 69 73 20 75 73 69 6e 67 20 61 20 4c 6f 67 n is using a Log
6660: 66 69 6c 65 20 6f 72 20 6e 6f 74 2e 3c 62 72 3e file or not.<br>
6670: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 62 67 63 <br>..<table bgc
6680: 6f 6c 6f 72 3d 22 23 66 38 66 38 64 38 22 20 63 olor="#f8f8d8" c
6690: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 22 20 63 ellpadding="6" c
66a0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 3e 3c ellspacing="8"><
66b0: 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 4e 6f 74 65 tr><td>..<u>Note
66c0: 3c 2f 75 3e 3a 20 74 68 65 20 4c 6f 67 66 69 6c </u>: the Logfil
66d0: 65 20 73 65 74 74 69 6e 67 20 69 73 20 70 65 72 e setting is per
66e0: 6d 61 6e 65 6e 74 20 6f 6e 20 61 20 70 65 72 2d manent on a per-
66f0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 62 61 73 69 73 connection basis
6700: 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 61 6e 79 ...<ul>..<li>any
6710: 20 6e 65 77 20 44 42 2d 63 6f 6e 6e 65 63 74 69 new DB-connecti
6720: 6f 6e 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 73 on will always s
6730: 74 61 72 74 20 62 79 20 6b 65 65 70 69 6e 67 20 tart by keeping
6740: 74 68 65 20 4c 6f 67 66 69 6c 65 20 64 69 73 61 the Logfile disa
6750: 62 6c 65 64 2e 3c 62 72 3e 0d 0a 59 6f 75 20 61 bled.<br>..You a
6760: 72 65 20 61 6c 77 61 79 73 20 72 65 71 75 69 72 re always requir
6770: 65 64 20 74 6f 20 70 65 72 66 6f 72 6d 20 61 6e ed to perform an
6780: 20 65 78 70 6c 69 63 69 74 20 63 61 6c 6c 20 74 explicit call t
6790: 6f 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 53 65 74 o <b>SqlProc_Set
67a0: 4c 6f 67 66 69 6c 65 28 29 3c 2f 62 3e 20 69 6e Logfile()</b> in
67b0: 20 6f 72 64 65 72 20 74 6f 20 65 66 66 65 63 74 order to effect
67c0: 69 76 65 6c 79 20 65 6e 61 62 6c 65 20 61 20 4c ively enable a L
67d0: 6f 67 66 69 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c ogfile.</li>..<l
67e0: 69 3e 6f 6e 63 65 20 61 20 4c 6f 67 66 69 6c 65 i>once a Logfile
67f0: 20 68 61 73 20 62 65 65 6e 20 65 6e 61 62 6c 65 has been enable
6800: 64 20 69 74 20 77 69 6c 6c 20 63 6f 6e 74 69 6e d it will contin
6810: 75 65 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 ue to support th
6820: 65 20 63 75 72 72 65 6e 74 20 44 42 2d 63 6f 6e e current DB-con
6830: 6e 65 63 74 69 6f 6e 20 64 75 72 69 6e 67 20 69 nection during i
6840: 74 73 20 6c 69 66 65 73 70 61 6e 2c 20 69 66 20 ts lifespan, if
6850: 6e 6f 74 20 62 65 65 6e 20 65 78 70 6c 69 63 69 not been explici
6860: 74 6c 79 20 64 69 73 61 62 6c 65 64 2e 3c 2f 6c tly disabled.</l
6870: 69 3e 0d 0a 3c 6c 69 3e 4c 6f 67 66 69 6c 65 20 i>..<li>Logfile
6880: 73 65 74 74 69 6e 67 73 20 61 72 65 20 73 74 72 settings are str
6890: 69 63 74 6c 79 20 63 6f 6e 66 69 6e 65 64 20 77 ictly confined w
68a0: 69 74 68 69 6e 67 20 74 68 65 20 63 75 72 72 65 ithing the curre
68b0: 6e 74 20 44 42 2d 63 6f 6e 6e 65 63 74 69 6f 6e nt DB-connection
68c0: 2c 20 61 6e 64 20 77 69 6c 6c 20 6e 65 76 65 72 , and will never
68d0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 automatically b
68e0: 65 20 63 6f 6e 74 69 6e 75 65 64 20 69 6e 20 61 e continued in a
68f0: 6e 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e ny following con
6900: 6e 65 63 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a nections.</li>..
6910: 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 </ul>..</td></tr
6920: 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 2f 6c 69 3e ></table>..</li>
6930: 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 62 72 3e 3c 68 72 ..</ol>..<br><hr
6940: 3e 0d 0a 3c 68 32 3e 54 75 74 6f 72 69 61 6c 20 >..<h2>Tutorial
6950: 23 31 3c 2f 68 32 3e 0d 0a 3c 74 61 62 6c 65 20 #1</h2>..<table
6960: 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 38 64 38 bgcolor="#f8f8d8
6970: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 " cellpadding="6
6980: 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 " cellspacing="8
6990: 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6c 6c 20 "><tr><td>..All
69a0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 75 the following tu
69b0: 74 6f 72 69 61 6c 73 20 61 72 65 20 62 61 73 65 torials are base
69c0: 64 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 73 61 d on the same sa
69d0: 6d 70 6c 65 20 64 61 74 61 62 61 73 65 2c 20 77 mple database, w
69e0: 68 69 63 68 20 73 68 6f 75 6c 64 20 62 65 20 3c hich should be <
69f0: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 a href="http://w
6a00: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 ww.gaia-gis.it/g
6a10: 61 69 61 2d 73 69 6e 73 2f 73 70 5f 73 61 6d 70 aia-sins/sp_samp
6a20: 6c 65 5f 64 62 2e 37 7a 22 3e 64 6f 77 6e 6c 6f le_db.7z">downlo
6a30: 61 64 65 64 3c 2f 61 3e 20 62 65 66 6f 72 65 20 aded</a> before
6a40: 63 6f 6e 74 69 6e 75 69 6e 67 2e 0d 0a 3c 2f 74 continuing...</t
6a50: 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c d></tr></table><
6a60: 62 72 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 br>..As you can
6a70: 73 65 65 2c 20 74 68 69 73 20 64 61 74 61 62 61 see, this databa
6a80: 73 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 72 65 se contains thre
6a90: 65 20 53 70 61 74 69 61 6c 20 54 61 62 6c 65 73 e Spatial Tables
6aa0: 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 representing th
6ab0: 65 20 3c 62 3e 3c 69 3e 41 64 6d 69 6e 69 73 74 e <b><i>Administ
6ac0: 72 61 74 69 76 65 20 42 6f 75 6e 64 61 72 69 65 rative Boundarie
6ad0: 73 3c 2f 69 3e 3c 2f 62 3e 20 6f 66 20 61 6c 6c s</i></b> of all
6ae0: 20 49 74 61 6c 69 61 6e 20 4d 75 6e 69 63 69 70 Italian Municip
6af0: 61 6c 69 74 69 65 73 20 61 73 20 6f 66 66 69 63 alities as offic
6b00: 69 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 ially determined
6b10: 20 62 79 20 3c 61 20 68 72 65 66 3d 22 68 74 74 by <a href="htt
6b20: 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 ps://en.wikipedi
6b30: 61 2e 6f 72 67 2f 77 69 6b 69 2f 4e 61 74 69 6f a.org/wiki/Natio
6b40: 6e 61 6c 5f 49 6e 73 74 69 74 75 74 65 5f 6f 66 nal_Institute_of
6b50: 5f 53 74 61 74 69 73 74 69 63 73 5f 28 49 74 61 _Statistics_(Ita
6b60: 6c 79 29 22 3e 49 53 54 41 54 3c 2f 61 3e 3a 0d ly)">ISTAT</a>:.
6b70: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 72 65 .<ul>..<li>there
6b80: 20 61 72 65 20 74 68 72 65 65 20 64 69 66 66 65 are three diffe
6b90: 72 65 6e 74 20 74 61 62 6c 65 73 2c 20 65 61 63 rent tables, eac
6ba0: 68 20 6f 6e 65 20 63 6f 72 72 65 73 70 6f 6e 64 h one correspond
6bb0: 69 6e 67 20 74 6f 20 61 20 73 70 65 63 69 66 69 ing to a specifi
6bc0: 63 20 4e 61 74 69 6f 6e 61 6c 20 43 65 6e 73 75 c National Censu
6bd0: 73 20 28 79 65 61 72 73 20 31 39 39 31 2c 20 32 s (years 1991, 2
6be0: 30 30 31 20 61 6e 64 20 32 30 31 31 20 61 72 65 001 and 2011 are
6bf0: 20 61 76 61 69 6c 61 62 6c 65 29 2e 3c 2f 6c 69 available).</li
6c00: 3e 0d 0a 3c 6c 69 3e 61 6c 6c 20 74 68 72 65 65 >..<li>all three
6c10: 20 74 61 62 6c 65 73 20 68 61 76 65 20 65 78 61 tables have exa
6c20: 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 6c 61 ctly the same la
6c30: 79 6f 75 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e yout.</li>..<li>
6c40: 41 64 6d 69 6e 69 73 74 72 61 74 69 76 65 20 42 Administrative B
6c50: 6f 75 6e 64 61 72 69 65 73 20 61 72 65 20 61 6c oundaries are al
6c60: 77 61 79 73 20 72 65 70 72 65 73 65 6e 74 65 64 ways represented
6c70: 20 61 73 20 4d 75 6c 74 69 50 6f 6c 79 67 6f 6e as MultiPolygon
6c80: 73 20 28 53 72 69 64 3d 33 32 36 33 32 29 2e 0d s (Srid=32632)..
6c90: 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 61 62 .</ul><br>..<tab
6ca0: 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 le bgcolor="#f8f
6cb0: 38 64 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 8d8" cellpadding
6cc0: 3d 22 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 ="6" cellspacing
6cd0: 3d 22 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c ="8"><tr><td>..<
6ce0: 68 34 3e 54 68 65 20 50 72 6f 62 6c 65 6d 3c 2f h4>The Problem</
6cf0: 68 34 3e 0d 0a 57 65 27 6c 6c 20 69 6d 70 6c 65 h4>..We'll imple
6d00: 6d 65 6e 74 20 61 20 3c 62 3e 50 72 6f 63 65 64 ment a <b>Proced
6d10: 75 72 65 3c 2f 62 3e 20 69 6e 74 65 6e 64 65 64 ure</b> intended
6d20: 20 74 6f 20 65 78 70 6f 72 74 20 73 65 6c 65 63 to export selec
6d30: 74 65 64 20 53 68 61 70 65 66 69 6c 65 73 2e 0d ted Shapefiles..
6d40: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 43 .<ul>..<li>The C
6d50: 65 6e 73 75 73 20 59 65 61 72 20 6d 75 73 74 20 ensus Year must
6d60: 62 65 20 66 72 65 65 6c 79 20 73 65 6c 65 63 74 be freely select
6d70: 61 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e able.</li>..<li>
6d80: 41 20 72 65 71 75 69 72 65 64 20 66 65 61 74 75 A required featu
6d90: 72 65 20 69 73 20 61 6c 6c 6f 77 69 6e 67 20 65 re is allowing e
6da0: 69 74 68 65 72 20 66 69 6c 74 65 72 69 6e 67 20 ither filtering
6db0: 61 20 73 69 6e 67 6c 65 20 4d 75 6e 69 63 69 70 a single Municip
6dc0: 61 6c 69 74 79 20 6f 72 20 6c 69 73 74 69 6e 67 ality or listing
6dd0: 20 61 6c 6c 20 4d 75 6e 69 63 69 70 61 6c 69 74 all Municipalit
6de0: 69 65 73 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f ies belonging to
6df0: 20 74 68 65 20 61 20 50 72 6f 76 69 6e 63 65 20 the a Province
6e00: 6f 72 20 52 65 67 69 6f 6e 2e 3c 2f 6c 69 3e 0d or Region.</li>.
6e10: 0a 3c 6c 69 3e 52 65 70 72 6f 6a 65 63 74 69 6e .<li>Reprojectin
6e20: 67 20 74 6f 20 73 6f 6d 65 20 61 6c 74 65 72 6e g to some altern
6e30: 61 74 69 76 65 20 53 52 49 44 20 77 69 6c 6c 20 ative SRID will
6e40: 62 65 20 61 20 73 75 70 70 6f 72 74 65 64 20 66 be a supported f
6e50: 65 61 74 75 72 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c eature.</li>..<l
6e60: 69 3e 57 68 69 6c 65 20 64 6f 69 6e 67 20 61 6c i>While doing al
6e70: 6c 20 74 68 69 73 20 77 65 27 6c 6c 20 6f 62 76 l this we'll obv
6e80: 69 6f 75 73 6c 79 20 74 72 79 20 74 6f 20 74 61 iously try to ta
6e90: 6b 65 20 66 75 6c 6c 20 61 64 76 61 6e 74 61 67 ke full advantag
6ea0: 65 20 6f 66 20 75 73 69 6e 67 20 3c 62 3e 56 61 e of using <b>Va
6eb0: 72 69 61 62 6c 65 73 3c 2f 62 3e 20 74 6f 20 6d riables</b> to m
6ec0: 61 6b 65 20 74 68 65 20 50 72 6f 63 65 64 75 72 ake the Procedur
6ed0: 65 20 61 73 20 67 65 6e 65 72 69 63 20 61 6e 64 e as generic and
6ee0: 20 66 6c 65 78 69 62 6c 65 20 61 73 20 70 6f 73 flexible as pos
6ef0: 73 69 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 sible.</li>..</u
6f00: 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f l>..</td></tr></
6f10: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 76 65 72 table><br>..<ver
6f20: 62 61 74 69 6d 3e 0d 0a 2d 2d 0d 0a 2d 2d 20 72 batim>..--..-- r
6f30: 65 6d 6f 76 69 6e 67 20 74 68 65 20 77 6f 72 6b emoving the work
6f40: 20 74 61 62 6c 65 20 28 6a 75 73 74 20 69 6e 20 table (just in
6f50: 63 61 73 65 20 69 74 20 61 6c 72 65 61 64 79 20 case it already
6f60: 65 78 69 73 74 73 29 0d 0a 2d 2d 0d 0a 53 45 4c exists)..--..SEL
6f70: 45 43 54 20 44 72 6f 70 47 65 6f 54 61 62 6c 65 ECT DropGeoTable
6f80: 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c ('transient_tabl
6f90: 65 27 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 69 e');....--..-- i
6fa0: 6e 73 65 72 74 69 6e 67 20 73 65 6c 65 63 74 65 nserting selecte
6fb0: 64 20 64 61 74 61 20 69 6e 74 6f 20 74 68 65 20 d data into the
6fc0: 77 6f 72 6b 20 74 61 62 6c 65 0d 0a 2d 2d 0d 0a work table..--..
6fd0: 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 72 61 CREATE TABLE tra
6fe0: 6e 73 69 65 6e 74 5f 74 61 62 6c 65 20 41 53 0d nsient_table AS.
6ff0: 0a 53 45 4c 45 43 54 20 69 64 2c 20 69 73 74 61 .SELECT id, ista
7000: 74 2c 20 6e 61 6d 65 2c 20 70 72 6f 76 69 6e 63 t, name, provinc
7010: 65 2c 20 72 65 67 69 6f 6e 2c 20 53 54 5f 54 72 e, region, ST_Tr
7020: 61 6e 73 66 6f 72 6d 28 67 65 6f 6d 2c 20 40 73 ansform(geom, @s
7030: 72 69 64 40 29 20 41 53 20 67 65 6f 6d 0d 0a 46 rid@) AS geom..F
7040: 52 4f 4d 20 6d 75 6e 69 63 69 70 61 6c 69 74 69 ROM municipaliti
7050: 65 73 5f 40 79 65 61 72 40 0d 0a 57 48 45 52 45 es_@year@..WHERE
7060: 20 28 55 70 70 65 72 28 6e 61 6d 65 29 20 3d 20 (Upper(name) =
7070: 55 70 70 65 72 28 27 40 6d 75 6e 69 63 69 70 61 Upper('@municipa
7080: 6c 69 74 79 40 27 29 20 4f 52 20 55 70 70 65 72 lity@') OR Upper
7090: 28 70 72 6f 76 69 6e 63 65 29 20 3d 20 55 70 70 (province) = Upp
70a0: 65 72 28 27 40 70 72 6f 76 69 6e 63 65 40 27 29 er('@province@')
70b0: 20 4f 52 20 55 70 70 65 72 28 72 65 67 69 6f 6e OR Upper(region
70c0: 29 20 3d 20 55 70 70 65 72 28 27 40 72 65 67 69 ) = Upper('@regi
70d0: 6f 6e 40 27 29 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d on@'));....--..-
70e0: 2d 20 70 72 6f 70 65 72 6c 79 20 72 65 63 6f 76 - properly recov
70f0: 65 72 69 6e 67 20 74 68 65 20 77 6f 72 6b 20 74 ering the work t
7100: 61 62 6c 65 0d 0a 2d 2d 0d 0a 53 45 4c 45 43 54 able..--..SELECT
7110: 20 52 65 63 6f 76 65 72 47 65 6f 6d 65 74 72 79 RecoverGeometry
7120: 43 6f 6c 75 6d 6e 28 27 74 72 61 6e 73 69 65 6e Column('transien
7130: 74 5f 74 61 62 6c 65 27 2c 20 27 67 65 6f 6d 27 t_table', 'geom'
7140: 2c 20 40 73 72 69 64 40 2c 20 27 4d 55 4c 54 49 , @srid@, 'MULTI
7150: 50 4f 4c 59 47 4f 4e 27 2c 20 27 58 59 27 29 3b POLYGON', 'XY');
7160: 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 65 78 70 6f 72 ....--..-- expor
7170: 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 77 6f ting from the wo
7180: 72 6b 20 74 61 62 6c 65 20 69 6e 74 6f 20 74 68 rk table into th
7190: 65 20 53 68 61 70 65 66 69 6c 65 0d 0a 2d 2d 0d e Shapefile..--.
71a0: 0a 53 45 4c 45 43 54 20 45 78 70 6f 72 74 53 68 .SELECT ExportSh
71b0: 70 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 p('transient_tab
71c0: 6c 65 27 2c 20 27 67 65 6f 6d 27 2c 20 27 40 73 le', 'geom', '@s
71d0: 68 70 5f 70 61 74 68 40 27 2c 20 27 43 50 31 32 hp_path@', 'CP12
71e0: 35 32 27 29 3b 0d 0a 0d 0a 2d 2d 0d 0a 2d 2d 20 52');....--..--
71f0: 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 77 6f 72 removing the wor
7200: 6b 20 74 61 62 6c 65 0d 0a 2d 2d 0d 0a 53 45 4c k table..--..SEL
7210: 45 43 54 20 44 72 6f 70 47 65 6f 54 61 62 6c 65 ECT DropGeoTable
7220: 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c ('transient_tabl
7230: 65 27 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d e');..</verbatim
7240: 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 73 65 >..As you can se
7250: 65 20 74 68 65 20 70 72 6f 70 6f 73 65 64 20 69 e the proposed i
7260: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 mplementation is
7270: 20 62 61 73 69 63 61 6c 6c 79 20 73 69 6d 70 6c basically simpl
7280: 65 2e 20 4e 6f 77 20 79 6f 75 20 73 69 6d 70 6c e. Now you simpl
7290: 79 20 68 61 76 65 20 74 6f 20 3c 62 3e 63 75 74 y have to <b>cut
72a0: 26 70 61 73 74 65 3c 2f 62 3e 20 74 68 65 20 61 &paste</b> the a
72b0: 62 6f 76 65 20 53 51 4c 20 62 6f 64 79 20 73 61 bove SQL body sa
72c0: 76 69 6e 67 20 69 74 20 69 6e 74 6f 20 61 20 66 ving it into a f
72d0: 69 6c 65 20 6e 61 6d 65 64 20 3c 62 3e 74 65 73 ile named <b>tes
72e0: 74 5f 73 70 2e 74 78 74 3c 2f 62 3e 20 66 6f 72 t_sp.txt</b> for
72f0: 20 66 75 72 74 68 65 72 20 75 73 61 67 65 2e 3c further usage.<
7300: 62 72 3e 3c 62 72 3e 0d 0a 46 65 77 20 69 6e 74 br><br>..Few int
7310: 65 72 65 73 74 69 6e 67 20 64 65 74 61 69 6c 73 eresting details
7320: 20 77 6f 72 74 68 20 62 65 69 6e 67 20 65 78 70 worth being exp
7330: 6c 61 69 6e 65 64 3a 0d 0a 3c 75 6c 3e 0d 0a 3c lained:..<ul>..<
7340: 6c 69 3e 56 61 72 69 61 62 6c 65 20 3c 62 3e 40 li>Variable <b>@
7350: 79 65 61 72 40 3c 2f 62 3e 20 69 73 20 69 6e 74 year@</b> is int
7360: 65 6e 64 65 64 20 74 6f 20 73 65 6c 65 63 74 20 ended to select
7370: 77 68 69 63 68 20 73 70 65 63 69 66 69 63 20 53 which specific S
7380: 70 61 74 69 61 6c 20 54 61 62 6c 65 20 77 69 6c patial Table wil
7390: 6c 20 62 65 20 71 75 65 72 69 65 64 2e 3c 2f 6c l be queried.</l
73a0: 69 3e 0d 0a 3c 6c 69 3e 56 61 72 69 61 62 6c 65 i>..<li>Variable
73b0: 20 3c 62 3e 40 73 72 69 64 40 3c 2f 62 3e 20 69 <b>@srid@</b> i
73c0: 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 s intended to sp
73d0: 65 63 69 66 79 20 74 68 65 20 6f 75 74 70 75 74 ecify the output
73e0: 20 53 52 49 44 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 SRID.</li>..<li
73f0: 3e 56 61 72 69 61 62 6c 65 20 3c 62 3e 40 73 68 >Variable <b>@sh
7400: 70 5f 70 61 74 68 40 3c 2f 62 3e 20 69 73 20 69 p_path@</b> is i
7410: 6e 74 65 6e 64 65 64 20 74 6f 20 73 70 65 63 69 ntended to speci
7420: 66 79 20 74 68 65 20 70 61 74 68 6e 61 6d 65 20 fy the pathname
7430: 6f 66 20 74 68 65 20 6f 75 74 70 75 74 20 53 68 of the output Sh
7440: 61 70 65 66 69 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c apefile.</li>..<
7450: 6c 69 3e 56 61 72 69 61 62 6c 65 73 20 3c 62 3e li>Variables <b>
7460: 40 6d 75 6e 69 63 69 70 61 6c 69 74 79 40 3c 2f @municipality@</
7470: 62 3e 2c 20 3c 62 3e 40 70 72 6f 76 69 6e 63 65 b>, <b>@province
7480: 40 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 40 72 65 @</b> and <b>@re
7490: 67 69 6f 6e 40 3c 2f 62 3e 20 61 72 65 20 69 6e gion@</b> are in
74a0: 74 65 6e 64 65 64 20 74 6f 20 73 70 65 63 69 66 tended to specif
74b0: 79 20 74 68 65 20 69 6e 74 65 6e 64 65 64 20 66 y the intended f
74c0: 69 6c 74 65 72 69 6e 67 20 63 72 69 74 65 72 69 iltering criteri
74d0: 61 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 a.<br>..This is
74e0: 61 20 6c 69 74 74 6c 65 20 62 69 74 20 74 72 69 a little bit tri
74f0: 63 6b 79 2c 20 73 6f 20 77 65 27 6c 6c 20 67 6f cky, so we'll go
7500: 20 69 6e 20 66 75 72 74 68 65 72 20 64 65 70 74 in further dept
7510: 68 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 h:..<ul>..<li>Th
7520: 65 73 65 20 56 61 72 69 61 62 6c 65 73 20 61 72 ese Variables ar
7530: 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 e expected to be
7540: 20 61 63 74 75 61 6c 6c 79 20 72 65 70 6c 61 63 actually replac
7550: 65 64 20 62 79 20 3c 62 3e 74 65 78 74 20 73 74 ed by <b>text st
7560: 72 69 6e 67 20 76 61 6c 75 65 73 3c 2f 62 3e 3b ring values</b>;
7570: 20 73 6f 20 77 65 27 76 65 20 63 6f 6e 73 69 73 so we've consis
7580: 74 65 6e 74 6c 79 20 3c 62 3e 73 69 6e 67 6c 65 tently <b>single
7590: 2d 71 75 6f 74 65 64 3c 2f 62 3e 20 74 68 65 20 -quoted</b> the
75a0: 76 61 72 69 61 62 6c 65 20 73 79 6d 62 6f 6c 2c variable symbol,
75b0: 20 73 6f 20 74 6f 20 61 6c 6c 6f 77 20 66 6f 72 so to allow for
75c0: 20 61 6e 20 65 61 73 69 65 72 20 76 61 6c 75 65 an easier value
75d0: 20 72 65 70 6c 61 63 65 6d 65 6e 74 2e 3c 2f 6c replacement.</l
75e0: 69 3e 0d 0a 3c 6c 69 3e 57 65 20 61 72 65 20 73 i>..<li>We are s
75f0: 79 73 74 65 6d 61 74 69 63 61 6c 6c 79 20 75 73 ystematically us
7600: 69 6e 67 20 74 68 65 20 3c 62 3e 55 70 70 65 72 ing the <b>Upper
7610: 28 29 3c 2f 62 3e 20 66 75 6e 63 74 69 6f 6e 20 ()</b> function
7620: 73 69 6d 70 6c 79 20 62 65 63 61 75 73 65 20 50 simply because P
7630: 72 6f 76 69 6e 63 65 20 61 6e 64 20 52 65 67 69 rovince and Regi
7640: 6f 6e 20 6e 61 6d 65 73 20 61 72 65 20 61 6c 6c on names are all
7650: 2d 75 70 70 65 72 63 61 73 65 20 69 6e 20 79 65 -uppercase in ye
7660: 61 72 73 20 31 39 39 31 20 61 6e 64 20 32 30 30 ars 1991 and 200
7670: 31 20 62 75 74 20 6e 6f 74 20 66 6f 72 20 74 68 1 but not for th
7680: 65 20 79 65 61 72 20 32 30 31 31 2e 3c 62 72 3e e year 2011.<br>
7690: 0d 0a 53 79 73 74 65 6d 61 74 69 63 61 6c 6c 79 ..Systematically
76a0: 20 75 73 69 6e 67 20 55 70 70 65 72 28 29 20 77 using Upper() w
76b0: 69 6c 6c 20 69 6e 73 75 72 65 20 63 6f 6e 73 69 ill insure consi
76c0: 73 74 65 6e 74 65 6e 63 79 20 6f 66 20 61 6c 6c stentency of all
76d0: 20 6e 61 6d 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c names.</li>..<l
76e0: 69 3e 57 65 20 61 72 65 20 75 73 69 6e 67 20 74 i>We are using t
76f0: 68 72 65 65 20 73 65 70 61 72 61 74 65 20 63 6f hree separate co
7700: 6d 70 61 72 69 73 6f 6e 73 20 28 6f 6e 65 20 66 mparisons (one f
7710: 6f 72 20 4d 75 6e 69 63 69 70 61 6c 69 74 79 2c or Municipality,
7720: 20 6f 6e 65 20 66 6f 72 20 50 72 6f 76 69 6e 63 one for Provinc
7730: 65 20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 52 65 e and one for Re
7740: 67 69 6f 6e 29 20 63 6f 6e 6e 65 63 74 65 64 20 gion) connected
7750: 62 79 20 3c 62 3e 4f 52 3c 2f 62 3e 20 6c 6f 67 by <b>OR</b> log
7760: 69 63 61 6c 20 6f 70 65 72 61 74 6f 72 73 20 73 ical operators s
7770: 6f 20 74 6f 20 6d 61 6b 65 20 69 74 20 70 6f 73 o to make it pos
7780: 73 69 62 6c 65 20 62 79 20 73 70 65 63 69 66 79 sible by specify
7790: 69 6e 67 20 6a 75 73 74 20 61 20 73 69 6e 67 6c ing just a singl
77a0: 65 20 6f 72 20 6d 6f 72 65 20 66 69 6c 74 65 72 e or more filter
77b0: 20 63 6c 61 75 73 65 73 2e 3c 62 72 3e 0d 0a 3c clauses.<br>..<
77c0: 75 3e 52 65 63 61 6c 6c 3c 2f 75 3e 3a 20 75 6e u>Recall</u>: un
77d0: 61 73 73 69 67 6e 65 64 20 56 61 72 69 61 62 6c assigned Variabl
77e0: 65 73 20 77 69 6c 6c 20 64 65 66 61 75 6c 74 20 es will default
77f0: 74 6f 20 4e 55 4c 4c 3b 20 73 6f 20 62 79 20 6a to NULL; so by j
7800: 75 73 74 20 64 65 63 6c 61 72 69 6e 67 20 0d 0a ust declaring ..
7810: 3c 62 3e 40 70 72 6f 76 69 6e 63 65 40 3d 41 72 <b>@province@=Ar
7820: 65 7a 7a 6f 3c 2f 62 3e 20 77 65 27 6c 6c 20 74 ezzo</b> we'll t
7830: 68 65 6e 20 67 65 74 20 61 20 3c 62 3e 3c 69 3e hen get a <b><i>
7840: 63 6f 6f 6b 65 64 3c 2f 69 3e 3c 2f 62 3e 20 57 cooked</i></b> W
7850: 48 45 52 45 20 63 6c 61 75 73 65 20 6c 69 6b 65 HERE clause like
7860: 20 74 68 69 73 3a 0d 0a 3c 76 65 72 62 61 74 69 this:..<verbati
7870: 6d 3e 0d 0a 57 48 45 52 45 20 28 55 70 70 65 72 m>..WHERE (Upper
7880: 28 6e 61 6d 65 29 20 3d 20 55 70 70 65 72 28 27 (name) = Upper('
7890: 4e 55 4c 4c 27 29 20 4f 52 20 55 70 70 65 72 28 NULL') OR Upper(
78a0: 70 72 6f 76 69 6e 63 65 29 20 3d 20 55 70 70 65 province) = Uppe
78b0: 72 28 27 41 72 65 7a 7a 6f 27 29 20 4f 52 20 55 r('Arezzo') OR U
78c0: 70 70 65 72 28 72 65 67 69 6f 6e 29 20 3d 20 55 pper(region) = U
78d0: 70 70 65 72 28 27 4e 55 4c 4c 27 29 29 0d 0a 3c pper('NULL'))..<
78e0: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 2f 6c 69 /verbatim>..</li
78f0: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 6c 69 3e 0d >..</ul>..</li>.
7900: 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 3c 76 .</ul>..<br>..<v
7910: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 erbatim>..SELECT
7920: 20 53 71 6c 50 72 6f 63 5f 45 78 65 63 75 74 65 SqlProc_Execute
7930: 28 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 46 69 ( SqlProc_FromFi
7940: 6c 65 20 28 27 43 3a 2f 75 73 65 72 73 2f 6a 6f le ('C:/users/jo
7950: 65 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 e/stored_proc_te
7960: 73 74 2f 74 65 73 74 5f 73 70 2e 74 78 74 27 29 st/test_sp.txt')
7970: 2c 0d 0a 20 20 27 40 73 72 69 64 40 3d 33 30 30 ,.. '@srid@=300
7980: 34 27 2c 20 27 40 79 65 61 72 40 3d 32 30 30 31 4', '@year@=2001
7990: 27 2c 20 27 40 72 65 67 69 6f 6e 40 3d 4c 61 7a ', '@region@=Laz
79a0: 69 6f 27 2c 20 27 40 73 68 70 5f 70 61 74 68 40 io', '@shp_path@
79b0: 3d 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 74 =C:/users/joe/st
79c0: 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f 6c ored_proc_test/l
79d0: 61 7a 69 6f 5f 32 30 30 31 5f 33 30 30 34 27 29 azio_2001_3004')
79e0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 ;..-----..1....S
79f0: 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 45 78 ELECT SqlProc_Ex
7a00: 65 63 75 74 65 28 20 53 71 6c 50 72 6f 63 5f 46 ecute( SqlProc_F
7a10: 72 6f 6d 46 69 6c 65 20 28 27 43 3a 2f 75 73 65 romFile ('C:/use
7a20: 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 rs/joe/stored_pr
7a30: 6f 63 5f 74 65 73 74 2f 74 65 73 74 5f 73 70 2e oc_test/test_sp.
7a40: 74 78 74 27 29 2c 0d 0a 20 20 27 40 73 72 69 64 txt'),.. '@srid
7a50: 40 3d 34 33 32 36 27 2c 20 27 40 79 65 61 72 40 @=4326', '@year@
7a60: 3d 31 39 39 31 27 2c 20 27 40 72 65 67 69 6f 6e =1991', '@region
7a70: 40 3d 70 75 67 6c 69 61 27 2c 20 27 40 73 68 70 @=puglia', '@shp
7a80: 5f 70 61 74 68 40 3d 43 3a 2f 75 73 65 72 73 2f _path@=C:/users/
7a90: 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f joe/stored_proc_
7aa0: 74 65 73 74 2f 70 75 67 6c 69 61 5f 31 39 39 31 test/puglia_1991
7ab0: 5f 34 33 32 36 27 29 3b 0d 0a 2d 2d 2d 2d 2d 0d _4326');..-----.
7ac0: 0a 31 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 71 6c .1....SELECT Sql
7ad0: 50 72 6f 63 5f 45 78 65 63 75 74 65 28 20 53 71 Proc_Execute( Sq
7ae0: 6c 50 72 6f 63 5f 46 72 6f 6d 46 69 6c 65 20 28 lProc_FromFile (
7af0: 27 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 74 'C:/users/joe/st
7b00: 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f 74 ored_proc_test/t
7b10: 65 73 74 5f 73 70 2e 74 78 74 27 29 2c 0d 0a 20 est_sp.txt'),..
7b20: 20 27 40 73 72 69 64 40 3d 33 30 30 33 27 2c 20 '@srid@=3003',
7b30: 27 40 79 65 61 72 40 3d 32 30 31 31 27 2c 20 27 '@year@=2011', '
7b40: 40 70 72 6f 76 69 6e 63 65 40 3d 41 52 45 5a 5a @province@=AREZZ
7b50: 4f 27 2c 20 27 40 73 68 70 5f 70 61 74 68 40 3d O', '@shp_path@=
7b60: 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 74 6f C:/users/joe/sto
7b70: 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f 61 72 red_proc_test/ar
7b80: 65 7a 7a 6f 5f 32 30 31 31 5f 33 30 30 33 27 29 ezzo_2011_3003')
7b90: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 ;..-----..1....S
7ba0: 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 45 78 ELECT SqlProc_Ex
7bb0: 65 63 75 74 65 28 20 53 71 6c 50 72 6f 63 5f 46 ecute( SqlProc_F
7bc0: 72 6f 6d 46 69 6c 65 20 28 27 43 3a 2f 75 73 65 romFile ('C:/use
7bd0: 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 rs/joe/stored_pr
7be0: 6f 63 5f 74 65 73 74 2f 74 65 73 74 5f 73 70 2e oc_test/test_sp.
7bf0: 74 78 74 27 29 2c 0d 0a 20 20 27 40 73 72 69 64 txt'),.. '@srid
7c00: 40 3d 33 30 30 33 27 2c 20 27 40 79 65 61 72 40 @=3003', '@year@
7c10: 3d 32 30 30 31 27 2c 20 27 40 6d 75 6e 69 63 69 =2001', '@munici
7c20: 70 61 6c 69 74 79 40 3d 41 52 45 5a 5a 4f 27 2c pality@=AREZZO',
7c30: 20 27 40 73 68 70 5f 70 61 74 68 40 3d 43 3a 2f '@shp_path@=C:/
7c40: 75 73 65 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 users/joe/stored
7c50: 5f 70 72 6f 63 5f 74 65 73 74 2f 63 6f 6d 5f 61 _proc_test/com_a
7c60: 72 65 7a 7a 6f 5f 32 30 30 31 5f 33 30 30 33 27 rezzo_2001_3003'
7c70: 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f );..-----..1..</
7c80: 76 65 72 62 61 74 69 6d 3e 0d 0a 49 6e 20 74 68 verbatim>..In th
7c90: 69 73 20 66 69 72 73 74 20 74 75 74 6f 72 69 61 is first tutoria
7ca0: 6c 20 77 65 20 68 61 76 65 20 61 6c 77 61 79 73 l we have always
7cb0: 20 3c 62 3e 65 78 65 63 75 74 65 64 3c 2f 62 3e <b>executed</b>
7cc0: 20 61 20 50 72 6f 63 65 64 75 72 65 20 6c 6f 61 a Procedure loa
7cd0: 64 65 64 20 66 72 6f 6d 20 61 6e 20 65 78 74 65 ded from an exte
7ce0: 72 6e 61 6c 20 66 69 6c 65 2e 3c 62 72 3e 0d 0a rnal file.<br>..
7cf0: 41 73 20 79 6f 75 20 63 61 6e 20 73 65 65 20 65 As you can see e
7d00: 78 65 63 75 74 69 6e 67 20 61 20 50 72 6f 63 65 xecuting a Proce
7d10: 64 75 72 65 20 69 73 20 61 20 73 74 72 61 69 67 dure is a straig
7d20: 68 74 66 6f 72 77 61 72 64 20 74 61 73 6b 3b 20 htforward task;
7d30: 79 6f 75 20 73 69 6d 70 6c 79 20 68 61 76 65 20 you simply have
7d40: 74 6f 20 73 70 65 63 69 66 79 20 61 6e 20 61 70 to specify an ap
7d50: 70 72 6f 70 72 69 61 74 65 20 6c 69 73 74 20 6f propriate list o
7d60: 66 20 3c 62 3e 56 61 72 69 61 62 6c 65 20 56 61 f <b>Variable Va
7d70: 6c 75 65 73 3c 2f 62 3e 20 61 6e 64 20 74 68 61 lues</b> and tha
7d80: 74 27 73 20 61 6c 6c 2e 0d 0a 3c 68 72 3e 0d 0a t's all...<hr>..
7d90: 3c 68 32 3e 54 75 74 6f 72 69 61 6c 20 23 32 3c <h2>Tutorial #2<
7da0: 2f 68 32 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e /h2>..<verbatim>
7db0: 0d 0a 53 45 4c 45 43 54 20 53 74 6f 72 65 64 50 ..SELECT StoredP
7dc0: 72 6f 63 5f 52 65 67 69 73 74 65 72 28 20 27 6d roc_Register( 'm
7dd0: 79 5f 70 72 6f 63 27 2c 20 27 61 20 53 74 6f 72 y_proc', 'a Stor
7de0: 65 64 20 50 72 6f 63 65 64 75 72 65 20 66 6f 72 ed Procedure for
7df0: 20 65 78 70 6f 72 74 69 6e 67 20 73 65 6c 65 63 exporting selec
7e00: 74 65 64 20 53 68 61 70 65 66 69 6c 65 73 27 2c ted Shapefiles',
7e10: 20 53 71 6c 50 72 6f 63 5f 46 72 6f 6d 46 69 6c SqlProc_FromFil
7e20: 65 20 28 27 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 e ('C:/users/joe
7e30: 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 /stored_proc_tes
7e40: 74 2f 74 65 73 74 5f 73 70 2e 74 78 74 27 29 20 t/test_sp.txt')
7e50: 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d );..</verbatim>.
7e60: 0a 54 68 69 73 20 73 65 63 6f 6e 64 20 74 75 74 .This second tut
7e70: 6f 72 69 61 6c 20 69 73 20 20 62 61 73 69 63 61 orial is basica
7e80: 6c 6c 79 20 74 68 65 20 73 61 6d 65 20 6f 66 20 lly the same of
7e90: 74 68 65 20 66 69 72 73 74 20 6f 6e 65 2e 3c 62 the first one.<b
7ea0: 72 3e 0d 0a 54 68 65 20 6f 6e 6c 79 20 64 69 66 r>..The only dif
7eb0: 66 65 72 65 6e 63 65 20 69 73 20 74 68 61 74 20 ference is that
7ec0: 77 65 27 6c 6c 20 6e 6f 77 20 75 73 65 20 61 20 we'll now use a
7ed0: 70 65 72 6d 61 6e 65 6e 74 6c 79 20 72 65 67 69 permanently regi
7ee0: 73 74 65 72 65 64 20 3c 62 3e 53 74 6f 72 65 64 stered <b>Stored
7ef0: 20 50 72 6f 63 65 64 75 72 65 3c 2f 62 3e 2e 0d Procedure</b>..
7f00: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c .<verbatim>..SEL
7f10: 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 45 ECT StoredProc_E
7f20: 78 65 63 75 74 65 28 20 27 6d 79 5f 70 72 6f 63 xecute( 'my_proc
7f30: 27 2c 20 27 40 73 72 69 64 40 3d 33 30 30 34 27 ', '@srid@=3004'
7f40: 2c 20 27 40 79 65 61 72 40 3d 32 30 30 31 27 2c , '@year@=2001',
7f50: 20 27 40 72 65 67 69 6f 6e 40 3d 4c 61 7a 69 6f '@region@=Lazio
7f60: 27 2c 20 27 40 73 68 70 5f 70 61 74 68 40 3d 43 ', '@shp_path@=C
7f70: 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 74 6f 72 :/users/joe/stor
7f80: 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f 6c 61 7a ed_proc_test/laz
7f90: 69 6f 5f 32 30 30 31 5f 33 30 30 34 27 29 3b 0d io_2001_3004');.
7fa0: 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 45 4c .-----..1....SEL
7fb0: 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 45 ECT StoredProc_E
7fc0: 78 65 63 75 74 65 28 20 27 6d 79 5f 70 72 6f 63 xecute( 'my_proc
7fd0: 27 2c 20 27 40 73 72 69 64 40 3d 34 33 32 36 27 ', '@srid@=4326'
7fe0: 2c 20 27 40 79 65 61 72 40 3d 31 39 39 31 27 2c , '@year@=1991',
7ff0: 20 27 40 72 65 67 69 6f 6e 40 3d 70 75 67 6c 69 '@region@=pugli
8000: 61 27 2c 20 27 40 73 68 70 5f 70 61 74 68 40 3d a', '@shp_path@=
8010: 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 74 6f C:/users/joe/sto
8020: 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f 70 75 red_proc_test/pu
8030: 67 6c 69 61 5f 31 39 39 31 5f 34 33 32 36 27 29 glia_1991_4326')
8040: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 ;..-----..1....S
8050: 45 4c 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 ELECT StoredProc
8060: 5f 45 78 65 63 75 74 65 28 20 27 6d 79 5f 70 72 _Execute( 'my_pr
8070: 6f 63 27 2c 20 27 40 73 72 69 64 40 3d 33 30 30 oc', '@srid@=300
8080: 33 27 2c 20 27 40 79 65 61 72 40 3d 32 30 31 31 3', '@year@=2011
8090: 27 2c 20 27 40 70 72 6f 76 69 6e 63 65 40 3d 41 ', '@province@=A
80a0: 52 45 5a 5a 4f 27 2c 20 27 40 73 68 70 5f 70 61 REZZO', '@shp_pa
80b0: 74 68 40 3d 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 th@=C:/users/joe
80c0: 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 /stored_proc_tes
80d0: 74 2f 61 72 65 7a 7a 6f 5f 32 30 31 31 5f 33 30 t/arezzo_2011_30
80e0: 30 33 27 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 03');..-----..1.
80f0: 0a 0d 0a 53 45 4c 45 43 54 20 53 74 6f 72 65 64 ...SELECT Stored
8100: 50 72 6f 63 5f 45 78 65 63 75 74 65 28 20 27 6d Proc_Execute( 'm
8110: 79 5f 70 72 6f 63 27 2c 20 27 40 73 72 69 64 40 y_proc', '@srid@
8120: 3d 33 30 30 33 27 2c 20 27 40 79 65 61 72 40 3d =3003', '@year@=
8130: 32 30 30 31 27 2c 20 27 40 6d 75 6e 69 63 69 70 2001', '@municip
8140: 61 6c 69 74 79 40 3d 41 52 45 5a 5a 4f 27 2c 20 ality@=AREZZO',
8150: 27 40 73 68 70 5f 70 61 74 68 40 3d 43 3a 2f 75 '@shp_path@=C:/u
8160: 73 65 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 5f sers/joe/stored_
8170: 70 72 6f 63 5f 74 65 73 74 2f 63 6f 6d 5f 61 72 proc_test/com_ar
8180: 65 7a 7a 6f 5f 32 30 30 31 5f 33 30 30 33 27 29 ezzo_2001_3003')
8190: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 ;..-----..1..</v
81a0: 65 72 62 61 74 69 6d 3e 0d 0a 45 78 65 63 75 74 erbatim>..Execut
81b0: 69 6e 67 20 61 20 53 74 6f 72 65 64 20 50 72 6f ing a Stored Pro
81c0: 63 65 64 75 72 65 20 69 73 6e 27 74 20 76 65 72 cedure isn't ver
81d0: 79 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d y different from
81e0: 20 65 78 65 63 75 74 69 6e 67 20 61 20 50 72 6f executing a Pro
81f0: 63 65 64 75 72 65 20 73 74 6f 72 65 64 20 69 6e cedure stored in
8200: 74 6f 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 66 to an external f
8210: 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 ile.<br>..<table
8220: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 38 64 bgcolor="#f8f8d
8230: 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 8" cellpadding="
8240: 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 6" cellspacing="
8250: 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 45 78 65 8"><tr><td>..Exe
8260: 63 75 74 69 6e 67 20 79 6f 75 72 20 50 72 6f 63 cuting your Proc
8270: 65 64 75 72 65 73 20 66 72 6f 6d 20 65 78 74 65 edures from exte
8280: 72 6e 61 6c 20 66 69 6c 65 73 20 6f 72 20 70 65 rnal files or pe
8290: 72 6d 61 6e 65 6e 74 6c 79 20 72 65 67 69 73 74 rmanently regist
82a0: 65 72 69 6e 67 20 53 74 6f 72 65 64 20 50 72 6f ering Stored Pro
82b0: 63 65 64 75 72 65 73 20 64 69 72 65 63 74 6c 79 cedures directly
82c0: 20 77 69 74 68 69 6e 20 61 20 64 61 74 61 62 61 within a databa
82d0: 73 65 20 69 73 20 61 20 6d 61 74 74 65 72 20 6f se is a matter o
82e0: 66 20 66 72 65 65 20 63 68 6f 69 63 65 2e 3c 62 f free choice.<b
82f0: 72 3e 0d 0a 49 66 20 79 6f 75 20 61 72 65 20 70 r>..If you are p
8300: 6c 61 6e 6e 69 6e 67 20 74 6f 20 64 65 70 6c 6f lanning to deplo
8310: 79 20 61 20 50 72 6f 63 65 64 75 72 65 20 69 6e y a Procedure in
8320: 74 65 6e 64 65 64 20 74 6f 20 73 75 70 70 6f 72 tended to suppor
8330: 74 20 6d 61 6e 79 20 64 69 66 66 65 72 65 6e 74 t many different
8340: 20 64 61 74 61 62 61 73 65 73 2c 20 74 68 65 6e databases, then
8350: 20 75 73 69 6e 67 20 61 6e 20 65 78 74 65 72 6e using an extern
8360: 61 6c 20 66 69 6c 65 20 63 6f 75 6c 64 20 70 72 al file could pr
8370: 6f 62 61 62 6c 79 20 73 69 6d 70 6c 69 66 79 20 obably simplify
8380: 79 6f 75 72 20 77 6f 72 6b 2e 3c 62 72 3e 0d 0a your work.<br>..
8390: 42 75 74 20 69 66 20 79 6f 75 20 61 72 65 20 70 But if you are p
83a0: 6c 61 6e 6e 69 6e 67 20 74 6f 20 64 65 70 6c 6f lanning to deplo
83b0: 79 20 61 20 50 72 6f 63 65 64 75 72 65 20 69 6e y a Procedure in
83c0: 74 65 6e 64 65 64 20 74 6f 20 61 75 74 6f 6d 61 tended to automa
83d0: 74 65 20 6d 61 6e 79 20 72 6f 75 74 69 6e 65 6c te many routinel
83e0: 79 20 74 61 73 6b 20 74 6f 20 62 65 20 65 78 65 y task to be exe
83f0: 63 75 74 65 64 20 6f 66 74 65 6e 20 6f 6e 20 74 cuted often on t
8400: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 he same database
8410: 2c 20 74 68 65 6e 20 70 65 72 6d 61 6e 65 6e 74 , then permanent
8420: 6c 79 20 72 65 67 69 73 74 65 72 69 6e 67 20 61 ly registering a
8430: 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 Stored Procedur
8440: 65 20 77 6f 75 6c 64 20 70 72 6f 62 61 62 6c 79 e would probably
8450: 20 62 65 20 62 65 74 74 65 72 20 61 6e 64 20 66 be better and f
8460: 61 73 74 65 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 aster...</td></t
8470: 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e r></table>..<br>
8480: 3c 68 72 3e 0d 0a 3c 68 32 3e 54 75 74 6f 72 69 <hr>..<h2>Tutori
8490: 61 6c 20 23 33 3c 2f 68 32 3e 0d 0a 54 68 69 73 al #3</h2>..This
84a0: 20 74 68 69 72 64 20 74 75 74 6f 72 69 61 6c 20 third tutorial
84b0: 69 73 20 6a 75 73 74 20 61 20 73 6d 61 6c 6c 20 is just a small
84c0: 76 61 72 69 61 74 69 6f 6e 20 6f 6e 20 74 68 65 variation on the
84d0: 20 74 68 65 6d 65 20 69 6e 74 65 6e 64 65 64 20 theme intended
84e0: 74 6f 20 68 69 67 68 6c 69 67 68 74 20 73 6f 6d to highlight som
84f0: 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 64 61 e potentially da
8500: 6e 67 65 72 6f 75 73 20 70 69 74 66 61 6c 6c 73 ngerous pitfalls
8510: 20 72 65 6c 61 74 65 64 20 74 6f 20 3c 62 3e 73 related to <b>s
8520: 69 6e 67 6c 65 2d 71 75 6f 74 69 6e 67 3c 2f 62 ingle-quoting</b
8530: 3e 2e 20 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d >. ..<verbatim>.
8540: 0a 53 45 4c 45 43 54 20 53 74 6f 72 65 64 50 72 .SELECT StoredPr
8550: 6f 63 5f 45 78 65 63 75 74 65 28 20 27 6d 79 5f oc_Execute( 'my_
8560: 70 72 6f 63 27 29 2c 20 27 40 73 72 69 64 40 3d proc'), '@srid@=
8570: 33 30 30 33 27 2c 20 27 40 79 65 61 72 40 3d 32 3003', '@year@=2
8580: 30 31 31 27 2c 20 27 40 6d 75 6e 69 63 69 70 61 011', '@municipa
8590: 6c 69 74 79 40 3d 72 69 6f 20 6e 65 6c 6c 27 27 lity@=rio nell''
85a0: 65 6c 62 61 27 2c 20 27 40 73 68 70 5f 70 61 74 elba', '@shp_pat
85b0: 68 40 3d 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f h@=C:/users/joe/
85c0: 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 stored_proc_test
85d0: 2f 72 69 6f 5f 65 6c 62 61 5f 32 30 31 31 5f 33 /rio_elba_2011_3
85e0: 30 30 33 27 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 53 003');..-----..S
85f0: 74 6f 72 65 64 50 72 6f 63 20 65 78 63 65 70 74 toredProc except
8600: 69 6f 6e 20 2d 20 61 20 66 61 74 61 6c 20 53 51 ion - a fatal SQ
8610: 4c 20 65 72 72 6f 72 20 77 61 73 20 65 6e 63 6f L error was enco
8620: 75 6e 74 65 72 65 64 2e 0d 0a 0d 0a 53 45 4c 45 untered.....SELE
8630: 43 54 20 53 71 6c 50 72 6f 63 5f 47 65 74 4c 61 CT SqlProc_GetLa
8640: 73 74 45 72 72 6f 72 28 29 3b 0d 0a 2d 2d 2d 2d stError();..----
8650: 2d 0d 0a 67 61 69 61 5f 73 71 6c 5f 70 72 6f 63 -..gaia_sql_proc
8660: 5f 65 78 65 63 75 74 65 3a 20 6e 65 61 72 20 22 _execute: near "
8670: 65 6c 62 61 22 3a 20 73 79 6e 74 61 78 20 65 72 elba": syntax er
8680: 72 6f 72 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e ror..</verbatim>
8690: 0d 0a 54 68 69 73 20 66 69 72 73 74 20 61 74 74 ..This first att
86a0: 65 6d 70 74 20 77 69 6c 6c 20 66 61 69 6c 2c 20 empt will fail,
86b0: 61 6e 64 20 75 73 69 6e 67 20 3c 62 3e 53 71 6c and using <b>Sql
86c0: 50 72 6f 63 5f 47 65 74 4c 61 73 74 45 72 72 6f Proc_GetLastErro
86d0: 72 3c 2f 62 3e 20 77 69 6c 6c 20 65 78 70 6c 61 r</b> will expla
86e0: 69 6e 20 77 68 79 20 69 74 20 66 61 69 6c 65 64 in why it failed
86f0: 3c 62 72 3e 0d 0a 57 65 27 76 65 20 70 61 73 73 <br>..We've pass
8700: 65 64 20 61 20 3c 62 3e 27 40 6d 75 6e 69 63 69 ed a <b>'@munici
8710: 70 61 6c 69 74 79 40 3d 72 69 6f 20 6e 65 6c 6c pality@=rio nell
8720: 27 27 65 6c 62 61 27 3c 2f 62 3e 20 56 61 72 69 ''elba'</b> Vari
8730: 61 62 6c 65 20 77 69 74 68 20 56 61 6c 75 65 2c able with Value,
8740: 20 74 68 61 74 20 77 69 6c 6c 20 6c 65 61 64 20 that will lead
8750: 74 6f 20 61 20 3c 62 3e 63 6f 6f 6b 65 64 3c 2f to a <b>cooked</
8760: 62 3e 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 b> WHERE clause
8770: 6c 69 6b 65 20 74 68 69 73 3a 0d 0a 3c 76 65 72 like this:..<ver
8780: 62 61 74 69 6d 3e 0d 0a 57 48 45 52 45 20 28 55 batim>..WHERE (U
8790: 70 70 65 72 28 6e 61 6d 65 29 20 3d 20 55 70 70 pper(name) = Upp
87a0: 65 72 28 27 72 69 6f 20 6e 65 6c 6c 27 65 6c 62 er('rio nell'elb
87b0: 61 27 29 20 4f 52 20 55 70 70 65 72 28 70 72 6f a') OR Upper(pro
87c0: 76 69 6e 63 65 29 20 3d 20 55 70 70 65 72 28 27 vince) = Upper('
87d0: 4e 55 4c 4c 27 29 20 4f 52 20 55 70 70 65 72 28 NULL') OR Upper(
87e0: 72 65 67 69 6f 6e 29 20 3d 20 55 70 70 65 72 28 region) = Upper(
87f0: 27 4e 55 4c 4c 27 29 29 0d 0a 3c 2f 76 65 72 62 'NULL'))..</verb
8800: 61 74 69 6d 3e 0d 0a 54 68 65 2c 20 6e 6f 74 20 atim>..The, not
8810: 61 6c 77 61 79 73 20 6f 62 76 69 6f 75 73 20 63 always obvious c
8820: 61 75 73 65 2c 20 69 73 20 74 68 61 74 20 3c 62 ause, is that <b
8830: 3e 27 72 69 6f 20 6e 65 6c 6c 27 65 6c 62 61 27 >'rio nell'elba'
8840: 3c 2f 62 3e 20 69 73 20 61 6e 20 69 6c 6c 65 67 </b> is an illeg
8850: 61 6c 20 53 51 4c 20 74 65 78 74 20 73 74 72 69 al SQL text stri
8860: 6e 67 3b 20 74 68 65 20 63 6f 72 72 65 63 74 20 ng; the correct
8870: 73 79 6e 74 61 78 20 73 68 6f 75 6c 64 20 62 65 syntax should be
8880: 20 69 6e 73 74 65 61 64 20 3c 62 3e 27 72 69 6f instead <b>'rio
8890: 20 6e 65 6c 6c 27 27 65 6c 62 61 27 3c 2f 62 3e nell''elba'</b>
88a0: 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 76 65 ...<br><br>..<ve
88b0: 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 rbatim>..SELECT
88c0: 53 74 6f 72 65 64 50 72 6f 63 5f 45 78 65 63 75 StoredProc_Execu
88d0: 74 65 28 20 27 6d 79 5f 70 72 6f 63 27 29 2c 20 te( 'my_proc'),
88e0: 27 40 73 72 69 64 40 3d 33 30 30 33 27 2c 20 27 '@srid@=3003', '
88f0: 40 79 65 61 72 40 3d 32 30 31 31 27 2c 20 27 40 @year@=2011', '@
8900: 6d 75 6e 69 63 69 70 61 6c 69 74 79 40 3d 72 69 municipality@=ri
8910: 6f 20 6e 65 6c 6c 27 27 27 27 65 6c 62 61 27 2c o nell''''elba',
8920: 20 27 40 73 68 70 5f 70 61 74 68 40 3d 43 3a 2f '@shp_path@=C:/
8930: 75 73 65 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 users/joe/stored
8940: 5f 70 72 6f 63 5f 74 65 73 74 2f 72 69 6f 5f 65 _proc_test/rio_e
8950: 6c 62 61 5f 32 30 31 31 5f 33 30 30 33 27 29 3b lba_2011_3003');
8960: 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 65 ..-----..1..</ve
8970: 72 62 61 74 69 6d 3e 0d 0a 52 65 73 6f 6c 76 69 rbatim>..Resolvi
8980: 6e 67 20 73 75 63 68 20 61 6e 20 69 73 73 75 65 ng such an issue
8990: 20 69 73 20 72 61 74 68 65 72 20 74 72 69 76 69 is rather trivi
89a0: 61 6c 3b 20 77 65 20 6a 75 73 74 20 68 61 76 65 al; we just have
89b0: 20 74 6f 20 75 73 65 20 3c 62 3e 66 6f 75 72 3c to use <b>four<
89c0: 2f 62 3e 20 63 6f 6e 73 65 63 75 74 69 76 65 20 /b> consecutive
89d0: 73 69 6e 67 6c 65 2d 71 75 6f 74 65 73 20 73 6f single-quotes so
89e0: 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 20 65 73 to correctly es
89f0: 63 61 70 65 20 74 68 65 20 73 74 72 69 6e 67 20 cape the string
8a00: 76 61 6c 75 65 20 6f 72 3c 62 72 3e 20 75 73 65 value or<br> use
8a10: 20 64 6f 75 62 6c 65 20 71 75 6f 74 65 73 20 66 double quotes f
8a20: 6f 72 20 66 69 65 6c 64 73 20 77 68 65 72 65 20 or fields where
8a30: 73 69 6e 67 6c 65 20 71 75 6f 74 65 73 20 6f 66 single quotes of
8a40: 74 65 6e 20 6f 63 63 75 72 20 69 6e 20 6e 61 6d ten occur in nam
8a50: 65 73 20 28 3c 62 3e 22 40 6d 75 6e 69 63 69 70 es (<b>"@municip
8a60: 61 6c 69 74 79 40 3d 72 69 6f 20 6e 65 6c 6c 27 ality@=rio nell'
8a70: 65 6c 62 61 22 3c 2f 62 3e 29 2e 0d 0a 3c 62 72 elba"</b>)...<br
8a80: 3e 3c 68 72 3e 0d 0a 3c 68 32 3e 54 75 74 6f 72 ><hr>..<h2>Tutor
8a90: 69 61 6c 20 23 34 3c 2f 68 32 3e 0d 0a 54 68 69 ial #4</h2>..Thi
8aa0: 73 20 6c 61 73 74 20 74 75 74 6f 72 69 61 6c 20 s last tutorial
8ab0: 69 73 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 is exactly the s
8ac0: 61 6d 65 20 6f 66 20 3c 62 3e 54 75 74 6f 72 69 ame of <b>Tutori
8ad0: 61 6c 20 23 32 3c 2f 62 3e 2c 20 62 75 74 20 74 al #2</b>, but t
8ae0: 68 69 73 20 74 69 6d 65 20 77 65 27 6c 6c 20 65 his time we'll e
8af0: 6e 61 62 6c 65 20 61 20 3c 62 3e 6c 6f 67 66 69 nable a <b>logfi
8b00: 6c 65 3c 2f 62 3e 2e 20 0d 0a 3c 76 65 72 62 61 le</b>. ..<verba
8b10: 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 71 6c tim>..SELECT Sql
8b20: 50 72 6f 63 5f 53 65 74 4c 6f 67 66 69 6c 65 28 Proc_SetLogfile(
8b30: 20 27 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 'C:/users/joe/s
8b40: 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f tored_proc_test/
8b50: 6c 6f 67 66 69 6c 65 2e 74 78 74 27 2c 20 31 29 logfile.txt', 1)
8b60: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 ;..-----..1....S
8b70: 45 4c 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 ELECT StoredProc
8b80: 5f 45 78 65 63 75 74 65 28 20 27 6d 79 5f 70 72 _Execute( 'my_pr
8b90: 6f 63 27 2c 20 27 40 73 72 69 64 40 3d 34 33 32 oc', '@srid@=432
8ba0: 36 27 2c 20 27 40 79 65 61 72 40 3d 31 39 39 31 6', '@year@=1991
8bb0: 27 2c 20 27 40 72 65 67 69 6f 6e 40 3d 70 75 67 ', '@region@=pug
8bc0: 6c 69 61 27 2c 20 27 40 73 68 70 5f 70 61 74 68 lia', '@shp_path
8bd0: 40 3d 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f 73 @=C:/users/joe/s
8be0: 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 2f tored_proc_test/
8bf0: 70 75 67 6c 69 61 5f 31 39 39 31 5f 34 33 32 36 puglia_1991_4326
8c00: 27 29 3b 29 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d '););..-----..1.
8c10: 0a 0d 0a 53 45 4c 45 43 54 20 53 74 6f 72 65 64 ...SELECT Stored
8c20: 50 72 6f 63 5f 45 78 65 63 75 74 65 28 20 27 6d Proc_Execute( 'm
8c30: 79 5f 70 72 6f 63 27 2c 20 27 40 73 72 69 64 40 y_proc', '@srid@
8c40: 3d 33 30 30 33 27 2c 20 27 40 79 65 61 72 40 3d =3003', '@year@=
8c50: 32 30 30 31 27 2c 20 27 40 6d 75 6e 69 63 69 70 2001', '@municip
8c60: 61 6c 69 74 79 40 3d 41 52 45 5a 5a 4f 27 2c 20 ality@=AREZZO',
8c70: 27 40 73 68 70 5f 70 61 74 68 40 3d 43 3a 2f 75 '@shp_path@=C:/u
8c80: 73 65 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 5f sers/joe/stored_
8c90: 70 72 6f 63 5f 74 65 73 74 2f 63 6f 6d 5f 61 72 proc_test/com_ar
8ca0: 65 7a 7a 6f 5f 32 30 30 31 5f 33 30 30 33 27 29 ezzo_2001_3003')
8cb0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 0d 0a 53 ;..-----..1....S
8cc0: 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f 53 65 ELECT SqlProc_Se
8cd0: 74 4c 6f 67 66 69 6c 65 28 20 4e 55 4c 4c 20 29 tLogfile( NULL )
8ce0: 3b 0d 0a 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3c 2f 76 ;..-----..1..</v
8cf0: 65 72 62 61 74 69 6d 3e 0d 0a 57 65 27 6c 6c 20 erbatim>..We'll
8d00: 73 74 61 72 74 20 62 79 20 63 61 6c 6c 69 6e 67 start by calling
8d10: 20 3c 62 3e 53 71 6c 50 72 6f 63 5f 53 65 74 4c <b>SqlProc_SetL
8d20: 6f 67 66 69 6c 65 28 29 3c 2f 62 3e 20 73 6f 20 ogfile()</b> so
8d30: 74 6f 20 65 6e 61 62 6c 65 20 74 68 65 20 6c 6f to enable the lo
8d40: 67 67 69 6e 67 20 66 61 63 69 6c 69 74 79 3b 20 gging facility;
8d50: 74 68 65 20 6c 6f 67 66 69 6c 65 20 77 69 6c 6c the logfile will
8d60: 20 62 65 20 3c 62 3e 43 3a 2f 75 73 65 72 73 2f be <b>C:/users/
8d70: 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f joe/stored_proc_
8d80: 74 65 73 74 2f 6c 6f 67 66 69 6c 65 2e 74 78 74 test/logfile.txt
8d90: 3c 2f 62 3e 20 61 6e 64 20 69 74 20 77 69 6c 6c </b> and it will
8da0: 20 62 65 20 6f 70 65 6e 65 64 20 69 6e 20 3c 62 be opened in <b
8db0: 3e 61 70 70 65 6e 64 20 6d 6f 64 65 3c 2f 62 3e >append mode</b>
8dc0: 2e 0d 0a 57 65 27 6c 6c 20 65 6e 64 20 66 69 6e ...We'll end fin
8dd0: 61 6c 6c 79 20 62 79 20 63 61 6c 6c 69 6e 67 20 ally by calling
8de0: 6f 6e 63 65 20 61 67 61 69 6e 20 3c 62 3e 53 71 once again <b>Sq
8df0: 6c 50 72 6f 63 5f 53 65 74 4c 6f 67 66 69 6c 65 lProc_SetLogfile
8e00: 28 29 3c 2f 62 3e 20 62 79 20 70 61 73 73 69 6e ()</b> by passin
8e10: 67 20 61 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 g a <b>NULL</b>
8e20: 70 61 74 68 6e 61 6d 65 20 73 6f 20 74 6f 20 64 pathname so to d
8e30: 69 73 61 62 6c 65 20 74 68 65 20 6c 6f 67 67 69 isable the loggi
8e40: 6e 67 20 66 61 63 69 6c 69 74 79 2e 3c 62 72 3e ng facility.<br>
8e50: 3c 62 72 3e 0d 0a 54 68 65 20 6c 6f 67 66 69 6c <br>..The logfil
8e60: 65 20 69 73 20 6a 75 73 74 20 61 20 70 6c 61 69 e is just a plai
8e70: 6e 20 74 65 78 74 20 66 69 6c 65 3b 20 79 6f 75 n text file; you
8e80: 20 63 61 6e 20 6f 70 65 6e 20 69 74 20 62 79 20 can open it by
8e90: 75 73 69 6e 67 20 61 6e 79 20 74 65 78 74 20 65 using any text e
8ea0: 64 69 74 6f 72 20 73 6f 20 74 6f 20 63 68 65 63 ditor so to chec
8eb0: 6b 20 74 68 61 74 20 69 74 20 77 69 6c 6c 20 6c k that it will l
8ec0: 6f 6f 6b 20 6c 69 6b 65 20 74 68 69 73 3a 0d 0a ook like this:..
8ed0: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 3d 3d 3d 3d <verbatim>..====
8ee0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8ef0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f00: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f10: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f20: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f30: 3d 3d 3d 3d 3d 0d 0a 3d 3d 20 20 20 20 20 53 51 =====..== SQ
8f40: 4c 20 73 65 73 73 69 6f 6e 20 73 74 61 72 74 20 L session start
8f50: 20 20 3d 20 20 20 32 30 31 37 2d 31 32 2d 32 31 = 2017-12-21
8f60: 20 31 32 3a 35 30 3a 30 39 0d 0a 3d 3d 3d 3d 3d 12:50:09..=====
8f70: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f80: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8f90: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8fa0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8fb0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
8fc0: 3d 3d 3d 3d 0d 0a 53 45 4c 45 43 54 20 44 72 6f ====..SELECT Dro
8fd0: 70 47 65 6f 54 61 62 6c 65 28 27 74 72 61 6e 73 pGeoTable('trans
8fe0: 69 65 6e 74 5f 74 61 62 6c 65 27 29 3b 0d 0a 2d ient_table');..-
8ff0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9000: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
9010: 44 72 6f 70 47 65 6f 54 61 62 6c 65 28 27 74 72 DropGeoTable('tr
9020: 61 6e 73 69 65 6e 74 5f 74 61 62 6c 65 27 29 0d ansient_table').
9030: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
9040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9050: 0d 0a 30 0d 0a 3d 3d 3d 20 31 20 72 6f 77 20 3d ..0..=== 1 row =
9060: 3d 3d 20 45 78 65 63 75 74 69 6f 6e 20 74 69 6d == Execution tim
9070: 65 3a 20 30 2e 30 30 33 0d 0a 0d 0a 43 52 45 41 e: 0.003....CREA
9080: 54 45 20 54 41 42 4c 45 20 74 72 61 6e 73 69 65 TE TABLE transie
9090: 6e 74 5f 74 61 62 6c 65 20 41 53 0d 0a 53 45 4c nt_table AS..SEL
90a0: 45 43 54 20 69 64 2c 20 69 73 74 61 74 2c 20 6e ECT id, istat, n
90b0: 61 6d 65 2c 20 70 72 6f 76 69 6e 63 65 2c 20 72 ame, province, r
90c0: 65 67 69 6f 6e 2c 20 53 54 5f 54 72 61 6e 73 66 egion, ST_Transf
90d0: 6f 72 6d 28 67 65 6f 6d 2c 20 34 33 32 36 29 20 orm(geom, 4326)
90e0: 41 53 20 67 65 6f 6d 0d 0a 46 52 4f 4d 20 6d 75 AS geom..FROM mu
90f0: 6e 69 63 69 70 61 6c 69 74 69 65 73 5f 31 39 39 nicipalities_199
9100: 31 0d 0a 57 48 45 52 45 20 28 55 70 70 65 72 28 1..WHERE (Upper(
9110: 6e 61 6d 65 29 20 3d 20 55 70 70 65 72 28 27 4e name) = Upper('N
9120: 55 4c 4c 27 29 20 4f 52 20 55 70 70 65 72 28 70 ULL') OR Upper(p
9130: 72 6f 76 69 6e 63 65 29 20 3d 20 55 70 70 65 72 rovince) = Upper
9140: 28 27 4e 55 4c 4c 27 29 20 4f 52 20 55 70 70 65 ('NULL') OR Uppe
9150: 72 28 72 65 67 69 6f 6e 29 20 3d 20 55 70 70 65 r(region) = Uppe
9160: 72 28 27 70 75 67 6c 69 61 27 29 29 3b 0d 0a 3d r('puglia'));..=
9170: 3d 3d 20 45 78 65 63 75 74 69 6f 6e 20 74 69 6d == Execution tim
9180: 65 3a 20 30 2e 31 31 31 0d 0a 0d 0a 53 45 4c 45 e: 0.111....SELE
9190: 43 54 20 52 65 63 6f 76 65 72 47 65 6f 6d 65 74 CT RecoverGeomet
91a0: 72 79 43 6f 6c 75 6d 6e 28 27 74 72 61 6e 73 69 ryColumn('transi
91b0: 65 6e 74 5f 74 61 62 6c 65 27 2c 20 27 67 65 6f ent_table', 'geo
91c0: 6d 27 2c 20 34 33 32 36 2c 20 27 4d 55 4c 54 49 m', 4326, 'MULTI
91d0: 50 4f 4c 59 47 4f 4e 27 2c 20 27 58 59 27 29 3b POLYGON', 'XY');
91e0: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
91f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9220: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
9230: 52 65 63 6f 76 65 72 47 65 6f 6d 65 74 72 79 43 RecoverGeometryC
9240: 6f 6c 75 6d 6e 28 27 74 72 61 6e 73 69 65 6e 74 olumn('transient
9250: 5f 74 61 62 6c 65 27 2c 20 27 67 65 6f 6d 27 2c _table', 'geom',
9260: 20 34 33 32 36 2c 20 27 4d 55 4c 54 49 50 4f 4c 4326, 'MULTIPOL
9270: 59 47 4f 4e 27 2c 20 27 58 59 27 29 0d 0a 2d 2d YGON', 'XY')..--
9280: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9290: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
92a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
92b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
92c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3d ----------..1..=
92d0: 3d 3d 20 31 20 72 6f 77 20 3d 3d 3d 20 45 78 65 == 1 row === Exe
92e0: 63 75 74 69 6f 6e 20 74 69 6d 65 3a 20 30 2e 30 cution time: 0.0
92f0: 33 31 0d 0a 0d 0a 53 45 4c 45 43 54 20 45 78 70 31....SELECT Exp
9300: 6f 72 74 53 68 70 28 27 74 72 61 6e 73 69 65 6e ortShp('transien
9310: 74 5f 74 61 62 6c 65 27 2c 20 27 67 65 6f 6d 27 t_table', 'geom'
9320: 2c 20 27 43 3a 2f 75 73 65 72 73 2f 6a 6f 65 2f , 'C:/users/joe/
9330: 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 65 73 74 stored_proc_test
9340: 2f 70 75 67 6c 69 61 5f 31 39 39 31 5f 34 33 32 /puglia_1991_432
9350: 36 27 2c 20 27 43 50 31 32 35 32 27 29 3b 0d 0a 6', 'CP1252');..
9360: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
93a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
93b0: 0a 45 78 70 6f 72 74 53 68 70 28 27 74 72 61 6e .ExportShp('tran
93c0: 73 69 65 6e 74 5f 74 61 62 6c 65 27 2c 20 27 67 sient_table', 'g
93d0: 65 6f 6d 27 2c 20 27 43 3a 2f 75 73 65 72 73 2f eom', 'C:/users/
93e0: 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f joe/stored_proc_
93f0: 74 65 73 74 2f 70 75 67 6c 69 61 5f 31 39 39 31 test/puglia_1991
9400: 5f 34 33 32 36 27 2c 20 27 43 50 31 32 35 32 27 _4326', 'CP1252'
9410: 29 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d )..-------------
9420: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9460: 2d 2d 0d 0a 32 35 37 0d 0a 3d 3d 3d 20 31 20 72 --..257..=== 1 r
9470: 6f 77 20 3d 3d 3d 20 45 78 65 63 75 74 69 6f 6e ow === Execution
9480: 20 74 69 6d 65 3a 20 30 2e 30 37 37 0d 0a 0d 0a time: 0.077....
9490: 53 45 4c 45 43 54 20 44 72 6f 70 47 65 6f 54 61 SELECT DropGeoTa
94a0: 62 6c 65 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 ble('transient_t
94b0: 61 62 6c 65 27 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d able');..-------
94c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
94d0: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 44 72 6f 70 47 65 --------..DropGe
94e0: 6f 54 61 62 6c 65 28 27 74 72 61 6e 73 69 65 6e oTable('transien
94f0: 74 5f 74 61 62 6c 65 27 29 0d 0a 2d 2d 2d 2d 2d t_table')..-----
9500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3d ----------..1..=
9520: 3d 3d 20 31 20 72 6f 77 20 3d 3d 3d 20 45 78 65 == 1 row === Exe
9530: 63 75 74 69 6f 6e 20 74 69 6d 65 3a 20 30 2e 30 cution time: 0.0
9540: 30 32 0d 0a 0d 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 02....==========
9550: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9560: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9570: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9580: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9590: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0d ===============.
95a0: 0a 3d 3d 20 20 20 20 20 53 51 4c 20 73 65 73 73 .== SQL sess
95b0: 69 6f 6e 20 65 6e 64 20 20 20 3d 20 20 20 32 30 ion end = 20
95c0: 31 37 2d 31 32 2d 32 31 20 31 32 3a 35 30 3a 30 17-12-21 12:50:0
95d0: 39 20 20 20 3d 20 20 20 35 20 73 74 61 74 65 6d 9 = 5 statem
95e0: 65 6e 74 73 20 77 65 72 65 20 65 78 65 63 75 74 ents were execut
95f0: 65 64 0d 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ed..============
9600: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9610: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9620: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9630: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9640: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0d 0a 0d =============...
9650: 0a 0d 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ...=============
9660: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9670: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9680: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9690: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
96a0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0d 0a 3d 3d ============..==
96b0: 20 20 20 20 20 53 51 4c 20 73 65 73 73 69 6f 6e SQL session
96c0: 20 73 74 61 72 74 20 20 20 3d 20 20 20 32 30 31 start = 201
96d0: 37 2d 31 32 2d 32 31 20 31 32 3a 35 33 3a 30 31 7-12-21 12:53:01
96e0: 0d 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ..==============
96f0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9700: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9710: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9720: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9730: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0d 0a 53 45 4c ===========..SEL
9740: 45 43 54 20 44 72 6f 70 47 65 6f 54 61 62 6c 65 ECT DropGeoTable
9750: 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c ('transient_tabl
9760: 65 27 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e');..----------
9770: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9780: 2d 2d 2d 2d 2d 0d 0a 44 72 6f 70 47 65 6f 54 61 -----..DropGeoTa
9790: 62 6c 65 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 ble('transient_t
97a0: 61 62 6c 65 27 29 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d able')..--------
97b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
97c0: 2d 2d 2d 2d 2d 2d 2d 0d 0a 30 0d 0a 3d 3d 3d 20 -------..0..===
97d0: 31 20 72 6f 77 20 3d 3d 3d 20 45 78 65 63 75 74 1 row === Execut
97e0: 69 6f 6e 20 74 69 6d 65 3a 20 30 2e 30 30 32 0d ion time: 0.002.
97f0: 0a 0d 0a 43 52 45 41 54 45 20 54 41 42 4c 45 20 ...CREATE TABLE
9800: 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c 65 20 transient_table
9810: 41 53 0d 0a 53 45 4c 45 43 54 20 69 64 2c 20 69 AS..SELECT id, i
9820: 73 74 61 74 2c 20 6e 61 6d 65 2c 20 70 72 6f 76 stat, name, prov
9830: 69 6e 63 65 2c 20 72 65 67 69 6f 6e 2c 20 53 54 ince, region, ST
9840: 5f 54 72 61 6e 73 66 6f 72 6d 28 67 65 6f 6d 2c _Transform(geom,
9850: 20 33 30 30 33 29 20 41 53 20 67 65 6f 6d 0d 0a 3003) AS geom..
9860: 46 52 4f 4d 20 6d 75 6e 69 63 69 70 61 6c 69 74 FROM municipalit
9870: 69 65 73 5f 32 30 30 31 0d 0a 57 48 45 52 45 20 ies_2001..WHERE
9880: 28 55 70 70 65 72 28 6e 61 6d 65 29 20 3d 20 55 (Upper(name) = U
9890: 70 70 65 72 28 27 41 52 45 5a 5a 4f 27 29 20 4f pper('AREZZO') O
98a0: 52 20 55 70 70 65 72 28 70 72 6f 76 69 6e 63 65 R Upper(province
98b0: 29 20 3d 20 55 70 70 65 72 28 27 4e 55 4c 4c 27 ) = Upper('NULL'
98c0: 29 20 4f 52 20 55 70 70 65 72 28 72 65 67 69 6f ) OR Upper(regio
98d0: 6e 29 20 3d 20 55 70 70 65 72 28 27 4e 55 4c 4c n) = Upper('NULL
98e0: 27 29 29 3b 0d 0a 3d 3d 3d 20 45 78 65 63 75 74 '));..=== Execut
98f0: 69 6f 6e 20 74 69 6d 65 3a 20 30 2e 30 33 32 0d ion time: 0.032.
9900: 0a 0d 0a 53 45 4c 45 43 54 20 52 65 63 6f 76 65 ...SELECT Recove
9910: 72 47 65 6f 6d 65 74 72 79 43 6f 6c 75 6d 6e 28 rGeometryColumn(
9920: 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c 65 'transient_table
9930: 27 2c 20 27 67 65 6f 6d 27 2c 20 33 30 30 33 2c ', 'geom', 3003,
9940: 20 27 4d 55 4c 54 49 50 4f 4c 59 47 4f 4e 27 2c 'MULTIPOLYGON',
9950: 20 27 58 59 27 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 'XY');..-------
9960: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9990: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
99a0: 2d 2d 2d 2d 2d 0d 0a 52 65 63 6f 76 65 72 47 65 -----..RecoverGe
99b0: 6f 6d 65 74 72 79 43 6f 6c 75 6d 6e 28 27 74 72 ometryColumn('tr
99c0: 61 6e 73 69 65 6e 74 5f 74 61 62 6c 65 27 2c 20 ansient_table',
99d0: 27 67 65 6f 6d 27 2c 20 33 30 30 33 2c 20 27 4d 'geom', 3003, 'M
99e0: 55 4c 54 49 50 4f 4c 59 47 4f 4e 27 2c 20 27 58 ULTIPOLYGON', 'X
99f0: 59 27 29 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d Y')..-----------
9a00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9a30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9a40: 2d 0d 0a 31 0d 0a 3d 3d 3d 20 31 20 72 6f 77 20 -..1..=== 1 row
9a50: 3d 3d 3d 20 45 78 65 63 75 74 69 6f 6e 20 74 69 === Execution ti
9a60: 6d 65 3a 20 30 2e 30 31 33 0d 0a 0d 0a 53 45 4c me: 0.013....SEL
9a70: 45 43 54 20 45 78 70 6f 72 74 53 68 70 28 27 74 ECT ExportShp('t
9a80: 72 61 6e 73 69 65 6e 74 5f 74 61 62 6c 65 27 2c ransient_table',
9a90: 20 27 67 65 6f 6d 27 2c 20 27 43 3a 2f 75 73 65 'geom', 'C:/use
9aa0: 72 73 2f 6a 6f 65 2f 73 74 6f 72 65 64 5f 70 72 rs/joe/stored_pr
9ab0: 6f 63 5f 74 65 73 74 2f 63 6f 6d 5f 61 72 65 7a oc_test/com_arez
9ac0: 7a 6f 5f 32 30 30 31 5f 33 30 30 33 27 2c 20 27 zo_2001_3003', '
9ad0: 43 50 31 32 35 32 27 29 3b 0d 0a 2d 2d 2d 2d 2d CP1252');..-----
9ae0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9af0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9b00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9b10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9b20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
9b30: 45 78 70 6f 72 74 53 68 70 28 27 74 72 61 6e 73 ExportShp('trans
9b40: 69 65 6e 74 5f 74 61 62 6c 65 27 2c 20 27 67 65 ient_table', 'ge
9b50: 6f 6d 27 2c 20 27 43 3a 2f 75 73 65 72 73 2f 6a om', 'C:/users/j
9b60: 6f 65 2f 73 74 6f 72 65 64 5f 70 72 6f 63 5f 74 oe/stored_proc_t
9b70: 65 73 74 2f 63 6f 6d 5f 61 72 65 7a 7a 6f 5f 32 est/com_arezzo_2
9b80: 30 30 31 5f 33 30 30 33 27 2c 20 27 43 50 31 32 001_3003', 'CP12
9b90: 35 32 27 29 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 52')..----------
9ba0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9be0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 31 0d 0a 3d 3d ---------..1..==
9bf0: 3d 20 31 20 72 6f 77 20 3d 3d 3d 20 45 78 65 63 = 1 row === Exec
9c00: 75 74 69 6f 6e 20 74 69 6d 65 3a 20 30 2e 30 30 ution time: 0.00
9c10: 38 0d 0a 0d 0a 53 45 4c 45 43 54 20 44 72 6f 70 8....SELECT Drop
9c20: 47 65 6f 54 61 62 6c 65 28 27 74 72 61 6e 73 69 GeoTable('transi
9c30: 65 6e 74 5f 74 61 62 6c 65 27 29 3b 0d 0a 2d 2d ent_table');..--
9c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9c50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 44 -------------..D
9c60: 72 6f 70 47 65 6f 54 61 62 6c 65 28 27 74 72 61 ropGeoTable('tra
9c70: 6e 73 69 65 6e 74 5f 74 61 62 6c 65 27 29 0d 0a nsient_table')..
9c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
9ca0: 0a 31 0d 0a 3d 3d 3d 20 31 20 72 6f 77 20 3d 3d .1..=== 1 row ==
9cb0: 3d 20 45 78 65 63 75 74 69 6f 6e 20 74 69 6d 65 = Execution time
9cc0: 3a 20 30 2e 30 30 37 0d 0a 0d 0a 3d 3d 3d 3d 3d : 0.007....=====
9cd0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9ce0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9cf0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9d00: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9d10: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9d20: 3d 3d 3d 3d 0d 0a 3d 3d 20 20 20 20 20 53 51 4c ====..== SQL
9d30: 20 73 65 73 73 69 6f 6e 20 65 6e 64 20 20 20 3d session end =
9d40: 20 20 20 32 30 31 37 2d 31 32 2d 32 31 20 31 32 2017-12-21 12
9d50: 3a 35 33 3a 30 31 20 20 20 3d 20 20 20 35 20 73 :53:01 = 5 s
9d60: 74 61 74 65 6d 65 6e 74 73 20 77 65 72 65 20 65 tatements were e
9d70: 78 65 63 75 74 65 64 0d 0a 3d 3d 3d 3d 3d 3d 3d xecuted..=======
9d80: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9d90: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9da0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9db0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9dc0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
9dd0: 3d 3d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d ==..</verbatim>.
9de0: 0a 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 68 32 3e 54 .<br><hr>..<h2>T
9df0: 75 74 6f 72 69 61 6c 20 23 35 20 28 61 64 76 61 utorial #5 (adva
9e00: 6e 63 65 64 29 3c 2f 68 32 3e 0d 0a 3c 68 33 3e nced)</h2>..<h3>
9e10: 35 2e 31 20 41 64 61 70 74 65 64 20 53 74 6f 72 5.1 Adapted Stor
9e20: 65 64 20 50 72 6f 63 65 64 75 72 65 20 66 6f 72 ed Procedure for
9e30: 20 69 73 74 61 74 5f 69 74 3c 2f 68 33 3e 0d 0a istat_it</h3>..
9e40: 42 61 73 65 64 20 6f 6e 20 3c 62 3e 54 75 74 6f Based on <b>Tuto
9e50: 72 69 61 6c 20 23 32 3c 2f 62 3e 2c 20 62 75 74 rial #2</b>, but
9e60: 20 61 64 61 70 74 65 64 20 73 6f 20 74 68 61 74 adapted so that
9e70: 20 74 68 65 20 53 74 6f 72 65 64 20 50 72 6f 63 the Stored Proc
9e80: 65 64 75 72 65 73 20 61 72 65 20 63 6f 6e 74 61 edures are conta
9e90: 69 6e 65 64 20 69 6e 20 61 6e 20 65 78 74 65 72 ined in an exter
9ea0: 6e 61 6c 20 3c 62 3e 3c 69 3e 61 74 74 61 63 68 nal <b><i>attach
9eb0: 3c 2f 69 3e 3c 2f 62 3e 65 64 20 44 61 74 61 62 </i></b>ed Datab
9ec0: 61 73 65 20 77 68 65 72 65 20 74 68 65 20 73 6f ase where the so
9ed0: 75 72 63 65 20 44 61 74 61 62 61 73 65 20 73 68 urce Database sh
9ee0: 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 72 65 61 ould only be rea
9ef0: 64 20 62 75 74 20 6e 6f 74 20 63 68 61 6e 67 65 d but not change
9f00: 64 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 0d 0a 54 68 d...<br><br>..Th
9f10: 65 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 e Stored Procedu
9f20: 72 65 20 68 61 73 20 62 65 65 6e 20 61 64 61 70 re has been adap
9f30: 74 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 61 ted to support a
9f40: 6e 20 3c 62 3e 3c 69 3e 61 74 74 61 63 68 3c 2f n <b><i>attach</
9f50: 69 3e 3c 2f 62 3e 65 64 20 44 61 74 61 62 61 73 i></b>ed Databas
9f60: 65 2e 3c 62 72 3e 0d 0a 49 74 20 69 73 20 73 70 e.<br>..It is sp
9f70: 65 63 69 66 69 63 20 66 6f 72 20 74 68 65 20 53 ecific for the S
9f80: 6f 75 72 63 65 20 3c 62 3e 69 73 74 61 74 5f 69 ource <b>istat_i
9f90: 74 3c 2f 62 3e 20 44 61 74 61 62 61 73 65 2e 3c t</b> Database.<
9fa0: 62 72 3e 0d 0a 3c 62 3e 40 61 74 74 61 63 68 5f br>..<b>@attach_
9fb0: 73 63 68 65 6d 61 5f 6e 61 6d 65 40 3c 2f 62 3e schema_name@</b>
9fc0: 20 77 69 6c 6c 20 63 6f 6e 74 61 69 6e 20 74 68 will contain th
9fd0: 65 20 73 63 68 65 6d 61 2d 6e 61 6d 65 20 75 73 e schema-name us
9fe0: 65 64 20 69 6e 20 74 68 65 20 63 61 6c 6c 69 6e ed in the callin
9ff0: 67 20 73 63 72 69 70 74 3a 20 0d 0a 3c 76 65 72 g script: ..<ver
a000: 62 61 74 69 6d 3e 0d 0a 2d 2d 20 2d 2d 20 2d 2d batim>..-- -- --
a010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a030: 20 2d 2d 0d 0a 2d 2d 20 41 54 54 41 43 48 20 73 --..-- ATTACH s
a040: 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 20 41 ource Database A
a050: 53 20 27 64 62 5f 73 6f 75 72 63 65 27 0d 0a 2d S 'db_source'..-
a060: 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - -- -----------
a070: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a080: 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 4e ------- --..-- N
a090: 6f 74 65 3a 20 53 6f 75 72 63 65 20 44 61 74 61 ote: Source Data
a0a0: 62 61 73 65 20 6d 75 73 74 20 62 65 20 61 74 74 base must be att
a0b0: 61 63 68 65 64 20 62 65 66 6f 72 65 20 74 68 69 ached before thi
a0c0: 73 20 69 73 20 63 61 6c 6c 65 64 0d 0a 2d 2d 20 s is called..--
a0d0: 20 49 66 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 If called from
a0e0: 69 6e 73 69 64 65 20 61 20 53 74 6f 72 65 64 20 inside a Stored
a0f0: 50 72 6f 63 65 64 75 72 65 73 20 77 69 6c 6c 20 Procedures will
a100: 77 6f 72 6b 20 74 68 65 20 66 69 72 73 74 20 74 work the first t
a110: 69 6d 65 2c 0d 0a 2d 2d 20 20 20 74 68 65 6e 20 ime,..-- then
a120: 66 61 69 6c 20 77 69 74 68 20 27 67 61 69 61 5f fail with 'gaia_
a130: 73 71 6c 5f 70 72 6f 63 5f 65 78 65 63 75 74 65 sql_proc_execute
a140: 3a 20 64 61 74 61 62 61 73 65 20 64 62 5f 73 6f : database db_so
a150: 75 72 63 65 20 69 73 20 61 6c 72 65 61 64 79 20 urce is already
a160: 69 6e 20 75 73 65 27 0d 0a 2d 2d 20 2d 2d 20 2d in use'..-- -- -
a170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a190: 2d 20 2d 2d 0d 0a 2d 2d 20 72 65 6d 6f 76 69 6e - --..-- removin
a1a0: 67 20 74 68 65 20 77 6f 72 6b 20 74 61 62 6c 65 g the work table
a1b0: 20 28 6a 75 73 74 20 69 6e 20 63 61 73 65 20 69 (just in case i
a1c0: 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73 t already exists
a1d0: 29 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d )..-- -- -------
a1e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a1f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a ----------- --..
a200: 53 45 4c 45 43 54 20 44 72 6f 70 47 65 6f 54 61 SELECT DropGeoTa
a210: 62 6c 65 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 ble('transient_t
a220: 61 62 6c 65 27 29 3b 0d 0a 2d 2d 20 2d 2d 20 2d able');..-- -- -
a230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a250: 2d 20 2d 2d 0d 0a 2d 2d 20 69 6e 73 65 72 74 69 - --..-- inserti
a260: 6e 67 20 73 65 6c 65 63 74 65 64 20 69 73 74 61 ng selected ista
a270: 74 5f 69 74 20 64 61 74 61 20 69 6e 74 6f 20 74 t_it data into t
a280: 68 65 20 77 6f 72 6b 20 74 61 62 6c 65 0d 0a 2d he work table..-
a290: 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - -- -----------
a2a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a2b0: 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 53 ------- --..-- S
a2c0: 45 4c 45 43 54 20 44 61 74 65 54 69 6d 65 28 27 ELECT DateTime('
a2d0: 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 69 6d 65 27 now','localtime'
a2e0: 29 2c 27 63 61 6c 6c 69 6e 67 3a 20 43 52 45 41 ),'calling: CREA
a2f0: 54 45 20 54 41 42 4c 45 27 3b 0d 0a 43 52 45 41 TE TABLE';..CREA
a300: 54 45 20 54 41 42 4c 45 20 74 72 61 6e 73 69 65 TE TABLE transie
a310: 6e 74 5f 74 61 62 6c 65 20 41 53 0d 0a 53 45 4c nt_table AS..SEL
a320: 45 43 54 20 69 64 2c 0d 0a 20 69 73 74 61 74 2c ECT id,.. istat,
a330: 0d 0a 20 6e 61 6d 65 2c 0d 0a 20 70 72 6f 76 69 .. name,.. provi
a340: 6e 63 65 2c 0d 0a 20 72 65 67 69 6f 6e 2c 0d 0a nce,.. region,..
a350: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 67 65 ST_Transform(ge
a360: 6f 6d 2c 20 40 73 72 69 64 40 29 20 41 53 20 67 om, @srid@) AS g
a370: 65 6f 6d 0d 0a 46 52 4f 4d 20 27 40 61 74 74 61 eom..FROM '@atta
a380: 63 68 5f 73 63 68 65 6d 61 5f 6e 61 6d 65 40 27 ch_schema_name@'
a390: 2e 6d 75 6e 69 63 69 70 61 6c 69 74 69 65 73 5f .municipalities_
a3a0: 40 79 65 61 72 40 0d 0a 57 48 45 52 45 0d 0a 28 @year@..WHERE..(
a3b0: 0d 0a 20 55 70 70 65 72 28 6e 61 6d 65 29 20 3d .. Upper(name) =
a3c0: 20 55 70 70 65 72 28 27 40 6d 75 6e 69 63 69 70 Upper('@municip
a3d0: 61 6c 69 74 79 40 27 29 20 4f 52 20 55 70 70 65 ality@') OR Uppe
a3e0: 72 28 70 72 6f 76 69 6e 63 65 29 20 3d 20 55 70 r(province) = Up
a3f0: 70 65 72 28 27 40 70 72 6f 76 69 6e 63 65 40 27 per('@province@'
a400: 29 20 4f 52 20 55 70 70 65 72 28 72 65 67 69 6f ) OR Upper(regio
a410: 6e 29 20 3d 20 55 70 70 65 72 28 27 40 72 65 67 n) = Upper('@reg
a420: 69 6f 6e 40 27 29 0d 0a 29 3b 0d 0a 2d 2d 20 2d ion@')..);..-- -
a430: 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - --------------
a440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a450: 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 70 72 6f 70 ---- --..-- prop
a460: 65 72 6c 79 20 72 65 63 6f 76 65 72 69 6e 67 20 erly recovering
a470: 74 68 65 20 77 6f 72 6b 20 74 61 62 6c 65 0d 0a the work table..
a480: 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- -- ----------
a490: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a4a0: 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 -------- --..--
a4b0: 53 45 4c 45 43 54 20 44 61 74 65 54 69 6d 65 28 SELECT DateTime(
a4c0: 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 69 6d 65 'now','localtime
a4d0: 27 29 2c 27 63 61 6c 6c 69 6e 67 3a 20 52 65 63 '),'calling: Rec
a4e0: 6f 76 65 72 47 65 6f 6d 65 74 72 79 43 6f 6c 75 overGeometryColu
a4f0: 6d 6e 27 3b 0d 0a 53 45 4c 45 43 54 20 52 65 63 mn';..SELECT Rec
a500: 6f 76 65 72 47 65 6f 6d 65 74 72 79 43 6f 6c 75 overGeometryColu
a510: 6d 6e 28 27 74 72 61 6e 73 69 65 6e 74 5f 74 61 mn('transient_ta
a520: 62 6c 65 27 2c 20 27 67 65 6f 6d 27 2c 20 40 73 ble', 'geom', @s
a530: 72 69 64 40 2c 20 27 4d 55 4c 54 49 50 4f 4c 59 rid@, 'MULTIPOLY
a540: 47 4f 4e 27 2c 20 27 58 59 27 29 3b 0d 0a 2d 2d GON', 'XY');..--
a550: 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- ------------
a560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a570: 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 65 78 ------ --..-- ex
a580: 70 6f 72 74 69 6e 67 20 66 72 6f 6d 20 74 68 65 porting from the
a590: 20 77 6f 72 6b 20 74 61 62 6c 65 20 69 6e 74 6f work table into
a5a0: 20 74 68 65 20 53 68 61 70 65 66 69 6c 65 0d 0a the Shapefile..
a5b0: 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- -- ----------
a5c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a5d0: 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 -------- --..--
a5e0: 53 45 4c 45 43 54 20 44 61 74 65 54 69 6d 65 28 SELECT DateTime(
a5f0: 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 69 6d 65 'now','localtime
a600: 27 29 2c 27 63 61 6c 6c 69 6e 67 3a 20 45 78 70 '),'calling: Exp
a610: 6f 72 74 53 68 70 27 3b 0d 0a 53 45 4c 45 43 54 ortShp';..SELECT
a620: 20 45 78 70 6f 72 74 53 68 70 28 27 74 72 61 6e ExportShp('tran
a630: 73 69 65 6e 74 5f 74 61 62 6c 65 27 2c 20 27 67 sient_table', 'g
a640: 65 6f 6d 27 2c 20 27 40 73 68 70 5f 64 69 72 65 eom', '@shp_dire
a650: 63 74 6f 72 79 40 2f 40 73 68 70 5f 66 69 6c 65 ctory@/@shp_file
a660: 40 27 2c 20 27 43 50 31 32 35 32 27 29 3b 0d 0a @', 'CP1252');..
a670: 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- -- ----------
a680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a690: 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 -------- --..--
a6a0: 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 77 6f 72 removing the wor
a6b0: 6b 20 74 61 62 6c 65 0d 0a 2d 2d 20 2d 2d 20 2d k table..-- -- -
a6c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a6d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a6e0: 2d 20 2d 2d 0d 0a 2d 2d 20 53 45 4c 45 43 54 20 - --..-- SELECT
a6f0: 44 61 74 65 54 69 6d 65 28 27 6e 6f 77 27 2c 27 DateTime('now','
a700: 6c 6f 63 61 6c 74 69 6d 65 27 29 2c 27 63 61 6c localtime'),'cal
a710: 6c 69 6e 67 3a 20 44 72 6f 70 47 65 6f 54 61 62 ling: DropGeoTab
a720: 6c 65 27 3b 0d 0a 53 45 4c 45 43 54 20 44 72 6f le';..SELECT Dro
a730: 70 47 65 6f 54 61 62 6c 65 28 27 74 72 61 6e 73 pGeoTable('trans
a740: 69 65 6e 74 5f 74 61 62 6c 65 27 29 3b 0d 0a 2d ient_table');..-
a750: 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - -- -----------
a760: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a770: 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 3c 2f 76 65 ------- --..</ve
a780: 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c 65 20 rbatim>..<table
a790: 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 38 64 38 bgcolor="#f8f8d8
a7a0: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 36 " cellpadding="6
a7b0: 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 " cellspacing="8
a7c0: 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 3e 4e "><tr><td>..<u>N
a7d0: 6f 74 65 73 3c 2f 75 3e 3a 20 44 69 66 66 65 72 otes</u>: Differ
a7e0: 65 6e 63 65 20 66 72 6f 6d 20 6d 61 69 6e 20 53 ence from main S
a7f0: 61 6d 70 6c 65 3a 3c 62 72 3e 0d 0a 54 68 65 20 ample:<br>..The
a800: 63 61 6c 6c 69 6e 67 20 73 63 72 69 70 74 20 77 calling script w
a810: 69 6c 6c 20 72 75 6e 20 61 67 61 69 6e 73 74 20 ill run against
a820: 74 68 65 20 44 61 74 61 62 61 73 65 20 74 68 61 the Database tha
a830: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 69 73 20 t contains this
a840: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
a850: 20 61 6e 64 20 41 54 54 41 43 48 20 74 68 65 20 and ATTACH the
a860: 73 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 20 source Database
a870: 75 73 69 6e 67 20 61 20 3c 62 3e 73 63 68 65 6d using a <b>schem
a880: 61 2d 6e 61 6d 65 3c 2f 62 3e 2e 0d 0a 3c 75 6c a-name</b>...<ul
a890: 3e 0d 0a 3c 6c 69 3e 55 73 65 20 6f 66 20 41 54 >..<li>Use of AT
a8a0: 54 41 43 48 2f 44 45 54 41 43 48 20 66 72 6f 6d TACH/DETACH from
a8b0: 20 69 6e 73 69 64 65 20 61 20 53 74 6f 72 65 64 inside a Stored
a8c0: 20 50 72 6f 63 65 64 75 72 65 73 20 77 69 6c 6c Procedures will
a8d0: 20 77 6f 72 6b 20 74 68 65 20 66 69 72 73 74 20 work the first
a8e0: 74 69 6d 65 2c 62 75 74 20 66 61 69 6c 20 77 68 time,but fail wh
a8f0: 65 6e 20 63 61 6c 6c 65 64 20 61 67 61 69 6e 20 en called again
a900: 77 69 74 68 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e with..<ul>..<li>
a910: 27 67 61 69 61 5f 73 71 6c 5f 70 72 6f 63 5f 65 'gaia_sql_proc_e
a920: 78 65 63 75 74 65 3a 20 3c 62 3e 64 61 74 61 62 xecute: <b>datab
a930: 61 73 65 20 64 62 5f 73 6f 75 72 63 65 20 69 73 ase db_source is
a940: 20 61 6c 72 65 61 64 79 20 69 6e 20 75 73 65 3c already in use<
a950: 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c /b></li>..</ul><
a960: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 65 6d 70 6f 72 /li>..<li>Tempor
a970: 61 72 79 20 54 41 42 4c 45 20 63 72 65 61 74 65 ary TABLE create
a980: 64 20 69 6e 20 64 75 72 69 6e 67 20 74 68 65 20 d in during the
a990: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
a9a0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 77 69 6c 6c ..<ul>..<li>will
a9b0: 20 62 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e be contained in
a9c0: 20 74 68 65 20 53 74 6f 72 65 64 20 50 72 6f 63 the Stored Proc
a9d0: 65 64 75 72 65 73 20 44 61 74 61 62 61 73 65 20 edures Database
a9e0: 61 6e 64 20 6e 6f 74 20 69 6e 20 74 68 65 20 73 and not in the s
a9f0: 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 2e 3c ource Database.<
aa00: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e /li>..</ul></li>
aa10: 0d 0a 3c 6c 69 3e 53 45 4c 45 43 54 20 6d 65 73 ..<li>SELECT mes
aa20: 73 61 67 65 73 20 63 61 6c 6c 65 64 20 64 75 72 sages called dur
aa30: 69 6e 67 20 74 68 65 20 53 74 6f 72 65 64 20 50 ing the Stored P
aa40: 72 6f 63 65 64 75 72 65 0d 0a 3c 75 6c 3e 0d 0a rocedure..<ul>..
aa50: 3c 6c 69 3e 77 69 6c 6c 20 62 65 20 6e 6f 74 20 <li>will be not
aa60: 62 65 20 73 68 6f 77 6e 20 61 6e 64 20 68 61 76 be shown and hav
aa70: 65 20 62 65 65 6e 20 63 6f 6d 6d 65 6e 74 65 64 e been commented
aa80: 20 6f 75 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c out.</li>..</ul
aa90: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 ></li>..<li>The
aaa0: 45 78 70 6f 72 74 20 53 68 61 70 65 20 64 69 72 Export Shape dir
aab0: 65 63 74 6f 72 79 20 61 6e 64 20 66 69 6c 65 20 ectory and file
aac0: 6e 61 6d 65 73 20 61 72 65 20 73 65 70 65 72 61 names are sepera
aad0: 74 65 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 77 61 te..<ul>..<li>wa
aae0: 73 20 3c 62 3e 73 68 70 5f 70 61 74 68 3c 2f 62 s <b>shp_path</b
aaf0: 3e 2c 20 6e 6f 77 20 3c 62 3e 73 68 70 5f 64 69 >, now <b>shp_di
ab00: 72 65 63 74 6f 72 79 3c 2f 62 3e 20 61 6e 64 20 rectory</b> and
ab10: 3c 62 3e 73 68 70 5f 66 69 6c 65 3c 2f 62 3e 2e <b>shp_file</b>.
ab20: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 6e </li>..<li>The n
ab30: 65 65 64 65 64 20 64 69 72 65 63 74 6f 72 79 20 eeded directory
ab40: 22 2f 22 20 62 65 74 77 65 65 6e 20 73 68 70 5f "/" between shp_
ab50: 64 69 72 65 63 74 6f 72 79 20 61 6e 64 20 73 68 directory and sh
ab60: 70 5f 66 69 6c 65 20 77 69 6c 6c 20 62 65 20 61 p_file will be a
ab70: 64 64 65 64 20 68 65 72 65 2e 3c 2f 6c 69 3e 0d dded here.</li>.
ab80: 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 .</ul></li>..</u
ab90: 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f l>..</td></tr></
aba0: 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c 68 72 3e table>..<br><hr>
abb0: 0d 0a 3c 68 33 3e 35 2e 32 20 43 72 65 61 74 69 ..<h3>5.2 Creati
abc0: 6e 67 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 ng Stored Proced
abd0: 75 72 65 20 44 61 74 61 62 61 73 65 3c 2f 68 33 ure Database</h3
abe0: 3e 0d 0a 54 68 65 20 53 74 6f 72 65 64 20 50 72 >..The Stored Pr
abf0: 6f 63 65 64 75 72 65 20 61 6e 64 20 70 6f 73 73 ocedure and poss
ac00: 69 62 6c 65 20 64 65 66 61 75 6c 74 20 76 61 6c ible default val
ac10: 75 65 73 20 77 69 6c 6c 20 62 65 20 73 74 6f 72 ues will be stor
ac20: 65 64 20 69 6e 20 74 68 65 20 63 72 65 61 74 65 ed in the create
ac30: 64 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 d Stored Procedu
ac40: 72 65 73 20 44 61 74 61 62 61 73 65 2e 3c 62 72 res Database.<br
ac50: 3e 0d 0a 3c 62 3e 40 61 74 74 61 63 68 5f 73 63 >..<b>@attach_sc
ac60: 68 65 6d 61 5f 6e 61 6d 65 40 3c 2f 62 3e 20 77 hema_name@</b> w
ac70: 69 6c 6c 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 ill contain the
ac80: 73 63 68 65 6d 61 2d 6e 61 6d 65 20 75 73 65 64 schema-name used
ac90: 20 69 6e 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 in the calling
aca0: 73 63 72 69 70 74 3a 0d 0a 3c 76 65 72 62 61 74 script:..<verbat
acb0: 69 6d 3e 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d im>..-- -- -----
acc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
acd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d ------------- --
ace0: 0d 0a 2d 2d 20 65 78 70 6f 72 74 20 53 50 41 54 ..-- export SPAT
acf0: 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 59 3d IALITE_SECURITY=
ad00: 72 65 6c 61 78 65 64 0d 0a 2d 2d 20 72 6d 20 73 relaxed..-- rm s
ad10: 74 6f 72 65 64 5f 70 72 6f 63 65 64 75 72 65 5f tored_procedure_
ad20: 64 62 2e 64 62 0d 0a 2d 2d 20 73 70 61 74 69 61 db.db..-- spatia
ad30: 6c 69 74 65 20 73 74 6f 72 65 64 5f 70 72 6f 63 lite stored_proc
ad40: 65 64 75 72 65 5f 64 62 2e 64 62 20 0d 0a 3c 2f edure_db.db ..</
ad50: 76 65 72 62 61 74 69 6d 3e 20 0d 0a 3c 74 61 62 verbatim> ..<tab
ad60: 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 le bgcolor="#f8f
ad70: 38 64 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 8d8" cellpadding
ad80: 3d 22 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 ="6" cellspacing
ad90: 3d 22 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c ="8"><tr><td>..<
ada0: 75 3e 4e 6f 74 65 73 3c 2f 75 3e 3a 20 44 69 66 u>Notes</u>: Dif
adb0: 66 65 72 65 6e 63 65 20 66 72 6f 6d 20 6d 61 69 ference from mai
adc0: 6e 20 53 61 6d 70 6c 65 3a 0d 0a 3c 75 6c 3e 0d n Sample:..<ul>.
add0: 0a 3c 6c 69 3e 54 68 65 20 63 61 6c 6c 65 64 20 .<li>The called
ade0: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
adf0: 20 69 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 is specific to
ae00: 74 68 65 20 41 54 54 41 43 48 65 64 20 73 6f 75 the ATTACHed sou
ae10: 72 63 65 20 44 61 74 61 62 61 73 65 2e 0d 0a 3c rce Database...<
ae20: 75 6c 3e 0d 0a 3c 6c 69 3e 63 61 72 65 20 6d 75 ul>..<li>care mu
ae30: 73 74 20 62 65 20 74 61 6b 65 6e 20 74 68 61 74 st be taken that
ae40: 20 74 68 65 79 20 62 6f 74 68 20 6d 61 74 63 68 they both match
ae50: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 </li>..</ul></li
ae60: 3e 0d 0a 3c 6c 69 3e 41 20 64 69 66 66 65 72 65 >..<li>A differe
ae70: 6e 74 20 53 6f 75 72 63 65 20 44 61 74 61 62 61 nt Source Databa
ae80: 73 65 20 63 61 6e 20 62 65 20 61 64 64 65 64 20 se can be added
ae90: 64 75 72 69 6e 67 20 74 68 65 20 63 61 6c 6c 69 during the calli
aea0: 6e 67 20 73 63 72 69 70 74 0d 0a 3c 75 6c 3e 0d ng script..<ul>.
aeb0: 0a 3c 6c 69 3e 74 68 61 74 20 6d 75 73 74 20 63 .<li>that must c
aec0: 61 6c 6c 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 all a correspond
aed0: 69 6e 67 20 45 78 70 6f 72 74 20 53 74 6f 72 65 ing Export Store
aee0: 64 20 50 72 6f 63 65 64 75 72 65 2e 3c 2f 6c 69 d Procedure.</li
aef0: 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c >..</ul></li>..<
af00: 6c 69 3e 54 68 65 20 53 68 61 70 65 20 6f 75 74 li>The Shape out
af10: 70 75 74 20 64 69 72 65 63 74 6f 72 79 0d 0a 3c put directory..<
af20: 75 6c 3e 0d 0a 3c 6c 69 3e 6d 61 79 20 62 65 2c ul>..<li>may be,
af30: 20 62 75 74 20 6d 75 73 74 20 6e 6f 74 20 62 65 but must not be
af40: 20 74 68 65 20 73 61 6d 65 20 66 6f 72 20 61 6c the same for al
af50: 6c 20 65 78 70 6f 72 74 65 64 20 53 68 61 70 65 l exported Shape
af60: 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f s.</li>..</ul></
af70: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 li>..</ul>..</td
af80: 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 0d 0a ></tr></table>..
af90: 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 68 33 3e 35 2e <br><hr>..<h3>5.
afa0: 33 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 73 63 3 The calling sc
afb0: 72 69 70 74 2c 20 70 6f 73 73 69 62 6c 79 20 63 ript, possibly c
afc0: 61 6c 6c 69 6e 67 20 64 69 66 66 65 72 65 6e 63 alling differenc
afd0: 65 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 e Stored Procedu
afe0: 72 65 73 20 61 6e 64 20 73 6f 75 72 63 65 20 44 res and source D
aff0: 61 74 61 62 61 73 65 73 3c 2f 68 33 3e 0d 0a 54 atabases</h3>..T
b000: 68 65 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 he Stored Proced
b010: 75 72 65 20 61 6e 64 20 70 6f 73 73 69 62 6c 65 ure and possible
b020: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 default values
b030: 77 69 6c 6c 20 62 65 20 73 74 6f 72 65 64 20 69 will be stored i
b040: 6e 20 74 68 65 20 63 72 65 61 74 65 64 20 53 74 n the created St
b050: 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 73 20 ored Procedures
b060: 44 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 44 Database.<br>..D
b070: 69 66 66 65 72 65 6e 74 20 53 6f 75 72 63 65 20 ifferent Source
b080: 44 61 74 61 62 61 73 65 73 2c 20 75 73 69 6e 67 Databases, using
b090: 20 64 69 66 66 65 72 65 6e 74 20 53 74 6f 72 65 different Store
b0a0: 64 20 50 72 6f 63 65 64 75 72 65 2c 20 63 6f 75 d Procedure, cou
b0b0: 6c 64 20 62 65 20 75 73 65 64 20 77 69 74 68 69 ld be used withi
b0c0: 6e 20 6f 6e 65 20 73 63 72 69 70 74 3a 20 0d 0a n one script: ..
b0d0: 3c 76 65 72 62 61 74 69 6d 3e 2d 2d 20 2d 2d 20 <verbatim>-- --
b0e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b0f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b100: 2d 2d 20 2d 2d 0d 0a 2d 2d 20 65 78 70 6f 72 74 -- --..-- export
b110: 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 SPATIALITE_SECU
b120: 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a 2d 2d RITY=relaxed..--
b130: 20 73 70 61 74 69 61 6c 69 74 65 20 73 74 6f 72 spatialite stor
b140: 65 64 5f 70 72 6f 63 65 64 75 72 65 5f 64 62 2e ed_procedure_db.
b150: 64 62 20 20 63 72 65 61 74 65 64 20 77 69 74 68 db created with
b160: 20 27 73 74 6f 72 65 2e 65 78 70 6f 72 74 5f 73 'store.export_s
b170: 68 61 70 65 2e 73 70 2e 73 71 6c 27 0d 0a 2d 2d hape.sp.sql'..--
b180: 20 54 65 6d 70 6f 72 61 72 79 20 54 41 42 4c 45 Temporary TABLE
b190: 53 20 63 72 65 61 74 65 64 20 69 6e 20 64 75 72 S created in dur
b1a0: 69 6e 67 20 74 68 65 20 53 74 6f 72 65 64 20 50 ing the Stored P
b1b0: 72 6f 63 65 64 75 72 65 0d 0a 2d 2d 20 20 77 69 rocedure..-- wi
b1c0: 6c 6c 20 62 65 20 63 6f 6e 74 61 69 6e 65 64 20 ll be contained
b1d0: 69 6e 20 74 68 65 20 53 74 6f 72 65 64 20 50 72 in the Stored Pr
b1e0: 6f 63 65 64 75 72 65 73 20 44 61 74 61 62 61 73 ocedures Databas
b1f0: 65 20 61 6e 64 20 6e 6f 74 20 69 6e 20 74 68 65 e and not in the
b200: 20 73 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 source Database
b210: 2e 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d ...-- -- -------
b220: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a ----------- --..
b240: 2d 2d 20 55 73 65 20 61 20 4c 6f 67 2d 66 69 6c -- Use a Log-fil
b250: 65 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 0d e for debugging.
b260: 0a 2d 2d 20 2d 3e 20 77 69 6c 6c 20 62 65 20 77 .-- -> will be w
b270: 72 69 74 74 65 6e 20 69 6e 20 74 68 65 20 73 61 ritten in the sa
b280: 6d 65 20 64 69 72 65 63 74 6f 72 79 20 61 73 20 me directory as
b290: 74 68 65 20 73 63 72 69 70 74 0d 0a 2d 2d 20 2d the script..-- -
b2a0: 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - --------------
b2b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b2c0: 2d 2d 2d 2d 20 2d 2d 0d 0a 53 45 4c 45 43 54 20 ---- --..SELECT
b2d0: 53 71 6c 50 72 6f 63 5f 53 65 74 4c 6f 67 66 69 SqlProc_SetLogfi
b2e0: 6c 65 20 28 20 27 6c 6f 67 2e 73 65 6c 65 63 74 le ( 'log.select
b2f0: 2e 65 78 70 6f 72 74 5f 73 68 61 70 65 5f 66 72 .export_shape_fr
b300: 6f 6d 5f 64 62 2e 74 78 74 27 20 29 3b 0d 0a 2d om_db.txt' );..-
b310: 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - -- -----------
b320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b330: 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 41 ------- --..-- A
b340: 74 74 61 63 68 20 73 6f 75 72 63 65 20 44 61 74 ttach source Dat
b350: 61 62 61 73 65 20 66 6f 72 20 75 73 65 20 66 72 abase for use fr
b360: 6f 6d 20 74 68 69 73 20 73 63 72 69 70 74 0d 0a om this script..
b370: 2d 2d 20 4e 6f 74 65 3a 20 75 73 65 20 6f 66 20 -- Note: use of
b380: 41 54 54 41 43 48 2f 44 45 54 41 43 48 20 66 72 ATTACH/DETACH fr
b390: 6f 6d 20 69 6e 73 69 64 65 20 61 0d 0a 2d 2d 20 om inside a..--
b3a0: 20 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 Stored Procedur
b3b0: 65 73 20 77 69 6c 6c 20 77 6f 72 6b 20 74 68 65 es will work the
b3c0: 20 66 69 72 73 74 20 74 69 6d 65 2c 0d 0a 2d 2d first time,..--
b3d0: 20 20 20 74 68 65 6e 20 66 61 69 6c 20 77 69 74 then fail wit
b3e0: 68 20 27 67 61 69 61 5f 73 71 6c 5f 70 72 6f 63 h 'gaia_sql_proc
b3f0: 5f 65 78 65 63 75 74 65 3a 20 64 61 74 61 62 61 _execute: databa
b400: 73 65 20 64 62 5f 73 6f 75 72 63 65 20 69 73 20 se db_source is
b410: 61 6c 72 65 61 64 79 20 69 6e 20 75 73 65 27 0d already in use'.
b420: 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d .-- -- ---------
b430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d --------- --..--
b450: 20 53 45 4c 45 43 54 20 44 61 74 65 54 69 6d 65 SELECT DateTime
b460: 28 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 69 6d ('now','localtim
b470: 65 27 29 2c 27 63 61 6c 6c 69 6e 67 3a 20 41 54 e'),'calling: AT
b480: 54 41 43 48 20 44 41 54 41 42 41 53 45 27 3b 0d TACH DATABASE';.
b490: 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d .-- -- ---------
b4a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b4b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d --------- --..--
b4c0: 20 54 68 65 20 75 73 65 64 20 73 63 68 65 6d 61 The used schema
b4d0: 2d 6e 61 6d 65 20 6d 75 73 74 20 62 65 20 70 61 -name must be pa
b4e0: 73 73 65 64 20 6f 6e 20 74 6f 20 74 68 65 20 63 ssed on to the c
b4f0: 61 6c 6c 65 64 20 53 74 6f 72 65 64 20 50 72 6f alled Stored Pro
b500: 63 65 64 75 72 65 0d 0a 2d 2d 20 2d 3e 20 27 64 cedure..-- -> 'd
b510: 62 5f 73 6f 75 72 63 65 27 0d 0a 2d 2d 20 2d 2d b_source'..-- --
b520: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ---------------
b530: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b540: 2d 2d 2d 20 2d 2d 0d 0a 41 54 54 41 43 48 20 44 --- --..ATTACH D
b550: 41 54 41 42 41 53 45 20 27 73 6f 75 72 63 65 5f ATABASE 'source_
b560: 64 62 2f 73 70 5f 73 61 6d 70 6c 65 5f 64 62 2e db/sp_sample_db.
b570: 64 62 27 20 41 53 20 64 62 5f 73 6f 75 72 63 65 db' AS db_source
b580: 3b 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d ;..-- -- -------
b590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b5a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a ----------- --..
b5b0: 2d 2d 20 53 45 4c 45 43 54 20 44 61 74 65 54 69 -- SELECT DateTi
b5c0: 6d 65 28 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 me('now','localt
b5d0: 69 6d 65 27 29 2c 22 63 61 6c 6c 69 6e 67 3a 20 ime'),"calling:
b5e0: 27 65 78 70 6f 72 74 5f 73 68 61 70 65 27 20 66 'export_shape' f
b5f0: 6f 72 20 4c 61 7a 69 6f 22 3b 0d 0a 53 45 4c 45 or Lazio";..SELE
b600: 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 45 78 CT StoredProc_Ex
b610: 65 63 75 74 65 28 20 27 65 78 70 6f 72 74 5f 73 ecute( 'export_s
b620: 68 61 70 65 27 2c 0d 0a 20 20 20 20 27 40 61 74 hape',.. '@at
b630: 74 61 63 68 5f 73 63 68 65 6d 61 5f 6e 61 6d 65 tach_schema_name
b640: 40 3d 64 62 5f 73 6f 75 72 63 65 27 2c 0d 0a 20 @=db_source',..
b650: 20 20 20 27 40 79 65 61 72 40 3d 32 30 30 31 27 '@year@=2001'
b660: 2c 0d 0a 20 20 20 20 27 40 73 72 69 64 40 3d 33 ,.. '@srid@=3
b670: 30 30 34 27 2c 0d 0a 20 20 20 20 27 40 72 65 67 004',.. '@reg
b680: 69 6f 6e 40 3d 4c 61 7a 69 6f 27 2c 0d 0a 20 20 ion@=Lazio',..
b690: 20 20 27 40 73 68 70 5f 66 69 6c 65 40 3d 6c 61 '@shp_file@=la
b6a0: 7a 69 6f 5f 32 30 30 31 5f 33 30 30 34 27 20 29 zio_2001_3004' )
b6b0: 3b 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d ;..-- -- -------
b6c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b6d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a ----------- --..
b6e0: 2d 2d 20 53 45 4c 45 43 54 20 44 61 74 65 54 69 -- SELECT DateTi
b6f0: 6d 65 28 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 me('now','localt
b700: 69 6d 65 27 29 2c 22 63 61 6c 6c 69 6e 67 3a 20 ime'),"calling:
b710: 27 65 78 70 6f 72 74 5f 73 68 61 70 65 27 20 66 'export_shape' f
b720: 6f 72 20 50 75 67 6c 69 61 22 3b 0d 0a 53 45 4c or Puglia";..SEL
b730: 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f 45 ECT StoredProc_E
b740: 78 65 63 75 74 65 28 20 27 65 78 70 6f 72 74 5f xecute( 'export_
b750: 73 68 61 70 65 27 2c 0d 0a 20 20 20 20 27 40 61 shape',.. '@a
b760: 74 74 61 63 68 5f 73 63 68 65 6d 61 5f 6e 61 6d ttach_schema_nam
b770: 65 40 3d 64 62 5f 73 6f 75 72 63 65 27 2c 0d 0a e@=db_source',..
b780: 20 20 20 20 27 40 79 65 61 72 40 3d 31 39 39 31 '@year@=1991
b790: 27 2c 0d 0a 20 20 20 20 27 40 73 72 69 64 40 3d ',.. '@srid@=
b7a0: 34 33 32 36 27 2c 0d 0a 20 20 20 20 27 40 72 65 4326',.. '@re
b7b0: 67 69 6f 6e 40 3d 70 75 67 6c 69 61 27 2c 0d 0a gion@=puglia',..
b7c0: 20 20 20 20 27 40 73 68 70 5f 66 69 6c 65 40 3d '@shp_file@=
b7d0: 70 75 67 6c 69 61 5f 31 39 39 31 5f 34 33 32 36 puglia_1991_4326
b7e0: 27 20 29 3b 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d ' );..-- -- ----
b7f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b800: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d -------------- -
b810: 2d 0d 0a 2d 2d 20 53 45 4c 45 43 54 20 44 61 74 -..-- SELECT Dat
b820: 65 54 69 6d 65 28 27 6e 6f 77 27 2c 27 6c 6f 63 eTime('now','loc
b830: 61 6c 74 69 6d 65 27 29 2c 22 63 61 6c 6c 69 6e altime'),"callin
b840: 67 3a 20 27 65 78 70 6f 72 74 5f 73 68 61 70 65 g: 'export_shape
b850: 27 20 66 6f 72 20 41 72 65 7a 7a 6f 22 3b 0d 0a ' for Arezzo";..
b860: 53 45 4c 45 43 54 20 53 74 6f 72 65 64 50 72 6f SELECT StoredPro
b870: 63 5f 45 78 65 63 75 74 65 28 20 27 65 78 70 6f c_Execute( 'expo
b880: 72 74 5f 73 68 61 70 65 27 2c 0d 0a 20 20 20 20 rt_shape',..
b890: 27 40 61 74 74 61 63 68 5f 73 63 68 65 6d 61 5f '@attach_schema_
b8a0: 6e 61 6d 65 40 3d 64 62 5f 73 6f 75 72 63 65 27 name@=db_source'
b8b0: 2c 0d 0a 20 20 20 20 27 40 79 65 61 72 40 3d 32 ,.. '@year@=2
b8c0: 30 31 31 27 2c 0d 0a 20 20 20 20 27 40 73 72 69 011',.. '@sri
b8d0: 64 40 3d 33 30 30 33 27 2c 0d 0a 20 20 20 20 27 d@=3003',.. '
b8e0: 40 70 72 6f 76 69 6e 63 65 40 3d 41 52 45 5a 5a @province@=AREZZ
b8f0: 4f 27 2c 0d 0a 20 20 20 20 27 40 73 68 70 5f 66 O',.. '@shp_f
b900: 69 6c 65 40 3d 70 72 6f 76 69 6e 63 65 5f 61 72 ile@=province_ar
b910: 65 7a 7a 6f 5f 32 30 31 31 5f 33 30 30 33 27 20 ezzo_2011_3003'
b920: 29 3b 0d 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d );..-- -- ------
b930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
b940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d ------------ --.
b950: 0a 2d 2d 20 53 45 4c 45 43 54 20 44 61 74 65 54 .-- SELECT DateT
b960: 69 6d 65 28 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c ime('now','local
b970: 74 69 6d 65 27 29 2c 22 63 61 6c 6c 69 6e 67 3a time'),"calling:
b980: 20 27 65 78 70 6f 72 74 5f 73 68 61 70 65 27 20 'export_shape'
b990: 66 6f 72 20 41 72 65 7a 7a 6f 22 3b 0d 0a 53 45 for Arezzo";..SE
b9a0: 4c 45 43 54 20 53 74 6f 72 65 64 50 72 6f 63 5f LECT StoredProc_
b9b0: 45 78 65 63 75 74 65 28 20 27 65 78 70 6f 72 74 Execute( 'export
b9c0: 5f 73 68 61 70 65 27 2c 0d 0a 20 20 20 20 27 40 _shape',.. '@
b9d0: 61 74 74 61 63 68 5f 73 63 68 65 6d 61 5f 6e 61 attach_schema_na
b9e0: 6d 65 40 3d 64 62 5f 73 6f 75 72 63 65 27 2c 0d me@=db_source',.
b9f0: 0a 20 20 20 20 27 40 79 65 61 72 40 3d 32 30 30 . '@year@=200
ba00: 31 27 2c 0d 0a 20 20 20 20 27 40 73 72 69 64 40 1',.. '@srid@
ba10: 3d 33 30 30 33 27 2c 0d 0a 20 20 20 20 27 40 6d =3003',.. '@m
ba20: 75 6e 69 63 69 70 61 6c 69 74 79 40 3d 41 72 65 unicipality@=Are
ba30: 7a 7a 6f 27 2c 0d 0a 20 20 20 20 27 40 73 68 70 zzo',.. '@shp
ba40: 5f 66 69 6c 65 40 3d 6d 75 6e 69 63 69 70 61 6c _file@=municipal
ba50: 69 74 79 5f 61 72 65 7a 7a 6f 5f 32 30 30 31 5f ity_arezzo_2001_
ba60: 33 30 30 33 27 20 29 3b 0d 0a 2d 2d 20 2d 2d 20 3003' );..-- --
ba70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
ba80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
ba90: 2d 2d 20 2d 2d 0d 0a 2d 2d 20 44 45 54 41 43 48 -- --..-- DETACH
baa0: 20 73 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 source Database
bab0: 0d 0a 2d 2d 20 54 68 65 20 75 73 65 64 20 73 63 ..-- The used sc
bac0: 68 65 6d 61 2d 6e 61 6d 65 20 6d 75 73 74 20 62 hema-name must b
bad0: 65 20 75 73 65 64 20 68 65 72 65 0d 0a 2d 2d 20 e used here..--
bae0: 2d 3e 20 27 64 62 5f 73 6f 75 72 63 65 27 0d 0a -> 'db_source'..
baf0: 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- -- ----------
bb00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
bb10: 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 -------- --..--
bb20: 53 45 4c 45 43 54 20 44 61 74 65 54 69 6d 65 28 SELECT DateTime(
bb30: 27 6e 6f 77 27 2c 27 6c 6f 63 61 6c 74 69 6d 65 'now','localtime
bb40: 27 29 2c 27 63 61 6c 6c 69 6e 67 3a 20 44 45 54 '),'calling: DET
bb50: 41 43 48 20 44 41 54 41 42 41 53 45 27 3b 0d 0a ACH DATABASE';..
bb60: 44 45 54 41 43 48 20 44 41 54 41 42 41 53 45 20 DETACH DATABASE
bb70: 64 62 5f 73 6f 75 72 63 65 3b 0d 0a 2d 2d 20 2d db_source;..-- -
bb80: 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d - --------------
bb90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
bba0: 2d 2d 2d 2d 20 2d 2d 0d 0a 2d 2d 20 53 45 4c 45 ---- --..-- SELE
bbb0: 43 54 20 44 61 74 65 54 69 6d 65 28 27 6e 6f 77 CT DateTime('now
bbc0: 27 2c 27 6c 6f 63 61 6c 74 69 6d 65 27 29 2c 22 ','localtime'),"
bbd0: 63 61 6c 6c 69 6e 67 3a 20 53 71 6c 50 72 6f 63 calling: SqlProc
bbe0: 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 22 3b 0d _GetLastError";.
bbf0: 0a 53 45 4c 45 43 54 20 53 71 6c 50 72 6f 63 5f .SELECT SqlProc_
bc00: 47 65 74 4c 61 73 74 45 72 72 6f 72 28 29 3b 0d GetLastError();.
bc10: 0a 2d 2d 20 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d .-- -- ---------
bc20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
bc30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 0d 0a 3c 2f --------- --..</
bc40: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c verbatim>..<tabl
bc50: 65 20 62 67 63 6f 6c 6f 72 3d 22 23 66 38 66 38 e bgcolor="#f8f8
bc60: 64 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d d8" cellpadding=
bc70: 22 36 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d "6" cellspacing=
bc80: 22 38 22 3e 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 75 "8"><tr><td>..<u
bc90: 3e 4e 6f 74 65 73 3c 2f 75 3e 3a 20 44 69 66 66 >Notes</u>: Diff
bca0: 65 72 65 6e 63 65 20 66 72 6f 6d 20 6d 61 69 6e erence from main
bcb0: 20 53 61 6d 70 6c 65 3a 0d 0a 3c 75 6c 3e 0d 0a Sample:..<ul>..
bcc0: 3c 6c 69 3e 54 68 65 20 63 61 6c 6c 65 64 20 53 <li>The called S
bcd0: 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 20 tored Procedure
bce0: 61 73 73 75 6d 65 73 20 74 68 61 74 20 74 68 65 assumes that the
bcf0: 20 73 6f 75 72 63 65 20 44 61 74 61 62 61 73 65 source Database
bd00: 20 68 61 73 20 62 65 65 6e 20 41 54 54 41 43 48 has been ATTACH
bd10: 65 64 2c 20 75 73 69 6e 67 20 74 68 65 20 67 69 ed, using the gi
bd20: 76 65 6e 20 3c 62 3e 61 74 74 61 63 68 5f 73 63 ven <b>attach_sc
bd30: 68 65 6d 61 5f 6e 61 6d 65 3c 2f 62 3e 2e 0d 0a hema_name</b>...
bd40: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 66 20 74 68 65 <ul>..<li>if the
bd50: 20 75 73 65 64 20 73 63 68 65 6d 61 2d 6e 61 6d used schema-nam
bd60: 65 20 3c 62 3e 69 73 20 6e 6f 74 3c 2f 62 3e 20 e <b>is not</b>
bd70: 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 the same as the
bd80: 73 65 74 20 64 65 66 61 75 6c 74 20 76 61 6c 75 set default valu
bd90: 65 2c 20 69 74 20 3c 62 3e 6d 75 73 74 3c 2f 62 e, it <b>must</b
bda0: 3e 20 62 65 20 67 69 76 65 6e 20 61 73 20 61 20 > be given as a
bdb0: 53 74 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 Stored Procedure
bdc0: 20 70 61 72 61 6d 65 74 65 72 2e 3c 2f 6c 69 3e parameter.</li>
bdd0: 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c ..</ul></li>..<l
bde0: 69 3e 54 68 65 20 53 68 61 70 65 20 6f 75 74 70 i>The Shape outp
bdf0: 75 74 20 66 69 6e 65 2d 6e 61 6d 65 0d 0a 3c 75 ut fine-name..<u
be00: 6c 3e 0d 0a 3c 6c 69 3e 6d 75 73 74 20 62 65 20 l>..<li>must be
be10: 3c 62 3e 75 6e 69 71 75 65 3c 2f 62 3e 20 77 69 <b>unique</b> wi
be20: 74 68 69 6e 20 74 68 65 20 53 68 61 70 65 20 6f thin the Shape o
be30: 75 74 70 75 74 20 64 69 72 65 63 74 6f 72 79 2e utput directory.
be40: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 </li>..</ul></li
be50: 3e 0d 0a 3c 6c 69 3e 54 68 65 20 53 68 61 70 65 >..<li>The Shape
be60: 20 6f 75 74 70 75 74 20 64 69 72 65 63 74 6f 72 output director
be70: 79 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 6d 61 79 y..<ul>..<li>may
be80: 20 62 65 2c 20 62 75 74 20 6d 75 73 74 20 6e 6f be, but must no
be90: 74 20 62 65 20 74 68 65 20 73 61 6d 65 20 66 6f t be the same fo
bea0: 72 20 61 6c 6c 20 65 78 70 6f 72 74 65 64 20 53 r all exported S
beb0: 68 61 70 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 hapes.</li>..</u
bec0: 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a l></li>..</ul>..
bed0: 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c </td></tr></tabl
bee0: 65 3e 0d 0a 3c 62 72 3e 3c 68 72 3e 0d 0a 3c 74 e>..<br><hr>..<t
bef0: 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 able width="100%
bf00: 22 3e 3c 74 72 3e 0d 0a 3c 74 64 20 77 69 64 74 "><tr>..<td widt
bf10: 68 3d 22 33 33 25 22 20 61 6c 69 67 6e 3d 22 6c h="33%" align="l
bf20: 65 66 74 22 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 eft"></td>..<td
bf30: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 3c align="center"><
bf40: 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f a href="https://
bf50: 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f www.gaia-gis.it/
bf60: 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 fossil/libspatia
bf70: 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 lite/wiki?name=4
bf80: 2e 33 2e 30 2b 64 6f 63 22 3e 62 61 63 6b 20 74 .3.0+doc">back t
bf90: 6f 20 69 6e 64 65 78 3c 2f 61 3e 3c 2f 74 64 3e o index</a></td>
bfa0: 0d 0a 3c 74 64 20 77 69 64 74 68 3d 22 33 33 25 ..<td width="33%
bfb0: 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e " align="right">
bfc0: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 3c 2f 74 61 </td>..</tr></ta
bfd0: 62 6c 65 3e 0a 5a 20 31 65 32 30 63 65 65 31 38 ble>.Z 1e20cee18
bfe0: 38 35 64 39 39 36 66 63 63 62 33 37 35 62 31 37 85d996fccb375b17
bff0: 65 37 61 61 38 34 39 0a e7aa849.