DOC-1906-warning-empty-primary-id 3.8

Author: Victor Lee

modules/ddl-and-loading/pages/defining-a-graph-schema.adoc

@@ -91,6 +91,12 @@ There are two ways of specifying the primary ID/key:
 . `PRIMARY KEY` syntax.
 This syntax is modeled after SQL.
 
+[IMPORTANT]
+====
+When loading or inserting vertices, take care not to accidentally leave the primary ID field empty.
+An empty string in the primary ID field is accepted as a valid input.
+====
+
 
 ==== `PRIMARY_ID`  and `WITH primary_id_as_attribute`
 

modules/ddl-and-loading/partials/load-statement.adoc

@@ -64,6 +64,12 @@ If the vertex data is loaded later, it will be automatically merged with the aut
 The user can disable this feature and perform regular referential integrity checking by setting the `VERTEX_MUST_EXIST` option to `true`.
 ====
 
+[IMPORTANT]
+====
+Take care that your data sources do not have unintentional empty fields.
+An empty string in the primary ID field is accepted as a valid input.
+====
+
 === Examples
 
 Suppose we have the following vertex and edge types: