--help, -?

ヘルプメッセージを表示して終了します。

--base64-output=value

このオプションは、イベントをいつ BINLOG ステートメントを使用して、base-64 文字列としてエンコードして表示するべきかを決定します。 このオプションには次の許容値があります (大/小文字は区別されません):

--base64-output および --verbose の行イベント出力への影響を示す例は、セクション4.6.8.2「mysqlbinlog 行イベントの表示」を参照してください。

--bind-address=ip_address

複数のネットワークインタフェースを持つコンピュータで、このオプションを使用して、MySQL サーバーへの接続に使用するインタフェースを選択します。

--binlog-row-event-max-size=N

行ベースのバイナリログイベントの最大サイズをバイト単位で指定します。 可能であれば、行はこのサイズより小さいイベントにグループ化されます。 値は 256 の倍数であるべきです。 デフォルトは 4G バイトです。

--character-sets-dir=dir_name

文字セットがインストールされているディレクトリ。 セクション10.15「文字セットの構成」を参照してください。

--compress

可能であれば、クライアントとサーバーの間で送信されるすべての情報を圧縮します。 セクション4.2.8「接続圧縮制御」を参照してください。

このオプションは MySQL 8.0.17 で追加されました。 MySQL 8.0.18 では非推奨です。 MySQL の将来のバージョンで削除されることが予想されます。 レガシー接続圧縮の構成を参照してください。

--compression-algorithms=value

サーバーへの接続に許可される圧縮アルゴリズム。 使用可能なアルゴリズムは、protocol_compression_algorithms システム変数の場合と同じです。 デフォルト値は uncompressed です。

詳細は、セクション4.2.8「接続圧縮制御」を参照してください。

このオプションは MySQL 8.0.18 で追加されました。

--connection-server-id=server_id

--connection-server-id は、mysqlbinlog がサーバーへの接続時にレポートするサーバー ID を指定します。 これは、レプリカサーバーまたは別の mysqlbinlog プロセスの ID との競合を回避するために使用できます。

--read-from-remote-server オプションが指定されている場合、mysqlbinlog はサーバー ID 0 を報告します。これは、最後のログファイルを送信した後に切断するようにサーバーに指示します (非ブロッキング動作)。 サーバーへの接続を維持するために --stop-never オプションも指定されている場合、mysqlbinlog はデフォルトで 0 の代わりに 1 のサーバー ID を報告し、必要に応じて --connection-server-id を使用してそのサーバー ID を置き換えることができます。 セクション4.6.8.4「mysqlbinlog サーバー ID の指定」を参照してください。

--database=db_name, -d db_name

このオプションを使用すると、mysqlbinlog は、USE によって db_name がデフォルトデータベースとして選択されている間に発生するバイナリログ (ローカルログのみ) からのエントリを出力するようになります。

mysqlbinlog の --database オプションは、mysqld の --binlog-do-db オプションと同様ですが、指定できるのは 1 つのデータベースのみです。 --database を複数回指定すると、最後のインスタンスのみが使用されます。

このオプションの影響は、ステートメントベースまたは行ベースのロギング形式のどちらが使用されているかによって異なります。これは、--binlog-do-db の影響がステートメントベースまたは行ベースのいずれのロギングが使用されているかによって異なるのと同じです。

ステートメントベースのロギング.  --database オプションは次のように機能します。

これらのステートメントを実行することによって、ステートメントベースのロギングを使用してバイナリログが作成されたとします。

INSERT INTO test.t1 (i) VALUES(100);
INSERT INTO db2.t2 (j)  VALUES(200);
USE test;
INSERT INTO test.t1 (i) VALUES(101);
INSERT INTO t1 (i)      VALUES(102);
INSERT INTO db2.t2 (j)  VALUES(201);
USE db2;
INSERT INTO test.t1 (i) VALUES(103);
INSERT INTO db2.t2 (j)  VALUES(202);
INSERT INTO t2 (j)      VALUES(203);

デフォルトデータベースがないため、mysqlbinlog --database=test は最初の 2 つの INSERT ステートメントを出力しません。 USE test に続く 3 つの INSERT ステートメントは出力しますが、USE db2 に続く 3 つの INSERT ステートメントは出力しません。

