Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

COPY FROM

Import CSV data into a table.

Syntax

COPY [keyspace.]table [(column1, column2, ...)] FROM 'filename'|STDIN [WITH option = value [AND ...]]

Options

OptionDefaultDescription
DELIMITER,Field delimiter character
QUOTE"Quote character
ESCAPE\\Escape character
HEADERfalseFirst row contains column headers
NULL(empty)String representing NULL values
CHUNKSIZE1000Rows per insert batch
INGESTRATE100000Target rows per second
MAXBATCHSIZE20Maximum rows per batch statement
MINBATCHSIZE2Minimum rows per batch statement
MAXPARSEERRORS-1Max parse errors before abort (-1 = unlimited)
MAXINSERTERRORS-1Max insert errors before abort (-1 = unlimited)
PREPAREDSTATEMENTStrueUse prepared statements
TTL-1TTL for inserted rows in seconds (-1 = no TTL)

Examples

-- Import from file
COPY users FROM '/tmp/users.csv';

-- Import with headers
COPY users FROM '/tmp/users.csv' WITH HEADER = true;

-- Import specific columns
COPY users (id, name) FROM '/tmp/users.csv' WITH HEADER = true;

-- Import from stdin
COPY users FROM STDIN;

Notes

  • Disabled when --no-file-io is used (except FROM STDIN).
  • See the COPY Guide for detailed usage and performance tips.