ETL - Extractors

When OrientDB executes the ETL module, extractor components handle data extraction from source. They are the first part of the ETL process. The ETL module in OrientDB supports the following extractors:

• Row
• CSV
• JDBC
• JSON
• XML

Row Extractor

When the ETL module runs with a Row Extractor, it extracts content row by row. It outputs a string array class.

• Component name: row
• Output Class: [ string ]

Syntax

The "multiLine" and "linefeed" parameters were introduced in version 2.0.9.

Examples

• Use the row extractor with its default configuration:

  { 
     "row": {} 
  }
  

CSV Extractor

When the ETL module runs the CSV Extractor, it parses a file formatted to Apache Commons CSV and extracts the data into OrientDB. This component was introduced in version 2.1.4 and is unavailable in older releases of OrientDB.

• Component name: csv
• Output class: [ ODocument ]

Syntax

• For the "columns" parameter, specify the type by postfixing it to the value. Specifying types guarantees better performance.

• For the "predefinedFormat" parameter, the available formats are: Default, Excel, MySQL, RFC4180, TDF.

Examples

• Extract lines from CSV to the ODocument class, using commas as the separator, considering NULL as the null value and skipping rows two through four:

  { "csv": 
      {  "separator": ",", 
         "nullValue": "NULL",
         "skipFrom": 1, 
         "skipTo": 3 
      }
  }
  

• Extract lines from a CSV exported from MySQL:

  { "csv": 
      {  "predefinedFormat": "MySQL"}
  }
  

• Extract lines from a CSV with the default formatting, using N/A as the null value and a custom date format:

  { "csv": 
      {  "predefinedFormat": "Default",
         "nullValue" : "N/A",
         "dateFormat" : "dd-MM-yyyy",
         "dateTimeFormat" : "dd-MM-yyyy HH:mm"
      }
  }
  

• Extract lines from a CSV with the default formatting, using N/A as the null value, a custom date format, a custom dateTime format and columns type mapping :

  { "csv": 
      {  "predefinedFormat": "DEFAULT",
         "nullValue" : "N/A",
         "dateFormat" : "dd-MM-yyyy",
         "dateTimeFormat" : "dd-MM-yyyy HH:mm",
         "columns": ["name:string","createdAt:date","updatedAt:dateTime"]
      }
  }
  

JDBC Extractor

When the ETL module runs the JDBC Extractor, it can access any database management system that supports the JDBC driver.

In order for the ETL component to connect to the source database, put the source database's JDBC driver in the classpath, or in the $ORIENTDB_HOME/lib directory.

• Component name: jdbc
• Output class: [ ODocument ]

Syntax

Example

• Extract the contents of the client table on the MySQL database test at localhost:

  { "jdbc": {
      "driver": "com.mysql.jdbc.Driver",
      "url": "jdbc:mysql://localhost/test",
      "userName": "root",
      "userPassword": "my_mysql_passwd",
      "query": "SELECT * FROM client"
    }
  }
  

JSON Extractor

When the ETL module runs with a JSON Extractor, it extracts data by parsing JSON objects. If the data has more than one JSON items, you must enclose the in [] brackets.

• Component name: json
• Output class: [ ODocument ]

Example

• Extract data from a JSON file.

  { "json": {} }
  

XML Extractor

When the ETL module runs with the XML extractor, it extracts data by parsing XML elements. This feature was introduced in version 2.2.

• Component name: xml
• Output class: [ ODocument ]

Syntax

Examples

• Extract data from an XML file, where the XML file reads as:

  <?xml version="1.0" encoding="UTF-8"?>
  <a>
    <b>
    	<c name='Ferrari' color='red'>ignore</c>
    	<c name='Maserati' color='black'/>
    </b>
  </a>
  

  While the OrientDB-ETL configuration file reads as:

  { "source": 
    { "file": 
      { "path": "src/test/resources/simple.xml" } 
    }, 
    "extractor" : 
      { "xml": {} }, 
      "loader": 
        { "test": {} } 
  }
  

  This extracts the data as:

  {
    "a": {
      "b": {
        "c": [
          {
            "color": "red",
            "name": "Ferrari"
          },
          {
            "color": "black",
            "name": "Maserati"
          }
        ]
      }
    }
  }
  

• Extract a collection from XML, where the XML file reads as:

  <?xml version="1.0" encoding="UTF-8"?>
  <CATALOG>
      <CD>
          <TITLE>Empire Burlesque</TITLE>
          <ARTIST>Bob Dylan</ARTIST>
          <COUNTRY>USA</COUNTRY>
          <COMPANY>Columbia</COMPANY>
          <PRICE>10.90</PRICE>
          <YEAR>1985</YEAR>
      </CD>
      <CD>
          <TITLE>Hide your heart</TITLE>
          <ARTIST>Bonnie Tyler</ARTIST>
          <COUNTRY>UK</COUNTRY>
          <COMPANY>CBS Records</COMPANY>
          <PRICE>9.90</PRICE>
          <YEAR>1988</YEAR>
      </CD>
      <CD>
          <TITLE>Greatest Hits</TITLE>
          <ARTIST>Dolly Parton</ARTIST>
          <COUNTRY>USA</COUNTRY>
          <COMPANY>RCA</COMPANY>
          <PRICE>9.90</PRICE>
          <YEAR>1982</YEAR>
      </CD>
  </CATALOG>
  

  While the OrientDB-ETL configuration file reads:

  { "source": 
    { "file": 
      { "path": "src/test/resources/music.xml" } 
    }, "extractor" : 
      { "xml": 
        { "rootNode": "CATALOG.CD", 
    	  "tagsAsAttribute": ["CATALOG.CD"] 
    	} 
      }, 
      "loader": { "test": {} } 
  }
  

  This extracts the data as:

  {
    "TITLE": "Empire Burlesque",
    "ARTIST": "Bob Dylan",
    "COUNTRY": "USA",
    "COMPANY": "Columbia",
    "PRICE": "10.90",
    "YEAR": "1985"
  }
  {
    "TITLE": "Hide your heart",
    "ARTIST": "Bonnie Tyler",
    "COUNTRY": "UK",
    "COMPANY": "CBS Records",
    "PRICE": "9.90",
    "YEAR": "1988"
  }
  {
    "TITLE": "Greatest Hits",
    "ARTIST": "Dolly Parton",
    "COUNTRY": "USA",
    "COMPANY": "RCA",
    "PRICE": "9.90",
    "YEAR": "1982"
  }