デフォルトデータベースがないため、mysqlbinlog --database=db2 は最初の 2 つの INSERT ステートメントを出力しません。 USE test に続く 3 つの INSERT ステートメントは出力しませんが、USE db2 に続く 3 つの INSERT ステートメントは出力します。

行ベースのロギング.  mysqlbinlog は、db_name に属するテーブルを変更するエントリのみを出力します。 これにはデフォルトのデータベースには影響しません。 今説明したバイナリログが、ステートメントベースのロギングではなく行ベースのロギングを使用して作成されたとします。mysqlbinlog --database=test は、USE が発行されたか、またはデフォルトのデータベースが何かにかかわらず、テストデータベースの t1 を変更するエントリのみを出力します。

サーバーが、binlog_format が MIXED に設定された状態で稼働していて、mysqlbinlog を --database オプションで使用できるようにする場合、変更されるテーブルが USE で選択されたデータベースであることを保証する必要があります。 (特に、クロスデータベースの更新は使用しないようにしてください。)

--rewrite-db オプションとともに使用すると、最初に --rewrite-db オプションが適用され、リライトされたデータベース名を使用して --database オプションが適用されます。 オプションが指定されている順序に違いはありません。

--debug[=debug_options], -# [debug_options]

デバッグのログを書き込みます。 一般的な debug_options 文字列は d:t:o,file_name です。 デフォルトは d:t:o,/tmp/mysqlbinlog.trace です。

このオプションは、MySQL が WITH_DEBUG を使用して構築された場合にのみ使用できます。 Oracle によって提供される MySQL リリースバイナリは、このオプションを使用して構築されません。

--debug-check

プログラムの終了時に、デバッグ情報を出力します。

このオプションは、MySQL が WITH_DEBUG を使用して構築された場合にのみ使用できます。 Oracle によって提供される MySQL リリースバイナリは、このオプションを使用して構築されません。

--debug-info

プログラムの終了時に、デバッグ情報とメモリーおよび CPU 使用率の統計を出力します。

このオプションは、MySQL が WITH_DEBUG を使用して構築された場合にのみ使用できます。 Oracle によって提供される MySQL リリースバイナリは、このオプションを使用して構築されません。

--default-auth=plugin

使用するクライアント側認証プラグインに関するヒント。 セクション6.2.17「プラガブル認証」を参照してください。

--defaults-extra-file=file_name

このオプションファイルは、グローバルオプションファイルのあとに読み取りますが、(UNIX では) ユーザーオプションファイルの前に読み取るようにしてください。 ファイルが存在しないかアクセスできない場合、エラーが発生します。file_name は、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--defaults-file=file_name

指定されたオプションファイルのみ使用します。 ファイルが存在しないかアクセスできない場合、エラーが発生します。file_name は、フルパス名でなく相対パス名として指定された場合、現行ディレクトリを基準にして解釈されます。

例外: --defaults-file でも、クライアントプログラムは .mylogin.cnf を読み取ります。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--defaults-group-suffix=str

通常のオプショングループだけでなく、通常の名前に str のサフィクスが付いたグループも読み取ります。 たとえば、mysqlbinlog は通常 [client] グループおよび [mysqlbinlog] グループを読み取ります。 --defaults-group-suffix=_other オプションを指定した場合、mysqlbinlog は [client_other] グループおよび [mysqlbinlog_other] グループも読み取ります。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--disable-log-bin, -D

バイナリロギングを無効化します。 これは、--to-last-log オプションを使用して同じ MySQL サーバーに対して出力を送信している場合、無限ループを回避するのに便利です。 このオプションは、ログに記録したステートメントの重複を回避するために、予期しない終了後にリストアする場合にも役立ちます。

このオプションを使用すると、mysqlbinlog の出力に SET sql_log_bin = 0 ステートメントが含まれ、残りの出力のバイナリロギングが無効になります。 sql_log_bin システム変数のセッション値の操作は制限付き操作であるため、このオプションを使用するには、制限付きセッション変数を設定するのに十分な権限が必要です。 セクション5.1.9.1「システム変数権限」を参照してください。

