DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

(mysql.info.gz) mysqlimport

Info Catalog (mysql.info.gz) mysqlhotcopy (mysql.info.gz) Client-Side Scripts (mysql.info.gz) mysqlshow
 
 8.10 The `mysqlimport' Data Import Program
 ==========================================
 
 The `mysqlimport' client provides a command-line interface to the `LOAD
 DATA INFILE' SQL statement.  Most options to `mysqlimport' correspond
 directly to clauses of `LOAD DATA INFILE'.   `LOAD DATA' LOAD
 DATA.
 
 Invoke `mysqlimport' like this:
 
      shell> mysqlimport [OPTIONS] DB_NAME TEXTFILE1 [TEXTFILE2 ...]
 
 For each text file named on the command line, `mysqlimport' strips any
 extension from the filename and uses the result to determine the name
 of the table into which to import the file's contents.  For example,
 files named `patient.txt', `patient.text', and `patient' all would be
 imported into a table named `patient'.
 
 `mysqlimport' supports the following options:
 
 `--help, -?'
      Display a help message and exit.
 
 `--columns=COLUMN_LIST, -c COLUMN_LIST'
      This option takes a comma-separated list of column names as its
      value. The order of the column names indicates how to match up
      data file columns with table columns.
 
 `--compress, -C'
      Compress all information sent between the client and the server if
      both support compression.
 
 `--debug[=DEBUG_OPTIONS], -# [DEBUG_OPTIONS]'
      Write a debugging log. The DEBUG_OPTIONS string often is
      `'d:t:o,FILE_NAME''.
 
 `--delete, -D'
      Empty the table before importing the text file.
 
 `--fields-terminated-by=...'
 `--fields-enclosed-by=...'
 `--fields-optionally-enclosed-by=...'
 `--fields-escaped-by=...'
 `--lines-terminated-by=...'
      These options have the same meaning as the corresponding clauses
      for `LOAD DATA INFILE'.  `LOAD DATA' LOAD DATA.
 
 `--force, -f'
      Ignore errors.  For example, if a table for a text file doesn't
      exist, continue processing any remaining files.  Without `--force',
      `mysqlimport' exits if a table doesn't exist.
 
 `--host=HOST_NAME, -h HOST_NAME'
      Import data to the MySQL server on the given host. The default host
      is `localhost'.
 
 `--ignore, -i'
      See the description for the `--replace' option.
 
 `--ignore-lines=N'
      Ignore the first N lines of the data file.
 
 `--local, -L'
      Read input files locally from the client host.
 
 `--lock-tables, -l'
      Lock _all_ tables for writing before processing any text files.
      This ensures that all tables are synchronized on the server.
 
 `--password[=PASSWORD], -p[PASSWORD]'
      The password to use when connecting to the server.  If you use the
      short option form (`-p'), you _cannot_ have a space between the
      option and the password.  If you omit the PASSWORD value following
      the `--password' or `-p' option on the command line, you will be
      prompted for one.
 
 `--port=PORT_NUM, -P PORT_NUM'
      The TCP/IP port number to use for the connection.
 
 `--protocol={TCP | SOCKET | PIPE | MEMORY}'
      The connection protocol to use.  New in MySQL 4.1.
 
 `--replace, -r'
      The `--replace' and `--ignore' options control handling of input
      records that duplicate existing records on unique key values.  If
      you specify `--replace', new rows replace existing rows that have
      the same unique key value. If you specify `--ignore', input rows
      that duplicate an existing row on a unique key value are skipped.
      If you don't specify either option, an error occurs when a
      duplicate key value is found, and the rest of the text file is
      ignored.
 
 `--silent, -s'
      Silent mode.  Produce output only when errors occur.
 
 `--socket=PATH, -S PATH'
      The socket file to use when connecting to `localhost' (which is the
      default host).
 
 `--user=USER_NAME, -u USER_NAME'
      The MySQL username to use when connecting to the server.
 
 `--verbose, -v'
      Verbose mode.  Print out more information what the program does.
 
 `--version, -V'
      Display version information and exit.
 
 
 Here is a sample session that demonstrates use of `mysqlimport':
 
      shell> mysql -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
      shell> ed
      a
      100     Max Sydow
      101     Count Dracula
      .
      w imptest.txt
      32
      q
      shell> od -c imptest.txt
      0000000   1   0   0  \t   M   a   x       S   y   d   o   w  \n   1   0
      0000020   1  \t   C   o   u   n   t       D   r   a   c   u   l   a  \n
      0000040
      shell> mysqlimport --local test imptest.txt
      test.imptest: Records: 2  Deleted: 0  Skipped: 0  Warnings: 0
      shell> mysql -e 'SELECT * FROM imptest' test
      +------+---------------+
      | id   | n             |
      +------+---------------+
      |  100 | Max Sydow     |
      |  101 | Count Dracula |
      +------+---------------+
 
Info Catalog (mysql.info.gz) mysqlhotcopy (mysql.info.gz) Client-Side Scripts (mysql.info.gz) mysqlshow
automatically generated byinfo2html