---
title: "Data Connector Overview"
description: "Overview of available data connectors, sources, and loading workflows."
component: "tigergraph-server"
version: "4.3"
module: "data-loading"
html_url: "/tigergraph-server/4.3/data-loading/data-loading-overview"
canonical_url: "https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview"
markdown_url: "https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md"
---

[View as HTML](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview)

# Data Connector Overview

Table of Contents

* [Connector Architecture Overview](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md#_connector_architecture_overview)
* [Data Source Categories](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md#_data_source_categories)
* [Loading Workflow](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md#_loading_workflow)
* [Loading Jobs](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md#_loading_jobs)

Once you have [defined a graph schema](https://www.tigergraph.com/docs/gsql-ref/4.3/ddl-and-loading/defining-a-graph-schema.md), you can load data into the graph.

This section provides an overview of how to configure TigerGraph to connect to different data sources, including data warehouses, cloud storage, streaming systems, and lakehouse platforms.

## Connector Architecture Overview

This diagram shows the supported data source categories, the connectors used to access them, and the TigerGraph components responsible for ingesting the data.

![Architectural diagram showing supported data sources](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/_images/data-connector-architecture_4.3.png) 

Figure 1\. TigerGraph Data Connector Architecture

## Data Source Categories

TigerGraph supports multiple categories of data sources, each accessed through a specific connector or integration method.

* **Local Files**: Files located on the TigerGraph server can be loaded directly without defining a `DATA_SOURCE` object. This option typically provides the highest performance.
* **External Sources (via Kafka Connect)**: External systems are accessed by defining a `DATA_SOURCE` object, which uses the [Kafka Connect](https://docs.confluent.io/platform/current/connect/index.html) framework. Kafka Connect provides a distributed and fault-tolerant data pipeline.  
Using this approach, TigerGraph can treat external sources similarly to local files. Supported sources include:  
   * Cloud storage (Amazon S3, Azure Blob Storage, Google Cloud Storage)  
   * Data warehouses (Google BigQuery, Snowflake, PostgreSQL)  
   * External Kafka clusters  
   * Lakehouse platforms such as Apache Iceberg (via Kafka Connect)  
See the pages for each connector for detailed configuration steps.
* **Lakehouse (via Spark or Kafka Connect)**: Lakehouse platforms combine features of data lakes and data warehouses.  
TigerGraph supports:  
   * Apache Iceberg via Kafka Connect  
   * Apache Iceberg, DeltaLake (and other Spark-supported sources) via the Spark Connector  
   * Databricks tables, including Delta Lake tables, via the Spark Connector running on Databricks  
For details, see [Load from Data Lakehouse](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-lakehouse.md) and [Load from Apache Iceberg](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-iceberg.md).
* **Spark**: The TigerGraph [Spark Connector](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-spark-dataframe.md) integrates with Apache Spark to load data from Spark DataFrames or lakehouse storage systems into TigerGraph. The connector runs on open-source Apache Spark and on Databricks. See [Load Data from Databricks](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-spark-dataframe.md#_load_data_from_databricks).  
This approach allows you to leverage the broader Spark ecosystem and its supported data sources.

## Loading Workflow

TigerGraph follows a consistent workflow for loading data, regardless of the source:

1. **Specify a graph**. Data is always loaded into a single graph. For example:  
```gsql  
USE GRAPH ldbc_snb  
```
2. If using an external connector, **define a `DATA_SOURCE` object**.  
See:  
[Cloud Storage](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-cloud.md),[BigQuery](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-warehouse.md#_bigquery),[Snowflake](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-warehouse.md#_snowflake),[PostgreSQL](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-warehouse.md#_postgresql),[Kafka](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-kafka.md), or[Apache Iceberg](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/load-from-iceberg.md).
3. **Create a [loading job](https://www.tigergraph.com/docs/tigergraph-server/4.3/data-loading/data-loading-overview.md#_loading_jobs)**.
4. **Run the loading job**.

## Loading Jobs

A loading job defines how data is transformed into vertices and edges in the graph.

CREATE LOADING JOB syntax

```gsql
CREATE LOADING JOB <job_name> FOR GRAPH <graph_name> {
  <DEFINE statements>
  <LOAD statements>
}
```

The loading job definition includes:

* A job name (`<job_name>`)
* A target graph (`<graph_name>`)

The body of the loading job consists of:

1. **DEFINE statements**: Create variables that reference data sources. These can represent files or external queries.
2. **LOAD statements**: Specify how input data fields map to vertices and edges.

> [!NOTE]
> For detailed syntax and examples, see [Creating a Loading Job](https://www.tigergraph.com/docs/gsql-ref/4.3/ddl-and-loading/creating-a-loading-job.md).