--exclude-gtids=gtid_set

gtid_set にリストされたグループを表示しません。

--force-if-open, -F

バイナリログファイルが開いているか適切に閉じられていない場合でも読み取ります。

--force-read, -f

このオプションでは、mysqlbinlog が認識できないバイナリログイベントを読み取った場合に、警告を出力し、イベントを無視して続行します。 このオプションを使用しない場合は、mysqlbinlog はそのようなイベントを読み取ると停止します。

--get-server-public-key

RSA キーペアベースのパスワード交換に必要な公開キーをサーバーにリクエストします。 このオプションは、caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 そのプラグインの場合、サーバーは要求されないかぎり公開鍵を送信しません。 このオプションは、そのプラグインで認証されないアカウントでは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

--server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、--get-server-public-key よりも優先されます。

caching_sha2_password プラグインの詳細は、セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

--hexdump, -H

セクション4.6.8.1「mysqlbinlog 16 進ダンプ形式」に説明されているように、ログの 16 進ダンプをコメントに表示します。 16 進出力はレプリケーションのデバッグに便利な場合があります。

--host=host_name, -h host_name

指定されたホストの MySQL サーバーからバイナリログを取得します。

--idempotent

更新の処理中に多重呼出し不変モードを使用するように MySQL Server に指示します。これにより、更新の処理中に現在のセッションでサーバーが検出した重複キーまたはキーが見つからないエラーが抑制されます。 このオプションは、必要に応じて、またはログが参照するすべてのデータが含まれていない可能性がある MySQL Server にバイナリログをリプレイする必要がある場合に便利です。

このオプションの効果の範囲には、現在の mysqlbinlog クライアントおよびセッションのみが含まれます。

--include-gtids=gtid_set

gtid_set にリストされたグループのみを表示します。

--local-load=dir_name, -l dir_name

LOAD DATA ステートメントに対応するデータロード操作の場合、mysqlbinlog はバイナリログイベントからファイルを抽出し、一時的なファイルとしてローカルファイルシステムに書き込み、LOAD DATA LOCAL ステートメントを書き込んでファイルをロードします。 デフォルトでは、mysqlbinlog はこれらの一時ファイルをオペレーティングシステム固有のディレクトリに書き込みます。 --local-load オプションを使用すると、mysqlbinlog がローカル一時ファイルを準備するディレクトリを明示的に指定できます。

他のプロセスはデフォルトのシステム固有のディレクトリにファイルを書き込むことができるため、mysqlbinlog に --local-load オプションを指定してデータファイルに別のディレクトリを指定し、mysqlbinlog からの出力を処理するときに mysql に --load-data-local-dir オプションを指定して同じディレクトリを指定することをお薦めします。 例:

mysqlbinlog --local-load=/my/local/data ...
    | mysql --load-data-local-dir=/my/local/data ...

--login-path=name

.mylogin.cnf ログインパスファイルの指定されたログインパスからオプションを読み取ります。 「「ログインパス」」は、接続先の MySQL サーバーおよび認証に使用するアカウントを指定するオプションを含むオプショングループです。 ログインパスファイルを作成または変更するには、mysql_config_editor ユーティリティを使用します。 セクション4.6.7「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--no-defaults

オプションファイルを読み取りません。 オプションファイルから不明のオプションを読み取ることが原因でプログラムの起動に失敗する場合、--no-defaults を使用して、オプションを読み取らないようにできます。

例外として、.mylogin.cnf ファイルは、存在する場合はすべての場合に読み取られます。 これにより、--no-defaults が使用された場合にも、コマンド行よりも安全な方法でパスワードを指定できます。(.mylogin.cnf は mysql_config_editor ユーティリティーによって作成されます。 セクション4.6.7「mysql_config_editor — MySQL 構成ユーティリティー」を参照してください)。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--offset=N, -o N

ログの最初の N 個のエントリをスキップします。

--open-files-limit=N

予約するオープンファイルディスクリプタの数を指定します。

--password[=password], -p[password]

