2.3. quasardb export tool#

2.3.1. Introduction#

The quasardb export tool (qdb_export, a.k.a. nugliar) retrieves the data from a timeseries into a CSV file. It can also export the configuration file needed by the import tool (qdb_import) if you want to migrate your data.

2.3.2. Quick Reference#

Option

Usage

Default

-h, --help

display help

--version

display the build version and date

-c, --cluster

set the cluster URI

qdb://127.0.0.1:2836

--ts

specify the timeseries to export

-f, --file

specify the file with the timeseries’s data

--tsv

separate values with tabulations

--config

specify the configuration file to write

--start-date

beginning of the range to export

--end-date

end of the range to export

--user-credentials-file

path to the user’s private file

--cluster-public-key-file

path to the cluster’s public file

--timeout

connection timeout duration with the server

Option	Usage	Default
`-h`, `--help`	display help
`--version`	display the build version and date
`-c`, `--cluster`	set the cluster URI	qdb://127.0.0.1:2836
`--ts`	specify the timeseries to export
`-f`, `--file`	specify the file with the timeseries’s data
`--tsv`	separate values with tabulations
`--config`	specify the configuration file to write
`--start-date`	beginning of the range to export
`--end-date`	end of the range to export
`--user-credentials-file`	path to the user’s private file
`--cluster-public-key-file`	path to the cluster’s public file
`--timeout`	connection timeout duration with the server

2.3.3. Program Options#

-h, --help#: Displays help about the program’s options.

--version#: Displays the build version and date.

-c, --cluster=<cluster_uri>#

Specifies the address and port of the quasardb cluster to which the export tool must connect.

Argument: The URI (list of comma-separated endpoints, i.e. addresses and ports, preceded by qdb://) of a cluster on which the tests will be run.
Default value: qdb://127.0.0.1:2836, the IPv4 localhost address and the port 2836.

--ts=<timeseries_name>#

Specifies the timeseries to export.

Argument: The timeseries’s name.

-f, --file=<path_to_file>#

Specifies the file receiving the timeseries data.

Argument: Path to the file.

--tsv#: Separate values with tabulations.

--config=<path_to_file>#

Specifies the configuration file which can be used by the import tool to insert the exported data.

Argument: Path to the file.

--start-date=<date-string>#

Beginning of the range to export.

Argument: A date in ISO format (yyyy-mm-ddThh:mm:ss.ns)

--end-date=<date-string>#

End of the range to export.

Argument: A date in ISO format (yyyy-mm-ddThh:mm:ss.ns)

--user-credentials-file=<path_to_file>#

Specifies the user’s private key file with both username and secret_key.

Argument: Path to the file.

--cluster-public-key-file=<path_to_file>#

Specifies the path to the cluster’s public key file.

Argument: Path to the file.

--timeout=<timeout>#

The connection timeout between the client and the server. Available units: d, h, min, s, ms”)

Argument: A timeout value.