Artifact
aac32263b65ae4fc942903280923069b21480032:
Wiki page
[version-1.8.0] by
sandro
2014-04-16 20:55:08.
0000: 44 20 32 30 31 34 2d 30 34 2d 31 36 54 32 30 3a D 2014-04-16T20:
0010: 35 35 3a 30 38 2e 30 39 30 0a 4c 20 76 65 72 73 55:08.090.L vers
0020: 69 6f 6e 2d 31 2e 38 2e 30 0a 55 20 73 61 6e 64 ion-1.8.0.U sand
0030: 72 6f 0a 57 20 36 34 37 31 0a 42 61 63 6b 20 74 ro.W 6471.Back t
0040: 6f 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 o <a href="https
0050: 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e ://www.gaia-gis.
0060: 69 74 2f 66 6f 73 73 69 6c 2f 73 70 61 74 69 61 it/fossil/spatia
0070: 6c 69 74 65 5f 67 75 69 2f 77 69 6b 69 3f 6e 61 lite_gui/wiki?na
0080: 6d 65 3d 73 70 61 74 69 61 6c 69 74 65 5f 67 75 me=spatialite_gu
0090: 69 22 3e 6d 61 69 6e 20 57 69 6b 69 20 70 61 67 i">main Wiki pag
00a0: 65 3c 2f 61 3e 3c 68 72 3e 3c 62 72 3e 0d 0a 3c e</a><hr><br>..<
00b0: 68 31 3e 43 68 61 6e 67 65 73 20 69 6e 74 72 6f h1>Changes intro
00c0: 64 75 63 65 64 20 73 74 61 72 74 69 6e 67 20 73 duced starting s
00d0: 69 6e 63 65 20 76 65 72 73 69 6f 6e 20 31 2e 38 ince version 1.8
00e0: 2e 30 3c 2f 68 31 3e 0d 0a 3c 68 32 3e 31 20 2d .0</h1>..<h2>1 -
00f0: 20 45 78 65 63 75 74 69 6e 67 20 6d 6f 72 65 20 Executing more
0100: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 69 SQL statements i
0110: 6e 20 61 20 73 69 6e 67 6c 65 20 73 68 6f 74 3c n a single shot<
0120: 2f 68 32 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 /h2>..<img src="
0130: 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 https://www.gaia
0140: 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e -gis.it/gaia-sin
0150: 73 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 s/spatialite-gui
0160: 2d 70 69 63 2f 6d 75 6c 74 69 2d 73 74 6d 74 2e -pic/multi-stmt.
0170: 70 6e 67 22 20 61 6c 74 3d 22 6d 75 6c 74 69 70 png" alt="multip
0180: 6c 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 le SQL statement
0190: 73 22 3e 3c 62 72 3e 0d 0a 54 68 65 20 65 78 65 s"><br>..The exe
01a0: 63 75 74 69 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 cution of multip
01b0: 6c 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 le SQL statement
01c0: 73 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 70 61 s in a single pa
01d0: 73 73 20 69 73 20 6e 6f 77 20 73 75 70 70 6f 72 ss is now suppor
01e0: 74 65 64 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e ted:..<ul>..<li>
01f0: 65 78 65 63 75 74 69 6f 6e 20 77 69 6c 6c 20 69 execution will i
0200: 6d 6d 65 64 69 61 74 65 6c 79 20 73 74 6f 70 20 mmediately stop
0210: 77 68 65 6e 20 73 6f 6d 65 20 53 51 4c 20 65 72 when some SQL er
0220: 72 6f 72 20 69 73 20 65 76 65 6e 74 75 61 6c 6c ror is eventuall
0230: 79 20 66 6f 75 6e 64 3b 20 74 68 69 73 20 70 72 y found; this pr
0240: 61 63 74 69 63 61 6c 6c 79 20 6d 65 61 6e 73 20 actically means
0250: 74 68 61 74 20 73 6f 6d 65 20 73 74 61 74 65 6d that some statem
0260: 65 6e 74 73 20 63 6f 75 6c 64 20 62 65 20 65 66 ents could be ef
0270: 66 65 63 74 69 76 65 6c 79 20 70 72 6f 63 65 73 fectively proces
0280: 73 65 64 2c 20 77 68 69 6c 65 20 6f 74 68 65 72 sed, while other
0290: 20 73 74 61 74 65 6d 65 6e 74 73 20 63 6f 75 6c statements coul
02a0: 64 20 62 65 20 69 67 6e 6f 72 65 64 20 64 75 65 d be ignored due
02b0: 20 74 6f 20 70 72 65 6d 61 74 75 72 65 20 74 65 to premature te
02c0: 72 6d 69 6e 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d rmination.</li>.
02d0: 0a 3c 6c 69 3e 6f 6e 6c 79 20 74 68 65 20 3c 75 .<li>only the <u
02e0: 3e 3c 69 3e 72 65 73 75 6c 74 73 65 74 3c 2f 69 ><i>resultset</i
02f0: 3e 3c 2f 75 3e 20 28 69 66 20 61 6e 79 29 20 72 ></u> (if any) r
0300: 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 6d eturned by the m
0310: 6f 73 74 20 72 65 63 65 6e 74 20 53 51 4c 20 73 ost recent SQL s
0320: 74 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 20 73 tatement being s
0330: 75 63 63 65 73 73 66 75 6c 6c 79 20 65 78 65 63 uccessfully exec
0340: 75 74 65 64 20 77 69 6c 6c 20 62 65 20 73 68 6f uted will be sho
0350: 77 6e 20 69 6e 20 74 68 65 20 70 61 6e 65 6c 2e wn in the panel.
0360: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 65 78 70 6c 69 </li>..<li>expli
0370: 63 69 74 6c 79 20 74 65 72 6d 69 6e 61 74 69 6e citly terminatin
0380: 67 20 65 61 63 68 20 73 69 6e 67 6c 65 20 53 51 g each single SQ
0390: 4c 20 73 74 61 74 65 6d 65 6e 74 20 62 79 20 69 L statement by i
03a0: 6e 73 65 72 74 69 6e 67 20 61 20 3c 75 3e 3c 69 nserting a <u><i
03b0: 3e 73 65 6d 69 2d 63 6f 6c 6f 6e 3c 2f 69 3e 3c >semi-colon</i><
03c0: 2f 75 3e 20 28 3c 62 3e 3b 3c 2f 62 3e 29 20 69 /u> (<b>;</b>) i
03d0: 73 20 61 6e 20 61 6c 77 61 79 73 20 73 75 67 67 s an always sugg
03e0: 65 73 74 65 64 20 67 6f 6f 64 20 70 72 61 63 74 ested good pract
03f0: 69 63 65 20 77 68 65 6e 20 65 78 65 63 75 74 69 ice when executi
0400: 6e 67 20 6d 75 6c 74 69 70 6c 65 20 73 74 61 74 ng multiple stat
0410: 65 6d 65 6e 74 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f ements.</li>..</
0420: 75 6c 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c ul><br>..<hr>..<
0430: 68 32 3e 32 20 2d 20 44 42 20 63 6f 6e 6e 65 63 h2>2 - DB connec
0440: 74 69 6f 6e 73 20 61 6e 64 20 53 65 63 75 72 69 tions and Securi
0450: 74 79 20 6d 6f 64 65 73 3c 2f 68 32 3e 0d 0a 41 ty modes</h2>..A
0460: 73 20 79 6f 75 20 70 72 6f 62 61 62 6c 79 20 72 s you probably r
0470: 65 6d 65 6d 62 65 72 2c 20 74 68 65 72 65 20 61 emember, there a
0480: 72 65 20 66 65 77 20 53 51 4c 20 66 75 6e 63 74 re few SQL funct
0490: 69 6f 6e 73 20 73 75 70 70 6f 72 74 65 64 20 62 ions supported b
04a0: 79 20 53 70 61 74 69 61 4c 69 74 65 20 74 68 61 y SpatiaLite tha
04b0: 74 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c t could eventual
04c0: 6c 79 20 70 6f 73 65 20 73 6f 6d 65 20 73 65 63 ly pose some sec
04d0: 75 72 69 74 79 20 63 6f 6e 63 65 72 6e 20 62 65 urity concern be
04e0: 63 61 75 73 65 20 74 68 65 79 20 69 6d 70 6c 65 cause they imple
04f0: 6d 65 6e 74 20 73 6f 6d 65 20 6b 69 6e 64 20 6f ment some kind o
0500: 66 20 64 69 72 65 63 74 20 64 61 74 61 20 65 78 f direct data ex
0510: 63 68 61 6e 67 65 20 62 65 74 77 65 65 6e 20 74 change between t
0520: 68 65 20 44 42 20 61 6e 64 20 74 68 65 20 6c 6f he DB and the lo
0530: 63 61 6c 20 66 69 6c 65 2d 73 79 73 74 65 6d 2e cal file-system.
0540: 3c 62 72 3e 0d 0a 49 6e 20 74 68 65 20 77 6f 72 <br>..In the wor
0550: 73 74 20 70 6f 73 73 69 62 6c 65 20 73 63 65 6e st possible scen
0560: 61 72 69 6f 20 61 6e 20 68 79 70 6f 74 68 65 74 ario an hypothet
0570: 69 63 61 6c 20 68 61 63 6b 65 72 20 63 6f 75 6c ical hacker coul
0580: 64 20 65 76 65 6e 74 75 61 6c 6c 79 20 61 74 74 d eventually att
0590: 65 6d 70 74 20 74 6f 20 61 74 74 61 63 6b 20 61 empt to attack a
05a0: 6e 20 65 78 74 65 72 6e 61 6c 20 73 79 73 74 65 n external syste
05b0: 6d 20 62 79 20 6f 66 66 65 72 69 6e 67 20 66 6f m by offering fo
05c0: 72 20 64 6f 77 6e 6c 6f 61 64 20 61 20 70 75 72 r download a pur
05d0: 70 6f 73 65 6c 79 20 66 6f 72 67 65 64 20 53 70 posely forged Sp
05e0: 61 74 69 61 4c 69 74 65 20 44 42 20 63 6f 6e 74 atiaLite DB cont
05f0: 61 69 6e 69 6e 67 20 6d 61 6c 69 63 69 6f 75 73 aining malicious
0600: 6c 79 20 66 6f 72 67 65 64 20 54 72 69 67 67 65 ly forged Trigge
0610: 72 73 2c 20 61 6e 64 20 74 68 65 20 75 73 65 72 rs, and the user
0620: 20 77 69 6c 6c 20 74 68 65 6e 20 62 65 20 63 6f will then be co
0630: 6d 70 6c 65 74 65 6c 79 20 75 6e 61 77 61 72 65 mpletely unaware
0640: 20 6f 66 20 73 75 63 68 20 61 20 70 6f 74 65 6e of such a poten
0650: 74 69 61 6c 6c 79 20 64 61 6e 67 65 72 6f 75 73 tially dangerous
0660: 20 74 68 72 65 61 74 2e 3c 62 72 3e 3c 62 72 3e threat.<br><br>
0670: 0d 0a 54 68 65 20 73 74 61 6e 64 61 72 64 20 61 ..The standard a
0680: 70 70 72 6f 61 63 68 20 69 6d 70 6c 65 6d 65 6e pproach implemen
0690: 74 65 64 20 62 79 20 3c 75 3e 3c 69 3e 6c 69 62 ted by <u><i>lib
06a0: 73 74 70 61 74 69 61 6c 69 74 65 3c 2f 69 3e 3c stpatialite</i><
06b0: 2f 75 3e 20 69 73 20 74 68 65 20 6f 6e 65 20 74 /u> is the one t
06c0: 6f 20 61 6c 77 61 79 73 20 6b 65 65 70 20 63 6f o always keep co
06d0: 6d 70 6c 65 74 65 6c 79 20 64 69 73 61 62 6c 65 mpletely disable
06e0: 64 20 61 6c 6c 20 74 68 65 73 65 20 70 6f 74 65 d all these pote
06f0: 6e 74 69 61 6c 6c 79 20 68 61 72 6d 66 75 6c 20 ntially harmful
0700: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 2c 20 75 SQL functions, u
0710: 6e 6c 65 73 73 20 74 68 65 20 3c 75 3e 3c 69 3e nless the <u><i>
0720: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari
0730: 61 62 6c 65 3c 2f 69 3e 3c 2f 75 3e 20 3c 62 3e able</i></u> <b>
0740: 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 SPATIALITE_SECUR
0750: 49 54 59 3d 3c 69 3e 72 65 6c 61 78 65 64 3c 2f ITY=<i>relaxed</
0760: 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 63 i></b> is explic
0770: 69 74 6c 79 20 73 65 74 20 62 79 20 74 68 65 20 itly set by the
0780: 75 73 65 72 2e 3c 62 72 3e 0d 0a 4e 6f 77 20 3c user.<br>..Now <
0790: 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 75 69 b>spatialite_gui
07a0: 3c 2f 62 3e 20 73 75 70 70 6f 72 74 20 61 20 73 </b> support a s
07b0: 6d 61 72 74 65 72 20 61 6e 64 20 65 61 73 69 65 marter and easie
07c0: 73 74 20 61 70 70 72 6f 61 63 68 2c 20 63 6f 6d st approach, com
07d0: 70 6c 65 74 65 6c 79 20 62 61 73 65 64 20 6f 6e pletely based on
07e0: 20 69 6e 74 65 72 6e 61 6c 20 61 63 74 69 6f 6e internal action
07f0: 73 20 61 6e 64 20 6e 6f 20 6c 6f 6e 67 65 72 20 s and no longer
0800: 72 65 71 75 69 72 69 6e 67 20 61 6e 79 20 65 78 requiring any ex
0810: 70 6c 69 63 69 74 20 75 73 65 72 20 61 63 74 69 plicit user acti
0820: 6f 6e 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 69 6d on.<br><br>..<im
0830: 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 g src="https://w
0840: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 ww.gaia-gis.it/g
0850: 61 69 61 2d 73 69 6e 73 2f 73 70 61 74 69 61 6c aia-sins/spatial
0860: 69 74 65 2d 67 75 69 2d 70 69 63 2f 73 65 63 75 ite-gui-pic/secu
0870: 72 69 74 79 2d 6e 6f 74 2d 63 6f 6e 6e 65 63 74 rity-not-connect
0880: 65 64 2e 70 6e 67 22 20 61 6c 74 3d 22 6e 6f 74 ed.png" alt="not
0890: 20 63 6f 6e 6e 65 63 74 65 64 22 3e 3c 62 72 3e connected"><br>
08a0: 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 ..<u>Please note
08b0: 3c 2f 75 3e 3a 20 6e 6f 77 20 61 20 73 6d 61 6c </u>: now a smal
08c0: 6c 20 3c 75 3e 3c 69 3e 69 63 6f 6e 3c 2f 69 3e l <u><i>icon</i>
08d0: 3c 2f 75 3e 20 61 6c 77 61 79 73 20 73 68 6f 77 </u> always show
08e0: 73 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 s the status of
08f0: 74 68 65 20 63 75 72 72 65 6e 74 20 44 42 20 43 the current DB C
0900: 6f 6e 6e 65 63 74 69 6f 6e 2e 0d 0a 3c 68 33 3e onnection...<h3>
0910: 63 61 73 65 20 41 29 20 63 6f 6e 6e 65 63 74 69 case A) connecti
0920: 6e 67 20 74 6f 20 61 20 73 61 6e 65 20 44 42 3c ng to a sane DB<
0930: 2f 68 33 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 /h3>..<img src="
0940: 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 https://www.gaia
0950: 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e -gis.it/gaia-sin
0960: 73 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 s/spatialite-gui
0970: 2d 70 69 63 2f 73 65 63 75 72 69 74 79 2d 72 65 -pic/security-re
0980: 6c 61 78 65 64 2e 70 6e 67 22 20 61 6c 74 3d 22 laxed.png" alt="
0990: 73 65 63 75 72 69 74 79 20 72 65 6c 61 78 65 64 security relaxed
09a0: 22 3e 3c 62 72 3e 0d 0a 3c 62 3e 73 70 61 74 69 "><br>..<b>spati
09b0: 61 6c 69 74 65 5f 67 75 69 3c 2f 62 3e 20 77 69 alite_gui</b> wi
09c0: 6c 6c 20 6e 6f 77 20 61 6c 77 61 79 73 20 70 65 ll now always pe
09d0: 72 66 6f 72 6d 20 61 20 70 72 65 6c 69 6d 69 6e rform a prelimin
09e0: 61 72 79 20 73 61 6e 69 74 79 20 63 68 65 63 6b ary sanity check
09f0: 20 3c 62 3e 62 65 66 6f 72 65 3c 2f 62 3e 20 63 <b>before</b> c
0a00: 6f 6e 6e 65 63 74 69 6e 67 20 61 6e 79 20 61 6c onnecting any al
0a10: 72 65 61 64 79 20 65 78 69 73 74 69 6e 67 20 44 ready existing D
0a20: 42 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 66 B...<ul>..<li>if
0a30: 20 6e 6f 20 61 63 74 75 61 6c 20 74 68 72 65 61 no actual threa
0a40: 74 20 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 6e t is found, then
0a50: 20 3c 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 <b>spatialite_g
0a60: 75 69 3c 2f 62 3e 20 77 69 6c 6c 20 61 75 74 6f ui</b> will auto
0a70: 6d 61 74 69 63 61 6c 6c 79 20 65 6e 61 62 6c 65 matically enable
0a80: 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 <b>SPATIALITE_S
0a90: 45 43 55 52 49 54 59 3d 3c 69 3e 72 65 6c 61 78 ECURITY=<i>relax
0aa0: 65 64 3c 2f 69 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d ed</i></b></li>.
0ab0: 0a 3c 6c 69 3e 74 68 75 73 20 61 6c 6c 6f 77 69 .<li>thus allowi
0ac0: 6e 67 20 74 68 65 20 75 73 65 72 20 74 6f 20 66 ng the user to f
0ad0: 72 65 65 6c 79 20 69 6e 76 6f 6b 65 20 61 6c 6c reely invoke all
0ae0: 20 73 65 63 75 72 69 74 79 2d 72 65 6c 61 74 65 security-relate
0af0: 64 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 d SQL functions
0b00: 77 69 74 68 6f 75 74 20 61 6e 79 20 72 65 73 74 without any rest
0b10: 72 69 63 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c riction.</li>..<
0b20: 6c 69 3e 69 6e 20 74 68 69 73 20 63 61 73 65 20 li>in this case
0b30: 74 68 65 20 3c 75 3e 3c 69 3e 63 6f 6e 6e 65 63 the <u><i>connec
0b40: 74 69 6f 6e 20 69 63 6f 6e 3c 2f 69 3e 3c 2f 75 tion icon</i></u
0b50: 3e 20 77 69 6c 6c 20 62 65 20 74 68 65 20 6f 6e > will be the on
0b60: 65 20 73 68 6f 77 6e 20 69 6e 20 74 68 69 73 20 e shown in this
0b70: 66 69 67 75 72 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f figure.</li>..</
0b80: 75 6c 3e 0d 0a 3c 68 33 3e 63 61 73 65 20 42 29 ul>..<h3>case B)
0b90: 20 73 74 61 72 74 69 6e 67 20 61 20 52 45 41 44 starting a READ
0ba0: 20 4f 4e 4c 59 20 44 42 20 63 6f 6e 6e 65 63 74 ONLY DB connect
0bb0: 69 6f 6e 3c 2f 68 33 3e 0d 0a 3c 69 6d 67 20 73 ion</h3>..<img s
0bc0: 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e rc="https://www.
0bd0: 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 gaia-gis.it/gaia
0be0: 2d 73 69 6e 73 2f 73 70 61 74 69 61 6c 69 74 65 -sins/spatialite
0bf0: 2d 67 75 69 2d 70 69 63 2f 73 65 63 75 72 69 74 -gui-pic/securit
0c00: 79 2d 72 64 6f 6e 6c 79 2e 70 6e 67 22 20 61 6c y-rdonly.png" al
0c10: 74 3d 22 73 65 63 75 72 69 74 79 20 72 65 61 64 t="security read
0c20: 20 6f 6e 6c 79 22 3e 3c 62 72 3e 0d 0a 3c 75 6c only"><br>..<ul
0c30: 3e 0d 0a 3c 6c 69 3e 61 6e 79 77 61 79 20 77 68 >..<li>anyway wh
0c40: 65 6e 65 76 65 72 20 61 20 3c 62 3e 52 45 41 44 enever a <b>READ
0c50: 20 4f 4e 4c 59 3c 2f 62 3e 20 63 6f 6e 6e 65 63 ONLY</b> connec
0c60: 74 69 6f 6e 20 69 73 20 65 73 74 61 62 6c 69 73 tion is establis
0c70: 68 65 64 20 74 68 65 20 6f 72 64 69 6e 61 72 79 hed the ordinary
0c80: 20 73 65 63 75 72 69 74 79 20 72 65 73 74 72 69 security restri
0c90: 63 74 69 6f 6e 73 20 77 69 6c 6c 20 61 6c 77 61 ctions will alwa
0ca0: 79 73 20 62 65 20 65 6e 66 6f 72 63 65 64 2e 3c ys be enforced.<
0cb0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 74 68 69 /li>..<li>in thi
0cc0: 73 20 63 61 73 65 20 74 68 65 20 3c 75 3e 3c 69 s case the <u><i
0cd0: 3e 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 63 6f 6e >connection icon
0ce0: 3c 2f 69 3e 3c 2f 75 3e 20 77 69 6c 6c 20 62 65 </i></u> will be
0cf0: 20 74 68 65 20 6f 6e 65 20 73 68 6f 77 6e 20 69 the one shown i
0d00: 6e 20 74 68 69 73 20 66 69 67 75 72 65 2e 3c 2f n this figure.</
0d10: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 68 33 3e li>..</ul>..<h3>
0d20: 63 61 73 65 20 43 29 20 63 6f 6e 6e 65 63 74 69 case C) connecti
0d30: 6e 67 20 74 6f 20 61 20 70 6f 74 65 6e 74 69 61 ng to a potentia
0d40: 6c 6c 79 20 68 61 72 6d 66 75 6c 20 44 42 3c 2f lly harmful DB</
0d50: 68 33 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 68 h3>..<img src="h
0d60: 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d ttps://www.gaia-
0d70: 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e 73 gis.it/gaia-sins
0d80: 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 2d /spatialite-gui-
0d90: 70 69 63 2f 73 65 63 75 72 69 74 79 2d 61 6c 65 pic/security-ale
0da0: 72 74 2e 70 6e 67 22 20 61 6c 74 3d 22 73 65 63 rt.png" alt="sec
0db0: 75 72 69 74 79 20 61 6c 65 72 74 22 3e 3c 62 72 urity alert"><br
0dc0: 3e 0d 0a 49 6e 20 74 68 65 20 75 6e 6c 75 63 6b >..In the unluck
0dd0: 79 20 63 61 73 65 20 74 68 61 74 20 74 68 65 20 y case that the
0de0: 70 72 65 6c 69 6d 69 6e 61 72 79 20 73 65 63 75 preliminary secu
0df0: 72 69 74 79 20 63 68 65 63 6b 20 77 6f 75 6c 64 rity check would
0e00: 20 69 64 65 6e 74 69 66 79 20 73 6f 6d 65 20 70 identify some p
0e10: 72 6f 62 6c 65 6d 61 74 69 63 20 54 72 69 67 67 roblematic Trigg
0e20: 65 72 2c 20 61 6e 20 61 70 70 72 6f 70 72 69 61 er, an appropria
0e30: 74 65 20 3c 75 3e 3c 69 3e 73 65 63 75 72 69 74 te <u><i>securit
0e40: 79 20 61 6c 65 72 74 3c 2f 69 3e 3c 2f 75 3e 20 y alert</i></u>
0e50: 77 69 6c 6c 20 62 65 20 69 6d 6d 65 64 69 61 74 will be immediat
0e60: 65 6c 79 20 72 61 69 73 65 64 2e 3c 62 72 3e 3c ely raised.<br><
0e70: 62 72 3e 20 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 br> ..<img src="
0e80: 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 https://www.gaia
0e90: 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e -gis.it/gaia-sin
0ea0: 73 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 s/spatialite-gui
0eb0: 2d 70 69 63 2f 73 65 63 75 72 69 74 79 2d 6c 6f -pic/security-lo
0ec0: 63 6b 2e 70 6e 67 22 20 61 6c 74 3d 22 73 65 63 ck.png" alt="sec
0ed0: 75 72 69 74 79 20 6c 6f 63 6b 22 3e 3c 62 72 3e urity lock"><br>
0ee0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 6e 20 74 ..<ul>..<li>in t
0ef0: 68 69 73 20 63 61 73 65 20 74 68 65 20 6f 72 64 his case the ord
0f00: 69 6e 61 72 79 20 73 65 63 75 72 69 74 79 20 72 inary security r
0f10: 65 73 74 72 69 63 74 69 6f 6e 73 20 77 69 6c 6c estrictions will
0f20: 20 61 6c 77 61 79 73 20 62 65 20 65 6e 66 6f 72 always be enfor
0f30: 63 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 ced.</li>..<li>t
0f40: 68 65 20 3c 75 3e 3c 69 3e 63 6f 6e 6e 65 63 74 he <u><i>connect
0f50: 69 6f 6e 20 69 63 6f 6e 3c 2f 69 3e 3c 2f 75 3e ion icon</i></u>
0f60: 20 77 69 6c 6c 20 62 65 20 74 68 65 20 6f 6e 65 will be the one
0f70: 20 73 68 6f 77 6e 20 69 6e 20 74 68 69 73 20 66 shown in this f
0f80: 69 67 75 72 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 igure.</li>..<li
0f90: 3e 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 ><u>Please note
0fa0: 77 65 6c 6c 3c 2f 75 3e 3a 20 61 6e 79 77 61 79 well</u>: anyway
0fb0: 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 28 69 2e an external (i.
0fc0: 65 2e 20 66 72 6f 6d 20 74 68 65 20 63 6f 6d 6d e. from the comm
0fd0: 61 6e 64 20 73 68 65 6c 6c 29 20 3c 62 3e 53 50 and shell) <b>SP
0fe0: 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 ATIALITE_SECURIT
0ff0: 59 3d 3c 69 3e 72 65 6c 61 78 65 64 3c 2f 69 3e Y=<i>relaxed</i>
1000: 3c 2f 62 3e 20 64 65 63 6c 61 72 61 74 69 6f 6e </b> declaration
1010: 20 77 69 6c 6c 20 73 74 69 6c 6c 20 63 6f 6e 74 will still cont
1020: 69 6e 75 65 20 74 6f 20 62 65 20 68 6f 6e 6f 72 inue to be honor
1030: 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d ed.</li>..</ul>.
1040: 0a 3c 68 32 3e 33 20 2d 20 52 61 73 74 65 72 4c .<h2>3 - RasterL
1050: 69 74 65 32 20 69 6e 74 65 67 72 61 74 65 64 20 ite2 integrated
1060: 73 75 70 70 6f 72 74 3c 2f 68 32 3e 0d 0a 53 74 support</h2>..St
1070: 61 72 74 69 6e 67 20 73 69 6e 63 65 20 76 65 72 arting since ver
1080: 73 69 6f 6e 20 3c 62 3e 31 2e 38 2e 30 3c 2f 62 sion <b>1.8.0</b
1090: 3e 20 3c 69 3e 6c 69 62 72 61 73 74 65 72 6c 69 > <i>librasterli
10a0: 74 65 32 3c 2f 69 3e 20 62 65 63 6f 6d 65 73 20 te2</i> becomes
10b0: 69 6e 74 65 67 72 61 6c 20 70 61 72 74 20 6f 66 integral part of
10c0: 20 3c 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 <b>spatialite_g
10d0: 75 69 3c 2f 62 3e 20 28 69 2e 65 2e 20 69 74 20 ui</b> (i.e. it
10e0: 77 69 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6e 6f will become a no
10f0: 74 20 63 6f 6e 66 69 67 75 72 61 62 6c 65 20 6d t configurable m
1100: 61 6e 64 61 74 6f 72 79 20 64 65 70 65 6e 64 65 andatory depende
1110: 6e 63 79 29 2e 0d 0a 3c 68 33 3e 33 2e 31 20 2d ncy)...<h3>3.1 -
1120: 20 52 61 73 74 65 72 20 43 6f 76 65 72 61 67 65 Raster Coverage
1130: 73 3c 2f 68 33 3e 0d 0a 3c 69 6d 67 20 73 72 63 s</h3>..<img src
1140: 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 ="https://www.ga
1150: 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 ia-gis.it/gaia-s
1160: 69 6e 73 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 ins/spatialite-g
1170: 75 69 2d 70 69 63 2f 72 61 73 74 65 72 2d 63 6f ui-pic/raster-co
1180: 76 65 72 61 67 65 73 2d 31 2e 70 6e 67 22 20 61 verages-1.png" a
1190: 6c 74 3d 22 72 61 73 74 65 72 20 63 6f 76 65 72 lt="raster cover
11a0: 61 67 65 73 20 31 22 3e 3c 62 72 3e 0d 0a 41 6c ages 1"><br>..Al
11b0: 6c 20 52 61 73 74 65 72 43 6f 76 65 72 61 67 65 l RasterCoverage
11c0: 2d 72 65 6c 61 74 65 64 20 74 61 62 6c 65 73 20 -related tables
11d0: 77 69 6c 6c 20 62 65 20 68 69 65 72 61 72 63 68 will be hierarch
11e0: 69 63 61 6c 6c 79 20 67 72 6f 75 70 65 64 20 6f ically grouped o
11f0: 6e 20 61 20 64 69 73 74 69 6e 63 74 20 62 72 61 n a distinct bra
1200: 6e 63 68 20 6f 66 20 74 68 65 20 54 61 62 6c 65 nch of the Table
1210: 73 20 54 72 65 65 2e 3c 62 72 3e 3c 62 72 3e 0d s Tree.<br><br>.
1220: 0a 3c 69 6d 67 20 73 72 63 3d 22 68 74 74 70 73 .<img src="https
1230: 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e ://www.gaia-gis.
1240: 69 74 2f 67 61 69 61 2d 73 69 6e 73 2f 73 70 61 it/gaia-sins/spa
1250: 74 69 61 6c 69 74 65 2d 67 75 69 2d 70 69 63 2f tialite-gui-pic/
1260: 72 61 73 74 65 72 2d 63 6f 76 65 72 61 67 65 73 raster-coverages
1270: 2d 32 2e 70 6e 67 22 20 61 6c 74 3d 22 72 61 73 -2.png" alt="ras
1280: 74 65 72 20 63 6f 76 65 72 61 67 65 73 20 32 22 ter coverages 2"
1290: 3e 3c 62 72 3e 0d 0a 41 64 6d 69 6e 69 73 74 65 ><br>..Administe
12a0: 72 69 6e 67 20 61 6c 6c 20 3c 75 3e 3c 69 3e 53 ring all <u><i>S
12b0: 4c 44 2f 53 45 20 53 74 79 6c 65 73 3c 2f 69 3e LD/SE Styles</i>
12c0: 3c 2f 75 3e 20 66 6f 72 20 65 61 63 68 20 73 69 </u> for each si
12d0: 6e 67 6c 65 20 52 61 73 74 65 72 20 43 6f 76 65 ngle Raster Cove
12e0: 72 61 67 65 20 77 69 6c 6c 20 6e 6f 77 20 62 65 rage will now be
12f0: 20 64 69 72 65 63 74 6c 79 20 61 63 63 65 73 73 directly access
1300: 69 62 6c 65 20 76 69 61 20 74 68 65 20 63 6f 72 ible via the cor
1310: 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6e 74 65 responding conte
1320: 78 74 20 6d 65 6e 75 2e 0d 0a 3c 68 33 3e 33 2e xt menu...<h3>3.
1330: 32 20 2d 20 53 4c 44 2f 53 45 20 53 74 79 6c 65 2 - SLD/SE Style
1340: 73 20 61 64 6d 69 6e 69 73 74 72 61 74 69 6f 6e s administration
1350: 3c 2f 68 33 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d </h3>..<img src=
1360: 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 "https://www.gai
1370: 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 a-gis.it/gaia-si
1380: 6e 73 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 ns/spatialite-gu
1390: 69 2d 70 69 63 2f 72 61 73 74 65 72 2d 73 74 79 i-pic/raster-sty
13a0: 6c 65 73 2d 31 2e 70 6e 67 22 20 61 6c 74 3d 22 les-1.png" alt="
13b0: 72 61 73 74 65 72 20 73 74 79 6c 65 73 20 31 22 raster styles 1"
13c0: 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 ><br>..<ul>..<li
13d0: 3e 74 68 69 73 20 3c 75 3e 3c 69 3e 64 69 61 6c >this <u><i>dial
13e0: 6f 67 20 62 6f 78 3c 2f 69 3e 3c 2f 75 3e 20 77 og box</i></u> w
13f0: 69 6c 6c 20 72 65 70 6f 72 74 20 61 6c 6c 20 53 ill report all S
1400: 4c 44 2f 53 45 20 53 74 79 6c 65 73 20 64 65 66 LD/SE Styles def
1410: 69 6e 65 64 20 66 6f 72 20 65 61 63 68 20 73 69 ined for each si
1420: 6e 67 6c 65 20 52 61 73 74 65 72 20 43 6f 76 65 ngle Raster Cove
1430: 72 61 67 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e rage.</li>..<li>
1440: 61 6e 64 20 74 68 65 20 73 61 6d 65 20 64 69 61 and the same dia
1450: 6c 6f 67 20 63 6f 75 6c 64 20 62 65 20 75 73 65 log could be use
1460: 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 64 d in order to ad
1470: 64 20 28 6f 72 20 65 76 65 6e 20 72 65 6d 6f 76 d (or even remov
1480: 65 29 20 53 4c 44 2f 53 45 20 53 74 79 6c 65 73 e) SLD/SE Styles
1490: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c .</li>..</ul>..<
14a0: 62 72 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 68 br>..<img src="h
14b0: 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d ttps://www.gaia-
14c0: 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e 73 gis.it/gaia-sins
14d0: 2f 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 2d /spatialite-gui-
14e0: 70 69 63 2f 72 61 73 74 65 72 2d 73 74 79 6c 65 pic/raster-style
14f0: 73 2d 32 2e 70 6e 67 22 20 61 6c 74 3d 22 72 61 s-2.png" alt="ra
1500: 73 74 65 72 20 73 74 79 6c 65 73 20 32 22 3e 3c ster styles 2"><
1510: 62 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e br>..<u>Please n
1520: 6f 74 65 3c 2f 75 3e 3a 20 77 68 65 6e 20 69 6d ote</u>: when im
1530: 70 6f 72 74 69 6e 67 20 65 78 74 65 72 6e 61 6c porting external
1540: 20 53 4c 44 2f 53 45 20 53 74 79 6c 65 73 20 73 SLD/SE Styles s
1550: 65 6c 65 63 74 69 6e 67 20 6d 6f 72 65 20 66 69 electing more fi
1560: 6c 65 73 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 les in a single
1570: 70 61 73 73 20 69 73 20 61 20 73 75 70 70 6f 72 pass is a suppor
1580: 74 65 64 20 6f 70 74 69 6f 6e 2e 0d 0a 3c 68 33 ted option...<h3
1590: 3e 33 2e 33 20 2d 20 43 6f 76 65 72 61 67 65 20 >3.3 - Coverage
15a0: 54 69 6c 65 73 20 50 72 65 76 69 65 77 3c 2f 68 Tiles Preview</h
15b0: 33 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 68 74 3>..<img src="ht
15c0: 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 tps://www.gaia-g
15d0: 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e 73 2f is.it/gaia-sins/
15e0: 73 70 61 74 69 61 6c 69 74 65 2d 67 75 69 2d 70 spatialite-gui-p
15f0: 69 63 2f 74 69 6c 65 2d 70 72 65 76 69 65 77 2d ic/tile-preview-
1600: 31 2e 70 6e 67 22 20 61 6c 74 3d 22 74 69 6c 65 1.png" alt="tile
1610: 20 70 72 65 76 69 65 77 20 31 22 3e 3c 62 72 3e preview 1"><br>
1620: 0d 0a 46 6f 72 20 65 61 63 68 20 3c 62 3e 26 6c ..For each <b>&l
1630: 74 3b 3c 69 3e 63 6f 76 65 72 61 67 65 2d 70 72 t;<i>coverage-pr
1640: 65 66 69 78 3c 2f 69 3e 26 67 74 3b 5f 74 69 6c efix</i>>_til
1650: 65 5f 64 61 74 61 3c 2f 62 3e 20 74 61 62 6c 65 e_data</b> table
1660: 20 28 74 68 65 20 6f 6e 65 20 65 66 66 65 63 74 (the one effect
1670: 69 76 65 6c 79 20 63 6f 6e 74 61 69 6e 69 6e 67 ively containing
1680: 20 72 61 73 74 65 72 20 74 69 6c 65 73 29 20 61 raster tiles) a
1690: 20 3c 62 3e 70 72 65 76 69 65 77 3c 2f 62 3e 20 <b>preview</b>
16a0: 66 65 61 74 75 72 65 20 69 73 20 73 75 70 70 6f feature is suppo
16b0: 72 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c rted.<br><br>..<
16c0: 69 6d 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f img src="https:/
16d0: 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 /www.gaia-gis.it
16e0: 2f 67 61 69 61 2d 73 69 6e 73 2f 73 70 61 74 69 /gaia-sins/spati
16f0: 61 6c 69 74 65 2d 67 75 69 2d 70 69 63 2f 74 69 alite-gui-pic/ti
1700: 6c 65 2d 70 72 65 76 69 65 77 2d 32 2e 6a 70 67 le-preview-2.jpg
1710: 22 20 61 6c 74 3d 22 74 69 6c 65 20 70 72 65 76 " alt="tile prev
1720: 69 65 77 20 32 22 3e 3c 62 72 3e 0d 0a 45 61 63 iew 2"><br>..Eac
1730: 68 20 74 69 6c 65 20 77 69 6c 6c 20 62 65 20 73 h tile will be s
1740: 68 6f 77 6e 20 61 63 63 6f 72 64 69 6e 67 6c 79 hown accordingly
1750: 20 74 6f 20 74 68 65 20 43 6f 76 65 72 61 67 65 to the Coverage
1760: 27 73 20 3c 75 3e 3c 69 3e 64 65 66 61 75 6c 74 's <u><i>default
1770: 3c 2f 69 3e 3c 2f 75 3e 20 73 74 79 6c 65 2e 3c </i></u> style.<
1780: 62 72 3e 3c 62 72 3e 0d 0a 3c 69 6d 67 20 73 72 br><br>..<img sr
1790: 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 c="https://www.g
17a0: 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d aia-gis.it/gaia-
17b0: 73 69 6e 73 2f 73 70 61 74 69 61 6c 69 74 65 2d sins/spatialite-
17c0: 67 75 69 2d 70 69 63 2f 74 69 6c 65 2d 70 72 65 gui-pic/tile-pre
17d0: 76 69 65 77 2d 33 2e 70 6e 67 22 20 61 6c 74 3d view-3.png" alt=
17e0: 22 74 69 6c 65 20 70 72 65 76 69 65 77 20 33 22 "tile preview 3"
17f0: 3e 3c 62 72 3e 0d 0a 49 6e 20 74 68 65 20 73 70 ><br>..In the sp
1800: 65 63 69 61 6c 20 63 61 73 65 20 6f 66 20 74 69 ecial case of ti
1810: 6c 65 73 20 61 64 6f 70 74 69 6e 67 20 73 6f 6d les adopting som
1820: 65 20 65 78 6f 74 69 63 20 70 69 78 65 6c 20 66 e exotic pixel f
1830: 6f 72 6d 61 74 20 28 65 2e 67 2e 20 55 49 4e 54 ormat (e.g. UINT
1840: 33 32 2c 20 46 4c 4f 41 54 20 6f 72 20 44 4f 55 32, FLOAT or DOU
1850: 42 4c 45 29 20 61 20 64 65 66 61 75 6c 74 20 3c BLE) a default <
1860: 75 3e 3c 69 3e 67 72 61 79 73 63 61 6c 65 3c 2f u><i>grayscale</
1870: 69 3e 3c 2f 75 3e 20 72 65 6e 64 65 72 69 6e 67 i></u> rendering
1880: 20 77 69 6c 6c 20 62 65 20 61 64 6f 70 74 65 64 will be adopted
1890: 2e 3c 62 72 3e 0d 0a 49 6e 20 74 68 65 20 76 65 .<br>..In the ve
18a0: 72 79 20 73 70 65 63 69 61 6c 20 63 61 73 65 20 ry special case
18b0: 6f 66 20 3c 75 3e 3c 69 3e 6d 75 6c 74 69 2d 62 of <u><i>multi-b
18c0: 61 6e 64 3c 2f 69 3e 3c 2f 75 3e 20 70 69 78 65 and</i></u> pixe
18d0: 6c 73 20 6f 6e 6c 79 20 74 68 65 20 66 69 72 73 ls only the firs
18e0: 74 20 62 61 6e 64 20 28 3c 62 3e 42 61 6e 64 20 t band (<b>Band
18f0: 23 30 3c 2f 62 3e 29 20 77 69 6c 6c 20 62 65 20 #0</b>) will be
1900: 73 68 6f 77 6e 2e 0d 0a 3c 62 72 3e 3c 62 72 3e shown...<br><br>
1910: 3c 68 72 3e 0d 0a 42 61 63 6b 20 74 6f 20 3c 61 <hr>..Back to <a
1920: 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 href="https://w
1930: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 ww.gaia-gis.it/f
1940: 6f 73 73 69 6c 2f 73 70 61 74 69 61 6c 69 74 65 ossil/spatialite
1950: 5f 67 75 69 2f 77 69 6b 69 3f 6e 61 6d 65 3d 73 _gui/wiki?name=s
1960: 70 61 74 69 61 6c 69 74 65 5f 67 75 69 22 3e 6d patialite_gui">m
1970: 61 69 6e 20 57 69 6b 69 20 70 61 67 65 3c 2f 61 ain Wiki page</a
1980: 3e 0a 5a 20 62 66 63 65 61 62 61 32 61 66 65 37 >.Z bfceaba2afe7
1990: 31 30 30 33 62 35 62 35 66 65 34 35 36 33 61 30 1003b5b5fe4563a0
19a0: 65 39 39 62 0a e99b.