サーバーへの接続に使用される MySQL アカウントのパスワード。 パスワード値はオプションです。 指定しない場合、mysqlbinlog によってプロンプトが表示されます。 指定する場合は、--password= または -p とそれに続くパスワードの間にスペースなしが存在する必要があります。 パスワードオプションを指定しない場合、デフォルトではパスワードは送信されません。

コマンド行でのパスワード指定は、セキュアでないと考えるべきです。 コマンド行でパスワードを指定しないようにするには、オプションファイルを使用します。 セクション6.1.2.1「パスワードセキュリティーのためのエンドユーザーガイドライン」を参照してください。

パスワードがなく、mysqlbinlog でパスワードの入力を求められないように明示的に指定するには、--skip-password オプションを使用します。

--plugin-dir=dir_name

プラグインを検索するディレクトリ。 このオプションは、--default-auth オプションを使用して認証プラグインを指定しても、mysqlbinlog がそれを検出しない場合に指定します。 セクション6.2.17「プラガブル認証」を参照してください。

--port=port_num, -P port_num

リモートサーバーへの接続に使用する TCP/IP ポート番号。

--print-defaults

プログラム名と、オプションファイルから受け取るすべてのオプションを出力します。

このオプションおよびその他のオプションファイルオプションの詳細は、セクション4.2.2.3「オプションファイルの処理に影響するコマンド行オプション」 を参照してください。

--print-table-metadata

バイナリログからテーブル関連のメタデータを出力します。 binlog-row-metadata を使用して、ログに記録されるテーブル関連のメタデータバイナリの量を構成します。

--protocol={TCP|SOCKET|PIPE|MEMORY}

サーバーへの接続に使用するトランスポートプロトコル。 これは、他の接続パラメータが通常、必要なプロトコル以外のプロトコルを使用する場合に便利です。 許可される値の詳細は、セクション4.2.7「接続トランスポートプロトコル」を参照してください。

--raw

デフォルトでは、mysqlbinlog はバイナリログファイルを読み取り、イベントをテキスト形式で書き出します。 --raw オプションは mysqlbinlog に対して、元のバイナリ形式で書き出すことを指示します。 ファイルはサーバーから要求されるため、これを使用するには、--read-from-remote-server も使用する必要があります。mysqlbinlog はサーバーから読み取った各ファイルに対して 1 つの出力ファイルを書き出します。 --raw オプションは、サーバーのバイナリログのバックアップを作成するために使用できます。 --stop-never オプションを使用すると、mysqlbinlog はサーバーに接続されたままになるため、バックアップは「ライブ」です。 デフォルトでは、出力ファイルは現在のディレクトリに元のログファイルと同じ名前で書き出されます。 出力ファイル名は --result-file オプションを使用して変更できます。 詳細は、セクション4.6.8.3「バイナリログファイルのバックアップのための mysqlbinlog の使用」を参照してください。

--read-from-remote-master=type

COM_BINLOG_DUMP コマンドまたは COM_BINLOG_DUMP_GTID コマンドで、オプション値をそれぞれ BINLOG-DUMP-NON-GTIDS または BINLOG-DUMP-GTIDS に設定して、MySQL サーバーからバイナリログを読み取ります。 --read-from-remote-master=BINLOG-DUMP-GTIDS が --exclude-gtids と組み合されている場合、不要なネットワークトラフィックを回避するために、ソースでトランザクションをフィルタで除外できます。

接続パラメータオプションは、このオプションまたは --read-from-remote-server オプションとともに使用します。 これらのオプションは --host、--password、--port、--protocol、--socket、および --user です。 どちらのリモートオプションも指定しない場合、接続パラメータオプションは無視されます。

このオプションを使用するには、REPLICATION SLAVE 権限が必要です。

--read-from-remote-server, -R

バイナリログをローカルログファイルからではなく MySQL サーバーから読み取ります。 このオプションでは、リモートサーバーが稼働していることが必要です。 リモートサーバー上のバイナリログファイルに対してのみ機能します。リレーログファイルには機能しません。

接続パラメータオプションは、このオプションまたは --read-from-remote-master オプションとともに使用します。 これらのオプションは --host、--password、--port、--protocol、--socket、および --user です。 どちらのリモートオプションも指定しない場合、接続パラメータオプションは無視されます。

