PyCharm 2016.3 Help

Import: <file_name> Format dialog

This dialog opens when importing delimiter-separated values (e.g. CSV, TSV) from a text file into a database (the Import from File command in the Database tool window).


In the left-hand part, specify how your delimiter-separated values should be converted into table format. If a new table is to be created, also specify the table name and structure in the right-hand part.

Conversion settings

When working on the conversion settings, use the table preview in the right-hand part of the dialog underneath the table settings.

ItemDescription
Formats Select your file format and check the table preview. If you haven't achieved the desired result yet, adjust the settings.

/help/img/idea/iconSaveOptions.png If you have changed the settings and want to save the changes, click this icon and select one of the following:

  • Save Changes. The settings are saved "under the same name", without creating a new format. (A format, in fact, is a named set of settings.)
  • Save As. The settings are saved "under a different name": a new format is created and you can specify the name for that new format.

Value separator Select or type the character used for separating individual values.
Row separator Select or type the character that should be treated as a row separator.
Null value text The text to be used as a value if a cell contains null (an unknown value).
Add row prefix/suffix Row prefix and suffix are character sequences which in addition to the row separator indicate the beginning and end of a row.

If necessary, click the link and specify the row prefix and suffix in the fields that appear.

Quotation Each line in the area under Quotation is a quotation pattern (see Quote values). A quotation pattern includes:
  • The left quotation character, the one inserted before a value.
  • The right quotation character, the one inserted after a value; usually, the same as the left quotation character.
  • An escape method or character for the cases when the quotation character is part of a value. E.g. Escape: duplicate means that if a quotation character occurs within a value, it is doubled. (You can specify your own escape character instead.)

If there is more than one pattern, the first of the patterns is used.

Use /help/img/idea/new.png, /help/img/idea/delete.png, /help/img/idea/arrowUp.png and /help/img/idea/arrowDown.png to create, delete and reorder the patterns.

To start editing an existing pattern, just click the pattern of interest.

Quote values Specify in which cases the values should be quoted (i.e. enclosed within quotation characters).
  • When needed. A value is quoted only if it contains the value and/or the row separator.
  • Always. Any value is quoted in its text representation.
Trim whitespaces If this check box is not selected, the Unicode whitespace characters that precede and follow the value separators are treated as parts of the corresponding values. If this check box is selected, the corresponding whitespace characters are ignored or removed.
First row is header If this check box is selected, the first row is treated as containing column names. The settings that appear under Header Format have the same meanings as the ones above but are applied to the first row.
First column is header If this check box is selected, the first column is treated as containing row names.

Table name and structure

ItemDescription
Table The name of the table.
Comment For a new table: the table comment.
Columns / Keys etc. If you are creating a new table, define the columns, constraints and indexes. E.g.:
  • To start editing a column definition, click the corresponding line in the list of columns.
  • To remove a column definition, select the corresponding line and click /help/img/idea/clear_all.png.

Error records file

If you select the Write error records to file check box, the lines that cannot be imported are written to the specified text file.

See Also

Last modified: 23 November 2016