IO: Add the if-exists query parameter by updating to influxio 0.4.0

Co-authored-by: Niklas Schmidtmer <[email protected]>

CHANGES.md

@@ -2,6 +2,7 @@
 
 
 ## Unreleased
+- IO: Added the `if-exists` query parameter by updating to influxio 0.4.0.
 
 ## 2024/06/18 v0.0.14
 - Add `ctk cfr` and `ctk wtf` diagnostics programs

doc/io/influxdb/loader.md

@@ -16,7 +16,7 @@ working with InfluxDB.
 pip install --upgrade 'cratedb-toolkit[influxdb]'
 ```
 
-## Examples
+## Usage
 
 ### Workstation
 
@@ -66,5 +66,26 @@ ctk load table \
   --cratedb-sqlalchemy-url="crate://admin:[email protected]:4200/testdrive/demo?ssl=true"
 ```
 
+## Parameters
+
+### `if-exists`
+
+The target table will be created automatically, if it does not exist. If it
+does exist, the `if-exists` URL query parameter can be used to configure this
+behavior. The default value is `fail`, the possible values are:
+
+* `fail`: Raise a ValueError.
+* `replace`: Drop the table before inserting new values.
+* `append`: Insert new values to the existing table.
+
+:::{rubric} Example usage
+:::
+In order to always replace the target table, i.e. to drop and re-create it
+prior to inserting data, use `?if-exists=replace`.
+```shell
+export CRATEDB_SQLALCHEMY_URL="crate://crate@localhost:4200/testdrive/demo?if-exists=replace"
+ctk load table influxdb2://example:token@localhost:8086/testdrive/demo
+```
+
 
 [influxio]: inv:influxio:*:label#index

pyproject.toml

@@ -140,7 +140,7 @@ full = [
 ]
 influxdb = [
   "cratedb-toolkit[io]",
-  "influxio>=0.3.1,<1",
+  "influxio>=0.4,<1",
 ]
 io = [
   "cr8",