GRASS logo

NAME

t.connect - Prints/sets general TGIS DB connection for current mapset.

KEYWORDS

database, attribute table, connection settings

SYNOPSIS

t.connect
t.connect help
t.connect [-pcdg] [driver=name] [database=name] [--verbose] [--quiet]

Flags:

-p
Print current connection parameters and exit
-c
Check connection parameters, set if uninitialized, and exit
-d
Set from default settings and exit
Overwrite current settings if initialized
-g
Print current connection parameter in shell style and exit
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

driver=name
Name of database driver
Options: sqlite, pg
database=name
Name of database

DESCRIPTION

t.connect allows the user to set the temporal GIS database connection.

NOTES

Values are stored in the mapset's VAR file; the connection is not tested for validity.

The -d flag will set the default TGIS connection parameters. A sqlite3 database "tgis.db" will be created in the PERMANET directory of the current location.

The -p flag will display the current TGIS connection parameters.

The -pg flag will display the current TGIS connection parameters using shell style.

The -c flag will silently check if the TGIS connection parameters have been set, and if not will set them to use GRASS's default values.

Note

The default TGIS database of type sqlite3 is located in the PERMANENT mapset directory. Temporal GIS content from all created mapsets will be stored here. In case you have thousends of maps to register in the temporal database or you need concurrent read and write access in the TGIS database, consider to use a postgresql database instead.

SQLite

t.connect driver=sqlite database='$GISDBASE/$LOCATION_NAME/PERMANENT/tgis.db'
t.connect -p
t.info -s

The SQLite database is created automatically when used the first time.

PostgreSQL

In case you use a postgresql database, you will need to specify the TGIS database connection for each mapset.
t.connect driver=pg database="dbname=grass_test user=soeren password=abcdefgh"
t.connect -p
t.info -s

AUTHOR

Soeren Gebbert, vTI/AK Braunschweig

Last changed: $Date: 2012-05-05 01:44:34 -0700 (Sat, 05 May 2012) $


Main index - Temporal index - Full index

© 2003-2012 GRASS Development Team