1t.connect(1)                  Grass User's Manual                 t.connect(1)
2
3
4

NAME

6       t.connect   -  Prints/sets general temporal GIS database connection for
7       current mapset.
8

KEYWORDS

10       temporal, settings, metadata
11

SYNOPSIS

13       t.connect
14       t.connect --help
15       t.connect [-pcdg]  [driver=name]   [database=name]   [--help]   [--ver‐
16       bose]  [--quiet]  [--ui]
17
18   Flags:
19       -p
20           Print current connection parameters and exit
21
22       -c
23           Check connection parameters, set if uninitialized, and exit
24
25       -d
26           Set from default settings and exit
27           Overwrite current settings if initialized
28
29       -g
30           Print current connection parameter in shell style and exit
31
32       --help
33           Print usage summary
34
35       --verbose
36           Verbose module output
37
38       --quiet
39           Quiet module output
40
41       --ui
42           Force launching GUI dialog
43
44   Parameters:
45       driver=name
46           Name of database driver
47           Options: sqlite, pg
48           Default: sqlite
49
50       database=name
51           Name of database
52           Default: $GISDBASE/$LOCATION_NAME/$MAPSET/tgis/sqlite.db
53

DESCRIPTION

55       t.connect allows the user to set the temporal database connection.  The
56       default setting is that  the  temporal  database  of  type  sqlite3  is
57       located in the current mapset directory.
58
59       The  -p  flag  will  display  the  current temporal database connection
60       parameters.
61
62       The -pg flag will display  the  current  temporal  database  connection
63       parameters using shell style.
64
65       The  -c  flag  will  silently check if the temporal database connection
66       parameters have been set, and if not  will  set  them  to  use  GRASS’s
67       default values.
68

NOTES

70       Setting  the connection with t.connect will not test the connection for
71       validity.  Hence a database connection will not be established.
72
73       The connection values are stored in the mapset’s VAR file.  The -d flag
74       will  set  the  default  TGIS connection parameters.  A SQLite database
75       "tgis/sqlite.db" will be created in the current mapset  directory.   It
76       will  be  located in the "tgis" sub-directory to not interfere with the
77       sqlite3 database used for vector attribute storage.
78
79       In case you have tens of thousands of maps to register in the  temporal
80       database  or  you need concurrent read and write access in the temporal
81       database, consider to use a PostgreSQL connection instead.
82
83       Be aware that you have to set the PostgreSQL connection  explicitly  in
84       every  mapset  that  should  store temporal information in the temporal
85       database.
86
87       PostgreSQL and SQLite databases can not be mixed in a location.
88

EXAMPLES

90   SQLite
91       The SQLite database is created automatically when used the first time.
92       # use single quotes here
93       t.connect driver=sqlite database=’$GISDBASE/$LOCATION_NAME/PERMANENT/tgis/sqlite.db’
94       t.connect -p
95       t.info -s
96
97   PostgreSQL
98       When using a PostgreSQL database, the user will  need  to  specify  the
99       TGIS database connection for each mapset.
100       t.connect driver=pg database="dbname=grass_test user=soeren password=abcdefgh"
101       t.connect -p
102       t.info -s
103

AUTHOR

105       Soeren Gebbert, Thünen Institute of Climate-Smart Agriculture
106
107       Last changed: $Date: 2015-09-22 10:10:38 +0200 (Tue, 22 Sep 2015) $
108

SOURCE CODE

110       Available at: t.connect source code (history)
111
112       Main index | Temporal index | Topics index | Keywords index | Graphical
113       index | Full index
114
115       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
116
117
118
119GRASS 7.6.0                                                       t.connect(1)