Skip to content

Commit 67f8481

Browse files
committed
update README.md
1 parent 0ca1548 commit 67f8481

File tree

2 files changed

+8
-3
lines changed

2 files changed

+8
-3
lines changed

README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,13 @@ DaBaDEx is a tool to download text data from and/or upload text data into a data
88

99
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`).
1010

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+
1115
## Usage
1216

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).
1418

1519
Type
1620

@@ -28,12 +32,13 @@ The commented parameter files (see [test-g.prm](parameters/test-g.prm) and [test
2832

2933
* lines starting with a hash ('#') are comments
3034
* `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.
3136
* 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'`
3237
* `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`).
3338
* `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').
3439

3540
### Further things to consider
3641

3742
* 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`)
3944
* 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).

src/main/java/dabadex/Start.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
import utils.Utils;
1515

1616
public class Start implements Runnable {
17-
public final static String version = "0.1.2 dbg";
17+
public final static String version = "0.1.3";
1818
public final static Logger LOGGER = Logger.getLogger("DaBaDExLog");
1919
public static int cycle = 1;
2020
private DaBaDExParam p;

0 commit comments

Comments
 (0)