# 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.