home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 April / Chip_2000-04_cd.bin / sharewar / DBF / ReadMe.txt < prev    next >
Text File  |  2000-02-01  |  4KB  |  109 lines
  1.  
  2.                               DBF2MySQL
  3.                          Version 1.0 freeware
  4.                   Copyright (C) by Alexander Eltsyn 
  5.                           E-mail: ae@nica.ru
  6.                      WWW: http://www.nica.ru/~ae
  7.  
  8.  
  9.   The program is also the subject of following copyrights:
  10.  
  11.   - Copyright (C) T.c.X. DataKonsult AB
  12.   - Copyright (C) 1998 Justin P. Yunke <yunke@productivity.org>
  13.   - Copyright (C) 1998 Ken Kyler
  14.   - Copyright (C) Bob Silva <bsilva@umesd.k12.or.us>
  15.     
  16.   
  17.                            WHAT IS DBF2MySQL?
  18.  
  19.      DBF2MySQL is Win32 application to transfer data from FoxPro .DBF
  20. files into MySQL server. To use this program you need an TCP/IP stack
  21. installed and configured.
  22.  
  23.  
  24.                             KEY FEATURES:
  25.  
  26.   * it requires no ODBC or other special clients to access MySQL and .DBF 
  27.     tables;
  28.   * editable "CREATE TABLE" queries;
  29.   * column names substitution/exclusion;
  30.   * "batch" table transfer mode; 
  31.   * .dbf tables preview
  32.  
  33.  
  34.                          BATCH TABLE PROCESSING
  35.  
  36.      If you need to transfer periodically a constant set of .dbf tables, 
  37. this feature is for you. First of all, the "batch script" is to be created.
  38. Then you may give it as a command line argument for DBF2MySQL.exe. 
  39.      Batch script format is described below.
  40.  
  41.  
  42.                       BATCH SCRIPT FORMAT DESCRIPTION
  43.  
  44.      Each line of the batch script contains instruction for one .DBF table. 
  45.  
  46. Script line format (all parameters may be quoted with `"`): 
  47.  
  48.  <dbf_file_name>,<mysql_table_name>,<ReCreate>,<delete_rows>,<TargetCP>{,<dbf_field_name>=<mysql_field_name>}
  49.  
  50.  Where:
  51.   <dbf_file_name>      - file name to transfer data from
  52.   <mysql_table_name>   - table name to transfer data to
  53.   <ReCreate>           - Recreate MySQL table structure. Possible values:
  54.                          0: leave table structure unchanged
  55.                          1: drop table and create new trable structure
  56.                             according to .DBF file.
  57.   <delete_rows>        - empty table before data transfer. Values:
  58.                          0: append .DBF data into table
  59.                          1: delete all existing data before data transfer
  60.   <TargetCP>           - Target code page. Values:
  61.                          0: Current Windows codepage
  62.                          1: Russian KOI-8
  63.                          2: Russian MS-DOS (866)
  64.                          3: OEM
  65.   <dbf_field_name>=<mysql_field_name> - associate DBF field name 
  66.                          with mysql field name. Empty value of
  67.                          <mysql_filed_name> means, that field should 
  68.                          not be transfered
  69.  
  70.  
  71. Example of script lines:
  72.  
  73. ".\db\abit.dbf", abit, 1, 1, 0, lock=""
  74. db\stud.dbf, stud, 0, 1, 0, "Field"="Fld"
  75.  
  76.                                 PROBLEMS
  77.  
  78. 1. Problem with tables contains large MEMO or GENERAL data.
  79.  
  80.    Don't forget to increase value of "max_allowed_packet" variable to 
  81. transfer large BLOB fields. Packet size should be large enough to store
  82. INSERT query with all transfered fields data including BLOB's. 
  83. The default value is 65536 bytes. See MySQL manual for details. 
  84.  
  85. 2. MEMO's codepage conversion.
  86.    There is some difference betwen MEMO and GENERAL datatype transfering:
  87.  
  88.  .DBF data type     Default MySQL data type     Codepage conversion
  89.    MEMO                 MEDIUMTEXT             As you choose in wizard
  90.    GENERAL              MEDIUMBLOB                     No
  91.  
  92.  
  93.  
  94.                                  HISTORY
  95.  
  96. 1.0 Release:
  97.   - Fixed bug with "Date" data type transfer
  98.   - Fixed bug with MEMO field transfering
  99.   - Memo data is now searched in .fpt in .dbt files
  100.   - Default MySQL column types for MEMO and GENERAL are 
  101.     MEDIUMTEXT and MEDIUMBLOB correspondingly
  102.   - Codepage for GENERAL datatype is not changing
  103.   - Added TargetCP parameter in batch script
  104.   - Some "cosmetic" changes
  105.  
  106. 1.0 a:
  107.   First available implementation
  108.  
  109.