diff --git a/src/main/java/com/influxdb/v3/client/InfluxDBClient.java b/src/main/java/com/influxdb/v3/client/InfluxDBClient.java index 4ea1ea20..ec7208cd 100644 --- a/src/main/java/com/influxdb/v3/client/InfluxDBClient.java +++ b/src/main/java/com/influxdb/v3/client/InfluxDBClient.java @@ -78,7 +78,12 @@ public interface InfluxDBClient extends AutoCloseable { * @param point the {@link Point} to write, can be null *

* Note: the timestamp passed will be converted to nanoseconds since the Unix epoch - * by NanosecondConverter helper class + * by NanosecondConverter helper class.
+ * Warning: Fields with {@code null} values in a {@link Point} are not written to InfluxDB. + * + * If such fields are later queried explicitly, for example: + * {@code SELECT normalField, nullField FROM my_table} + * an error will be thrown. */ void writePoint(@Nullable final Point point); @@ -89,7 +94,12 @@ public interface InfluxDBClient extends AutoCloseable { * @param options the options for writing data to InfluxDB *

* Note: the timestamp passed will be converted to nanoseconds since the Unix epoch - * by NanosecondConverter helper class + * by NanosecondConverter helper class.
+ * Warning: Fields with {@code null} values in a {@link Point} are not written to InfluxDB. + * + * If such fields are later queried explicitly, for example: + * {@code SELECT normalField, nullField FROM my_table} + * an error will be thrown. */ void writePoint(@Nullable final Point point, @Nonnull final WriteOptions options); @@ -99,7 +109,11 @@ public interface InfluxDBClient extends AutoCloseable { * @param points the list of {@link Point} to write, cannot be null *

* Note: the timestamp passed will be converted to nanoseconds since the Unix epoch - * by NanosecondConverter helper class + * by NanosecondConverter helper class.
+ * Warning: If the provided list contains only one {@link Point}, and that {@code Point} + * contains fields with {@code null} values, those fields are not written to InfluxDB. + * If such fields are later queried explicitly, for example: + * {@code SELECT normalField, nullField FROM my_table} an error will be thrown. */ void writePoints(@Nonnull final List points); @@ -110,7 +124,14 @@ public interface InfluxDBClient extends AutoCloseable { * @param options the options for writing data to InfluxDB *

* Note: the timestamp passed will be converted to nanoseconds since the Unix epoch - * by NanosecondConverter helper class + * by NanosecondConverter helper class.
+ * + * Warning: If the provided list contains only one {@link Point}, and that {@code Point} + * contains fields with {@code null} values, those fields are not written to InfluxDB. + * + * If such fields are later queried explicitly, for example: + * {@code SELECT normalField, nullField FROM my_table} + * an error will be thrown. */ void writePoints(@Nonnull final List points, @Nonnull final WriteOptions options);