Batch Import using Local File

Before running any Pinot commands, make sure to set Java 11 on the CLI and export other required configurations.

Bash
    
 
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.25.0.9-2.el8.x86_64export PATH=$JAVA_HOME/bin:$PATHexport JAVA_OPTS="-Xms1G -Xmx2G"export LOG_ROOT=/var/log/pinot
Copy

Create different tables and schemas.

Prepare your Data

Create a directory to store raw data:

Bash
    
 
mkdir -p /tmp/pinot-new/rawdata
Copy

Create a sample CSV file:

Bash
    
 
cat <<EOF > /tmp/pinot-new/rawdata/transcriptnew.csvstudentID,firstName,lastName,gender,subject,score,timestampInEpoch200,Lucy,Smith,Female,Maths,3.8,1570863600000200,Lucy,Smith,Female,English,3.5,1571036400000201,Bob,King,Male,Maths,3.2,1571900400000202,Nick,Young,Male,Physics,3.6,1572418800000EOF
Copy

Make sure that the table and schema names are the same.

Create Schema

Define a schema in the JSON format:

Bash
    
 
cat <<EOF > /tmp/pinot-new/transcriptschemanew.json{  "schemaName": "transcriptnew",  "dimensionFieldSpecs": [    {"name": "studentID", "dataType": "INT"},    {"name": "firstName", "dataType": "STRING"},    {"name": "lastName", "dataType": "STRING"},    {"name": "gender", "dataType": "STRING"},    {"name": "subject", "dataType": "STRING"}  ],  "metricFieldSpecs": [    {"name": "score", "dataType": "FLOAT"}  ],  "dateTimeFieldSpecs": [{    "name": "timestampInEpoch",    "dataType": "LONG",    "format" : "1:MILLISECONDS:EPOCH",    "granularity": "1:MILLISECONDS"  }]}EOF
Copy

Create Table Configuration

Define the table configuration in the JSON format:

Bash
    
 
cat <<EOF > /tmp/pinot-new/transcripttableofflinenew.json{  "tableName": "transcriptnew",  "tableType": "OFFLINE",  "segmentsConfig": {    "timeColumnName": "timestampInEpoch",    "timeType": "MILLISECONDS",    "replication": "1",    "schemaName": "transcriptnew"  },  "tableIndexConfig": {    "invertedIndexColumns": [],    "loadMode": "MMAP"  },  "tenants": {    "broker": "DefaultTenant",    "server": "DefaultTenant"  },  "metadata": {}}EOF
Copy

Upload Schema and Table Configuration

Use the Pinot Controller REST API to upload them:

Upload Schema:

Bash
    
curl -X POST "http://{hostname}or{IP}:9000/schemas" -H "Content-Type: application/json" -d @/tmp/pinot-new/transcriptschemanew.json
Copy

Upload the Table Configuration:

Bash
    
curl -X POST "http://{hostname}or{IP}:9000/tables" -H "Content-Type: application/json" -d @/tmp/pinot-new/transcripttableofflinenew.json
Copy

Verify if the table and schema were uploaded:

Bash
    
 
curl -X GET "http://{hostname}or{IP}:9000/tables/transcriptnew"curl -X GET "http://{hostname}or{IP}:9000/schemas/transcriptnew"
Copy

Create a Segment Job Spec (YAML)

Bash
    
 
cat <<EOF > /tmp/pinot-new/batch-job-spec.ymlexecutionFrameworkSpec:  name: 'standalone'  segmentGenerationJobRunnerClassName: 'org.apache.pinot.plugin.ingestion.batch.standalone.SegmentGenerationJobRunner'  segmentTarPushJobRunnerClassName: 'org.apache.pinot.plugin.ingestion.batch.standalone.SegmentTarPushJobRunner'  segmentUriPushJobRunnerClassName: 'org.apache.pinot.plugin.ingestion.batch.standalone.SegmentUriPushJobRunner'jobType: SegmentCreationinputDirURI: 'file:///tmp/pinot-new/rawdata/'includeFileNamePattern: 'glob:**/*.csv'outputDirURI: 'file:///tmp/pinot-new/segments/'overwriteOutput: truepinotFSSpecs:  - scheme: file    className: org.apache.pinot.spi.filesystem.LocalPinotFSrecordReaderSpec:  dataFormat: 'csv'  className: 'org.apache.pinot.plugin.inputformat.csv.CSVRecordReader'  configClassName: 'org.apache.pinot.plugin.inputformat.csv.CSVRecordReaderConfig'tableSpec:  tableName: 'transcriptnew'  schemaURI: 'http://{hostname}or{IP}:9000/schemas/transcriptnew'  tableConfigURI: 'http://{hostname}or{IP}:9000/tables/transcriptnew'pinotClusterSpecs:  - controllerURI: 'http://{hostname}or{IP}:9000'EOF
Copy

Generate Segments using Batch Job Spec

Bash
    
 
./bin/pinot-admin.sh LaunchDataIngestionJob -jobSpecFile /tmp/pinot-new/batch-job-spec.yml
Copy

Ingest Data into Pinot

Run the following command to ingest data into Pinot.

Bash
    
./bin/pinot-admin.sh UploadSegment -controllerHost {hostname}or{IP} -controllerPort 9000 -tableName transcriptnew -segmentDir /tmp/pinot-new/segments/
Copy

Bash
    
​x
    
[root@pinot apache-pinot-1.3.0-bin]# ./bin/pinot-admin.sh UploadSegment -controllerHost 10.100.11.41 -controllerPort 9000 -tableName transcript -segmentDir /tmp/pinot-quick-start/segments/WARNING: An illegal reflective access operation has occurredWARNING: Illegal reflective access by org.codehaus.groovy.reflection.CachedClass (file:/root/himanshu/apache-pinot-1.3.0-bin/lib/pinot-all-1.3.0-jar-with-dependencies.jar) to method java.lang.Object.finalize()WARNING: Please consider reporting this to the maintainers of org.codehaus.groovy.reflection.CachedClassWARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operationsWARNING: All illegal access operations will be denied in a future release​2025/03/20 15:05:24.376 INFO [UploadSegmentCommand] [main] Executing command: UploadSegment -controllerProtocol http -controllerHost 10.100.11.41 -controllerPort 9000 -segmentDir /tmp/pinot-quick-start/segments/2025/03/20 15:05:24.544 INFO [UploadSegmentCommand] [main] Uploading segment tar file: /tmp/pinot-quick-start/segments/transcript_OFFLINE_1570863600000_1572418800000_0.tar.gz
Copy

Verify Data Ingestion

Run a query using Pinot’s Query Console:

Last updated on May 6, 2025

Was this page helpful?