1t.connect(1)                GRASS GIS 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  lo‐
57       cated in the current mapset directory.
58
59       The  -p  flag will display the current temporal database connection pa‐
60       rameters.
61
62       The -pg flag will display the current temporal database connection  pa‐
63       rameters using shell style.
64
65       The -c flag will silently check if the temporal database connection pa‐
66       rameters have been set, and if not will set them to use GRASS’s default
67       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

SOURCE CODE

108       Available at: t.connect source code (history)
109
110       Accessed: Saturday Jan 21 20:41:04 2023
111
112       Main index | Temporal index | Topics index | Keywords index | Graphical
113       index | Full index
114
115       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
116
117
118
119GRASS 8.2.1                                                       t.connect(1)