You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-2Lines changed: 7 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -8,9 +8,13 @@ DaBaDEx is a tool to download text data from and/or upload text data into a data
8
8
9
9
Imagine for a moment, that you need to repeatedly query a database to extract data. Or, that you regularly need to upload data into a database. Or both. In comes DaBaDEx. It can either put (mode `-p`) or get (mode `-g`) data into or from a database, respectively. DaBaDEx uses plain old csv files as in- (mode `-p`) or output (mode `-g`).
10
10
11
+
## Install
12
+
13
+
Download the latest zipped compiled version from [Releases](https://github.com/joheli/DaBaDEx/releases) and unpack it into a directory of your choice. The directories `bin` and `lib` contain executables (see [Usage](#Usage)) and libraries, respectively.
14
+
11
15
## Usage
12
16
13
-
Depending on your operating system the executable file (`{dabadex executable}`) is named `dabadex` or `dabadex.bat` (see 'Releases').
17
+
Depending on your operating system the executable file (`{dabadex executable}`) is named `dabadex` or `dabadex.bat` (for Linux and Windows, respectively).
14
18
15
19
Type
16
20
@@ -28,12 +32,13 @@ The commented parameter files (see [test-g.prm](parameters/test-g.prm) and [test
28
32
29
33
* lines starting with a hash ('#') are comments
30
34
*`dataFile` (mode 'put') - this can be a directory or a file; if a directory is given, only the latest file within the directory is processed. Latter behaviour is helpful if the names of the files to be processed change (e.g. are added a timetstamp etc.).
35
+
***NEW** (v0.1.3): `moveDataFileToDir` (mode 'put') optionally specifies a directory to which `dataFile` is moved after being processed.
31
36
* numeric fields in `fields` (mode 'put'): integer, double, real, etc. have to be suffixed with a single apostrophe to avoid them being surrounded by quotes during upload, like so: `fieldname'`
32
37
*`action` (mode 'put') - depending on the primary key-gs in the receiving table of the database DaBaDEx can behave in two different ways when trying to upload entries already present: it can either replace fields other than the key(s) (`action = update`) or leave them untouched (`action = keep`).
33
38
*`driver` - please obtain the correct JDBC driver (see the [JDBC driver Wikipedia entry](https://en.wikipedia.org/wiki/JDBC_driver)) for your database and enter the driver here; drivers for PostgreSQL, MySQL, Microsoft SQL Server, and Sybase are already provided (see 'Releases').
34
39
35
40
### Further things to consider
36
41
37
42
* DaBaDEx processes can be chained, i.e. you can follow up a process of mode 'get' with one of mode 'put'. This way you can use DaBaDEx to get data from one database and put it into another!
38
-
* DaBaDEx currently does not take care of intermediary files and log files after processing. Please consider adding a routine to clear or rotate those files regularly.
43
+
*~~DaBaDEx currently does not take care of intermediary files and log files after processing. Please consider adding a routine to clear or rotate those files regularly.~~ (see parameter `moveDataFileToDir`)
39
44
* The level of logging can optionally be modified by setting the environment variable `DBDX_LOGLEVEL`, which can be assigned values `SEVERE` (highest value), `WARNING`, `INFO`, `CONFIG`, `FINE`, `FINER`, and `FINEST` (lowest value).
0 commit comments