[cubicweb/doc] Add tutorial on data import in CubicWeb. This involves creating the "tutorials/dataimport" directory structure under "cubicweb/doc" and, inside the "dataimport" directory, putting several files: - a ResT file containing the tutorial *per se*; this tutorial addresses the following issues: * creating a CubicWeb schema for representing a given data set (here, the Diseasome RDF data, for illustration purposes); * parsing the data; * importing the data, by using several stores: + the ``RQLObjectStore``, ``NoHookRQLObjectStore`` and ``SQLGenObjectStore`` from the ``dataimport`` module in CubicWeb; + the ``MassiveObjectStore`` from the ``dataimport`` module in the ``dataio`` cube. The tutorial also provides timing benchmarks of the various stores. - a set of Python files illustrating the data import, in the context of Diseasome RDF data parsing: * a Diseasome RDF data parse module, * a Diseasome data import module, * a CubicWeb schema for representing Diseasome data.

     1

from yams import schema2sql as y2sql

     2

     3

dbhelper = repo.system_source.dbhelper

     4

rdefdef = schema['CWSource'].rdef('name')

     5

attrtype = y2sql.type_from_constraints(dbhelper, rdefdef.object, rdefdef.constraints).split()[0]

     6

     7

cursor = session.cnxset['system']

     8

sql('UPDATE entities SET asource = source WHERE asource is NULL')

     9

dbhelper.change_col_type(cursor, 'entities', 'asource', attrtype, False)

    10

dbhelper.change_col_type(cursor, 'entities', 'source', attrtype, False)

    11

dbhelper.change_col_type(cursor, 'deleted_entities', 'source', attrtype, False)