このオプションを使用するには、REPLICATION SLAVE 権限が必要です。

このオプションは、--read-from-remote-master=BINLOG-DUMP-NON-GTIDS に似ています。

--result-file=name, -r name

--raw オプションがない場合は、このオプションは mysqlbinlog がテキスト出力を書き出すファイルを示します。 --raw がある場合は、mysqlbinlog はサーバーから転送される各ログファイルに対して 1 つのバイナリ出力ファイルを、デフォルトでは現在のディレクトリに元のログファイルと同じ名前で書き出します。 この場合、--result-file オプションの値は出力ファイル名を変更するプリフィクスとして処理されます。

--require-row-format

イベントの行ベースのバイナリロギング形式が必要です。 このオプションは、mysqlbinlog 出力に行ベースのレプリケーションイベントを強制します。 このオプションを使用して生成されたイベントのストリームは、(MySQL 8.0.23 の) CHANGE REPLICATION SOURCE TO ステートメントまたは CHANGE MASTER TO ステートメント (MySQL 8.0.23 の前) の REQUIRE_ROW_FORMAT オプションを使用して保護されたレプリケーションチャネルによって受け入れられます。binlog_format=ROW は、バイナリログが書き込まれたサーバーに設定する必要があります。 このオプションを指定すると、LOAD DATA INFILE 命令、一時テーブルの作成または削除、INTVAR、RAND または USER_VAR イベント、DML トランザクション内の行ベース以外のイベントなど、REQUIRE_ROW_FORMAT 制限の下で許可されていないイベントが発生した場合、mysqlbinlog はエラーメッセージで停止します。また、mysqlbinlog は、制限を適用するためその出力の開始時に、出力が実行されたが SET @@session.pseudo_thread_id ステートメントがプリントされない場合、SET @@session.require_row_format ステートメントをプリントします。

このオプションは MySQL 8.0.19 で追加されました。

--rewrite-db='from_name->to_name'

行ベースまたはステートメントベースのログから読み取る場合は、すべての from_name を to_name にリライトします。 リライトは、ステートメントベースのログの行、行ベースのログおよび USE 句に対して実行されます。

このオプションの値として使用されるリライトルールは、前述のように'from_name->to_name'という形式の文字列であり、このため引用符で囲む必要があります。

複数のリライトルールを使用するには、次に示すように、オプションを複数回指定します:

shell> mysqlbinlog --rewrite-db='dbcurrent->dbold' --rewrite-db='dbtest->dbcurrent' \
                     binlog.00001 > /tmp/statements.sql

--database オプションとともに使用すると、最初に --rewrite-db オプションが適用され、リライトされたデータベース名を使用して --database オプションが適用されます。 オプションが指定されている順序に違いはありません。

これは、たとえば、mysqlbinlog が --rewrite-db='mydb->yourdb' --database=yourdb で起動された場合、データベース mydb および yourdb 内のテーブルに対するすべての更新が出力に含まれることを意味します。 一方、--rewrite-db='mydb->yourdb' --database=mydb で起動された場合、mysqlbinlog はステートメントをまったく出力しません: mydb へのすべての更新は、--database オプションを適用する前に yourdb への更新として最初にリライトされるため、--database=mydb に一致する更新は残っていません。

--server-id=id

指定されたサーバー ID を持つサーバーによって作成されたイベントのみを表示します。

--server-id-bits=N

サーバーを特定するために、server_id の最初の N ビットのみを使用します。 server-id-bits が 32 未満にセットされ、ユーザーデータが最上位ビットに保存される mysqld によってバイナリログが書き出された場合、--server-id-bits を 32 にセットして mysqlbinlog を実行するとこのデータを表示できます。

このオプションは、NDB Cluster ディストリビューションで提供される mysqlbinlog のバージョン、または NDB Cluster サポートで構築されたバージョンでのみサポートされます。

--server-public-key-path=file_name

RSA キーペアベースのパスワード交換のためにサーバーが必要とする公開キーのクライアント側コピーを含む、PEM 形式のファイルへのパス名。 このオプションは、sha256_password または caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 これらのプラグインのいずれかで認証されないアカウントでは、このオプションは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

