# mysqlimport

# Basic usage

Given the tab-separated file employee.txt

1 `\t` Arthur Dent
2 `\t` Marvin
3 `\t` Zaphod Beeblebrox

$ mysql --user=user --password=password mycompany -e 'CREATE TABLE employee(id INT, name VARCHAR(100), PRIMARY KEY (id))'

$ mysqlimport --user=user --password=password mycompany employee.txt

# Using a custom field-delimiter

Given the text file employee.txt

1|Arthur Dent
2|Marvin
3|Zaphod Beeblebrox

$ mysqlimport --fields-terminated-by='|' mycompany employee.txt

# Using a custom row-delimiter

This example is useful for windows-like endings:

$ mysqlimport --lines-terminated-by='\r\n' mycompany employee.txt

# Handling duplicate keys

Given the table Employee

id Name
3 Yooden Vranx

And the file employee.txt

1 `\t` Arthur Dent
2 `\t` Marvin
3 `\t` Zaphod Beeblebrox

The --ignore option will ignore the entry on duplicate keys

$ mysqlimport --ignore mycompany employee.txt

id Name
1 Arthur Dent
2 Marvin
3 Yooden Vranx

The --replace option will overwrite the old entry

$ mysqlimport --replace mycompany employee.txt

id Name
1 Arthur Dent
2 Marvin
3 Zaphod Beeblebrox

# Conditional import

$ mysqlimport --where="id>2" mycompany employee.txt

# Import a standard csv

$ mysqlimport
    --fields-optionally-enclosed-by='"'
    --fields-terminated-by=,
    --lines-terminated-by="\r\n"
    mycompany employee.csv

# Parameters

Parameter Description
--delete -D empty the table before importing the text file
--fields-optionally-enclosed-by define the character that quotes the fields
--fields-terminated-by field terminator
--ignore -i ignore the ingested row in case of duplicate-keys
--lines-terminated-by define row terminator
--password -p password
--port -P port
--replace -r overwrite the old entry row in case of duplicate-keys
--user -u username
--where -w specify a condition

# Remarks

mysqlimport will use the name of the imported file, after stripping the extension, to determine the destination table.