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.
* 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
+ *
+ * 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