PDF (US Ltr)
- 27.1Mb
PDF (A4)
- 27.2Mb
HTML Download (TGZ)
- 7.2Mb
HTML Download (Zip)
- 7.2Mb
注記
このユーティリティーは MySQL 5.6.20 で非推奨で、MySQL 5.7 で削除されます。
mysqlhotcopy はもともと Tim Bunce によって書かれ、提供された Perl スクリプトです。FLUSH TABLES、LOCK TABLES、および cp または scp を使用してデータベースのバックアップを作成します。データベースまたは単一のテーブルのバックアップを作成するための高速な方法ですが、データベースディレクトリが置かれているのと同じマシンでしか実行できません。mysqlhotcopy は MyISAM テーブルおよびARCHIVE テーブルのみに機能します。Unix で実行されます。
mysqlhotcopy を使用するには、バックアップを行うテーブルのファイルへの読み取りアクセス、これらのテーブルの SELECT 権限、RELOAD 権限 (FLUSH TABLES を実行できるように)、および LOCK TABLES 権限 (テーブルをロックできるように) を持っていなければなりません。
shell> mysqlhotcopy db_name [/path/to/new_directory]shell> mysqlhotcopy db_name_1 ... db_name_n /path/to/new_directory指定されたデータベース内で正規表現と一致するテーブルをバックアップします。
shell> mysqlhotcopy db_name./regex/
テーブル名の正規表現は、チルダ (「~」) をプリフィクスとして使用することで否定できます。
shell> mysqlhotcopy db_name./~regex/
mysqlhotcopy は次のオプションをサポートします。これらはコマンド行またはオプションファイルの [mysqlhotcopy] グループおよび [client] グループで指定できます。MySQL プログラムによって使用されるオプションファイルの詳細については、セクション4.2.6「オプションファイルの使用」を参照してください。
表 4.17 mysqlhotcopy のオプション
| 形式 | 説明 |
|---|---|
| --addtodest | ターゲットディレクトリの名前変更をせず (存在する場合)、単にファイルを追加 |
| --allowold | ターゲットが存在する場合中止せず、_old サフィクスを追加することで名前変更 |
| --checkpoint | チェックポイントエントリを挿入 |
| --chroot | mysqld が動作する chroot ジェイルのベースディレクトリ |
| --debug | デバッグのログを書き込み |
| --dryrun | アクションを実行せずにレポート |
| --flushlog | すべてのテーブルがロックされたあとにログをフラッシュ |
| --help | ヘルプメッセージを表示して終了 |
| --host | 指定されたホスト上で MySQL サーバーに接続 |
| --keepold | 終了後に以前の (名前変更された) ターゲットを消去しない |
| --method | ファイルをコピーする方法 |
| --noindices | フルインデックスファイルをバックアップに含めない |
| --old_server | FLUSH TABLES tbl_list WITH READ LOCK をサポートしないサーバーに接続しない |
| --password | サーバーに接続する際に使用するパスワード |
| --port | 接続に使用する TCP/IP ポート番号 |
| --quiet | エラー発生時以外サイレント |
| --regexp | 与えられた正規表現と一致する名前を持つデータベースをすべてコピー |
| --resetmaster | テーブルをすべてロックしたあとにバイナリログをリセット |
| --resetslave | テーブルをすべてロックしたあとに master.info ファイルをリセット |
| --socket | ローカルホストへの接続で、使用する Unix ソケットファイル |
| --tmpdir | 一時ディレクトリ |
| --user | サーバーへの接続時に使用する MySQL ユーザー名 |
-
ヘルプメッセージを表示して終了します。
-
ターゲットディレクトリの名前変更をせず (存在する場合)、単にファイルを追加します。
-
ターゲットが存在する場合、中止せず
_oldサフィクスを追加することで名前変更します。 -
指定されたデータベース
db_nameとテーブルtbl_nameにチェックポイントエントリを挿入します。 -
mysqld が稼働している chroot jail のベースディレクトリ。
path値は mysqld に与えられる--chrootオプションと一致するようにしてください。 -
デバッグ出力を有効化します。
-
アクションを実行せずにレポートします。
-
すべてのテーブルがロックされたあとにログをフラッシュします。
-
--host=,host_name-hhost_nameローカルサーバーへの TCP/IP 接続を行うために使用するローカルホストのホスト名。デフォルトでは、Unix ソケットファイルを使用して
localhostに接続します。 -
終了後に以前の (名前変更された) ターゲットを削除しません。
-
ファイルのコピー方法 (
cpまたはscp)。デフォルトはcpです。 -
MyISAMテーブルのフルインデックスファイルをバックアップに含めません。これによりバックアップを小さく、高速にできます。リロードされたテーブルのインデックスはあとで myisamchk -rq を使用して再構築できます。 -
--password=,password-ppasswordサーバーに接続する際に使用するパスワードです。ほかの MySQL プログラムとは異なり、このオプションではパスワード値はオプションではありません。
コマンド行でパスワードを指定することはセキュアでないとみなすべきです。セクション6.1.2.1「パスワードセキュリティーのためのエンドユーザーガイドライン」を参照してください。オプションファイルを使用すれば、コマンド行でパスワードを指定することを回避できます。
-
ローカルサーバーへの接続時に使用する TCP/IP ポート番号。
-
MySQL 5.6 では、mysqlhotcopy は
FLUSH TABLESを使用してテーブルのフラッシュおよびロックを実行します。サーバーが、このステートメントが導入された 5.5.3 より古い場合は、tbl_listWITH READ LOCK--old_serverオプションを使用します。 -
エラー発生時以外サイレントにします。
-
--record_log_pos=db_name.tbl_name指定されたデータベース
db_nameおよびテーブルtbl_nameに、マスターとスレーブのステータスを記録します。 -
与えられた正規表現と一致する名前を持つデータベースをすべてコピーします。
-
テーブルをすべてロックしたあとにバイナリログをリセットします。
-
テーブルをすべてロックしたあとに、マスター情報リポジトリファイルまたはテーブルをリセットします。
-
localhostへの接続に使用される Unix ソケットファイル。 -
コピーされたデータベースの名前に使用するサフィクス。
-
一時ディレクトリ。デフォルトは
/tmpです。 -
--user=,user_name-uuser_nameサーバーへの接続時に使用する MySQL ユーザー名。
--checkpoint オプションおよび --record_log_pos オプションに必要なテーブルの構造に関する情報を含めて、追加の mysqlhotcopy ドキュメントに関しては、perldoc を使用してください。
shell> perldoc mysqlhotcopy
Here it is, use at own risk.
package au.com.infomedix.utility;
import java.io.*;
import java.sql.*;
import java.util.Calendar;
import org.apache.commons.io.FileUtils;
/**
*
* A java representation of the perl mysqlhotcopy script
* Ref: http://dev.mysql.com/doc/refman/5.0/en/mysqlhotcopy.html
* <p>
* Some statistics for 28 files totaling 640MB:<br>
* <br>Windows Native: 104375 msecs
* <br>UNIX Native: 95520 msecs
* <br>
* <br>UNIX commons-io: 94657 msecs (1.5 mins)
* <br>WINDOWS commons-io: 96360 msecs (1.5 mins)
* <br>
*
* @TODO: Add a debug/verbose flag
* @TODO: Add more options
*
* @author Andrew Bruno
*
*/
public class MySqlHotCopy
{
private String username = null;
private String password = null;
/*
* Should always be localhost as files are assumed to be on the same server
* that mysql is running on. On Unix use 127.0.0.1 and not localhost or else
* you'll get Socket Exceptions
*/
private final String host = "127.0.0.1";
private String database = null;
private String url = null;
private String dirSourceIndex = null;
private String dirBackup = null;
private String copymode = null;
private static boolean error = false;
public MySqlHotCopy()
{
super();
}
public MySqlHotCopy( String args[] )
{
super();
username = args[0];
password = args[1];
database = args[2];
dirSourceIndex = args[3];
dirBackup = args[4];
copymode = args[5];
url = "jdbc:mysql://" + host + "/" + database;
}
/**
* @param args
*/
public static void main(String[] args)
{
if (args.length <= 0)
{
showUsageAndExit("Parameters missing", args);
}
else
{
if (args.length != 6)
{
showUsageAndExit("6 Parameters required", args);
}
else
{
MySqlHotCopy mySqlHotCopy = new MySqlHotCopy(args);
Connection conn = null;
try
{
Class.forName("com.mysql.jdbc.Driver").newInstance();
conn = DriverManager.getConnection(mySqlHotCopy.url, mySqlHotCopy.username, mySqlHotCopy.password);
System.out.println("Database connection established");
Statement s = conn.createStatement();
s.executeQuery("SHOW TABLES");
ResultSet rs = s.getResultSet();
String lockSqlCommand = "LOCK TABLES ";
String flushSqlCommand = "FLUSH TABLES ";
while (rs.next())
{
String tableName = (String) rs.getObject(1);
lockSqlCommand = lockSqlCommand + tableName + " READ";
flushSqlCommand = flushSqlCommand + tableName;
if (rs.isLast())
{
lockSqlCommand = lockSqlCommand + ";";
flushSqlCommand = flushSqlCommand + ";";
}
else
{
lockSqlCommand = lockSqlCommand + ", ";
flushSqlCommand = flushSqlCommand + ", ";
}
}
rs.close();
System.out.println("Lock Sql Command is " + lockSqlCommand);
System.out.println("Flush Sql Command is " + flushSqlCommand);
s.executeUpdate(lockSqlCommand);
s.executeUpdate(flushSqlCommand);
s.executeUpdate("FLUSH LOGS");
// s.executeUpdate("RESET MASTER");
// s.executeUpdate("RESET SLAVE");
long time = Calendar.getInstance().getTimeInMillis();
if (mySqlHotCopy.copymode.equals("nativedos"))
{
System.out.println("Using Native Dos mode to copy files");
String copyCommand = "cmd /c COPY /Y \"" + mySqlHotCopy.dirSourceIndex + "\" \"" + mySqlHotCopy.dirBackup + "\"";
System.out.println("DOS Copy Command = '" + copyCommand + "'");
Process process = Runtime.getRuntime().exec(copyCommand);
DataInputStream p_in = new DataInputStream(process.getInputStream());
BufferedReader d = new BufferedReader(new InputStreamReader(p_in));
String p_str;
while ((p_str = d.readLine()) != null)
{
System.out.println(p_str);
}
if (process.exitValue() != 0)
{
System.out.println("Dos copy process exited with an error value of " + process.exitValue());
}
}
else if (mySqlHotCopy.copymode.equals("nativeunix"))
{
final String copyCommand = "/bin/cp -v " + mySqlHotCopy.dirSourceIndex + "*" + " " + mySqlHotCopy.dirBackup;
System.out.println("Using Native Unix mode to copy files");
String[] cmd = { "/bin/sh", "-c", copyCommand };
System.out.println("UNIX Copy Command = '" + copyCommand + "'");
// See
// http://www.mountainstorm.com/publications/javazine.html
Process process = Runtime.getRuntime().exec(cmd, null, null);
DataInputStream p_in = new DataInputStream(process.getInputStream());
BufferedReader d_in = new BufferedReader(new InputStreamReader(p_in));
String p_str;
while ((p_str = d_in.readLine()) != null)
{
System.out.println(p_str);
}
DataInputStream p_err = new DataInputStream(process.getErrorStream());
BufferedReader d_err = new BufferedReader(new InputStreamReader(p_err));
String p_err_str;
while ((p_err_str = d_err.readLine()) != null)
{
System.out.println(p_err_str);
}
// OutputStreamWriter osWriter = new
// OutputStreamWriter(process.getOutputStream());
// PrintWriter out = new PrintWriter(osWriter);
// if ((process != null) && (process.exitValue() != 0))
// {
// System.out.println("UNIX copy process exited with an
// error value of " + process.exitValue());
// }
}
else if (mySqlHotCopy.copymode.equals("commonsiojava"))
{
System.out.println("Using Commons IO mode to copy files");
FileUtils.copyDirectory(new File(mySqlHotCopy.dirSourceIndex), new File(mySqlHotCopy.dirBackup));
}
else
{
showUsageAndExit("copymode " + mySqlHotCopy.copymode + " not supported", args);
}
time = Calendar.getInstance().getTimeInMillis() - time;
System.out.println("Copying of files took " + time + " milleseconds");
/* I dont think this is really needed */
s.executeUpdate("UNLOCK TABLES");
s.close();
}
catch (Exception e)
{
System.err.println("Exception caught: " + e.getMessage());
e.printStackTrace();
error = true;
}
finally
{
if (conn != null)
{
try
{
conn.close();
// System.out.println("Database connection terminated");
}
catch (Exception e)
{ /* ignore close errors */
}
}
}
if (error)
System.exit(1);
else
System.exit(0);
}
}
}
private static void showUsageAndExit(String errorString, String[] args)
{
System.err.println();
if ((errorString != null) && (errorString.length() != 0))
{
System.err.println("Error Message: " + errorString);
}
if (args.length != 0)
{
System.err.print(MySqlHotCopy.class.getName() + " called with parameters ");
for (int i = 0; i < args.length; i++)
{
String string = args[i];
System.err.print(string + " ");
}
System.err.println();
}
System.out.println("Usage: au.com.infomedix.udr.utility.MySqlHotCopy username password database dbindexdir dbbackupindexdir <copymode>");
System.out.println("where <copymode> is one of: ");
System.out.println("\t nativedos");
System.out.println("\t nativeunix");
System.out.println("\t commonsiojava");
System.exit(1);
}
}
On the other hand, if there is a way to find the directory location of where the index files to the MYISAM are via an SQL query, then you could alter code, and remove the sourceIndexDir field. This would add safely, and make the code smarter.
A bug report with a potential fix has been submitted.
This is how I finally did it in one line in bash:
cd /tmp/mysqlhotcopies/ && mysqlhotcopy --flushlog --regexp '.*' . && for d in *; do { mysqlhotcopy --flushlog --addtodest $d /tmp/mysqlhotcopies; } done
Suggestions welcomed.
-Kevin
DBD::mysql::db do failed: Can't find file: '...'
To avoid this you should dump the databases separately, so instead of doing
mysqlhotcopy --regexp='.+'.'.+' <dumpdir>
do it in two or more steps, for instance
mysqlhotcopy --regexp='^[a-m].+'.'.+' <dumpdir>
mysqlhotcopy --regexp='^[n-z].+'.'.+' <dumpdir>
DBD::mysql::db do failed: File '_path_to_file_' not found (Errcode: 24) at /usr/bin/mysqlhotcopy line 466.
A similar work around using regexp to split up the number of tables to dump should work.
If there is a --all-databases option for this utility would be a more elegant solution.
#!/usr/bin/perl
opendir (D, "/var/lib/mysql");
@f = readdir (D);
closedir (D);
foreach $file (@f)
{
$filename = "/var/lib/mysql/" . $file;
if (-d $filename && $file ne '.' && $file ne '..')
{
system "/usr/bin/mysqlhotcopy --allowold -u root $file /backup/mysql/";
}
}
That way only tables in one database are locked when copying files. If you have some very large database and other smaller all are locked because it takes a long time to copy the big one although smaller could be copied instantly.
#!/bin/bash
BACKUP_DIR=/backup
for i in `/usr/bin/find /var/lib/mysql/* -type d -printf "%f\n"`;do /usr/bin/mysqlhotcopy --allowold -u root $i $BACKUP_DIR; done
http://groups.google.co.uk/group/mailing.database.myodbc/browse_frm/thread/6309388ee0b0b295/45c8077d82d240e1?hl=en&lnk=st&q=mysql+backup+noindices#45c8077d82d240e1
The manual page is at
http://dev.mysql.com/doc/refman/4.1/en/repair-table.html