実験機器からMySQLデータベースへのデータログ記録方法

RS232コネクタを備えた実験機器をポーリングし、抽出したデータをMySQLデータベースに直接エクスポートする完全ガイド。

1. プロトコル設定: 研究室機器

通信タイプ: パッシブリスニング / 双方向（RS232またはUSB仮想COM）

分光光度計、滴定装置、血液分析装置は、専用のASCIIフォーマットやASTM E1381/E1394プロトコルを使用することが多いです。機器が生のASCIIを出力する場合は、「ASCIIデータパーサー」を使用します。ASTMを使用する場合は、専用の「ASTMデータパーサー」プラグインを使用して、ヘッダー（H）、患者（P）、オーダー（O）、結果（R）の各レコードを正しく展開する必要があります。

シリアル接続にこの基本設定を適用してください:

{
  "port": "COM4",
  "baud_rate": 9600,
  "data_bits": 8,
  "stop_bits": 1,
  "parity": "none",
  "parser_type": "astm_e1381",
  "ack_nak_handshake": true
}

2. データベース設定: MySQL

Data Loggerを実行するマシンにMySQL Connector/ODBCがインストールされている必要があります。MySQLサーバーインスタンスを指すシステムDSNを作成してください。

次のSQLスクリプトを使用してターゲットテーブルを作成してください。 テーブルロックなしで高頻度の同時挿入を処理するには、InnoDBエンジンの使用をお勧めします。

CREATE TABLE sensor_data (
  id INT AUTO_INCREMENT PRIMARY KEY,
  log_timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
  device_id VARCHAR(50),
  register_value FLOAT
) ENGINE=InnoDB;

3. プロトコル固有のトラブルシューティング

• 機器が全くデータを送信しない: 機器によっては、「印刷」ボタンを押したときだけにデータを送信するか、ホストコンピューターからの特別なコマンドを必要とします。
• 機器が1つのレコードを送信した後、送信を停止する: 多くの研究室機器は、データブロックを受信した後にACK（確認応答）文字を必要とします。データロガーで「ACK/NAKハンドシェイク」機能を有効にすると、応答が返され、機器は次のバッチを送信するよう促されます。
• プログラムがすべてのデータを抽出しない。一部のフィールドが欠落している: デフォルトでは、ロガーは重要なデータのみを抽出します。ASCIIデータパーサープラグインを使用して自分のパーサーを作成するか、サポートチームにお問い合わせください。

4. データベース固有のトラブルシューティング

• MySQLサーバーが切断されました: シリアルデバイスが一晩中アイドル状態の場合、MySQLは接続を切断します。Data LoggerのODBCエクスポートモジュールで「接続を維持」設定を有効にしてください。
• デバイスのデータ行を挿入または更新するにはどうすればよいですか？: 「SQL Database Pro」プラグインでは任意のSQLクエリを使用できます。MySQLでは、次のSQLを簡単に実行できます：「INSERT INTO ....... ON DUPLICATE KEY .... UPDATE ....」。
• 各デバイスのデータを異なるテーブルに書き込みたいのですが、どうすればよいですか？: 「SQL Database Pro」プラグインでは、SQLにプレースホルダーを使用できます。例えば「INSERT INTO SerialData%DEVICE_ID% (....)」のようにします。SQLを実行する前に、ロガーは%DEVICE_ID%を解析データの対応する値に置き換え、実際の宛先テーブルは異なります（SerialData1、SerialData2など）。