UltipaDocs
Products
Solutions
Resources
Company
Start Free Trial
UltipaDocs
Start Free Trial
  • Ultipa CLI
    • Overview
    • Importer
    • Import Configurations
      • Import from CSV
      • Import from JSON / JSONL
      • Import from a Relational Database
      • Import from Neo4j
      • Import from BigQuery
      • Import from Kafka
      • Import from Hive
      • Import from Salesforce
      • Import from RDF
      • Import from GraphML
    • Exporter
    • Export Configurations
      • Export to CSV
      • Export to JSON / JSONL
      • Export to GraphML
  1. Docs
  2. /
  3. Ultipa Tools
  4. /
  5. Ultipa Transporter

Importer

Overview

gqldb-importer is the bulk-import tool of the Ultipa Transporter suite. It reads from external sources and writes nodes and edges into a GQLDB graph in batched, multi-threaded fashion.

Supported Sources

  • CSV
  • JSON / JSONL
  • Relational databases (MySQL, PostgreSQL, SQL Server, Oracle, Snowflake)
  • Neo4j
  • BigQuery
  • Kafka
  • Hive
  • Salesforce
  • RDF
  • GraphML

Workflow

gqldb-importer is configuration-driven. The typical workflow is:

  1. Generate a sample configuration for the source type.
  2. Edit the configuration to point at your source data and the target server.
  3. Run the import.
Bash
# 1. Generate a sample configuration (writes ./import.sample.<type>.yml)
./gqldb-importer -sample csv

# 2. Rename / edit it
mv import.sample.csv.yml my-import.yml

# 3. Run the import
./gqldb-importer -c my-import.yml

Use -sample all to generate sample configurations for every supported source at once.

See Import Configurations for the full configuration reference.

Flags

FlagDescription
-c, -configPath to the configuration file. Default: config.yml.
-sampleGenerate a sample configuration file for a source type (csv, json, jsonl, sql, neo4j, bigQuery, kafka, hive, salesforce, rdf, graphml, or all) and exit.
-connectTest the server connection only; do not import.
-previewRead and display the first N rows of each source without importing.
-abort-sessionAbort an existing bulk-import session before starting a new one.
-hostOverride server.host from the config.
-usernameOverride server.username from the config.
-passwordOverride server.password from the config.
-graphOverride server.graph from the config.
-levelOverride the log level: debug, info, warn, error.
-v, -verboseEnable verbose output.