RONCC
/
Geografic-Information-System


			
							1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
							<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS-SQLite driver</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>

<body bgcolor="white">

<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>

<h1>SQLite driver in GRASS</h1>

<H2>Creating a SQLite database</H2>

GRASS is automatically creating the SQLite database if it is not yet
existing when the first table is created in the SQLite database. It
is sufficient to define the connection (see next step).

<H2>Connecting GRASS to SQLite</H2>

The database name 'sqlite.db' is at user's choice.
Also the file storage location can be freely chosen. If the database
does not exist, it will be automatically created when database content
is created:

<div class="code"><pre>
# example for storing DB in mapset directory (keep single quotes):
db.connect driver=sqlite database='$GISDBASE/$LOCATION_NAME/$MAPSET/sqlite.db'
db.connect -p
</pre></div>

<H2>Supported SQL commands</H2>

All SQL commands supported by SQLite (for limitations, see
SQLite help page:
<a href="http://www.sqlite.org/lang.html">SQL As Understood By SQLite</a> and
<a href="http://www.sqlite.org/omitted.html">Unsupported SQL</a>).


<H2>Operators available in conditions</H2>

All SQL operators supported by SQLite.


<H2>Browsing table data in DB</H2>

A convenient SQLite front-end is <a href="http://sqlitebrowser.sourceforge.net/">sqlitebrowser</a>.
To open a DB file stored within the current mapset,
the following way is suggested (corresponds to above database connection):

<div class="code"><pre>
eval `g.gisenv`
# use double quotes:
sqlitebrowser "$GISDBASE/$LOCATION_NAME/$MAPSET"/sqlite.db
</pre></div>

<!-- doesnt work yet, why?:
  ah, pending patch: http://www.sqlite.org/cvstrac/tktview?tn=1476

<H2>Adding an unique ID column</H2>

Import vector module require an unique ID column which can
be generated as follows for a SQLite table:

<div class="code"><pre>
echo "
 ALTER TABLE mytable ADD ID integer;
 CREATE SEQUENCE mytable_seq;
 UPDATE mytabe SET ID = nextval('mytable_seq');
 DROP SEQUENCE mytable_seq;
" | db.execute
</pre></div>
-->

<H2>SEE ALSO</H2>

<em><a href="http://www.sqlite.org">SQLite web site</a>,
<a href="http://www.sqlite.org/quickstart.html">SQLite manual</a>,
<a HREF="db.connect.html">db.connect</a>,
<a HREF="db.execute.html">db.execute</a>,
<a HREF="sql.html">SQL support in GRASS GIS</a>,
<a HREF="http://www.sqlite.org/cvstrac/wiki?p=ManagementTools">sqlite - Management Tools</a>
</em>

<p><i>Last changed: $Date$</i>
<HR>
<BR><a href=index.html>Help Index</a>
</body>
</html>