# HG changeset patch
# User Sylvain Thénault <sylvain.thenault@logilab.fr>
# Date 1454411329 -3600
# Node ID f2ff82dfcd5cb70fbf4f05e541e7d275091ab0f5
# Parent  6adfa1e75179817d8a652176cb3073b14dd84f5a
[dataimport] add a bit of extra-documentation on the massive store

about prepare_insert_relation limitation on inlined relation and lack of
full-text indexation.

diff -r 6adfa1e75179 -r f2ff82dfcd5c cubicweb/dataimport/massive_store.py
--- a/cubicweb/dataimport/massive_store.py	Fri Jan 29 18:57:30 2016 +0100
+++ b/cubicweb/dataimport/massive_store.py	Tue Feb 02 12:08:49 2016 +0100
@@ -34,8 +34,7 @@
 
 
 class MassiveObjectStore(stores.RQLObjectStore):
-    """
-    Store for massive import of data, with delayed insertion of meta data.
+    """Store for massive import of data, with delayed insertion of meta data.
 
     WARNINGS:
 
@@ -82,6 +81,9 @@
        ...
        store.commit()
        store.finish()
+
+    Full-text indexation is not handled, you'll have to reindex the proper entity types by yourself
+    if desired.
     """
     # max size of the iid, used to create the iid_eid conversion table
     iid_maxsize = 1024
@@ -305,8 +307,11 @@
     def prepare_insert_relation(self, eid_from, rtype, eid_to, **kwargs):
         """Insert into the database a  relation ``rtype`` between entities with eids ``eid_from``
         and ``eid_to``.
+
+        Relation must not be inlined.
         """
         if not self.slave_mode and rtype not in self._initialized:
+            assert not self._cnx.vreg.schema.rschema(rtype).inlined
             self._initialized.add(rtype)
             self._dbh.drop_indexes('%s_relation' % rtype.lower())
             self.sql('CREATE TABLE %s_relation_tmp (eid_from integer, eid_to integer)'