mysqldump.1
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:7k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. .TH MYSQLDUMP 1 "19 December 2000"
  2. .SH NAME
  3. mysqldump - text-based client for dumping or backing up mysql databases , tables and or data.
  4. .SH  USAGE
  5. .BR "mysqldump [fPfIOPTIONSfP] database [fPfItablesfP]"
  6. .TP
  7. OR
  8. .BR "mysqldump [fPfIOPTIONSfP] --databases [fPfIOPTIONSfP] DB1 [fPfIDB2 DB3...fP]"
  9. .TP
  10. OR
  11. .BR "mysqldump [fPfIOPTIONSfP] --all-databases [fPfIOPTIONSfP]"
  12. .SH OPTION SYNOPSIS
  13. .B mysqldump
  14. .RB [  -A | --all-databases ]
  15. .RB [  -a | --all ]
  16. .RB [  -# | --debug=... ]
  17. .RB [  --character-sets-dir=...]
  18. .RB [ -? | --help       ]
  19. .RB [  -B | --databases     ]
  20. .RB [  -c | --complete-insert ]
  21. .RB [  -C | --compress       ]
  22. .RB [  --default-character-set=...]
  23. .RB [ -e | --extended-insert ]
  24. .RB [  --add-drop-table      ]
  25. .RB [  --add-locks          ] 
  26. .RB [  --allow-keywords      ]
  27. .RB [  --delayed-insert      ]
  28. .RB [  -F | --flush-logs    ]
  29. .RB [  -f | --force     ]     
  30. .RB [  -h | --host=...       ]
  31. .RB [  -l | --lock-tables    ]
  32. .RB [  -n | --no-create-db ]   
  33. .RB [  -t | --no-create-info  ]
  34. .RB [  -d | --no-data     ]    
  35. .RB [  -O | --set-variable var=fPfIoptionfP         ]               
  36. .RB [  --opt       ]         
  37. .RB [  -p | --passwordfPfI[=...]fP  ]
  38. .RB [  -P | --port=...       ]
  39. .RB [  -q | --quick      ]    
  40. .RB [  -Q | --quote-names ]   
  41. .RB [  -S | --socket=...  ] 
  42. .RB [  --tables   ]       
  43. .RB [  -T | --tab=...  ]      
  44. .RB [  -u | --user=# ]
  45. .RB [  -v | --verbose  ]
  46. .RB [  -V | --version ]    
  47. .RB [  -w | --where= ]
  48. .RB [ --delayed ]
  49. .RB [ -e | --extended-insert ]
  50. .RB [ --fields-terminated-by=... ]
  51. .RB [ --fields-enclosed-by=... ]
  52. .RB [ --fields-optionally-enclosed-by=... ]
  53. .RB [ --fields-escaped-by=... ]
  54. .RB [ --lines-terminated-by=... ]
  55. .RB [ -v | --verbose ]
  56. .RB [ -V | --version ]
  57. .RB [ "-O net_buffer_length=#, where # < 16M" ]
  58. .SH DESCRIPTION
  59. Dumping definition and data mysql database or table
  60. .IR mysqldump
  61. supports by executing 
  62. .TP 
  63. .BR  -A | --all-databases 
  64. Dump all the databases. This will be same as
  65. .BR--databases 
  66. with all databases selected.
  67. .TP                        
  68. .BR    -a | --all
  69. Include all MySQL specific create options.
  70. .TP  
  71. .BR   -# | --debug=...
  72. Output debug log. Often this is 'd:t:o,filename`.
  73. .TP  
  74. .BR    --character-sets-dir=...
  75. Directory where character sets are
  76. .TP 
  77. .BR    -? | --help
  78. Display this help message and exit.
  79. .TP  
  80. .BR -B | --databases
  81. To dump several databases. Note the difference in
  82. usage; In this case no tables are given. All name
  83. arguments are regarded as databasenames.
  84. 'USE db_name;' will be included in the output
  85. .TP  
  86. .BR    -c | --complete-insert 
  87. Use complete insert statements.
  88. .TP  
  89. .BR    -C | --compress 
  90. Use compression in server/client protocol.
  91. .TP  
  92. .BR    --default-character-set=...
  93. Set the default character set
  94. .TP  
  95. .BR    -e | --extended-insert 
  96. Allows utilization of the new, much faster
  97. INSERT syntax.
  98. .TP  
  99. .BR    --add-drop-table
  100. Add a 'drop table' before each create.
  101. .TP  
  102. .BR    --add-locks
  103. Add locks around insert statements.
  104. .TP  
  105. .BR    --allow-keywords 
  106. Allow creation of column names that are keywords.
  107. .TP  
  108. .BR    --delayed-insert
  109. Insert rows with INSERT DELAYED.
  110. .TP  
  111. .BR    -F | --flush-logs
  112. Flush logs file in server before starting dump.
  113. .TP  
  114. .BR    -f | --force 
  115. Continue even if we get an sql-error.
  116. .TP  
  117. .BR    -h | --host=...
  118. Connect to host.
  119. .TP  
  120. .BR    -l | --lock-tables
  121. Lock all tables for read.
  122. .TP  
  123. .BR    -n | --no-create-db 
  124. 'CREATE DATABASE /*!32312 IF NOT EXISTS*/ db_name;'
  125. will not be put in the output. The above line will
  126. be added otherwise, if 
  127. .BR --databases 
  128. or
  129. .BR --all-databases 
  130. option was given.
  131. .TP  
  132. .BR    -t | --no-create-info  
  133. Don't write table creation info.
  134. .TP  
  135. .BR    -d | --no-data
  136. No row information.
  137. .TP  
  138. .BR    -O | "--set-variable var=option"
  139. give a variable a value. 
  140. .BR --help 
  141. lists variables
  142. .TP  
  143. .BR   --opt
  144. Same as 
  145. .BR " --add-drop-table --add-locks --all --extended-insert --quick --lock-tables "
  146. .TP  
  147. .BR    -p | --password[=...]  
  148. Password to use when connecting to server.
  149. If password is not given it's solicited on the tty.
  150. .TP  
  151. .BR    -P | --port=...
  152. Port number to use for connection.
  153. .TP  
  154. .BR    -q | --quick 
  155. Don't buffer query, dump directly to stdout.
  156. .TP  
  157. .BR    -Q | --quote-names
  158. Quote table and column names with `
  159. .TP  
  160. .BR -S | --socket=...
  161. Socket file to use for connection.
  162. .TP  
  163. .BR    --tables
  164. fPfIOverrides fPoption 
  165. .BR --databases (-B).
  166. .TP  
  167. .BR    -T | --tab=...
  168. Creates tab separated textfile for each table to
  169. given path. (creates .sql and .txt files).
  170. NOTE: This only works if mysqldump is run on
  171. the same machine as the mysqld daemon.
  172. .TP  
  173. .BR    -u | --user=#  
  174. User for login if not current user.
  175. .TP  
  176. .BR    -v | --verbose 
  177. Print info about the various stages.
  178. .TP  
  179. .BR    -V | --version   
  180. Output version information and exit.
  181. .TP  
  182. .BR    -w | --where=    
  183. dump only selected records; QUOTES mandatory!
  184. .TP 
  185. .BR --delayed 
  186. Insert rows with the INSERT DELAYED command. 
  187. .TP 
  188. .BR -e | --extended-insert 
  189. Use the new multiline INSERT syntax. (Gives more compact and faster inserts statements.) 
  190. .TP 
  191. .BR --fields-terminated-by=... 
  192. .TP 
  193. .BR --fields-enclosed-by=... 
  194. .TP 
  195. .TP 
  196. .BR --fields-optionally-enclosed-by=... 
  197. .TP 
  198. .BR --fields-escaped-by=... 
  199. .TP 
  200. .BR --lines-terminated-by=... 
  201. These options are used with the 
  202. .BR -T 
  203. option and have the same meaning as the corresponding clauses for LOAD DATA INFILE. See Mysql manual section 7.23 LOAD DATA INFILE Syntax. 
  204. .TP 
  205. .BR -v | --verbose 
  206. Verbose mode. Print out more information on what the program does. 
  207. .TP 
  208. .BR -V | --version 
  209. Print version information and exit. 
  210. .TP 
  211. .BR "-O net_buffer_length=#, where # < 16M "
  212. When creating multi-row-insert statements (as with option 
  213. .BR --extended-insert 
  214. or 
  215. .BR --opt
  216. ), mysqldump will create rows up to net_buffer_length length. If you increase this variable, you should also ensure that the max_allowed_packet variable in the MySQL server is bigger than the net_buffer_length. 
  217. .SH EXAMPLES
  218. .TP
  219. The most normal use of mysqldump is probably for making a backup of whole databases. See Mysql Manual section 21.2 Database Backups. 
  220. .TP
  221. mysqldump  --opt fPfIdatabasefP > backup-file.sql
  222. .TP
  223. You can read this back into MySQL with: 
  224. .TP
  225. .BR mysql 
  226. fPfIdatabasefP 
  227. .BR < 
  228. backup-file.sql
  229. .TP
  230. or 
  231. .TP
  232. .BR mysql 
  233. -e 'source /patch-to-backup/backup-file.sql' database
  234. .TP
  235. However, it's also very useful to populate another MySQL server with information from a database: 
  236. .TP
  237. mysqldump --opt fPfIdatabasefP | mysql --host=fPfIremote-hostfP -C database
  238. .TP
  239. It is possible to dump several databases with one command: 
  240. .TP
  241. mysqldump --databases database1 [ database2 database3... ]  > my_databases.sql
  242. .TP
  243. If all the databases are wanted, one can use: 
  244. .TP
  245. mysqldump fPfI--all-databasesfP > all_databases.sql
  246. .SH "SEE ALSO"
  247. isamchk (1),
  248. isamlog (1),
  249. mysqlaccess (1),
  250. mysqladmin (1),
  251. mysqlbug (1),
  252. mysqld (1),
  253. mysqldump (1),
  254. mysqlshow (1),
  255. msql2mysql (1),
  256. perror (1),
  257. replace (1),
  258. safe_mysqld (1),
  259. which1 (1),
  260. zap (1),
  261. .SH AUTHOR
  262. Ver 1.0, distribution 3.23.29a
  263. Michael (Monty) Widenius (monty@tcx.se),
  264. TCX Datakonsult AB (http://www.tcx.se).
  265. This software comes with no warranty.
  266. Manual page by L. (Kill-9) Pedersen 
  267. (kill-9@kill-9.dk), Mercurmedia Data Model Architect /
  268. system developer (http://www.mercurmedia.com)
  269. ." end of man page