--server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、--get-server-public-key よりも優先されます。

sha256_password の場合、このオプションは、MySQL が OpenSSL を使用して構築された場合にのみ適用されます。

sha256_password および caching_sha2_password プラグインの詳細は、セクション6.4.1.3「SHA-256 プラガブル認証」 および セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

--set-charset=charset_name

SET NAMES charset_name ステートメントを出力に追加して、ログファイルの処理に使用される文字セットを指定します。

--shared-memory-base-name=name

Windows の場合、共有メモリを使用してローカルサーバに接続するために使用する共有メモリ名。 デフォルト値は MYSQL です。 共有メモリー名では大文字と小文字が区別されます。

このオプションは、共有メモリー接続をサポートするために shared_memory システム変数を有効にしてサーバーを起動した場合にのみ適用されます。

--short-form, -s

追加情報および行ベースのイベントなしで、ログに含まれるステートメントのみを表示します。 これはテスト専用で、本番環境のシステムで使用するべきではありません。 これは非推奨であり、将来のリリースで削除される予定です。

--skip-gtids[=(true|false)]

出力に GTID を表示しません。 これは、次の例に示すように GTID を含む 1 つまたは複数のバイナリログからダンプファイルに書き出す場合に必要です。

shell> mysqlbinlog --skip-gtids binlog.000001 >  /tmp/dump.sql
shell> mysqlbinlog --skip-gtids binlog.000002 >> /tmp/dump.sql
shell> mysql -u root -p -e "source /tmp/dump.sql"

そうでない場合には、このオプションを本番環境で使用することは、通常推奨されません。

--socket=path, -S path

localhost への接続用に使用する、Unix ソケットファイル、または Windows では使用する名前付きパイプの名前。

Windows では、このオプションは、名前付きパイプ接続をサポートするために named_pipe システム変数を有効にしてサーバーを起動した場合にのみ適用されます。 また、接続を行うユーザーは、named_pipe_full_access_group システム変数で指定された Windows グループのメンバーである必要があります。

--ssl*

--ssl で始まるオプションは、SSL を使用してサーバーに接続するかどうかを指定し、SSL 鍵および証明書を検索する場所を指定します。 暗号化接続のコマンドオプションを参照してください。

--ssl-fips-mode={OFF|ON|STRICT}

クライアント側で FIPS モードを有効にするかどうかを制御します。 --ssl-fips-mode オプションは、暗号化された接続の確立には使用されず、許可する暗号化操作に影響する点で、他の --ssl-xxx オプションとは異なります。 セクション6.8「FIPS のサポート」を参照してください。

次の --ssl-fips-mode 値を使用できます:

--start-datetime=datetime

datetime 引数と同じかそれより遅いタイムスタンプを持つ最初のイベントから、バイナリログの読み取りを始めます。 datetime 値は、mysqlbinlog を実行するマシンのローカルタイムゾーンに相対的です。 値は DATETIME または TIMESTAMP データ型に受け付けられる形式にしてください。 例:

shell> mysqlbinlog --start-datetime="2005-12-25 11:25:56" binlog.000003

このオプションはポイントインタイムリカバリに便利です。 セクション7.5「Point-in-Time (増分) リカバリ」を参照してください。

--start-position=N, -j N

ログ位置 N でバイナリログのデコードを開始します。出力には、位置 N 以降で開始するイベントも含まれます。 位置はログファイル内のバイトポイントであり、イベントカウンタではありません。有用な出力を生成するには、イベントの開始位置を指す必要があります。 このオプションはコマンド行で最初に指名されたログファイルに適用されます。

このオプションはポイントインタイムリカバリに便利です。 セクション7.5「Point-in-Time (増分) リカバリ」を参照してください。

--stop-datetime=datetime

datetime 引数と同じかそれより遅いタイムスタンプを持つ最初のイベントで、バイナリログの読み取りを終了します。 datetime 値の詳細については、--start-datetime オプションの説明を参照してください。

このオプションはポイントインタイムリカバリに便利です。 セクション7.5「Point-in-Time (増分) リカバリ」を参照してください。

--stop-never

