レプリケーション ログ リーダー エージェント

適用対象: SQL Server Azure SQL Managed Instance

レプリケーション ログ リーダー エージェントは、トランザクション レプリケーション用に構成した各データベースのトランザクション ログを監視し、レプリケーションのマークが付けられたトランザクションをトランザクション ログからディストリビューション データベースにコピーする実行可能ファイルです。

構文

logread [ -? ]
-Publisher server_name [ \instance_name ]
-PublisherDB publisher_database
[ -Continuous ]
[ -DefinitionFile def_path_and_file_name ]
[ -Distributor server_name[ \instance_name ] ]
[ -DistributorLogin distributor_login ]
[ -DistributorPassword distributor_password ]
[ -DistributorSecurityMode [ 0 | 1 ] ]
[ -EncryptionLevel [ 0 | 1 | 2 ] ]
[ -ExtendedEventConfigFile configuration_path_and_file_name ]
[ -HistoryVerboseLevel [ 0 | 1 | 2 ] ]
[ -KeepAliveMessageInterval keep_alive_message_interval_seconds ]
[ -LoginTimeOut login_time_out_seconds ]
[ -LogScanThreshold scan_threshold ]
[ -MaxCmdsInTran number_of_commands ]
[ -MessageInterval message_interval ]
[ -MultiSubnetFailover [ 0 | 1 ] ]
[ -Output output_path_and_file_name ]
[ -OutputVerboseLevel [ 0 | 1 | 2 | 3 | 4 ] ]
[ -PacketSize packet_size ]
[ -PollingInterval polling_interval ]
[ -ProfileName profile_name ]
[ -PublisherFailoverPartner server_name[ \instance_name ] ]
[ -PublisherSecurityMode [ 0 | 1 ] ]
[ -PublisherLogin publisher_login ]
[ -PublisherPassword publisher_password ]
[ -QueryTimeOut query_time_out_seconds ]
[ -ReadBatchSize number_of_transactions ]
[ -ReadBatchThreshold read_batch_threshold ]
[ -RecoverFromDataErrors ]

引数

-?

使用方法に関する情報を表示します。

-Publisher server_name [ \instance_name ]

パブリッシャーの名前。 そのサーバー上の SQL Server の既定のインスタンスの <server_name> を指定します。 そのサーバー上の SQL Server の名前付きインスタンスの <server_name>\<instance_name> を指定します。

-PublisherDB publisher_database

パブリッシャー データベースの名前。

-Continuous

エージェントがレプリケートされたトランザクションの呼び出しを継続的に試みるかどうかを指定します。 このパラメーターを指定する場合は、保留されているトランザクションがなくても、エージェントはポーリング間隔でレプリケートされたトランザクションをソースから呼び出します。

-DefinitionFile def_path_and_file_name

