From 07c6881ade823065dec16862554a07e552e0b8dc Mon Sep 17 00:00:00 2001
From: NguyenHoangSon96 <hoangsonnguyen4321@gmail.com>
Date: Fri, 17 Apr 2026 10:40:58 +0700
Subject: [PATCH] docs: comments for write null fields

---
 influxdb_client_3/__init__.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/influxdb_client_3/__init__.py b/influxdb_client_3/__init__.py
index 1f58b8b..888a455 100644
--- a/influxdb_client_3/__init__.py
+++ b/influxdb_client_3/__init__.py
@@ -388,6 +388,11 @@ def write(self, record=None, database=None, **kwargs):
         """
         Write data to InfluxDB.
 
+        Warning: When you write with only one Point or one Dict, and If that Point or Dict
+        contains fields with None value, those fields will not be written to InfluxDB.
+        If such fields are later queried explicitly, for example,
+        "SELECT field_with_value, field_with_null_value FROM my_table" an error will be thrown.
+
         :param record: The data point(s) to write.
         :type record: object or list of objects
         :param database: The database to write to. If not provided, uses the database provided during initialization.