Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
t.connect(1)		    GRASS GIS User's Manual		  t.connect(1)

NAME
       t.connect   -  Prints/sets general temporal GIS database	connection for
       current mapset.

KEYWORDS
       temporal, settings, metadata

SYNOPSIS
       t.connect
       t.connect --help
       t.connect [-pcdg]  [driver=name]	  [database=name]   [--help]   [--ver-
       bose]  [--quiet]	 [--ui]

   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

       --help
	   Print usage summary

       --verbose
	   Verbose module output

       --quiet
	   Quiet module	output

       --ui
	   Force launching GUI dialog

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

       database=name
	   Name	of database
	   Default: $GISDBASE/$LOCATION_NAME/$MAPSET/tgis/sqlite.db

DESCRIPTION
       t.connect allows	the user to set	the temporal database connection.  The
       default setting is that the temporal database of	type  sqlite3  is  lo-
       cated in	the current mapset directory.

       The  -p	flag will display the current temporal database	connection pa-
       rameters.

       The -pg flag will display the current temporal database connection  pa-
       rameters	using shell style.

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

NOTES
       Setting	the connection with t.connect will not test the	connection for
       validity.  Hence	a database connection will not be established.

       The connection values are stored	in the mapset's	VAR file.  The -d flag
       will  set  the  default	TGIS connection	parameters.  A SQLite database
       "tgis/sqlite.db"	will be	created	in the current mapset  directory.   It
       will  be	 located in the	"tgis" sub-directory to	not interfere with the
       sqlite3 database	used for vector	attribute storage.

       In case you have	tens of	thousands of maps to register in the  temporal
       database	 or  you need concurrent read and write	access in the temporal
       database, consider to use a PostgreSQL connection instead.

       Be aware	that you have to set the PostgreSQL connection	explicitly  in
       every  mapset  that  should  store temporal information in the temporal
       database.

       PostgreSQL and SQLite databases can not be mixed	in a location.

EXAMPLES
   SQLite
       The SQLite database is created automatically when used the first	time.
       # use single quotes here
       t.connect driver=sqlite database='$GISDBASE/$LOCATION_NAME/PERMANENT/tgis/sqlite.db'
       t.connect -p
       t.info -s

   PostgreSQL
       When using a PostgreSQL database, the user 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, ThA1/4nen Institute of Climate-Smart Agriculture

SOURCE CODE
       Available at: t.connect source code (history)

       Main index | Temporal index | Topics index | Keywords index | Graphical
       index | Full index

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.3 Reference	Manual

GRASS 7.8.3							  t.connect(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLES | AUTHOR | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=t.connect&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help