エージェント定義ファイルのパス。 エージェント定義ファイルには、エージェントのコマンド ライン引数が含まれます。 ファイルの内容は実行可能ファイルとして解析されます。 任意の文字を含む引数値を指定するには、二重引用符 (") を使用します。

-Distributor server_name [ \instance_name ]

ディストリビューター名。 そのサーバー上の SQL Server の既定のインスタンスの <server_name> を指定します。 そのサーバー上の SQL Server の名前付きインスタンスの <server_name>\<instance_name> を指定します。

-DistributorLogin distributor_login

ディストリビューターのログイン名。

-DistributorPassword distributor_password

ディストリビューターのパスワード。

-DistributorSecurityMode [ 0 | 1 ]

ディストリビューターのセキュリティ モードを指定します。 0の値は SQL Server 認証モード (既定値) を示し、1の値は Windows 認証モードを示します。

-EncryptionLevel [ 0 | 1 | 2 ]

トランスポート層セキュリティ (TLS) のレベル。以前は Secure Sockets Layer (SSL) と呼ばれ、接続時にログ リーダー エージェントによって使用される暗号化です。

詳細については、「 View and Modify Replication Security Settings」を参照してください。

-ExtendedEventConfigFile configuration_path_and_file_name

拡張イベントの XML 構成ファイルのパスとファイル名を指定します。 拡張イベントの構成ファイルによって、追跡に必要なセッションを構成し、イベントを有効にすることができます。 内部のみで使用します。

-HistoryVerboseLevel [ 0 | 1 | 2 ]

ログ リーダー操作中にログに記録する履歴の量を指定します。 1を選択すると、履歴ログのパフォーマンス効果を最小限に抑えることができます。

-KeepAliveMessageInterval keep_alive_message_interval_seconds

既存の接続のいずれかがサーバーからの応答を待機しているかどうかを、履歴スレッドが確認するまでの秒数。 長時間実行のときに、照合エージェントによってログ リーダー エージェントに SUSPECT とマークされないようにするには、この値を小さくします。 既定では 300 秒です。

-LoginTimeOut login_time_out_seconds

ログインがタイムアウトするまでの秒数。既定値は 15 秒です。

-LogScanThreshold scan_threshold

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

-MaxCmdsInTran number_of_commands

ログ リーダーがディストリビューション データベースにコマンドを書き込む際に、トランザクションにグループ化されるステートメントの最大数を指定します。 このパラメーターを使用すると、ログ リーダー エージェントおよびディストリビューション エージェントは、サブスクライバーでコマンドを適用するときに、パブリッシャーで (多数のコマンドで構成される) 大きなトランザクションを複数の小さなトランザクションに分割できます。 このパラメーターを指定すると、ディストリビューターでの競合を減らし、パブリッシャーとサブスクライバーの間の待機時間を減らすことができます。 元のトランザクションはより小さな単位で適用されるため、サブスクライバーは元のトランザクションの終了前に大規模な論理パブリッシャー トランザクションの行にアクセスでき、厳密なトランザクションのアトミック性が損なわれます。 既定値は 0 であり、パブリッシャーのトランザクション境界が保持されます。

このパラメーターは、SQL Server 以外のパブリケーションでは無視されます。 詳細については、「 トランザクション セット ジョブの構成」を参照してください。

MaxCmdsInTran は、常にオンにするように設計されていませんでした。 これは、1 つのトランザクションで多数の DML 操作を誤って実行した場合に回避されます。 これにより、トランザクション全体がディストリビューション データベース内に存在し、ロックが保持されるまで、コマンドの配布が遅れます。このような状況が日常的に発生する場合は、アプリケーションを確認し、トランザクション サイズを小さくする方法を見つけます。

-MessageInterval message_interval

履歴ログに使用される時間間隔。 履歴イベントは、最後の履歴イベントがログに記録された後に MessageInterval 値に達したときにログに記録されます。

ソースで使用できるレプリケートされたトランザクションがない場合、エージェントはトランザクションなしメッセージをディストリビューターに報告します。 このオプションは、エージェントが次にトランザクションなしのメッセージを報告するまでの待ち時間を指定します。 前回レプリケートされたトランザクションを処理した後で、ソースに利用可能なトランザクションがないことを検出すると、エージェントは必ずトランザクションなしのメッセージを報告します。 既定値は 60 秒です。

-MultiSubnetFailover [ 0 | 1 ]

適用対象: SQL Server 2019 (15.x) 以降のバージョン。

MultiSubnetFailover プロパティを有効にするかどうかを指定します。 アプリケーションが異なるサブネット上の AlwaysOn 可用性グループ (AG) に接続している場合、MultiSubnetFailover を 1 (true) に設定すると、(現在) アクティブなサーバーの検出と接続が速くなります。

AG でトランザクション パブリケーションを構成すると、ログ リーダー エージェントによって、リスナーがメタデータを検証するための動的リンク サーバーが作成されます。 SQL Server 2022 (16.x) CU 10 以降のバージョンでは、動的リンク サーバーの構成が変更されています。 詳しくは、KB5031778 を参照してください。

-Output output_path_and_file_name

エージェント出力ファイルのパス。 ファイル名が指定されていない場合、出力はコンソールに送信されます。 指定された名前のファイルが存在する場合、出力はそのファイルに追加されます。

-OutputVerboseLevel [ 0 | 1 | 2 | 3 | 4 ]

出力を詳細表示にするかどうかを指定します。

値 2 ～ 4 はデバッグ時に有用です。

-PacketSize packet_size

パケット サイズ (バイト単位)。 既定値は 4096 (バイト) です。

-PollingInterval polling_interval

レプリケートされたトランザクションに対してログが照会される頻度 (秒単位)。 既定値は 5 秒です。

-ProfileName profile_name

エージェント パラメーターに使用するエージェント プロファイルを指定します。 ProfileNameがNULLされている場合、エージェント プロファイルは無効になります。 ProfileNameが指定されていない場合は、エージェントの種類の既定のプロファイルが使用されます。 詳細については、「レプリケーション エージェント プロファイル」を参照してください。

-PublisherFailoverPartner server_name [ \instance_name ]

パブリケーション データベースとのデータベース ミラーリング セッションに参加する、SQL Server フェールオーバー パートナー インスタンスを指定します。 詳細については、「データベース ミラーリングとレプリケーション (SQL Server)」をご覧ください。

-PublisherSecurityMode [ 0 | 1 ]

パブリッシャーのセキュリティ モードを指定します。 0 の値は SQL Server 認証 (既定値) を示し、1 の値は Windows 認証モードを示します。

-PublisherLogin publisher_login

パブリッシャー のログイン名。

-PublisherPassword publisher_password

発行元のパスワード。

-QueryTimeOut query_time_out_seconds

クエリがタイムアウトするまでの秒数。既定値は 1,800 秒です。

-ReadBatchSize number_of_transactions

処理サイクルごとに発行データベースのトランザクション ログから読み取られるトランザクションの最大数。既定値は 500、最大は 10000 です。 エージェントは、すべてのトランザクションがログから読み取られるまで、トランザクションをバッチで読み取り続けます。 このパラメーターは、Oracle パブリッシャーではサポートされていません。

-ReadBatchThreshold number_of_commands

ディストリビューション エージェントによってサブスクライバーに発行される前にトランザクション ログから読み取られるレプリケーション コマンドの数。 既定値は 0 です。 このパラメーターが指定されていない場合、ログ リーダー エージェントはログの末尾または -ReadBatchSize で指定された数 (トランザクション数) を読み取ります。

-RecoverFromDataErrors

SQL Server 以外のパブリッシャーからパブリッシュされる列データでエラーが発生しても、ログ リーダー エージェントを継続して実行することを指定します。 既定では、このようなエラーが発生するとログ リーダー エージェントは失敗します。 -RecoverFromDataErrorsを使用すると、誤った列データがNULLまたは適切な null 以外の値としてレプリケートされ、警告メッセージがMSlogreader_history テーブルに記録されます。 このパラメーターは、Oracle パブリッシャーに対してのみサポートされます。

解説

ドメイン ユーザー アカウント (既定値) ではなくローカル システム アカウントで実行するように SQL Server エージェントをインストールした場合、サービスはローカル コンピューターにのみアクセスできます。 SQL Server エージェントから実行されるログ リーダー エージェントで、Windows 認証モードを使用するように構成すると、SQL Server へのログイン時にログ リーダー エージェントは異常終了します。 既定の設定は SQL Server 認証です。 セキュリティ アカウント変更の詳細については、「 View and Modify Replication Security Settings」を参照してください。

ログ リーダー エージェントを起動するには、コマンド プロンプトから logread.exe を実行します。 詳細については、「レプリケーション エージェント実行可能ファイルの概念」を参照してください。

関連するコンテンツ

• レプリケーション エージェントの管理