このオプションは --read-from-remote-server とともに使用されます。 mysqlbinlog に対して、サーバーに接続したままの状態を保つことを指示します。 そうしないと、mysqlbinlog は最後のログファイルがサーバーから転送された時点で終了します。--stop-never は暗黙的に --to-last-log を指定するため、コマンド行で指名する必要があるのは転送される最初のログファイルのみです。

--stop-never は一般的に、ライブバイナリログバックアップを作成するために --raw とともに使用されますが、--raw なしで使用して、サーバーがログイベントを生成するに従ってそれらを継続的にテキスト表示することも可能です。

--stop-never では、デフォルトで、mysqlbinlog はサーバーへの接続時にサーバー ID 1 を報告します。 --connection-server-id を使用して、レポートする代替 ID を明示的に指定します。 これは、レプリカサーバーまたは別の mysqlbinlog プロセスの ID との競合を回避するために使用できます。 セクション4.6.8.4「mysqlbinlog サーバー ID の指定」を参照してください。

--stop-never-slave-server-id=id

このオプションは非推奨です。将来のリリースで削除される予定です。 かわりに --connection-server-id オプションを使用して、レポートする mysqlbinlog のサーバー ID を指定します。

--stop-position=N

ログ位置 N 以降で開始するイベントを出力から除外して、ログ位置 N でバイナリログのデコードを停止します。 位置はログファイル内のバイトポイントであり、イベントカウンタではありません。出力に含める最後のイベントの開始位置の後の位置を指す必要があります。 位置 N の前に開始し、位置以降に終了するイベントが、最後に処理されるイベントです。 このオプションは、コマンド行で最後に指名されたログファイルに適用されます。

このオプションはポイントインタイムリカバリに便利です。 セクション7.5「Point-in-Time (増分) リカバリ」を参照してください。

--tls-ciphersuites=ciphersuite_list

TLSv1.3 を使用する暗号化された接続に許可される暗号スイート。 値は、コロンで区切られた 1 つ以上の暗号スイート名のリストです。 このオプションに指定できる暗号スイートは、MySQL のコンパイルに使用される SSL ライブラリによって異なります。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。

このオプションは MySQL 8.0.16 で追加されました。

--tls-version=protocol_list

暗号化された接続に許可される TLS プロトコル。 値は、1 つまたは複数のコンマ区切りプロトコル名のリストです。 このオプションに指定できるプロトコルは、MySQL のコンパイルに使用される SSL ライブラリによって異なります。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。

--to-last-log, -t

MySQL サーバーから要求されたバイナリログの最後で終了せず、最後のバイナリログの最後まで続けて出力します。 同じ MySQL サーバーに出力を送信した場合、無限ループになる場合があります。 このオプションには --read-from-remote-server が必要です。

--user=user_name, -u user_name

リモートサーバーへの接続時に使用する MySQL アカウントのユーザー名。

--verbose, -v

行イベントを再構築し、該当する場合はテーブルパーティション情報とともにコメント付き SQL ステートメントとして表示します。 このオプションを (\"-vv \"または\"--verbose --verbose\"のいずれかを渡して) 2 回指定すると、出力には、カラムのデータ型と一部のメタデータを示すコメント、および binlog_rows_query_log_events システム変数が TRUE に設定されている場合の行クエリーログイベントなどの情報ログイベントが含まれます。

--base64-output および --verbose の行イベント出力への影響を示す例は、セクション4.6.8.2「mysqlbinlog 行イベントの表示」を参照してください。

--verify-binlog-checksum, -c

バイナリログファイルのチェックサムを検証します。

--version, -V

バージョン情報を表示して終了します。

このオプションを使用するときに表示される mysqlbinlog のバージョン番号は、3.4 です。

--zstd-compression-level=level

zstd 圧縮アルゴリズムを使用するサーバーへの接続に使用する圧縮レベル。 許可されるレベルは 1 から 22 で、大きい値は圧縮レベルの増加を示します。 デフォルトの zstd 圧縮レベルは 3 です。 圧縮レベルの設定は、zstd 圧縮を使用しない接続には影響しません。

詳細は、セクション4.2.8「接続圧縮制御」を参照してください。

このオプションは MySQL 8.0.18 で追加されました。