npm - @k2works/claude-code-booster - Versions diffs - 4.11.0 → 4.12.0 - Mend

@k2works/claude-code-booster 4.11.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (749) hide show

package/lib/assets/docs/article/practical-database-design/part5/chapter39.md CHANGED Viewed

@@ -1,2334 +1,2334 @@
-# 第39章：データ連携の実装パターン
-本章では、基幹業務システム間のデータ連携を実現するための具体的な実装パターンについて解説します。バッチ連携とリアルタイム連携の両方のアプローチを理解し、適切な連携テーブル設計とエラーハンドリングの方法を学びます。
----
-## 39.1 バッチ連携
-### バッチ連携の概要
-バッチ連携は、定期的なスケジュールでまとめてデータを転送する方式です。大量データの処理や、リアルタイム性が不要な業務に適しています。
-```plantuml
-@startuml
-title バッチ連携の基本構造
-rectangle "ソースシステム" as source {
-    database "販売管理DB" as sales_db
-}
-rectangle "バッチ処理" as batch {
-    rectangle "抽出\n(Extract)" as extract
-    rectangle "変換\n(Transform)" as transform
-    rectangle "ロード\n(Load)" as load
-}
-rectangle "ターゲットシステム" as target {
-    database "財務会計DB" as accounting_db
-}
-file "中間ファイル" as staging_file
-sales_db --> extract : 定期実行
-extract --> staging_file : 出力
-staging_file --> transform : 読込
-transform --> load : 変換済データ
-load --> accounting_db : 投入
-note bottom of batch
-  【バッチ連携の特徴】
-  ・大量データの一括処理に適する
-  ・処理時間の予測が容易
-  ・障害時のリカバリが比較的簡単
-  ・リアルタイム性は犠牲になる
-end note
-@enduml
-```
-### ファイル連携（CSV / XML / JSON）
-基幹業務システム間のデータ連携では、ファイル形式でのデータ交換が広く使われています。
-#### ファイル形式の比較
-| 形式 | 特徴 | 適用場面 | 注意点 |
-|-----|-----|---------|-------|
-| CSV | 軽量・シンプル | 定型データ、レガシー連携 | 文字コード、区切り文字 |
-| XML | 構造化、スキーマ定義 | 複雑な階層データ | ファイルサイズ大 |
-| JSON | 軽量・可読性高 | Web API 連携 | スキーマ検証が必要 |
-| 固定長 | 高速処理 | 大量データ、メインフレーム | 柔軟性に欠ける |
-#### ファイル連携の設計
-```plantuml
-@startuml
-title ファイル連携のデータフロー
-|ソースシステム|
-start
-:データ抽出クエリ実行;
-:ファイル出力;
-note right
-  ・日付フォルダ作成
-  ・連番ファイル名
-  ・完了ファイル出力
-end note
-:ファイル転送;
-|ターゲットシステム|
-:ファイル受信確認;
-note right
-  完了ファイル（.done）の
-  存在を確認してから処理開始
-end note
-:バリデーション;
-if (検証OK?) then (yes)
-    :データ変換;
-    :データ投入;
-    :正常完了記録;
-else (no)
-    :エラーファイル出力;
-    :アラート通知;
-endif
-stop
-@enduml
-```
-<details>
-<summary>Java 実装例 - CSV 出力</summary>
-```java
-// 売上データ CSV 出力サービス
-@Service
-public class SalesCsvExportService {
-    private final SalesRepository salesRepository;
-    private final FileStorageService fileStorage;
-    @Transactional(readOnly = true)
-    public ExportResult exportSalesData(LocalDate targetDate) {
-        // 出力ディレクトリ
-        String directory = String.format("sales/%s",
-            targetDate.format(DateTimeFormatter.ofPattern("yyyyMMdd")));
-        // データ取得
-        List<SalesData> salesList = salesRepository.findByDate(targetDate);
-        // CSV 出力
-        String fileName = String.format("sales_%s_%s.csv",
-            targetDate.format(DateTimeFormatter.ofPattern("yyyyMMdd")),
-            LocalDateTime.now().format(DateTimeFormatter.ofPattern("HHmmss")));
-        try (CsvWriter writer = new CsvWriter(
-                fileStorage.getOutputStream(directory, fileName),
-                StandardCharsets.UTF_8)) {
-            // ヘッダー出力
-            writer.writeHeader(
-                "売上番号", "売上日", "得意先コード", "得意先名",
-                "商品コード", "商品名", "数量", "単価", "金額", "消費税"
-            );
-            // データ出力
-            for (SalesData sales : salesList) {
-                writer.writeRow(
-                    sales.getSalesNumber(),
-                    sales.getSalesDate().toString(),
-                    sales.getCustomerCode(),
-                    sales.getCustomerName(),
-                    sales.getProductCode(),
-                    sales.getProductName(),
-                    sales.getQuantity().toString(),
-                    sales.getUnitPrice().toString(),
-                    sales.getAmount().toString(),
-                    sales.getTaxAmount().toString()
-                );
-            }
-        }
-        // 完了ファイル出力
-        String doneFileName = fileName.replace(".csv", ".done");
-        fileStorage.createEmptyFile(directory, doneFileName);
-        return new ExportResult(
-            fileName,
-            salesList.size(),
-            ExportStatus.SUCCESS
-        );
-    }
-}
-// CSV ライター
-public class CsvWriter implements AutoCloseable {
-    private final BufferedWriter writer;
-    private final String delimiter = ",";
-    private final String lineEnding = "\r\n";
-    public CsvWriter(OutputStream outputStream, Charset charset) {
-        this.writer = new BufferedWriter(
-            new OutputStreamWriter(outputStream, charset)
-        );
-    }
-    public void writeHeader(String... columns) throws IOException {
-        writeLine(columns);
-    }
-    public void writeRow(String... values) throws IOException {
-        String[] escapedValues = Arrays.stream(values)
-            .map(this::escapeField)
-            .toArray(String[]::new);
-        writeLine(escapedValues);
-    }
-    private void writeLine(String[] fields) throws IOException {
-        writer.write(String.join(delimiter, fields));
-        writer.write(lineEnding);
-    }
-    private String escapeField(String field) {
-        if (field == null) return "";
-        if (field.contains(",") || field.contains("\"")
-                || field.contains("\n")) {
-            return "\"" + field.replace("\"", "\"\"") + "\"";
-        }
-        return field;
-    }
-    @Override
-    public void close() throws IOException {
-        writer.close();
-    }
-}
-```
-</details>
-<details>
-<summary>Java 実装例 - CSV 取込</summary>
-```java
-// 仕訳データ CSV 取込サービス
-@Service
-public class JournalCsvImportService {
-    private final JournalRepository journalRepository;
-    private final FileStorageService fileStorage;
-    private final ImportLogRepository importLogRepository;
-    @Transactional
-    public ImportResult importJournalData(String directory, String fileName) {
-        ImportLog log = ImportLog.start(fileName);
-        try {
-            // 完了ファイル確認
-            String doneFileName = fileName.replace(".csv", ".done");
-            if (!fileStorage.exists(directory, doneFileName)) {
-                throw new ImportException("完了ファイルが見つかりません: " + doneFileName);
-            }
-            // CSV 読込
-            List<JournalImportRow> rows = new ArrayList<>();
-            List<ImportError> errors = new ArrayList<>();
-            try (CsvReader reader = new CsvReader(
-                    fileStorage.getInputStream(directory, fileName),
-                    StandardCharsets.UTF_8)) {
-                int lineNumber = 1;
-                reader.skipHeader();
-                lineNumber++;
-                String[] line;
-                while ((line = reader.readLine()) != null) {
-                    try {
-                        JournalImportRow row = parseRow(line, lineNumber);
-                        validateRow(row);
-                        rows.add(row);
-                    } catch (ValidationException e) {
-                        errors.add(new ImportError(lineNumber, e.getMessage()));
-                    }
-                    lineNumber++;
-                }
-            }
-            // エラーがある場合は中断
-            if (!errors.isEmpty()) {
-                log.fail(errors);
-                importLogRepository.save(log);
-                return new ImportResult(ImportStatus.VALIDATION_ERROR, 0, errors);
-            }
-            // データ投入
-            int insertedCount = 0;
-            for (JournalImportRow row : rows) {
-                JournalEntry journal = convertToEntity(row);
-                journalRepository.save(journal);
-                insertedCount++;
-            }
-            log.success(insertedCount);
-            importLogRepository.save(log);
-            return new ImportResult(ImportStatus.SUCCESS, insertedCount, List.of());
-        } catch (Exception e) {
-            log.fail(e.getMessage());
-            importLogRepository.save(log);
-            throw new ImportException("取込処理でエラーが発生しました", e);
-        }
-    }
-    private JournalImportRow parseRow(String[] fields, int lineNumber) {
-        if (fields.length < 10) {
-            throw new ValidationException("フィールド数が不足しています");
-        }
-        return new JournalImportRow(
-            fields[0],  // 伝票番号
-            LocalDate.parse(fields[1]),  // 伝票日付
-            fields[2],  // 借方勘定科目
-            fields[3],  // 借方補助科目
-            new BigDecimal(fields[4]),  // 借方金額
-            fields[5],  // 貸方勘定科目
-            fields[6],  // 貸方補助科目
-            new BigDecimal(fields[7]),  // 貸方金額
-            fields[8],  // 摘要
-            fields[9]   // 部門コード
-        );
-    }
-    private void validateRow(JournalImportRow row) {
-        // 貸借一致チェック
-        if (row.debitAmount().compareTo(row.creditAmount()) != 0) {
-            throw new ValidationException("貸借金額が一致しません");
-        }
-        // その他のバリデーション...
-    }
-}
-```
-</details>
-### ETL 処理の設計
-ETL（Extract-Transform-Load）は、データ連携の標準的なアプローチです。
-```plantuml
-@startuml
-title ETL 処理の設計パターン
-rectangle "Extract（抽出）" as extract {
-    rectangle "フル抽出" as full_extract
-    rectangle "差分抽出" as incremental_extract
-    rectangle "CDC 抽出" as cdc_extract
-}
-rectangle "Transform（変換）" as transform {
-    rectangle "データクレンジング" as cleansing
-    rectangle "コード変換" as code_mapping
-    rectangle "集計・計算" as aggregation
-    rectangle "データ結合" as join_data
-}
-rectangle "Load（ロード）" as load {
-    rectangle "フルリフレッシュ" as full_refresh
-    rectangle "インクリメンタル" as incremental_load
-    rectangle "Upsert" as upsert
-}
-full_extract --> cleansing
-incremental_extract --> cleansing
-cdc_extract --> cleansing
-cleansing --> code_mapping
-code_mapping --> aggregation
-aggregation --> join_data
-join_data --> full_refresh
-join_data --> incremental_load
-join_data --> upsert
-note bottom of extract
-  【抽出方式の選択基準】
-  ・フル抽出：データ量が少ない場合
-  ・差分抽出：更新日時で判定可能な場合
-  ・CDC：リアルタイム性が必要な場合
-end note
-@enduml
-```
-#### ETL ジョブ設計
-```plantuml
-@startuml
-title ETL ジョブの実行フロー
-|スケジューラ|
-start
-:ジョブ起動;
-note right
-  毎日 AM 2:00
-  または手動起動
-end note
-|抽出フェーズ|
-:前回実行日時取得;
-:差分データ抽出;
-if (データあり?) then (yes)
-    :ステージングテーブルに格納;
-    |変換フェーズ|
-    :データクレンジング;
-    note right
-      ・NULL 値処理
-      ・文字コード変換
-      ・日付フォーマット統一
-    end note
-    :コード変換;
-    note right
-      ・コードマッピングテーブル参照
-      ・未定義コードはエラー
-    end note
-    :業務ルール適用;
-    note right
-      ・消費税計算
-      ・勘定科目判定
-      ・部門配賦
-    end note
-    |ロードフェーズ|
-    :本番テーブルに投入;
-    :実行結果記録;
-else (no)
-    :スキップ記録;
-endif
-|スケジューラ|
-:完了通知;
-stop
-@enduml
-```
-<details>
-<summary>Java 実装例 - ETL ジョブ</summary>
-```java
-// ETL ジョブ基底クラス
-public abstract class EtlJob<S, T> {
-    protected final Logger log = LoggerFactory.getLogger(getClass());
-    public EtlJobResult execute(EtlJobContext context) {
-        EtlJobResult result = new EtlJobResult(getJobName());
-        result.start();
-        try {
-            // 抽出フェーズ
-            log.info("抽出フェーズ開始");
-            List<S> sourceData = extract(context);
-            result.setExtractedCount(sourceData.size());
-            log.info("抽出完了: {} 件", sourceData.size());
-            if (sourceData.isEmpty()) {
-                result.complete(EtlJobStatus.SKIPPED, "対象データなし");
-                return result;
-            }
-            // 変換フェーズ
-            log.info("変換フェーズ開始");
-            TransformResult<T> transformResult = transform(sourceData, context);
-            result.setTransformedCount(transformResult.successCount());
-            result.setErrorCount(transformResult.errorCount());
-            result.addErrors(transformResult.errors());
-            log.info("変換完了: 成功 {} 件, エラー {} 件",
-                transformResult.successCount(), transformResult.errorCount());
-            // エラー閾値チェック
-            if (exceedsErrorThreshold(transformResult, context)) {
-                result.complete(EtlJobStatus.FAILED, "エラー閾値超過");
-                return result;
-            }
-            // ロードフェーズ
-            log.info("ロードフェーズ開始");
-            int loadedCount = load(transformResult.data(), context);
-            result.setLoadedCount(loadedCount);
-            log.info("ロード完了: {} 件", loadedCount);
-            result.complete(EtlJobStatus.SUCCESS, null);
-            return result;
-        } catch (Exception e) {
-            log.error("ETL ジョブでエラー発生", e);
-            result.complete(EtlJobStatus.FAILED, e.getMessage());
-            return result;
-        }
-    }
-    protected abstract String getJobName();
-    protected abstract List<S> extract(EtlJobContext context);
-    protected abstract TransformResult<T> transform(List<S> data, EtlJobContext context);
-    protected abstract int load(List<T> data, EtlJobContext context);
-    private boolean exceedsErrorThreshold(
-            TransformResult<T> result, EtlJobContext context) {
-        double errorRate = (double) result.errorCount()
-            / (result.successCount() + result.errorCount());
-        return errorRate > context.getErrorThreshold();
-    }
-}
-// 売上→仕訳 ETL ジョブ
-@Component
-public class SalesToJournalEtlJob extends EtlJob<SalesData, JournalEntry> {
-    private final SalesRepository salesRepository;
-    private final JournalRepository journalRepository;
-    private final JournalPatternService patternService;
-    @Override
-    protected String getJobName() {
-        return "売上仕訳連携";
-    }
-    @Override
-    protected List<SalesData> extract(EtlJobContext context) {
-        LocalDateTime lastRunTime = context.getLastRunTime();
-        LocalDateTime currentTime = context.getCurrentTime();
-        return salesRepository.findByUpdatedAtBetween(lastRunTime, currentTime);
-    }
-    @Override
-    protected TransformResult<JournalEntry> transform(
-            List<SalesData> salesList, EtlJobContext context) {
-        List<JournalEntry> journals = new ArrayList<>();
-        List<TransformError> errors = new ArrayList<>();
-        for (SalesData sales : salesList) {
-            try {
-                // 自動仕訳パターン取得
-                JournalPattern pattern = patternService.findPattern(
-                    sales.getProductGroup(),
-                    sales.getCustomerGroup()
-                );
-                if (pattern == null) {
-                    errors.add(new TransformError(
-                        sales.getSalesNumber(),
-                        "仕訳パターンが見つかりません"
-                    ));
-                    continue;
-                }
-                // 仕訳生成
-                JournalEntry journal = createJournal(sales, pattern);
-                journals.add(journal);
-            } catch (Exception e) {
-                errors.add(new TransformError(
-                    sales.getSalesNumber(),
-                    e.getMessage()
-                ));
-            }
-        }
-        return new TransformResult<>(journals, journals.size(), errors.size(), errors);
-    }
-    @Override
-    @Transactional
-    protected int load(List<JournalEntry> journals, EtlJobContext context) {
-        int count = 0;
-        for (JournalEntry journal : journals) {
-            journalRepository.save(journal);
-            count++;
-        }
-        return count;
-    }
-    private JournalEntry createJournal(SalesData sales, JournalPattern pattern) {
-        return JournalEntry.builder()
-            .journalDate(sales.getSalesDate())
-            .debitAccountCode(pattern.getDebitAccountCode())
-            .debitAmount(sales.getAmount())
-            .creditAccountCode(pattern.getCreditAccountCode())
-            .creditAmount(sales.getAmount())
-            .description("売上計上: " + sales.getSalesNumber())
-            .sourceType("SALES")
-            .sourceId(sales.getSalesNumber())
-            .build();
-    }
-}
-```
-</details>
-### 差分抽出と全件抽出
-```plantuml
-@startuml
-title 差分抽出と全件抽出の比較
-rectangle "全件抽出" as full {
-    note right
-      【処理内容】
-      ・ソーステーブルの全データを抽出
-      ・ターゲットを全件削除後に投入
-      【メリット】
-      ・実装がシンプル
-      ・データ不整合が起きにくい
-      【デメリット】
-      ・処理時間が長い
-      ・リソース消費が大きい
-      【適用場面】
-      ・マスタデータ
-      ・データ量が少ない場合
-      ・日次全件洗い替え
-    end note
-}
-rectangle "差分抽出" as incremental {
-    note right
-      【処理内容】
-      ・更新日時 > 前回実行日時 で抽出
-      ・差分のみ INSERT/UPDATE
-      【メリット】
-      ・処理時間が短い
-      ・リソース効率が良い
-      【デメリット】
-      ・削除データの検知が困難
-      ・更新日時の管理が必要
-      【適用場面】
-      ・トランザクションデータ
-      ・大量データ
-      ・高頻度実行
-    end note
-}
-@enduml
-```
-#### 差分抽出の実装パターン
-```plantuml
-@startuml
-title 差分抽出のパターン
-rectangle "タイムスタンプ方式" as timestamp {
-    note right
-      WHERE 更新日時 > :前回実行日時
-      【前提条件】
-      ・全テーブルに更新日時カラム
-      ・更新時に自動更新される仕組み
-    end note
-}
-rectangle "トリガー方式" as trigger {
-    note right
-      変更を変更ログテーブルに記録
-      連携後にログを削除
-      【前提条件】
-      ・各テーブルにトリガー設定
-      ・変更ログテーブルの管理
-    end note
-}
-rectangle "シーケンス方式" as sequence {
-    note right
-      WHERE ID > :前回最大ID
-      【前提条件】
-      ・単調増加の ID カラム
-      ・UPDATE はなく INSERT のみ
-    end note
-}
-rectangle "CDC 方式" as cdc {
-    note right
-      トランザクションログから
-      変更を検知
-      【前提条件】
-      ・CDC ツール（Debezium等）
-      ・リアルタイム処理基盤
-    end note
-}
-@enduml
-```
-<details>
-<summary>Java 実装例 - 差分抽出</summary>
-```java
-// 差分抽出サービス
-@Service
-public class IncrementalExtractService {
-    private final JdbcTemplate jdbcTemplate;
-    private final ExtractCheckpointRepository checkpointRepository;
-    /**
-     * タイムスタンプ方式による差分抽出
-     */
-    public <T> List<T> extractByTimestamp(
-            String tableName,
-            String timestampColumn,
-            RowMapper<T> rowMapper) {
-        // 前回実行日時取得
-        ExtractCheckpoint checkpoint = checkpointRepository
-            .findByTableName(tableName)
-            .orElse(new ExtractCheckpoint(tableName, LocalDateTime.MIN));
-        LocalDateTime lastExtractTime = checkpoint.getLastExtractTime();
-        LocalDateTime currentTime = LocalDateTime.now();
-        // 差分抽出
-        String sql = String.format(
-            "SELECT * FROM %s WHERE %s > ? AND %s <= ? ORDER BY %s",
-            tableName, timestampColumn, timestampColumn, timestampColumn
-        );
-        List<T> result = jdbcTemplate.query(sql, rowMapper,
-            lastExtractTime, currentTime);
-        // チェックポイント更新
-        checkpoint.setLastExtractTime(currentTime);
-        checkpointRepository.save(checkpoint);
-        return result;
-    }
-    /**
-     * シーケンス方式による差分抽出
-     */
-    public <T> List<T> extractBySequence(
-            String tableName,
-            String sequenceColumn,
-            RowMapper<T> rowMapper) {
-        ExtractCheckpoint checkpoint = checkpointRepository
-            .findByTableName(tableName)
-            .orElse(new ExtractCheckpoint(tableName, 0L));
-        Long lastSequence = checkpoint.getLastSequence();
-        // 差分抽出
-        String sql = String.format(
-            "SELECT * FROM %s WHERE %s > ? ORDER BY %s",
-            tableName, sequenceColumn, sequenceColumn
-        );
-        List<T> result = jdbcTemplate.query(sql, rowMapper, lastSequence);
-        // 最大シーケンス取得と更新
-        if (!result.isEmpty()) {
-            Long maxSequence = jdbcTemplate.queryForObject(
-                String.format("SELECT MAX(%s) FROM %s WHERE %s > ?",
-                    sequenceColumn, tableName, sequenceColumn),
-                Long.class, lastSequence
-            );
-            checkpoint.setLastSequence(maxSequence);
-            checkpointRepository.save(checkpoint);
-        }
-        return result;
-    }
-    /**
-     * 削除データの検知（論理削除方式）
-     */
-    public List<String> extractDeletedIds(
-            String tableName,
-            String idColumn,
-            String deleteFlagColumn) {
-        ExtractCheckpoint checkpoint = checkpointRepository
-            .findByTableName(tableName + "_DELETE")
-            .orElse(new ExtractCheckpoint(tableName + "_DELETE", LocalDateTime.MIN));
-        String sql = String.format(
-            "SELECT %s FROM %s WHERE %s = true AND 更新日時 > ?",
-            idColumn, tableName, deleteFlagColumn
-        );
-        List<String> deletedIds = jdbcTemplate.queryForList(
-            sql, String.class, checkpoint.getLastExtractTime()
-        );
-        checkpoint.setLastExtractTime(LocalDateTime.now());
-        checkpointRepository.save(checkpoint);
-        return deletedIds;
-    }
-}
-// 抽出チェックポイント
-@Entity
-@Table(name = "抽出チェックポイント")
-public class ExtractCheckpoint {
-    @Id
-    private String tableName;
-    private LocalDateTime lastExtractTime;
-    private Long lastSequence;
-    public ExtractCheckpoint(String tableName, LocalDateTime lastExtractTime) {
-        this.tableName = tableName;
-        this.lastExtractTime = lastExtractTime;
-    }
-    public ExtractCheckpoint(String tableName, Long lastSequence) {
-        this.tableName = tableName;
-        this.lastSequence = lastSequence;
-    }
-    // getters, setters...
-}
-```
-</details>
----
-## 39.2 リアルタイム連携
-### Change Data Capture（CDC）
-CDC は、データベースの変更をリアルタイムで検知し、他システムに伝播するパターンです。
-```plantuml
-@startuml
-title Change Data Capture の仕組み
-rectangle "ソースDB" as source {
-    database "販売管理" as sales_db
-    file "トランザクション\nログ" as tx_log
-}
-rectangle "CDC プラットフォーム" as cdc {
-    rectangle "Debezium\nConnector" as connector
-    queue "Kafka" as kafka
-}
-rectangle "ターゲットシステム" as targets {
-    database "財務会計" as accounting
-    database "分析DB" as analytics
-    rectangle "通知サービス" as notification
-}
-sales_db --> tx_log : WAL/Binlog
-tx_log --> connector : 変更検知
-connector --> kafka : イベント発行
-kafka --> accounting : 消費
-kafka --> analytics : 消費
-kafka --> notification : 消費
-note bottom of connector
-  【CDC の仕組み】
-  ・データベースのトランザクションログを監視
-  ・INSERT/UPDATE/DELETE を検知
-  ・変更内容をイベントとして発行
-end note
-@enduml
-```
-#### CDC イベントの構造
-```plantuml
-@startuml
-title CDC イベントの構造
-class "CDC イベント" as cdc_event {
-    +source: SourceInfo
-    +operation: String
-    +timestamp: Long
-    +before: Record
-    +after: Record
-}
-class "SourceInfo" as source_info {
-    +connector: String
-    +database: String
-    +schema: String
-    +table: String
-    +txId: Long
-    +lsn: Long
-}
-note right of cdc_event
-  【operation の値】
-  ・c: CREATE（INSERT）
-  ・u: UPDATE
-  ・d: DELETE
-  ・r: READ（スナップショット）
-  【before/after】
-  ・INSERT: before=null, after=新データ
-  ・UPDATE: before=旧データ, after=新データ
-  ・DELETE: before=旧データ, after=null
-end note
-cdc_event --> source_info
-@enduml
-```
-<details>
-<summary>Java 実装例 - CDC コンシューマー</summary>
-```java
-// CDC イベントコンシューマー
-@Component
-public class SalesCdcConsumer {
-    private final ObjectMapper objectMapper;
-    private final JournalSyncService journalSyncService;
-    @KafkaListener(topics = "sales.public.売上")
-    public void consume(String message) {
-        try {
-            CdcEvent event = objectMapper.readValue(message, CdcEvent.class);
-            switch (event.getOperation()) {
-                case "c" -> handleInsert(event.getAfter());
-                case "u" -> handleUpdate(event.getBefore(), event.getAfter());
-                case "d" -> handleDelete(event.getBefore());
-                default -> log.warn("Unknown operation: {}", event.getOperation());
-            }
-        } catch (Exception e) {
-            log.error("CDC イベント処理エラー", e);
-            throw new CdcProcessingException(e);
-        }
-    }
-    private void handleInsert(JsonNode after) {
-        SalesData sales = objectMapper.convertValue(after, SalesData.class);
-        journalSyncService.createJournalFromSales(sales);
-    }
-    private void handleUpdate(JsonNode before, JsonNode after) {
-        SalesData oldSales = objectMapper.convertValue(before, SalesData.class);
-        SalesData newSales = objectMapper.convertValue(after, SalesData.class);
-        // 赤黒処理で訂正
-        journalSyncService.reverseJournal(oldSales);
-        journalSyncService.createJournalFromSales(newSales);
-    }
-    private void handleDelete(JsonNode before) {
-        SalesData sales = objectMapper.convertValue(before, SalesData.class);
-        journalSyncService.reverseJournal(sales);
-    }
-}
-// CDC イベント
-@Data
-public class CdcEvent {
-    private SourceInfo source;
-    private String operation;  // c, u, d, r
-    private Long tsMs;
-    private JsonNode before;
-    private JsonNode after;
-}
-@Data
-public class SourceInfo {
-    private String connector;
-    private String db;
-    private String schema;
-    private String table;
-    private Long txId;
-    private Long lsn;
-}
-```
-</details>
-### データベーストリガーの活用
-トリガーを使用した変更検知は、CDC ツールなしでも実装できるシンプルな方式です。
-```plantuml
-@startuml
-title トリガーによる変更検知
-database "ソースDB" as source {
-    entity "売上テーブル" as sales
-    entity "変更ログ" as change_log
-}
-rectangle "トリガー" as trigger {
-    rectangle "INSERT トリガー" as insert_trigger
-    rectangle "UPDATE トリガー" as update_trigger
-    rectangle "DELETE トリガー" as delete_trigger
-}
-rectangle "連携バッチ" as batch {
-    rectangle "変更ログ読込" as read_log
-    rectangle "ターゲット更新" as update_target
-    rectangle "ログ削除" as delete_log
-}
-database "ターゲットDB" as target
-sales --> insert_trigger : INSERT
-sales --> update_trigger : UPDATE
-sales --> delete_trigger : DELETE
-insert_trigger --> change_log : 記録
-update_trigger --> change_log : 記録
-delete_trigger --> change_log : 記録
-change_log --> read_log : 定期実行
-read_log --> update_target
-update_target --> target
-update_target --> delete_log
-note bottom of trigger
-  【トリガー方式のメリット】
-  ・追加ツール不要
-  ・確実に変更を捕捉
-  【デメリット】
-  ・パフォーマンスへの影響
-  ・トリガーの管理が煩雑
-end note
-@enduml
-```
-<details>
-<summary>SQL 定義 - 変更ログトリガー</summary>
-```sql
--- 変更ログテーブル
-CREATE TABLE 変更ログ (
-    ログID SERIAL PRIMARY KEY,
-    テーブル名 VARCHAR(100) NOT NULL,
-    操作種別 VARCHAR(10) NOT NULL,  -- INSERT, UPDATE, DELETE
-    レコードID VARCHAR(100) NOT NULL,
-    変更前データ JSONB,
-    変更後データ JSONB,
-    変更日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    処理済フラグ BOOLEAN DEFAULT FALSE,
-    処理日時 TIMESTAMP
-);
-CREATE INDEX idx_変更ログ_未処理 ON 変更ログ (処理済フラグ, 変更日時)
-    WHERE 処理済フラグ = FALSE;
--- 売上テーブル用トリガー関数
-CREATE OR REPLACE FUNCTION fn_売上変更ログ()
-RETURNS TRIGGER AS $$
-BEGIN
-    IF TG_OP = 'INSERT' THEN
-        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更後データ)
-        VALUES ('売上', 'INSERT', NEW.売上番号, row_to_json(NEW)::JSONB);
-        RETURN NEW;
-    ELSIF TG_OP = 'UPDATE' THEN
-        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更前データ, 変更後データ)
-        VALUES ('売上', 'UPDATE', NEW.売上番号,
-            row_to_json(OLD)::JSONB, row_to_json(NEW)::JSONB);
-        RETURN NEW;
-    ELSIF TG_OP = 'DELETE' THEN
-        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更前データ)
-        VALUES ('売上', 'DELETE', OLD.売上番号, row_to_json(OLD)::JSONB);
-        RETURN OLD;
-    END IF;
-END;
-$$ LANGUAGE plpgsql;
--- トリガー設定
-CREATE TRIGGER trg_売上変更ログ
-AFTER INSERT OR UPDATE OR DELETE ON 売上
-FOR EACH ROW EXECUTE FUNCTION fn_売上変更ログ();
-```
-</details>
-<details>
-<summary>Java 実装例 - 変更ログ処理</summary>
-```java
-// 変更ログ処理サービス
-@Service
-public class ChangeLogProcessingService {
-    private final JdbcTemplate jdbcTemplate;
-    private final Map<String, ChangeLogHandler> handlers;
-    @Scheduled(fixedDelay = 5000)  // 5秒ごと
-    @Transactional
-    public void processChangeLogs() {
-        // 未処理ログを取得（ロック付き）
-        String selectSql = """
-            SELECT ログID, テーブル名, 操作種別, レコードID, 変更前データ, 変更後データ
-            FROM 変更ログ
-            WHERE 処理済フラグ = FALSE
-            ORDER BY 変更日時
-            LIMIT 100
-            FOR UPDATE SKIP LOCKED
-            """;
-        List<ChangeLog> logs = jdbcTemplate.query(selectSql,
-            (rs, rowNum) -> new ChangeLog(
-                rs.getLong("ログID"),
-                rs.getString("テーブル名"),
-                rs.getString("操作種別"),
-                rs.getString("レコードID"),
-                rs.getString("変更前データ"),
-                rs.getString("変更後データ")
-            )
-        );
-        for (ChangeLog log : logs) {
-            try {
-                // テーブル別ハンドラーで処理
-                ChangeLogHandler handler = handlers.get(log.tableName());
-                if (handler != null) {
-                    handler.handle(log);
-                }
-                // 処理済みマーク
-                markAsProcessed(log.logId());
-            } catch (Exception e) {
-                // エラーログ記録（処理は継続）
-                recordError(log.logId(), e.getMessage());
-            }
-        }
-    }
-    private void markAsProcessed(Long logId) {
-        jdbcTemplate.update(
-            "UPDATE 変更ログ SET 処理済フラグ = TRUE, 処理日時 = CURRENT_TIMESTAMP WHERE ログID = ?",
-            logId
-        );
-    }
-    private void recordError(Long logId, String errorMessage) {
-        jdbcTemplate.update(
-            "UPDATE 変更ログ SET エラー内容 = ? WHERE ログID = ?",
-            errorMessage, logId
-        );
-    }
-}
-// 変更ログハンドラーインターフェース
-public interface ChangeLogHandler {
-    void handle(ChangeLog log);
-}
-// 売上変更ログハンドラー
-@Component("売上")
-public class SalesChangeLogHandler implements ChangeLogHandler {
-    private final ObjectMapper objectMapper;
-    private final JournalSyncService journalSyncService;
-    @Override
-    public void handle(ChangeLog log) {
-        switch (log.operation()) {
-            case "INSERT" -> {
-                SalesData sales = parseJson(log.afterData(), SalesData.class);
-                journalSyncService.createJournalFromSales(sales);
-            }
-            case "UPDATE" -> {
-                SalesData oldSales = parseJson(log.beforeData(), SalesData.class);
-                SalesData newSales = parseJson(log.afterData(), SalesData.class);
-                journalSyncService.reverseJournal(oldSales);
-                journalSyncService.createJournalFromSales(newSales);
-            }
-            case "DELETE" -> {
-                SalesData sales = parseJson(log.beforeData(), SalesData.class);
-                journalSyncService.reverseJournal(sales);
-            }
-        }
-    }
-    private <T> T parseJson(String json, Class<T> clazz) {
-        try {
-            return objectMapper.readValue(json, clazz);
-        } catch (JsonProcessingException e) {
-            throw new RuntimeException("JSON パース失敗", e);
-        }
-    }
-}
-```
-</details>
-### メッセージキューによる非同期連携
-メッセージキューを使用した非同期連携は、システム間の疎結合を実現します。
-```plantuml
-@startuml
-title メッセージキューによる非同期連携
-rectangle "プロデューサー" as producer {
-    rectangle "販売管理\nサービス" as sales_service
-}
-rectangle "メッセージブローカー" as broker {
-    queue "売上イベント\nキュー" as sales_queue
-    queue "仕訳イベント\nキュー" as journal_queue
-    queue "在庫イベント\nキュー" as inventory_queue
-}
-rectangle "コンシューマー" as consumer {
-    rectangle "財務会計\nサービス" as accounting_service
-    rectangle "在庫管理\nサービス" as inventory_service
-    rectangle "分析\nサービス" as analytics_service
-}
-sales_service --> sales_queue : 売上イベント発行
-sales_queue --> accounting_service : 消費（仕訳生成）
-sales_queue --> inventory_service : 消費（在庫更新）
-sales_queue --> analytics_service : 消費（分析用）
-accounting_service --> journal_queue : 仕訳イベント発行
-note bottom of broker
-  【メッセージキューの特徴】
-  ・非同期処理による疎結合
-  ・メッセージの永続化
-  ・再処理・リトライが容易
-  ・スケーラビリティ
-end note
-@enduml
-```
-#### メッセージ配信パターン
-```plantuml
-@startuml
-title メッセージ配信パターン
-rectangle "Point-to-Point" as p2p {
-    queue "キュー" as queue1
-    rectangle "Consumer A" as consumer_a
-    queue1 --> consumer_a : 1対1配信
-    note right of queue1
-      1つのメッセージは
-      1つのコンシューマーのみが受信
-    end note
-}
-rectangle "Pub/Sub" as pubsub {
-    rectangle "トピック" as topic
-    rectangle "Consumer B" as consumer_b
-    rectangle "Consumer C" as consumer_c
-    rectangle "Consumer D" as consumer_d
-    topic --> consumer_b
-    topic --> consumer_c
-    topic --> consumer_d
-    note right of topic
-      1つのメッセージを
-      複数のサブスクライバーが受信
-    end note
-}
-rectangle "Competing Consumers" as competing {
-    queue "キュー" as queue2
-    rectangle "Consumer E1" as consumer_e1
-    rectangle "Consumer E2" as consumer_e2
-    rectangle "Consumer E3" as consumer_e3
-    queue2 --> consumer_e1
-    queue2 --> consumer_e2
-    queue2 --> consumer_e3
-    note right of queue2
-      複数のコンシューマーが
-      並列でメッセージを処理
-      （負荷分散）
-    end note
-}
-@enduml
-```
-<details>
-<summary>Java 実装例 - メッセージキュー連携</summary>
-```java
-// メッセージプロデューサー
-@Service
-public class SalesEventPublisher {
-    private final RabbitTemplate rabbitTemplate;
-    private final ObjectMapper objectMapper;
-    private static final String EXCHANGE = "sales.events";
-    public void publishSalesCreated(SalesData sales) {
-        SalesCreatedEvent event = new SalesCreatedEvent(
-            UUID.randomUUID().toString(),
-            Instant.now(),
-            sales.getSalesNumber(),
-            sales.getCustomerCode(),
-            sales.getSalesDate(),
-            sales.getTotalAmount()
-        );
-        publish(event, "sales.created");
-    }
-    public void publishSalesCancelled(String salesNumber, String reason) {
-        SalesCancelledEvent event = new SalesCancelledEvent(
-            UUID.randomUUID().toString(),
-            Instant.now(),
-            salesNumber,
-            reason
-        );
-        publish(event, "sales.cancelled");
-    }
-    private void publish(Object event, String routingKey) {
-        try {
-            String json = objectMapper.writeValueAsString(event);
-            rabbitTemplate.convertAndSend(EXCHANGE, routingKey, json);
-            log.info("イベント発行: {} -> {}", routingKey, event);
-        } catch (Exception e) {
-            log.error("イベント発行失敗", e);
-            throw new EventPublishException(e);
-        }
-    }
-}
-// メッセージコンシューマー
-@Component
-public class SalesEventConsumer {
-    private final ObjectMapper objectMapper;
-    private final JournalService journalService;
-    private final InventoryService inventoryService;
-    @RabbitListener(queues = "accounting.sales.queue")
-    public void handleSalesCreatedForAccounting(String message) {
-        SalesCreatedEvent event = parseEvent(message, SalesCreatedEvent.class);
-        try {
-            // 仕訳生成
-            journalService.createFromSales(event);
-            log.info("売上仕訳生成完了: {}", event.salesNumber());
-        } catch (Exception e) {
-            log.error("売上仕訳生成失敗: {}", event.salesNumber(), e);
-            throw new AmqpRejectAndDontRequeueException(e);
-        }
-    }
-    @RabbitListener(queues = "inventory.sales.queue")
-    public void handleSalesCreatedForInventory(String message) {
-        SalesCreatedEvent event = parseEvent(message, SalesCreatedEvent.class);
-        try {
-            // 在庫引当解除
-            inventoryService.releaseAllocation(event.salesNumber());
-            log.info("在庫引当解除完了: {}", event.salesNumber());
-        } catch (Exception e) {
-            log.error("在庫引当解除失敗: {}", event.salesNumber(), e);
-            throw new AmqpRejectAndDontRequeueException(e);
-        }
-    }
-    private <T> T parseEvent(String message, Class<T> clazz) {
-        try {
-            return objectMapper.readValue(message, clazz);
-        } catch (JsonProcessingException e) {
-            throw new EventParseException(e);
-        }
-    }
-}
-// RabbitMQ 設定
-@Configuration
-public class RabbitMqConfig {
-    @Bean
-    public TopicExchange salesEventsExchange() {
-        return new TopicExchange("sales.events");
-    }
-    @Bean
-    public Queue accountingSalesQueue() {
-        return QueueBuilder.durable("accounting.sales.queue")
-            .withArgument("x-dead-letter-exchange", "sales.events.dlx")
-            .withArgument("x-dead-letter-routing-key", "accounting.sales.dead")
-            .build();
-    }
-    @Bean
-    public Queue inventorySalesQueue() {
-        return QueueBuilder.durable("inventory.sales.queue")
-            .withArgument("x-dead-letter-exchange", "sales.events.dlx")
-            .withArgument("x-dead-letter-routing-key", "inventory.sales.dead")
-            .build();
-    }
-    @Bean
-    public Binding accountingBinding() {
-        return BindingBuilder
-            .bind(accountingSalesQueue())
-            .to(salesEventsExchange())
-            .with("sales.*");
-    }
-    @Bean
-    public Binding inventoryBinding() {
-        return BindingBuilder
-            .bind(inventorySalesQueue())
-            .to(salesEventsExchange())
-            .with("sales.*");
-    }
-    // Dead Letter Queue 設定
-    @Bean
-    public DirectExchange deadLetterExchange() {
-        return new DirectExchange("sales.events.dlx");
-    }
-    @Bean
-    public Queue deadLetterQueue() {
-        return QueueBuilder.durable("sales.events.dead").build();
-    }
-}
-```
-</details>
----
-## 39.3 連携テーブルの設計
-### 連携ステータス管理
-データ連携の状態を追跡するためのテーブル設計は、運用上非常に重要です。
-```plantuml
-@startuml
-title 連携ステータス管理テーブル
-entity "連携ジョブ" as job {
-    *ジョブID : UUID <<PK>>
-    --
-    *ジョブ名 : VARCHAR(100)
-    *連携種別 : VARCHAR(50)
-    ソースシステム : VARCHAR(50)
-    ターゲットシステム : VARCHAR(50)
-    スケジュール : VARCHAR(50)
-    有効フラグ : BOOLEAN
-    作成日時 : TIMESTAMP
-}
-entity "連携実行履歴" as execution {
-    *実行ID : UUID <<PK>>
-    --
-    *ジョブID : UUID <<FK>>
-    *開始日時 : TIMESTAMP
-    終了日時 : TIMESTAMP
-    *ステータス : VARCHAR(20)
-    抽出件数 : INTEGER
-    成功件数 : INTEGER
-    エラー件数 : INTEGER
-    スキップ件数 : INTEGER
-    エラー内容 : TEXT
-}
-entity "連携対象データ" as data {
-    *データID : UUID <<PK>>
-    --
-    *実行ID : UUID <<FK>>
-    *ソースID : VARCHAR(100)
-    *連携ステータス : VARCHAR(20)
-    処理日時 : TIMESTAMP
-    エラー内容 : TEXT
-    リトライ回数 : INTEGER
-}
-entity "連携エラー詳細" as error {
-    *エラーID : UUID <<PK>>
-    --
-    *データID : UUID <<FK>>
-    *エラー種別 : VARCHAR(50)
-    *エラーメッセージ : TEXT
-    スタックトレース : TEXT
-    発生日時 : TIMESTAMP
-}
-job ||--o{ execution : has
-execution ||--o{ data : contains
-data ||--o{ error : has
-note right of execution
-  【ステータス】
-  ・RUNNING: 実行中
-  ・SUCCESS: 正常完了
-  ・PARTIAL: 部分完了
-  ・FAILED: 失敗
-  ・CANCELLED: 中止
-end note
-note right of data
-  【連携ステータス】
-  ・PENDING: 処理待ち
-  ・PROCESSING: 処理中
-  ・SUCCESS: 成功
-  ・ERROR: エラー
-  ・SKIPPED: スキップ
-end note
-@enduml
-```
-<details>
-<summary>SQL 定義</summary>
-```sql
--- 連携ジョブマスタ
-CREATE TABLE 連携ジョブ (
-    ジョブID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    ジョブ名 VARCHAR(100) NOT NULL UNIQUE,
-    連携種別 VARCHAR(50) NOT NULL,  -- BATCH, REALTIME, CDC
-    ソースシステム VARCHAR(50),
-    ターゲットシステム VARCHAR(50),
-    スケジュール VARCHAR(50),  -- cron 式
-    設定JSON JSONB,
-    有効フラグ BOOLEAN DEFAULT TRUE,
-    作成日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    更新日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
--- 連携実行履歴
-CREATE TABLE 連携実行履歴 (
-    実行ID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    ジョブID UUID NOT NULL REFERENCES 連携ジョブ(ジョブID),
-    開始日時 TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    終了日時 TIMESTAMP,
-    ステータス VARCHAR(20) NOT NULL DEFAULT 'RUNNING',
-    抽出件数 INTEGER DEFAULT 0,
-    成功件数 INTEGER DEFAULT 0,
-    エラー件数 INTEGER DEFAULT 0,
-    スキップ件数 INTEGER DEFAULT 0,
-    エラー内容 TEXT,
-    実行パラメータ JSONB,
-    CONSTRAINT chk_ステータス CHECK (
-        ステータス IN ('RUNNING', 'SUCCESS', 'PARTIAL', 'FAILED', 'CANCELLED')
-    )
-);
-CREATE INDEX idx_連携実行履歴_ジョブ日時
-    ON 連携実行履歴 (ジョブID, 開始日時 DESC);
--- 連携対象データ
-CREATE TABLE 連携対象データ (
-    データID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    実行ID UUID NOT NULL REFERENCES 連携実行履歴(実行ID),
-    ソースID VARCHAR(100) NOT NULL,
-    連携ステータス VARCHAR(20) NOT NULL DEFAULT 'PENDING',
-    処理日時 TIMESTAMP,
-    エラー内容 TEXT,
-    リトライ回数 INTEGER DEFAULT 0,
-    ソースデータ JSONB,
-    CONSTRAINT chk_連携ステータス CHECK (
-        連携ステータス IN ('PENDING', 'PROCESSING', 'SUCCESS', 'ERROR', 'SKIPPED')
-    )
-);
-CREATE INDEX idx_連携対象データ_実行ステータス
-    ON 連携対象データ (実行ID, 連携ステータス);
--- 連携エラー詳細
-CREATE TABLE 連携エラー詳細 (
-    エラーID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    データID UUID NOT NULL REFERENCES 連携対象データ(データID),
-    エラー種別 VARCHAR(50) NOT NULL,
-    エラーメッセージ TEXT NOT NULL,
-    スタックトレース TEXT,
-    発生日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
--- 連携サマリービュー
-CREATE VIEW v_連携サマリー AS
-SELECT
-    j.ジョブ名,
-    j.連携種別,
-    e.実行ID,
-    e.開始日時,
-    e.終了日時,
-    e.ステータス,
-    e.抽出件数,
-    e.成功件数,
-    e.エラー件数,
-    CASE
-        WHEN e.抽出件数 > 0
-        THEN ROUND(e.成功件数::NUMERIC / e.抽出件数 * 100, 2)
-        ELSE 0
-    END AS 成功率
-FROM 連携ジョブ j
-JOIN 連携実行履歴 e ON j.ジョブID = e.ジョブID
-ORDER BY e.開始日時 DESC;
-```
-</details>
-### エラーハンドリングとリトライ
-データ連携におけるエラーハンドリングは、システムの信頼性を確保するために重要です。
-```plantuml
-@startuml
-title エラーハンドリングとリトライフロー
-|連携処理|
-start
-:データ取得;
-repeat
-    :データ処理実行;
-    if (成功?) then (yes)
-        :成功記録;
-        break
-    else (no)
-        :リトライ回数 + 1;
-        if (リトライ上限?) then (no)
-            :待機（指数バックオフ）;
-            note right
-              1回目: 1秒
-              2回目: 2秒
-              3回目: 4秒
-              4回目: 8秒
-              ...
-            end note
-        else (yes)
-            :エラー記録;
-            :Dead Letter Queue へ;
-            break
-        endif
-    endif
-repeat while (リトライ中)
-stop
-@enduml
-```
-#### リトライ戦略
-```plantuml
-@startuml
-title リトライ戦略の比較
-rectangle "固定間隔リトライ" as fixed {
-    note right
-      【特徴】
-      一定間隔でリトライ
-      例: 5秒ごと
-      【適用場面】
-      ・短期的な障害
-      ・軽微なエラー
-    end note
-}
-rectangle "指数バックオフ" as exponential {
-    note right
-      【特徴】
-      リトライ間隔を指数的に増加
-      例: 1秒 → 2秒 → 4秒 → 8秒
-      【適用場面】
-      ・外部サービス障害
-      ・負荷軽減が必要な場合
-    end note
-}
-rectangle "ジッター付きバックオフ" as jitter {
-    note right
-      【特徴】
-      指数バックオフにランダム要素追加
-      例: 1〜2秒 → 2〜4秒 → 4〜8秒
-      【適用場面】
-      ・多数クライアントの同時リトライ回避
-      ・サンダリングハード問題対策
-    end note
-}
-rectangle "サーキットブレーカー" as circuit {
-    note right
-      【特徴】
-      エラー率が閾値超過で遮断
-      一定時間後に再試行
-      【適用場面】
-      ・長期的な障害
-      ・カスケード障害防止
-    end note
-}
-@enduml
-```
-<details>
-<summary>Java 実装例 - リトライ機構</summary>
-```java
-// リトライ設定
-@Configuration
-public class RetryConfig {
-    @Bean
-    public RetryTemplate retryTemplate() {
-        RetryTemplate template = new RetryTemplate();
-        // 指数バックオフ設定
-        ExponentialBackOffPolicy backOffPolicy = new ExponentialBackOffPolicy();
-        backOffPolicy.setInitialInterval(1000);  // 1秒
-        backOffPolicy.setMultiplier(2.0);
-        backOffPolicy.setMaxInterval(30000);  // 最大30秒
-        template.setBackOffPolicy(backOffPolicy);
-        // リトライポリシー
-        Map<Class<? extends Throwable>, Boolean> retryableExceptions = new HashMap<>();
-        retryableExceptions.put(TransientDataAccessException.class, true);
-        retryableExceptions.put(TimeoutException.class, true);
-        retryableExceptions.put(ConnectException.class, true);
-        SimpleRetryPolicy retryPolicy = new SimpleRetryPolicy(
-            5,  // 最大5回
-            retryableExceptions
-        );
-        template.setRetryPolicy(retryPolicy);
-        // リスナー
-        template.registerListener(new RetryListenerSupport() {
-            @Override
-            public <T, E extends Throwable> void onError(
-                    RetryContext context, RetryCallback<T, E> callback, Throwable throwable) {
-                log.warn("リトライ {} 回目: {}",
-                    context.getRetryCount(), throwable.getMessage());
-            }
-        });
-        return template;
-    }
-}
-// リトライ付き連携サービス
-@Service
-public class RetryableIntegrationService {
-    private final RetryTemplate retryTemplate;
-    private final IntegrationDataRepository dataRepository;
-    private final DeadLetterService deadLetterService;
-    @Transactional
-    public void processWithRetry(IntegrationData data) {
-        try {
-            retryTemplate.execute(context -> {
-                // 処理実行
-                processData(data);
-                // 成功記録
-                data.setStatus(IntegrationStatus.SUCCESS);
-                data.setProcessedAt(LocalDateTime.now());
-                dataRepository.save(data);
-                return null;
-            });
-        } catch (Exception e) {
-            // リトライ上限超過
-            handleMaxRetriesExceeded(data, e);
-        }
-    }
-    private void processData(IntegrationData data) {
-        // 実際の連携処理
-        // ...
-    }
-    private void handleMaxRetriesExceeded(IntegrationData data, Exception e) {
-        // エラー記録
-        data.setStatus(IntegrationStatus.ERROR);
-        data.setErrorMessage(e.getMessage());
-        data.setRetryCount(data.getRetryCount() + 1);
-        dataRepository.save(data);
-        // Dead Letter Queue へ
-        deadLetterService.send(data);
-        // アラート通知
-        alertService.notify(
-            "連携エラー: " + data.getSourceId(),
-            e.getMessage()
-        );
-    }
-}
-// サーキットブレーカー付きサービス
-@Service
-public class CircuitBreakerIntegrationService {
-    private final CircuitBreaker circuitBreaker;
-    private final ExternalSystemClient externalClient;
-    public CircuitBreakerIntegrationService() {
-        CircuitBreakerConfig config = CircuitBreakerConfig.custom()
-            .failureRateThreshold(50)  // 50%以上でオープン
-            .waitDurationInOpenState(Duration.ofSeconds(30))
-            .slidingWindowSize(10)
-            .build();
-        this.circuitBreaker = CircuitBreaker.of("external-system", config);
-    }
-    public void sendToExternalSystem(IntegrationData data) {
-        Try.ofSupplier(
-            CircuitBreaker.decorateSupplier(circuitBreaker, () -> {
-                return externalClient.send(data);
-            })
-        ).recover(CallNotPermittedException.class, e -> {
-            log.warn("サーキットブレーカーオープン中");
-            // フォールバック処理
-            queueForLater(data);
-            return null;
-        }).get();
-    }
-    private void queueForLater(IntegrationData data) {
-        // 後で再処理するためキューイング
-        pendingQueue.add(data);
-    }
-}
-```
-</details>
-### 冪等性の確保
-データ連携において冪等性を確保することで、重複実行による問題を防ぎます。
-```plantuml
-@startuml
-title 冪等性確保のパターン
-rectangle "冪等キー方式" as idempotency_key {
-    note right
-      【仕組み】
-      ・リクエストに一意のキーを付与
-      ・処理済みキーをテーブルに記録
-      ・重複リクエストはスキップ
-      【実装】
-      冪等キーテーブルで管理
-    end note
-}
-rectangle "Upsert 方式" as upsert {
-    note right
-      【仕組み】
-      ・INSERT or UPDATE で処理
-      ・存在すれば更新、なければ挿入
-      ・同じデータで何度実行しても同じ結果
-      【実装】
-      INSERT ... ON CONFLICT DO UPDATE
-    end note
-}
-rectangle "バージョン管理方式" as version {
-    note right
-      【仕組み】
-      ・データにバージョン番号を付与
-      ・古いバージョンの更新は無視
-      ・最新バージョンのみ適用
-      【実装】
-      楽観ロック + バージョン比較
-    end note
-}
-rectangle "ステータス管理方式" as status {
-    note right
-      【仕組み】
-      ・処理ステータスを記録
-      ・処理済みデータは再処理しない
-      ・ステータス遷移を厳密に管理
-      【実装】
-      ステータス + 処理日時で判定
-    end note
-}
-@enduml
-```
-<details>
-<summary>SQL 定義 - 冪等性テーブル</summary>
-```sql
--- 冪等キーテーブル
-CREATE TABLE 冪等キー (
-    冪等キー VARCHAR(100) PRIMARY KEY,
-    処理種別 VARCHAR(50) NOT NULL,
-    ソースID VARCHAR(100) NOT NULL,
-    処理結果 JSONB,
-    処理日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    有効期限 TIMESTAMP NOT NULL
-);
-CREATE INDEX idx_冪等キー_有効期限 ON 冪等キー (有効期限);
--- 期限切れキーの自動削除
-CREATE OR REPLACE FUNCTION fn_冪等キー_クリーンアップ()
-RETURNS void AS $$
-BEGIN
-    DELETE FROM 冪等キー WHERE 有効期限 < CURRENT_TIMESTAMP;
-END;
-$$ LANGUAGE plpgsql;
--- 冪等処理の実行関数
-CREATE OR REPLACE FUNCTION fn_冪等処理(
-    p_冪等キー VARCHAR,
-    p_処理種別 VARCHAR,
-    p_ソースID VARCHAR,
-    p_有効期間_日数 INTEGER DEFAULT 7
-) RETURNS TABLE (
-    処理可能 BOOLEAN,
-    既存結果 JSONB
-) AS $$
-DECLARE
-    v_existing RECORD;
-BEGIN
-    -- 既存キーを検索（ロック付き）
-    SELECT * INTO v_existing
-    FROM 冪等キー
-    WHERE 冪等キー = p_冪等キー
-    FOR UPDATE;
-    IF v_existing IS NOT NULL THEN
-        -- 既に処理済み
-        RETURN QUERY SELECT FALSE, v_existing.処理結果;
-    ELSE
-        -- 新規キーを登録
-        INSERT INTO 冪等キー (冪等キー, 処理種別, ソースID, 有効期限)
-        VALUES (
-            p_冪等キー,
-            p_処理種別,
-            p_ソースID,
-            CURRENT_TIMESTAMP + (p_有効期間_日数 || ' days')::INTERVAL
-        );
-        RETURN QUERY SELECT TRUE, NULL::JSONB;
-    END IF;
-END;
-$$ LANGUAGE plpgsql;
--- 処理結果の記録関数
-CREATE OR REPLACE FUNCTION fn_冪等結果記録(
-    p_冪等キー VARCHAR,
-    p_処理結果 JSONB
-) RETURNS void AS $$
-BEGIN
-    UPDATE 冪等キー
-    SET 処理結果 = p_処理結果
-    WHERE 冪等キー = p_冪等キー;
-END;
-$$ LANGUAGE plpgsql;
-```
-</details>
-<details>
-<summary>Java 実装例 - 冪等性サービス</summary>
-```java
-// 冪等性サービス
-@Service
-public class IdempotencyService {
-    private final JdbcTemplate jdbcTemplate;
-    /**
-     * 冪等処理を実行
-     * @return true: 処理可能, false: 既に処理済み
-     */
-    @Transactional
-    public IdempotencyResult checkAndLock(
-            String idempotencyKey,
-            String processType,
-            String sourceId) {
-        // 既存キーをチェック
-        Map<String, Object> result = jdbcTemplate.queryForMap(
-            "SELECT * FROM fn_冪等処理(?, ?, ?)",
-            idempotencyKey, processType, sourceId
-        );
-        boolean canProcess = (Boolean) result.get("処理可能");
-        String existingResult = (String) result.get("既存結果");
-        return new IdempotencyResult(canProcess, existingResult);
-    }
-    /**
-     * 処理結果を記録
-     */
-    @Transactional
-    public void recordResult(String idempotencyKey, Object result) {
-        try {
-            String jsonResult = new ObjectMapper().writeValueAsString(result);
-            jdbcTemplate.update(
-                "SELECT fn_冪等結果記録(?, ?::JSONB)",
-                idempotencyKey, jsonResult
-            );
-        } catch (JsonProcessingException e) {
-            throw new RuntimeException("結果のJSON変換に失敗", e);
-        }
-    }
-}
-// 冪等性デコレーター
-@Aspect
-@Component
-public class IdempotencyAspect {
-    private final IdempotencyService idempotencyService;
-    @Around("@annotation(idempotent)")
-    public Object ensureIdempotency(
-            ProceedingJoinPoint joinPoint,
-            Idempotent idempotent) throws Throwable {
-        // 冪等キーを取得
-        String idempotencyKey = extractIdempotencyKey(joinPoint, idempotent);
-        String processType = joinPoint.getSignature().getName();
-        String sourceId = extractSourceId(joinPoint, idempotent);
-        // 冪等チェック
-        IdempotencyResult check = idempotencyService.checkAndLock(
-            idempotencyKey, processType, sourceId
-        );
-        if (!check.canProcess()) {
-            log.info("冪等スキップ: {} (既存結果: {})",
-                idempotencyKey, check.existingResult());
-            return check.existingResult();
-        }
-        try {
-            // 処理実行
-            Object result = joinPoint.proceed();
-            // 結果記録
-            idempotencyService.recordResult(idempotencyKey, result);
-            return result;
-        } catch (Exception e) {
-            // エラー時は冪等キーを削除（再試行可能に）
-            idempotencyService.removeKey(idempotencyKey);
-            throw e;
-        }
-    }
-    private String extractIdempotencyKey(
-            ProceedingJoinPoint joinPoint, Idempotent idempotent) {
-        // アノテーションの keyExpression から冪等キーを抽出
-        // SpEL で引数から動的に取得
-        // ...
-    }
-}
-// 冪等アノテーション
-@Target(ElementType.METHOD)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface Idempotent {
-    String keyExpression();  // SpEL式: "#args[0].id"
-    String sourceIdExpression() default "";
-}
-// 使用例
-@Service
-public class JournalIntegrationService {
-    @Idempotent(keyExpression = "'SALES_JOURNAL_' + #sales.salesNumber")
-    @Transactional
-    public JournalEntry createJournalFromSales(SalesData sales) {
-        // この処理は同じ売上番号に対して1回だけ実行される
-        return journalService.createFromSales(sales);
-    }
-}
-// Upsert による冪等性
-@Repository
-public class JournalRepository {
-    @Transactional
-    public void upsertFromIntegration(JournalEntry journal) {
-        String sql = """
-            INSERT INTO 仕訳 (
-                伝票番号, 伝票日付, 借方勘定, 借方金額,
-                貸方勘定, 貸方金額, 摘要, ソース種別, ソースID
-            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-            ON CONFLICT (ソース種別, ソースID) DO UPDATE SET
-                伝票日付 = EXCLUDED.伝票日付,
-                借方勘定 = EXCLUDED.借方勘定,
-                借方金額 = EXCLUDED.借方金額,
-                貸方勘定 = EXCLUDED.貸方勘定,
-                貸方金額 = EXCLUDED.貸方金額,
-                摘要 = EXCLUDED.摘要,
-                更新日時 = CURRENT_TIMESTAMP
-            """;
-        jdbcTemplate.update(sql,
-            journal.getJournalNumber(),
-            journal.getJournalDate(),
-            journal.getDebitAccount(),
-            journal.getDebitAmount(),
-            journal.getCreditAccount(),
-            journal.getCreditAmount(),
-            journal.getDescription(),
-            journal.getSourceType(),
-            journal.getSourceId()
-        );
-    }
-}
-```
-</details>
-### 連携監視ダッシュボード
-```plantuml
-@startuml
-title 連携監視ダッシュボードの構成
-rectangle "監視ダッシュボード" as dashboard {
-    rectangle "リアルタイム監視" as realtime {
-        rectangle "実行中ジョブ" as running
-        rectangle "キュー滞留" as queue_depth
-        rectangle "エラー発生" as errors
-    }
-    rectangle "統計情報" as stats {
-        rectangle "日次処理件数" as daily_count
-        rectangle "成功率推移" as success_rate
-        rectangle "平均処理時間" as avg_time
-    }
-    rectangle "アラート" as alerts {
-        rectangle "エラー閾値超過" as error_alert
-        rectangle "遅延アラート" as delay_alert
-        rectangle "滞留アラート" as backlog_alert
-    }
-}
-database "連携履歴DB" as history_db
-queue "メッセージキュー" as mq
-history_db --> stats : 集計
-mq --> queue_depth : 監視
-history_db --> errors : エラー検出
-alerts --> "通知サービス" : Slack/Email
-@enduml
-```
-<details>
-<summary>SQL 定義 - 監視用ビュー</summary>
-```sql
--- 日次連携サマリービュー
-CREATE VIEW v_日次連携サマリー AS
-SELECT
-    DATE(e.開始日時) AS 実行日,
-    j.ジョブ名,
-    COUNT(*) AS 実行回数,
-    SUM(CASE WHEN e.ステータス = 'SUCCESS' THEN 1 ELSE 0 END) AS 成功回数,
-    SUM(CASE WHEN e.ステータス = 'FAILED' THEN 1 ELSE 0 END) AS 失敗回数,
-    SUM(e.抽出件数) AS 総抽出件数,
-    SUM(e.成功件数) AS 総成功件数,
-    SUM(e.エラー件数) AS 総エラー件数,
-    ROUND(
-        SUM(e.成功件数)::NUMERIC / NULLIF(SUM(e.抽出件数), 0) * 100, 2
-    ) AS 成功率,
-    AVG(EXTRACT(EPOCH FROM (e.終了日時 - e.開始日時))) AS 平均処理時間_秒
-FROM 連携実行履歴 e
-JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
-WHERE e.開始日時 >= CURRENT_DATE - INTERVAL '30 days'
-GROUP BY DATE(e.開始日時), j.ジョブ名
-ORDER BY 実行日 DESC, j.ジョブ名;
--- リアルタイム監視ビュー
-CREATE VIEW v_リアルタイム監視 AS
-SELECT
-    j.ジョブ名,
-    e.実行ID,
-    e.ステータス,
-    e.開始日時,
-    EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - e.開始日時)) AS 経過時間_秒,
-    e.抽出件数,
-    e.成功件数,
-    e.エラー件数,
-    ROUND(
-        e.成功件数::NUMERIC / NULLIF(e.抽出件数, 0) * 100, 2
-    ) AS 進捗率
-FROM 連携実行履歴 e
-JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
-WHERE e.ステータス = 'RUNNING'
-ORDER BY e.開始日時;
--- エラー傾向分析ビュー
-CREATE VIEW v_エラー傾向 AS
-SELECT
-    j.ジョブ名,
-    ed.エラー種別,
-    COUNT(*) AS 発生件数,
-    MIN(ed.発生日時) AS 初回発生,
-    MAX(ed.発生日時) AS 最終発生
-FROM 連携エラー詳細 ed
-JOIN 連携対象データ d ON ed.データID = d.データID
-JOIN 連携実行履歴 e ON d.実行ID = e.実行ID
-JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
-WHERE ed.発生日時 >= CURRENT_DATE - INTERVAL '7 days'
-GROUP BY j.ジョブ名, ed.エラー種別
-ORDER BY 発生件数 DESC;
--- アラート条件チェック関数
-CREATE OR REPLACE FUNCTION fn_連携アラートチェック()
-RETURNS TABLE (
-    アラート種別 VARCHAR,
-    ジョブ名 VARCHAR,
-    メッセージ TEXT,
-    重要度 VARCHAR
-) AS $$
-BEGIN
-    -- エラー率アラート
-    RETURN QUERY
-    SELECT
-        'エラー率超過'::VARCHAR,
-        j.ジョブ名,
-        FORMAT('エラー率 %.1f%% (閾値: 10%%)',
-            e.エラー件数::NUMERIC / e.抽出件数 * 100),
-        'HIGH'::VARCHAR
-    FROM 連携実行履歴 e
-    JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
-    WHERE e.ステータス IN ('PARTIAL', 'FAILED')
-    AND e.開始日時 >= CURRENT_TIMESTAMP - INTERVAL '1 hour'
-    AND e.抽出件数 > 0
-    AND e.エラー件数::NUMERIC / e.抽出件数 > 0.1;
-    -- 長時間実行アラート
-    RETURN QUERY
-    SELECT
-        '長時間実行'::VARCHAR,
-        j.ジョブ名,
-        FORMAT('実行時間 %s 分 (閾値: 30分)',
-            EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - e.開始日時)) / 60),
-        'MEDIUM'::VARCHAR
-    FROM 連携実行履歴 e
-    JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
-    WHERE e.ステータス = 'RUNNING'
-    AND e.開始日時 < CURRENT_TIMESTAMP - INTERVAL '30 minutes';
-    -- 未実行アラート
-    RETURN QUERY
-    SELECT
-        'スケジュール遅延'::VARCHAR,
-        j.ジョブ名,
-        FORMAT('最終実行: %s',
-            COALESCE(MAX(e.開始日時)::TEXT, '実行履歴なし')),
-        'MEDIUM'::VARCHAR
-    FROM 連携ジョブ j
-    LEFT JOIN 連携実行履歴 e ON j.ジョブID = e.ジョブID
-    WHERE j.有効フラグ = TRUE
-    GROUP BY j.ジョブID, j.ジョブ名
-    HAVING MAX(e.開始日時) < CURRENT_TIMESTAMP - INTERVAL '1 day'
-        OR MAX(e.開始日時) IS NULL;
-END;
-$$ LANGUAGE plpgsql;
-```
-</details>
----
-## 39.4 まとめ
-本章では、データ連携の具体的な実装パターンについて解説しました。
-### 学んだこと
-1. **バッチ連携**
-   - ファイル連携（CSV / XML / JSON）の設計と実装
-   - ETL 処理のパターン（Extract-Transform-Load）
-   - 差分抽出と全件抽出の使い分け
-2. **リアルタイム連携**
-   - Change Data Capture（CDC）による変更検知
-   - データベーストリガーの活用
-   - メッセージキューによる非同期連携
-3. **連携テーブルの設計**
-   - 連携ステータス管理の重要性
-   - エラーハンドリングとリトライ戦略
-   - 冪等性の確保方法
-### 連携パターンの選択指針
-| 要件 | バッチ連携 | リアルタイム連携 |
-|-----|----------|----------------|
-| データ量 | 大量 | 少〜中量 |
-| 即時性 | 不要 | 必要 |
-| 複雑な変換 | 適している | 向かない |
-| システム負荷 | 集中（定期実行） | 分散（常時） |
-| 障害復旧 | 容易 | やや複雑 |
-| 実装コスト | 低 | 中〜高 |
-### 信頼性確保のチェックリスト
-- [ ] 冪等性が確保されているか
-- [ ] リトライ機構が実装されているか
-- [ ] Dead Letter Queue が設定されているか
-- [ ] 監視・アラートが設定されているか
-- [ ] エラー発生時の通知が設定されているか
-- [ ] 手動リカバリ手順が文書化されているか
-### Part 5 の総括
-第5部「エンタープライズインテグレーション」では、基幹業務システム間の統合について体系的に学びました。
-- **第33章**：システム統合の概要と境界づけられたコンテキスト
-- **第34章**：メッセージングパターン（EIP）
-- **第35章**：システム間連携パターン（販売・財務・生産）
-- **第36章**：マスタデータ管理（MDM）
-- **第37章**：イベント駆動アーキテクチャ
-- **第38章**：API 設計とサービス連携
-- **第39章**：データ連携の実装パターン
-これらの知識を活用することで、疎結合で保守性の高い基幹業務システムの統合を実現できます。
+# 第39章：データ連携の実装パターン
+本章では、基幹業務システム間のデータ連携を実現するための具体的な実装パターンについて解説します。バッチ連携とリアルタイム連携の両方のアプローチを理解し、適切な連携テーブル設計とエラーハンドリングの方法を学びます。
+---
+## 39.1 バッチ連携
+### バッチ連携の概要
+バッチ連携は、定期的なスケジュールでまとめてデータを転送する方式です。大量データの処理や、リアルタイム性が不要な業務に適しています。
+```plantuml
+@startuml
+title バッチ連携の基本構造
+rectangle "ソースシステム" as source {
+    database "販売管理DB" as sales_db
+}
+rectangle "バッチ処理" as batch {
+    rectangle "抽出\n(Extract)" as extract
+    rectangle "変換\n(Transform)" as transform
+    rectangle "ロード\n(Load)" as load
+}
+rectangle "ターゲットシステム" as target {
+    database "財務会計DB" as accounting_db
+}
+file "中間ファイル" as staging_file
+sales_db --> extract : 定期実行
+extract --> staging_file : 出力
+staging_file --> transform : 読込
+transform --> load : 変換済データ
+load --> accounting_db : 投入
+note bottom of batch
+  【バッチ連携の特徴】
+  ・大量データの一括処理に適する
+  ・処理時間の予測が容易
+  ・障害時のリカバリが比較的簡単
+  ・リアルタイム性は犠牲になる
+end note
+@enduml
+```
+### ファイル連携（CSV / XML / JSON）
+基幹業務システム間のデータ連携では、ファイル形式でのデータ交換が広く使われています。
+#### ファイル形式の比較
+| 形式 | 特徴 | 適用場面 | 注意点 |
+|-----|-----|---------|-------|
+| CSV | 軽量・シンプル | 定型データ、レガシー連携 | 文字コード、区切り文字 |
+| XML | 構造化、スキーマ定義 | 複雑な階層データ | ファイルサイズ大 |
+| JSON | 軽量・可読性高 | Web API 連携 | スキーマ検証が必要 |
+| 固定長 | 高速処理 | 大量データ、メインフレーム | 柔軟性に欠ける |
+#### ファイル連携の設計
+```plantuml
+@startuml
+title ファイル連携のデータフロー
+|ソースシステム|
+start
+:データ抽出クエリ実行;
+:ファイル出力;
+note right
+  ・日付フォルダ作成
+  ・連番ファイル名
+  ・完了ファイル出力
+end note
+:ファイル転送;
+|ターゲットシステム|
+:ファイル受信確認;
+note right
+  完了ファイル（.done）の
+  存在を確認してから処理開始
+end note
+:バリデーション;
+if (検証OK?) then (yes)
+    :データ変換;
+    :データ投入;
+    :正常完了記録;
+else (no)
+    :エラーファイル出力;
+    :アラート通知;
+endif
+stop
+@enduml
+```
+<details>
+<summary>Java 実装例 - CSV 出力</summary>
+```java
+// 売上データ CSV 出力サービス
+@Service
+public class SalesCsvExportService {
+    private final SalesRepository salesRepository;
+    private final FileStorageService fileStorage;
+    @Transactional(readOnly = true)
+    public ExportResult exportSalesData(LocalDate targetDate) {
+        // 出力ディレクトリ
+        String directory = String.format("sales/%s",
+            targetDate.format(DateTimeFormatter.ofPattern("yyyyMMdd")));
+        // データ取得
+        List<SalesData> salesList = salesRepository.findByDate(targetDate);
+        // CSV 出力
+        String fileName = String.format("sales_%s_%s.csv",
+            targetDate.format(DateTimeFormatter.ofPattern("yyyyMMdd")),
+            LocalDateTime.now().format(DateTimeFormatter.ofPattern("HHmmss")));
+        try (CsvWriter writer = new CsvWriter(
+                fileStorage.getOutputStream(directory, fileName),
+                StandardCharsets.UTF_8)) {
+            // ヘッダー出力
+            writer.writeHeader(
+                "売上番号", "売上日", "得意先コード", "得意先名",
+                "商品コード", "商品名", "数量", "単価", "金額", "消費税"
+            );
+            // データ出力
+            for (SalesData sales : salesList) {
+                writer.writeRow(
+                    sales.getSalesNumber(),
+                    sales.getSalesDate().toString(),
+                    sales.getCustomerCode(),
+                    sales.getCustomerName(),
+                    sales.getProductCode(),
+                    sales.getProductName(),
+                    sales.getQuantity().toString(),
+                    sales.getUnitPrice().toString(),
+                    sales.getAmount().toString(),
+                    sales.getTaxAmount().toString()
+                );
+            }
+        }
+        // 完了ファイル出力
+        String doneFileName = fileName.replace(".csv", ".done");
+        fileStorage.createEmptyFile(directory, doneFileName);
+        return new ExportResult(
+            fileName,
+            salesList.size(),
+            ExportStatus.SUCCESS
+        );
+    }
+}
+// CSV ライター
+public class CsvWriter implements AutoCloseable {
+    private final BufferedWriter writer;
+    private final String delimiter = ",";
+    private final String lineEnding = "\r\n";
+    public CsvWriter(OutputStream outputStream, Charset charset) {
+        this.writer = new BufferedWriter(
+            new OutputStreamWriter(outputStream, charset)
+        );
+    }
+    public void writeHeader(String... columns) throws IOException {
+        writeLine(columns);
+    }
+    public void writeRow(String... values) throws IOException {
+        String[] escapedValues = Arrays.stream(values)
+            .map(this::escapeField)
+            .toArray(String[]::new);
+        writeLine(escapedValues);
+    }
+    private void writeLine(String[] fields) throws IOException {
+        writer.write(String.join(delimiter, fields));
+        writer.write(lineEnding);
+    }
+    private String escapeField(String field) {
+        if (field == null) return "";
+        if (field.contains(",") || field.contains("\"")
+                || field.contains("\n")) {
+            return "\"" + field.replace("\"", "\"\"") + "\"";
+        }
+        return field;
+    }
+    @Override
+    public void close() throws IOException {
+        writer.close();
+    }
+}
+```
+</details>
+<details>
+<summary>Java 実装例 - CSV 取込</summary>
+```java
+// 仕訳データ CSV 取込サービス
+@Service
+public class JournalCsvImportService {
+    private final JournalRepository journalRepository;
+    private final FileStorageService fileStorage;
+    private final ImportLogRepository importLogRepository;
+    @Transactional
+    public ImportResult importJournalData(String directory, String fileName) {
+        ImportLog log = ImportLog.start(fileName);
+        try {
+            // 完了ファイル確認
+            String doneFileName = fileName.replace(".csv", ".done");
+            if (!fileStorage.exists(directory, doneFileName)) {
+                throw new ImportException("完了ファイルが見つかりません: " + doneFileName);
+            }
+            // CSV 読込
+            List<JournalImportRow> rows = new ArrayList<>();
+            List<ImportError> errors = new ArrayList<>();
+            try (CsvReader reader = new CsvReader(
+                    fileStorage.getInputStream(directory, fileName),
+                    StandardCharsets.UTF_8)) {
+                int lineNumber = 1;
+                reader.skipHeader();
+                lineNumber++;
+                String[] line;
+                while ((line = reader.readLine()) != null) {
+                    try {
+                        JournalImportRow row = parseRow(line, lineNumber);
+                        validateRow(row);
+                        rows.add(row);
+                    } catch (ValidationException e) {
+                        errors.add(new ImportError(lineNumber, e.getMessage()));
+                    }
+                    lineNumber++;
+                }
+            }
+            // エラーがある場合は中断
+            if (!errors.isEmpty()) {
+                log.fail(errors);
+                importLogRepository.save(log);
+                return new ImportResult(ImportStatus.VALIDATION_ERROR, 0, errors);
+            }
+            // データ投入
+            int insertedCount = 0;
+            for (JournalImportRow row : rows) {
+                JournalEntry journal = convertToEntity(row);
+                journalRepository.save(journal);
+                insertedCount++;
+            }
+            log.success(insertedCount);
+            importLogRepository.save(log);
+            return new ImportResult(ImportStatus.SUCCESS, insertedCount, List.of());
+        } catch (Exception e) {
+            log.fail(e.getMessage());
+            importLogRepository.save(log);
+            throw new ImportException("取込処理でエラーが発生しました", e);
+        }
+    }
+    private JournalImportRow parseRow(String[] fields, int lineNumber) {
+        if (fields.length < 10) {
+            throw new ValidationException("フィールド数が不足しています");
+        }
+        return new JournalImportRow(
+            fields[0],  // 伝票番号
+            LocalDate.parse(fields[1]),  // 伝票日付
+            fields[2],  // 借方勘定科目
+            fields[3],  // 借方補助科目
+            new BigDecimal(fields[4]),  // 借方金額
+            fields[5],  // 貸方勘定科目
+            fields[6],  // 貸方補助科目
+            new BigDecimal(fields[7]),  // 貸方金額
+            fields[8],  // 摘要
+            fields[9]   // 部門コード
+        );
+    }
+    private void validateRow(JournalImportRow row) {
+        // 貸借一致チェック
+        if (row.debitAmount().compareTo(row.creditAmount()) != 0) {
+            throw new ValidationException("貸借金額が一致しません");
+        }
+        // その他のバリデーション...
+    }
+}
+```
+</details>
+### ETL 処理の設計
+ETL（Extract-Transform-Load）は、データ連携の標準的なアプローチです。
+```plantuml
+@startuml
+title ETL 処理の設計パターン
+rectangle "Extract（抽出）" as extract {
+    rectangle "フル抽出" as full_extract
+    rectangle "差分抽出" as incremental_extract
+    rectangle "CDC 抽出" as cdc_extract
+}
+rectangle "Transform（変換）" as transform {
+    rectangle "データクレンジング" as cleansing
+    rectangle "コード変換" as code_mapping
+    rectangle "集計・計算" as aggregation
+    rectangle "データ結合" as join_data
+}
+rectangle "Load（ロード）" as load {
+    rectangle "フルリフレッシュ" as full_refresh
+    rectangle "インクリメンタル" as incremental_load
+    rectangle "Upsert" as upsert
+}
+full_extract --> cleansing
+incremental_extract --> cleansing
+cdc_extract --> cleansing
+cleansing --> code_mapping
+code_mapping --> aggregation
+aggregation --> join_data
+join_data --> full_refresh
+join_data --> incremental_load
+join_data --> upsert
+note bottom of extract
+  【抽出方式の選択基準】
+  ・フル抽出：データ量が少ない場合
+  ・差分抽出：更新日時で判定可能な場合
+  ・CDC：リアルタイム性が必要な場合
+end note
+@enduml
+```
+#### ETL ジョブ設計
+```plantuml
+@startuml
+title ETL ジョブの実行フロー
+|スケジューラ|
+start
+:ジョブ起動;
+note right
+  毎日 AM 2:00
+  または手動起動
+end note
+|抽出フェーズ|
+:前回実行日時取得;
+:差分データ抽出;
+if (データあり?) then (yes)
+    :ステージングテーブルに格納;
+    |変換フェーズ|
+    :データクレンジング;
+    note right
+      ・NULL 値処理
+      ・文字コード変換
+      ・日付フォーマット統一
+    end note
+    :コード変換;
+    note right
+      ・コードマッピングテーブル参照
+      ・未定義コードはエラー
+    end note
+    :業務ルール適用;
+    note right
+      ・消費税計算
+      ・勘定科目判定
+      ・部門配賦
+    end note
+    |ロードフェーズ|
+    :本番テーブルに投入;
+    :実行結果記録;
+else (no)
+    :スキップ記録;
+endif
+|スケジューラ|
+:完了通知;
+stop
+@enduml
+```
+<details>
+<summary>Java 実装例 - ETL ジョブ</summary>
+```java
+// ETL ジョブ基底クラス
+public abstract class EtlJob<S, T> {
+    protected final Logger log = LoggerFactory.getLogger(getClass());
+    public EtlJobResult execute(EtlJobContext context) {
+        EtlJobResult result = new EtlJobResult(getJobName());
+        result.start();
+        try {
+            // 抽出フェーズ
+            log.info("抽出フェーズ開始");
+            List<S> sourceData = extract(context);
+            result.setExtractedCount(sourceData.size());
+            log.info("抽出完了: {} 件", sourceData.size());
+            if (sourceData.isEmpty()) {
+                result.complete(EtlJobStatus.SKIPPED, "対象データなし");
+                return result;
+            }
+            // 変換フェーズ
+            log.info("変換フェーズ開始");
+            TransformResult<T> transformResult = transform(sourceData, context);
+            result.setTransformedCount(transformResult.successCount());
+            result.setErrorCount(transformResult.errorCount());
+            result.addErrors(transformResult.errors());
+            log.info("変換完了: 成功 {} 件, エラー {} 件",
+                transformResult.successCount(), transformResult.errorCount());
+            // エラー閾値チェック
+            if (exceedsErrorThreshold(transformResult, context)) {
+                result.complete(EtlJobStatus.FAILED, "エラー閾値超過");
+                return result;
+            }
+            // ロードフェーズ
+            log.info("ロードフェーズ開始");
+            int loadedCount = load(transformResult.data(), context);
+            result.setLoadedCount(loadedCount);
+            log.info("ロード完了: {} 件", loadedCount);
+            result.complete(EtlJobStatus.SUCCESS, null);
+            return result;
+        } catch (Exception e) {
+            log.error("ETL ジョブでエラー発生", e);
+            result.complete(EtlJobStatus.FAILED, e.getMessage());
+            return result;
+        }
+    }
+    protected abstract String getJobName();
+    protected abstract List<S> extract(EtlJobContext context);
+    protected abstract TransformResult<T> transform(List<S> data, EtlJobContext context);
+    protected abstract int load(List<T> data, EtlJobContext context);
+    private boolean exceedsErrorThreshold(
+            TransformResult<T> result, EtlJobContext context) {
+        double errorRate = (double) result.errorCount()
+            / (result.successCount() + result.errorCount());
+        return errorRate > context.getErrorThreshold();
+    }
+}
+// 売上→仕訳 ETL ジョブ
+@Component
+public class SalesToJournalEtlJob extends EtlJob<SalesData, JournalEntry> {
+    private final SalesRepository salesRepository;
+    private final JournalRepository journalRepository;
+    private final JournalPatternService patternService;
+    @Override
+    protected String getJobName() {
+        return "売上仕訳連携";
+    }
+    @Override
+    protected List<SalesData> extract(EtlJobContext context) {
+        LocalDateTime lastRunTime = context.getLastRunTime();
+        LocalDateTime currentTime = context.getCurrentTime();
+        return salesRepository.findByUpdatedAtBetween(lastRunTime, currentTime);
+    }
+    @Override
+    protected TransformResult<JournalEntry> transform(
+            List<SalesData> salesList, EtlJobContext context) {
+        List<JournalEntry> journals = new ArrayList<>();
+        List<TransformError> errors = new ArrayList<>();
+        for (SalesData sales : salesList) {
+            try {
+                // 自動仕訳パターン取得
+                JournalPattern pattern = patternService.findPattern(
+                    sales.getProductGroup(),
+                    sales.getCustomerGroup()
+                );
+                if (pattern == null) {
+                    errors.add(new TransformError(
+                        sales.getSalesNumber(),
+                        "仕訳パターンが見つかりません"
+                    ));
+                    continue;
+                }
+                // 仕訳生成
+                JournalEntry journal = createJournal(sales, pattern);
+                journals.add(journal);
+            } catch (Exception e) {
+                errors.add(new TransformError(
+                    sales.getSalesNumber(),
+                    e.getMessage()
+                ));
+            }
+        }
+        return new TransformResult<>(journals, journals.size(), errors.size(), errors);
+    }
+    @Override
+    @Transactional
+    protected int load(List<JournalEntry> journals, EtlJobContext context) {
+        int count = 0;
+        for (JournalEntry journal : journals) {
+            journalRepository.save(journal);
+            count++;
+        }
+        return count;
+    }
+    private JournalEntry createJournal(SalesData sales, JournalPattern pattern) {
+        return JournalEntry.builder()
+            .journalDate(sales.getSalesDate())
+            .debitAccountCode(pattern.getDebitAccountCode())
+            .debitAmount(sales.getAmount())
+            .creditAccountCode(pattern.getCreditAccountCode())
+            .creditAmount(sales.getAmount())
+            .description("売上計上: " + sales.getSalesNumber())
+            .sourceType("SALES")
+            .sourceId(sales.getSalesNumber())
+            .build();
+    }
+}
+```
+</details>
+### 差分抽出と全件抽出
+```plantuml
+@startuml
+title 差分抽出と全件抽出の比較
+rectangle "全件抽出" as full {
+    note right
+      【処理内容】
+      ・ソーステーブルの全データを抽出
+      ・ターゲットを全件削除後に投入
+      【メリット】
+      ・実装がシンプル
+      ・データ不整合が起きにくい
+      【デメリット】
+      ・処理時間が長い
+      ・リソース消費が大きい
+      【適用場面】
+      ・マスタデータ
+      ・データ量が少ない場合
+      ・日次全件洗い替え
+    end note
+}
+rectangle "差分抽出" as incremental {
+    note right
+      【処理内容】
+      ・更新日時 > 前回実行日時 で抽出
+      ・差分のみ INSERT/UPDATE
+      【メリット】
+      ・処理時間が短い
+      ・リソース効率が良い
+      【デメリット】
+      ・削除データの検知が困難
+      ・更新日時の管理が必要
+      【適用場面】
+      ・トランザクションデータ
+      ・大量データ
+      ・高頻度実行
+    end note
+}
+@enduml
+```
+#### 差分抽出の実装パターン
+```plantuml
+@startuml
+title 差分抽出のパターン
+rectangle "タイムスタンプ方式" as timestamp {
+    note right
+      WHERE 更新日時 > :前回実行日時
+      【前提条件】
+      ・全テーブルに更新日時カラム
+      ・更新時に自動更新される仕組み
+    end note
+}
+rectangle "トリガー方式" as trigger {
+    note right
+      変更を変更ログテーブルに記録
+      連携後にログを削除
+      【前提条件】
+      ・各テーブルにトリガー設定
+      ・変更ログテーブルの管理
+    end note
+}
+rectangle "シーケンス方式" as sequence {
+    note right
+      WHERE ID > :前回最大ID
+      【前提条件】
+      ・単調増加の ID カラム
+      ・UPDATE はなく INSERT のみ
+    end note
+}
+rectangle "CDC 方式" as cdc {
+    note right
+      トランザクションログから
+      変更を検知
+      【前提条件】
+      ・CDC ツール（Debezium等）
+      ・リアルタイム処理基盤
+    end note
+}
+@enduml
+```
+<details>
+<summary>Java 実装例 - 差分抽出</summary>
+```java
+// 差分抽出サービス
+@Service
+public class IncrementalExtractService {
+    private final JdbcTemplate jdbcTemplate;
+    private final ExtractCheckpointRepository checkpointRepository;
+    /**
+     * タイムスタンプ方式による差分抽出
+     */
+    public <T> List<T> extractByTimestamp(
+            String tableName,
+            String timestampColumn,
+            RowMapper<T> rowMapper) {
+        // 前回実行日時取得
+        ExtractCheckpoint checkpoint = checkpointRepository
+            .findByTableName(tableName)
+            .orElse(new ExtractCheckpoint(tableName, LocalDateTime.MIN));
+        LocalDateTime lastExtractTime = checkpoint.getLastExtractTime();
+        LocalDateTime currentTime = LocalDateTime.now();
+        // 差分抽出
+        String sql = String.format(
+            "SELECT * FROM %s WHERE %s > ? AND %s <= ? ORDER BY %s",
+            tableName, timestampColumn, timestampColumn, timestampColumn
+        );
+        List<T> result = jdbcTemplate.query(sql, rowMapper,
+            lastExtractTime, currentTime);
+        // チェックポイント更新
+        checkpoint.setLastExtractTime(currentTime);
+        checkpointRepository.save(checkpoint);
+        return result;
+    }
+    /**
+     * シーケンス方式による差分抽出
+     */
+    public <T> List<T> extractBySequence(
+            String tableName,
+            String sequenceColumn,
+            RowMapper<T> rowMapper) {
+        ExtractCheckpoint checkpoint = checkpointRepository
+            .findByTableName(tableName)
+            .orElse(new ExtractCheckpoint(tableName, 0L));
+        Long lastSequence = checkpoint.getLastSequence();
+        // 差分抽出
+        String sql = String.format(
+            "SELECT * FROM %s WHERE %s > ? ORDER BY %s",
+            tableName, sequenceColumn, sequenceColumn
+        );
+        List<T> result = jdbcTemplate.query(sql, rowMapper, lastSequence);
+        // 最大シーケンス取得と更新
+        if (!result.isEmpty()) {
+            Long maxSequence = jdbcTemplate.queryForObject(
+                String.format("SELECT MAX(%s) FROM %s WHERE %s > ?",
+                    sequenceColumn, tableName, sequenceColumn),
+                Long.class, lastSequence
+            );
+            checkpoint.setLastSequence(maxSequence);
+            checkpointRepository.save(checkpoint);
+        }
+        return result;
+    }
+    /**
+     * 削除データの検知（論理削除方式）
+     */
+    public List<String> extractDeletedIds(
+            String tableName,
+            String idColumn,
+            String deleteFlagColumn) {
+        ExtractCheckpoint checkpoint = checkpointRepository
+            .findByTableName(tableName + "_DELETE")
+            .orElse(new ExtractCheckpoint(tableName + "_DELETE", LocalDateTime.MIN));
+        String sql = String.format(
+            "SELECT %s FROM %s WHERE %s = true AND 更新日時 > ?",
+            idColumn, tableName, deleteFlagColumn
+        );
+        List<String> deletedIds = jdbcTemplate.queryForList(
+            sql, String.class, checkpoint.getLastExtractTime()
+        );
+        checkpoint.setLastExtractTime(LocalDateTime.now());
+        checkpointRepository.save(checkpoint);
+        return deletedIds;
+    }
+}
+// 抽出チェックポイント
+@Entity
+@Table(name = "抽出チェックポイント")
+public class ExtractCheckpoint {
+    @Id
+    private String tableName;
+    private LocalDateTime lastExtractTime;
+    private Long lastSequence;
+    public ExtractCheckpoint(String tableName, LocalDateTime lastExtractTime) {
+        this.tableName = tableName;
+        this.lastExtractTime = lastExtractTime;
+    }
+    public ExtractCheckpoint(String tableName, Long lastSequence) {
+        this.tableName = tableName;
+        this.lastSequence = lastSequence;
+    }
+    // getters, setters...
+}
+```
+</details>
+---
+## 39.2 リアルタイム連携
+### Change Data Capture（CDC）
+CDC は、データベースの変更をリアルタイムで検知し、他システムに伝播するパターンです。
+```plantuml
+@startuml
+title Change Data Capture の仕組み
+rectangle "ソースDB" as source {
+    database "販売管理" as sales_db
+    file "トランザクション\nログ" as tx_log
+}
+rectangle "CDC プラットフォーム" as cdc {
+    rectangle "Debezium\nConnector" as connector
+    queue "Kafka" as kafka
+}
+rectangle "ターゲットシステム" as targets {
+    database "財務会計" as accounting
+    database "分析DB" as analytics
+    rectangle "通知サービス" as notification
+}
+sales_db --> tx_log : WAL/Binlog
+tx_log --> connector : 変更検知
+connector --> kafka : イベント発行
+kafka --> accounting : 消費
+kafka --> analytics : 消費
+kafka --> notification : 消費
+note bottom of connector
+  【CDC の仕組み】
+  ・データベースのトランザクションログを監視
+  ・INSERT/UPDATE/DELETE を検知
+  ・変更内容をイベントとして発行
+end note
+@enduml
+```
+#### CDC イベントの構造
+```plantuml
+@startuml
+title CDC イベントの構造
+class "CDC イベント" as cdc_event {
+    +source: SourceInfo
+    +operation: String
+    +timestamp: Long
+    +before: Record
+    +after: Record
+}
+class "SourceInfo" as source_info {
+    +connector: String
+    +database: String
+    +schema: String
+    +table: String
+    +txId: Long
+    +lsn: Long
+}
+note right of cdc_event
+  【operation の値】
+  ・c: CREATE（INSERT）
+  ・u: UPDATE
+  ・d: DELETE
+  ・r: READ（スナップショット）
+  【before/after】
+  ・INSERT: before=null, after=新データ
+  ・UPDATE: before=旧データ, after=新データ
+  ・DELETE: before=旧データ, after=null
+end note
+cdc_event --> source_info
+@enduml
+```
+<details>
+<summary>Java 実装例 - CDC コンシューマー</summary>
+```java
+// CDC イベントコンシューマー
+@Component
+public class SalesCdcConsumer {
+    private final ObjectMapper objectMapper;
+    private final JournalSyncService journalSyncService;
+    @KafkaListener(topics = "sales.public.売上")
+    public void consume(String message) {
+        try {
+            CdcEvent event = objectMapper.readValue(message, CdcEvent.class);
+            switch (event.getOperation()) {
+                case "c" -> handleInsert(event.getAfter());
+                case "u" -> handleUpdate(event.getBefore(), event.getAfter());
+                case "d" -> handleDelete(event.getBefore());
+                default -> log.warn("Unknown operation: {}", event.getOperation());
+            }
+        } catch (Exception e) {
+            log.error("CDC イベント処理エラー", e);
+            throw new CdcProcessingException(e);
+        }
+    }
+    private void handleInsert(JsonNode after) {
+        SalesData sales = objectMapper.convertValue(after, SalesData.class);
+        journalSyncService.createJournalFromSales(sales);
+    }
+    private void handleUpdate(JsonNode before, JsonNode after) {
+        SalesData oldSales = objectMapper.convertValue(before, SalesData.class);
+        SalesData newSales = objectMapper.convertValue(after, SalesData.class);
+        // 赤黒処理で訂正
+        journalSyncService.reverseJournal(oldSales);
+        journalSyncService.createJournalFromSales(newSales);
+    }
+    private void handleDelete(JsonNode before) {
+        SalesData sales = objectMapper.convertValue(before, SalesData.class);
+        journalSyncService.reverseJournal(sales);
+    }
+}
+// CDC イベント
+@Data
+public class CdcEvent {
+    private SourceInfo source;
+    private String operation;  // c, u, d, r
+    private Long tsMs;
+    private JsonNode before;
+    private JsonNode after;
+}
+@Data
+public class SourceInfo {
+    private String connector;
+    private String db;
+    private String schema;
+    private String table;
+    private Long txId;
+    private Long lsn;
+}
+```
+</details>
+### データベーストリガーの活用
+トリガーを使用した変更検知は、CDC ツールなしでも実装できるシンプルな方式です。
+```plantuml
+@startuml
+title トリガーによる変更検知
+database "ソースDB" as source {
+    entity "売上テーブル" as sales
+    entity "変更ログ" as change_log
+}
+rectangle "トリガー" as trigger {
+    rectangle "INSERT トリガー" as insert_trigger
+    rectangle "UPDATE トリガー" as update_trigger
+    rectangle "DELETE トリガー" as delete_trigger
+}
+rectangle "連携バッチ" as batch {
+    rectangle "変更ログ読込" as read_log
+    rectangle "ターゲット更新" as update_target
+    rectangle "ログ削除" as delete_log
+}
+database "ターゲットDB" as target
+sales --> insert_trigger : INSERT
+sales --> update_trigger : UPDATE
+sales --> delete_trigger : DELETE
+insert_trigger --> change_log : 記録
+update_trigger --> change_log : 記録
+delete_trigger --> change_log : 記録
+change_log --> read_log : 定期実行
+read_log --> update_target
+update_target --> target
+update_target --> delete_log
+note bottom of trigger
+  【トリガー方式のメリット】
+  ・追加ツール不要
+  ・確実に変更を捕捉
+  【デメリット】
+  ・パフォーマンスへの影響
+  ・トリガーの管理が煩雑
+end note
+@enduml
+```
+<details>
+<summary>SQL 定義 - 変更ログトリガー</summary>
+```sql
+-- 変更ログテーブル
+CREATE TABLE 変更ログ (
+    ログID SERIAL PRIMARY KEY,
+    テーブル名 VARCHAR(100) NOT NULL,
+    操作種別 VARCHAR(10) NOT NULL,  -- INSERT, UPDATE, DELETE
+    レコードID VARCHAR(100) NOT NULL,
+    変更前データ JSONB,
+    変更後データ JSONB,
+    変更日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    処理済フラグ BOOLEAN DEFAULT FALSE,
+    処理日時 TIMESTAMP
+);
+CREATE INDEX idx_変更ログ_未処理 ON 変更ログ (処理済フラグ, 変更日時)
+    WHERE 処理済フラグ = FALSE;
+-- 売上テーブル用トリガー関数
+CREATE OR REPLACE FUNCTION fn_売上変更ログ()
+RETURNS TRIGGER AS $$
+BEGIN
+    IF TG_OP = 'INSERT' THEN
+        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更後データ)
+        VALUES ('売上', 'INSERT', NEW.売上番号, row_to_json(NEW)::JSONB);
+        RETURN NEW;
+    ELSIF TG_OP = 'UPDATE' THEN
+        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更前データ, 変更後データ)
+        VALUES ('売上', 'UPDATE', NEW.売上番号,
+            row_to_json(OLD)::JSONB, row_to_json(NEW)::JSONB);
+        RETURN NEW;
+    ELSIF TG_OP = 'DELETE' THEN
+        INSERT INTO 変更ログ (テーブル名, 操作種別, レコードID, 変更前データ)
+        VALUES ('売上', 'DELETE', OLD.売上番号, row_to_json(OLD)::JSONB);
+        RETURN OLD;
+    END IF;
+END;
+$$ LANGUAGE plpgsql;
+-- トリガー設定
+CREATE TRIGGER trg_売上変更ログ
+AFTER INSERT OR UPDATE OR DELETE ON 売上
+FOR EACH ROW EXECUTE FUNCTION fn_売上変更ログ();
+```
+</details>
+<details>
+<summary>Java 実装例 - 変更ログ処理</summary>
+```java
+// 変更ログ処理サービス
+@Service
+public class ChangeLogProcessingService {
+    private final JdbcTemplate jdbcTemplate;
+    private final Map<String, ChangeLogHandler> handlers;
+    @Scheduled(fixedDelay = 5000)  // 5秒ごと
+    @Transactional
+    public void processChangeLogs() {
+        // 未処理ログを取得（ロック付き）
+        String selectSql = """
+            SELECT ログID, テーブル名, 操作種別, レコードID, 変更前データ, 変更後データ
+            FROM 変更ログ
+            WHERE 処理済フラグ = FALSE
+            ORDER BY 変更日時
+            LIMIT 100
+            FOR UPDATE SKIP LOCKED
+            """;
+        List<ChangeLog> logs = jdbcTemplate.query(selectSql,
+            (rs, rowNum) -> new ChangeLog(
+                rs.getLong("ログID"),
+                rs.getString("テーブル名"),
+                rs.getString("操作種別"),
+                rs.getString("レコードID"),
+                rs.getString("変更前データ"),
+                rs.getString("変更後データ")
+            )
+        );
+        for (ChangeLog log : logs) {
+            try {
+                // テーブル別ハンドラーで処理
+                ChangeLogHandler handler = handlers.get(log.tableName());
+                if (handler != null) {
+                    handler.handle(log);
+                }
+                // 処理済みマーク
+                markAsProcessed(log.logId());
+            } catch (Exception e) {
+                // エラーログ記録（処理は継続）
+                recordError(log.logId(), e.getMessage());
+            }
+        }
+    }
+    private void markAsProcessed(Long logId) {
+        jdbcTemplate.update(
+            "UPDATE 変更ログ SET 処理済フラグ = TRUE, 処理日時 = CURRENT_TIMESTAMP WHERE ログID = ?",
+            logId
+        );
+    }
+    private void recordError(Long logId, String errorMessage) {
+        jdbcTemplate.update(
+            "UPDATE 変更ログ SET エラー内容 = ? WHERE ログID = ?",
+            errorMessage, logId
+        );
+    }
+}
+// 変更ログハンドラーインターフェース
+public interface ChangeLogHandler {
+    void handle(ChangeLog log);
+}
+// 売上変更ログハンドラー
+@Component("売上")
+public class SalesChangeLogHandler implements ChangeLogHandler {
+    private final ObjectMapper objectMapper;
+    private final JournalSyncService journalSyncService;
+    @Override
+    public void handle(ChangeLog log) {
+        switch (log.operation()) {
+            case "INSERT" -> {
+                SalesData sales = parseJson(log.afterData(), SalesData.class);
+                journalSyncService.createJournalFromSales(sales);
+            }
+            case "UPDATE" -> {
+                SalesData oldSales = parseJson(log.beforeData(), SalesData.class);
+                SalesData newSales = parseJson(log.afterData(), SalesData.class);
+                journalSyncService.reverseJournal(oldSales);
+                journalSyncService.createJournalFromSales(newSales);
+            }
+            case "DELETE" -> {
+                SalesData sales = parseJson(log.beforeData(), SalesData.class);
+                journalSyncService.reverseJournal(sales);
+            }
+        }
+    }
+    private <T> T parseJson(String json, Class<T> clazz) {
+        try {
+            return objectMapper.readValue(json, clazz);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("JSON パース失敗", e);
+        }
+    }
+}
+```
+</details>
+### メッセージキューによる非同期連携
+メッセージキューを使用した非同期連携は、システム間の疎結合を実現します。
+```plantuml
+@startuml
+title メッセージキューによる非同期連携
+rectangle "プロデューサー" as producer {
+    rectangle "販売管理\nサービス" as sales_service
+}
+rectangle "メッセージブローカー" as broker {
+    queue "売上イベント\nキュー" as sales_queue
+    queue "仕訳イベント\nキュー" as journal_queue
+    queue "在庫イベント\nキュー" as inventory_queue
+}
+rectangle "コンシューマー" as consumer {
+    rectangle "財務会計\nサービス" as accounting_service
+    rectangle "在庫管理\nサービス" as inventory_service
+    rectangle "分析\nサービス" as analytics_service
+}
+sales_service --> sales_queue : 売上イベント発行
+sales_queue --> accounting_service : 消費（仕訳生成）
+sales_queue --> inventory_service : 消費（在庫更新）
+sales_queue --> analytics_service : 消費（分析用）
+accounting_service --> journal_queue : 仕訳イベント発行
+note bottom of broker
+  【メッセージキューの特徴】
+  ・非同期処理による疎結合
+  ・メッセージの永続化
+  ・再処理・リトライが容易
+  ・スケーラビリティ
+end note
+@enduml
+```
+#### メッセージ配信パターン
+```plantuml
+@startuml
+title メッセージ配信パターン
+rectangle "Point-to-Point" as p2p {
+    queue "キュー" as queue1
+    rectangle "Consumer A" as consumer_a
+    queue1 --> consumer_a : 1対1配信
+    note right of queue1
+      1つのメッセージは
+      1つのコンシューマーのみが受信
+    end note
+}
+rectangle "Pub/Sub" as pubsub {
+    rectangle "トピック" as topic
+    rectangle "Consumer B" as consumer_b
+    rectangle "Consumer C" as consumer_c
+    rectangle "Consumer D" as consumer_d
+    topic --> consumer_b
+    topic --> consumer_c
+    topic --> consumer_d
+    note right of topic
+      1つのメッセージを
+      複数のサブスクライバーが受信
+    end note
+}
+rectangle "Competing Consumers" as competing {
+    queue "キュー" as queue2
+    rectangle "Consumer E1" as consumer_e1
+    rectangle "Consumer E2" as consumer_e2
+    rectangle "Consumer E3" as consumer_e3
+    queue2 --> consumer_e1
+    queue2 --> consumer_e2
+    queue2 --> consumer_e3
+    note right of queue2
+      複数のコンシューマーが
+      並列でメッセージを処理
+      （負荷分散）
+    end note
+}
+@enduml
+```
+<details>
+<summary>Java 実装例 - メッセージキュー連携</summary>
+```java
+// メッセージプロデューサー
+@Service
+public class SalesEventPublisher {
+    private final RabbitTemplate rabbitTemplate;
+    private final ObjectMapper objectMapper;
+    private static final String EXCHANGE = "sales.events";
+    public void publishSalesCreated(SalesData sales) {
+        SalesCreatedEvent event = new SalesCreatedEvent(
+            UUID.randomUUID().toString(),
+            Instant.now(),
+            sales.getSalesNumber(),
+            sales.getCustomerCode(),
+            sales.getSalesDate(),
+            sales.getTotalAmount()
+        );
+        publish(event, "sales.created");
+    }
+    public void publishSalesCancelled(String salesNumber, String reason) {
+        SalesCancelledEvent event = new SalesCancelledEvent(
+            UUID.randomUUID().toString(),
+            Instant.now(),
+            salesNumber,
+            reason
+        );
+        publish(event, "sales.cancelled");
+    }
+    private void publish(Object event, String routingKey) {
+        try {
+            String json = objectMapper.writeValueAsString(event);
+            rabbitTemplate.convertAndSend(EXCHANGE, routingKey, json);
+            log.info("イベント発行: {} -> {}", routingKey, event);
+        } catch (Exception e) {
+            log.error("イベント発行失敗", e);
+            throw new EventPublishException(e);
+        }
+    }
+}
+// メッセージコンシューマー
+@Component
+public class SalesEventConsumer {
+    private final ObjectMapper objectMapper;
+    private final JournalService journalService;
+    private final InventoryService inventoryService;
+    @RabbitListener(queues = "accounting.sales.queue")
+    public void handleSalesCreatedForAccounting(String message) {
+        SalesCreatedEvent event = parseEvent(message, SalesCreatedEvent.class);
+        try {
+            // 仕訳生成
+            journalService.createFromSales(event);
+            log.info("売上仕訳生成完了: {}", event.salesNumber());
+        } catch (Exception e) {
+            log.error("売上仕訳生成失敗: {}", event.salesNumber(), e);
+            throw new AmqpRejectAndDontRequeueException(e);
+        }
+    }
+    @RabbitListener(queues = "inventory.sales.queue")
+    public void handleSalesCreatedForInventory(String message) {
+        SalesCreatedEvent event = parseEvent(message, SalesCreatedEvent.class);
+        try {
+            // 在庫引当解除
+            inventoryService.releaseAllocation(event.salesNumber());
+            log.info("在庫引当解除完了: {}", event.salesNumber());
+        } catch (Exception e) {
+            log.error("在庫引当解除失敗: {}", event.salesNumber(), e);
+            throw new AmqpRejectAndDontRequeueException(e);
+        }
+    }
+    private <T> T parseEvent(String message, Class<T> clazz) {
+        try {
+            return objectMapper.readValue(message, clazz);
+        } catch (JsonProcessingException e) {
+            throw new EventParseException(e);
+        }
+    }
+}
+// RabbitMQ 設定
+@Configuration
+public class RabbitMqConfig {
+    @Bean
+    public TopicExchange salesEventsExchange() {
+        return new TopicExchange("sales.events");
+    }
+    @Bean
+    public Queue accountingSalesQueue() {
+        return QueueBuilder.durable("accounting.sales.queue")
+            .withArgument("x-dead-letter-exchange", "sales.events.dlx")
+            .withArgument("x-dead-letter-routing-key", "accounting.sales.dead")
+            .build();
+    }
+    @Bean
+    public Queue inventorySalesQueue() {
+        return QueueBuilder.durable("inventory.sales.queue")
+            .withArgument("x-dead-letter-exchange", "sales.events.dlx")
+            .withArgument("x-dead-letter-routing-key", "inventory.sales.dead")
+            .build();
+    }
+    @Bean
+    public Binding accountingBinding() {
+        return BindingBuilder
+            .bind(accountingSalesQueue())
+            .to(salesEventsExchange())
+            .with("sales.*");
+    }
+    @Bean
+    public Binding inventoryBinding() {
+        return BindingBuilder
+            .bind(inventorySalesQueue())
+            .to(salesEventsExchange())
+            .with("sales.*");
+    }
+    // Dead Letter Queue 設定
+    @Bean
+    public DirectExchange deadLetterExchange() {
+        return new DirectExchange("sales.events.dlx");
+    }
+    @Bean
+    public Queue deadLetterQueue() {
+        return QueueBuilder.durable("sales.events.dead").build();
+    }
+}
+```
+</details>
+---
+## 39.3 連携テーブルの設計
+### 連携ステータス管理
+データ連携の状態を追跡するためのテーブル設計は、運用上非常に重要です。
+```plantuml
+@startuml
+title 連携ステータス管理テーブル
+entity "連携ジョブ" as job {
+    *ジョブID : UUID <<PK>>
+    --
+    *ジョブ名 : VARCHAR(100)
+    *連携種別 : VARCHAR(50)
+    ソースシステム : VARCHAR(50)
+    ターゲットシステム : VARCHAR(50)
+    スケジュール : VARCHAR(50)
+    有効フラグ : BOOLEAN
+    作成日時 : TIMESTAMP
+}
+entity "連携実行履歴" as execution {
+    *実行ID : UUID <<PK>>
+    --
+    *ジョブID : UUID <<FK>>
+    *開始日時 : TIMESTAMP
+    終了日時 : TIMESTAMP
+    *ステータス : VARCHAR(20)
+    抽出件数 : INTEGER
+    成功件数 : INTEGER
+    エラー件数 : INTEGER
+    スキップ件数 : INTEGER
+    エラー内容 : TEXT
+}
+entity "連携対象データ" as data {
+    *データID : UUID <<PK>>
+    --
+    *実行ID : UUID <<FK>>
+    *ソースID : VARCHAR(100)
+    *連携ステータス : VARCHAR(20)
+    処理日時 : TIMESTAMP
+    エラー内容 : TEXT
+    リトライ回数 : INTEGER
+}
+entity "連携エラー詳細" as error {
+    *エラーID : UUID <<PK>>
+    --
+    *データID : UUID <<FK>>
+    *エラー種別 : VARCHAR(50)
+    *エラーメッセージ : TEXT
+    スタックトレース : TEXT
+    発生日時 : TIMESTAMP
+}
+job ||--o{ execution : has
+execution ||--o{ data : contains
+data ||--o{ error : has
+note right of execution
+  【ステータス】
+  ・RUNNING: 実行中
+  ・SUCCESS: 正常完了
+  ・PARTIAL: 部分完了
+  ・FAILED: 失敗
+  ・CANCELLED: 中止
+end note
+note right of data
+  【連携ステータス】
+  ・PENDING: 処理待ち
+  ・PROCESSING: 処理中
+  ・SUCCESS: 成功
+  ・ERROR: エラー
+  ・SKIPPED: スキップ
+end note
+@enduml
+```
+<details>
+<summary>SQL 定義</summary>
+```sql
+-- 連携ジョブマスタ
+CREATE TABLE 連携ジョブ (
+    ジョブID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    ジョブ名 VARCHAR(100) NOT NULL UNIQUE,
+    連携種別 VARCHAR(50) NOT NULL,  -- BATCH, REALTIME, CDC
+    ソースシステム VARCHAR(50),
+    ターゲットシステム VARCHAR(50),
+    スケジュール VARCHAR(50),  -- cron 式
+    設定JSON JSONB,
+    有効フラグ BOOLEAN DEFAULT TRUE,
+    作成日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    更新日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+-- 連携実行履歴
+CREATE TABLE 連携実行履歴 (
+    実行ID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    ジョブID UUID NOT NULL REFERENCES 連携ジョブ(ジョブID),
+    開始日時 TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    終了日時 TIMESTAMP,
+    ステータス VARCHAR(20) NOT NULL DEFAULT 'RUNNING',
+    抽出件数 INTEGER DEFAULT 0,
+    成功件数 INTEGER DEFAULT 0,
+    エラー件数 INTEGER DEFAULT 0,
+    スキップ件数 INTEGER DEFAULT 0,
+    エラー内容 TEXT,
+    実行パラメータ JSONB,
+    CONSTRAINT chk_ステータス CHECK (
+        ステータス IN ('RUNNING', 'SUCCESS', 'PARTIAL', 'FAILED', 'CANCELLED')
+    )
+);
+CREATE INDEX idx_連携実行履歴_ジョブ日時
+    ON 連携実行履歴 (ジョブID, 開始日時 DESC);
+-- 連携対象データ
+CREATE TABLE 連携対象データ (
+    データID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    実行ID UUID NOT NULL REFERENCES 連携実行履歴(実行ID),
+    ソースID VARCHAR(100) NOT NULL,
+    連携ステータス VARCHAR(20) NOT NULL DEFAULT 'PENDING',
+    処理日時 TIMESTAMP,
+    エラー内容 TEXT,
+    リトライ回数 INTEGER DEFAULT 0,
+    ソースデータ JSONB,
+    CONSTRAINT chk_連携ステータス CHECK (
+        連携ステータス IN ('PENDING', 'PROCESSING', 'SUCCESS', 'ERROR', 'SKIPPED')
+    )
+);
+CREATE INDEX idx_連携対象データ_実行ステータス
+    ON 連携対象データ (実行ID, 連携ステータス);
+-- 連携エラー詳細
+CREATE TABLE 連携エラー詳細 (
+    エラーID UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    データID UUID NOT NULL REFERENCES 連携対象データ(データID),
+    エラー種別 VARCHAR(50) NOT NULL,
+    エラーメッセージ TEXT NOT NULL,
+    スタックトレース TEXT,
+    発生日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+-- 連携サマリービュー
+CREATE VIEW v_連携サマリー AS
+SELECT
+    j.ジョブ名,
+    j.連携種別,
+    e.実行ID,
+    e.開始日時,
+    e.終了日時,
+    e.ステータス,
+    e.抽出件数,
+    e.成功件数,
+    e.エラー件数,
+    CASE
+        WHEN e.抽出件数 > 0
+        THEN ROUND(e.成功件数::NUMERIC / e.抽出件数 * 100, 2)
+        ELSE 0
+    END AS 成功率
+FROM 連携ジョブ j
+JOIN 連携実行履歴 e ON j.ジョブID = e.ジョブID
+ORDER BY e.開始日時 DESC;
+```
+</details>
+### エラーハンドリングとリトライ
+データ連携におけるエラーハンドリングは、システムの信頼性を確保するために重要です。
+```plantuml
+@startuml
+title エラーハンドリングとリトライフロー
+|連携処理|
+start
+:データ取得;
+repeat
+    :データ処理実行;
+    if (成功?) then (yes)
+        :成功記録;
+        break
+    else (no)
+        :リトライ回数 + 1;
+        if (リトライ上限?) then (no)
+            :待機（指数バックオフ）;
+            note right
+              1回目: 1秒
+              2回目: 2秒
+              3回目: 4秒
+              4回目: 8秒
+              ...
+            end note
+        else (yes)
+            :エラー記録;
+            :Dead Letter Queue へ;
+            break
+        endif
+    endif
+repeat while (リトライ中)
+stop
+@enduml
+```
+#### リトライ戦略
+```plantuml
+@startuml
+title リトライ戦略の比較
+rectangle "固定間隔リトライ" as fixed {
+    note right
+      【特徴】
+      一定間隔でリトライ
+      例: 5秒ごと
+      【適用場面】
+      ・短期的な障害
+      ・軽微なエラー
+    end note
+}
+rectangle "指数バックオフ" as exponential {
+    note right
+      【特徴】
+      リトライ間隔を指数的に増加
+      例: 1秒 → 2秒 → 4秒 → 8秒
+      【適用場面】
+      ・外部サービス障害
+      ・負荷軽減が必要な場合
+    end note
+}
+rectangle "ジッター付きバックオフ" as jitter {
+    note right
+      【特徴】
+      指数バックオフにランダム要素追加
+      例: 1〜2秒 → 2〜4秒 → 4〜8秒
+      【適用場面】
+      ・多数クライアントの同時リトライ回避
+      ・サンダリングハード問題対策
+    end note
+}
+rectangle "サーキットブレーカー" as circuit {
+    note right
+      【特徴】
+      エラー率が閾値超過で遮断
+      一定時間後に再試行
+      【適用場面】
+      ・長期的な障害
+      ・カスケード障害防止
+    end note
+}
+@enduml
+```
+<details>
+<summary>Java 実装例 - リトライ機構</summary>
+```java
+// リトライ設定
+@Configuration
+public class RetryConfig {
+    @Bean
+    public RetryTemplate retryTemplate() {
+        RetryTemplate template = new RetryTemplate();
+        // 指数バックオフ設定
+        ExponentialBackOffPolicy backOffPolicy = new ExponentialBackOffPolicy();
+        backOffPolicy.setInitialInterval(1000);  // 1秒
+        backOffPolicy.setMultiplier(2.0);
+        backOffPolicy.setMaxInterval(30000);  // 最大30秒
+        template.setBackOffPolicy(backOffPolicy);
+        // リトライポリシー
+        Map<Class<? extends Throwable>, Boolean> retryableExceptions = new HashMap<>();
+        retryableExceptions.put(TransientDataAccessException.class, true);
+        retryableExceptions.put(TimeoutException.class, true);
+        retryableExceptions.put(ConnectException.class, true);
+        SimpleRetryPolicy retryPolicy = new SimpleRetryPolicy(
+            5,  // 最大5回
+            retryableExceptions
+        );
+        template.setRetryPolicy(retryPolicy);
+        // リスナー
+        template.registerListener(new RetryListenerSupport() {
+            @Override
+            public <T, E extends Throwable> void onError(
+                    RetryContext context, RetryCallback<T, E> callback, Throwable throwable) {
+                log.warn("リトライ {} 回目: {}",
+                    context.getRetryCount(), throwable.getMessage());
+            }
+        });
+        return template;
+    }
+}
+// リトライ付き連携サービス
+@Service
+public class RetryableIntegrationService {
+    private final RetryTemplate retryTemplate;
+    private final IntegrationDataRepository dataRepository;
+    private final DeadLetterService deadLetterService;
+    @Transactional
+    public void processWithRetry(IntegrationData data) {
+        try {
+            retryTemplate.execute(context -> {
+                // 処理実行
+                processData(data);
+                // 成功記録
+                data.setStatus(IntegrationStatus.SUCCESS);
+                data.setProcessedAt(LocalDateTime.now());
+                dataRepository.save(data);
+                return null;
+            });
+        } catch (Exception e) {
+            // リトライ上限超過
+            handleMaxRetriesExceeded(data, e);
+        }
+    }
+    private void processData(IntegrationData data) {
+        // 実際の連携処理
+        // ...
+    }
+    private void handleMaxRetriesExceeded(IntegrationData data, Exception e) {
+        // エラー記録
+        data.setStatus(IntegrationStatus.ERROR);
+        data.setErrorMessage(e.getMessage());
+        data.setRetryCount(data.getRetryCount() + 1);
+        dataRepository.save(data);
+        // Dead Letter Queue へ
+        deadLetterService.send(data);
+        // アラート通知
+        alertService.notify(
+            "連携エラー: " + data.getSourceId(),
+            e.getMessage()
+        );
+    }
+}
+// サーキットブレーカー付きサービス
+@Service
+public class CircuitBreakerIntegrationService {
+    private final CircuitBreaker circuitBreaker;
+    private final ExternalSystemClient externalClient;
+    public CircuitBreakerIntegrationService() {
+        CircuitBreakerConfig config = CircuitBreakerConfig.custom()
+            .failureRateThreshold(50)  // 50%以上でオープン
+            .waitDurationInOpenState(Duration.ofSeconds(30))
+            .slidingWindowSize(10)
+            .build();
+        this.circuitBreaker = CircuitBreaker.of("external-system", config);
+    }
+    public void sendToExternalSystem(IntegrationData data) {
+        Try.ofSupplier(
+            CircuitBreaker.decorateSupplier(circuitBreaker, () -> {
+                return externalClient.send(data);
+            })
+        ).recover(CallNotPermittedException.class, e -> {
+            log.warn("サーキットブレーカーオープン中");
+            // フォールバック処理
+            queueForLater(data);
+            return null;
+        }).get();
+    }
+    private void queueForLater(IntegrationData data) {
+        // 後で再処理するためキューイング
+        pendingQueue.add(data);
+    }
+}
+```
+</details>
+### 冪等性の確保
+データ連携において冪等性を確保することで、重複実行による問題を防ぎます。
+```plantuml
+@startuml
+title 冪等性確保のパターン
+rectangle "冪等キー方式" as idempotency_key {
+    note right
+      【仕組み】
+      ・リクエストに一意のキーを付与
+      ・処理済みキーをテーブルに記録
+      ・重複リクエストはスキップ
+      【実装】
+      冪等キーテーブルで管理
+    end note
+}
+rectangle "Upsert 方式" as upsert {
+    note right
+      【仕組み】
+      ・INSERT or UPDATE で処理
+      ・存在すれば更新、なければ挿入
+      ・同じデータで何度実行しても同じ結果
+      【実装】
+      INSERT ... ON CONFLICT DO UPDATE
+    end note
+}
+rectangle "バージョン管理方式" as version {
+    note right
+      【仕組み】
+      ・データにバージョン番号を付与
+      ・古いバージョンの更新は無視
+      ・最新バージョンのみ適用
+      【実装】
+      楽観ロック + バージョン比較
+    end note
+}
+rectangle "ステータス管理方式" as status {
+    note right
+      【仕組み】
+      ・処理ステータスを記録
+      ・処理済みデータは再処理しない
+      ・ステータス遷移を厳密に管理
+      【実装】
+      ステータス + 処理日時で判定
+    end note
+}
+@enduml
+```
+<details>
+<summary>SQL 定義 - 冪等性テーブル</summary>
+```sql
+-- 冪等キーテーブル
+CREATE TABLE 冪等キー (
+    冪等キー VARCHAR(100) PRIMARY KEY,
+    処理種別 VARCHAR(50) NOT NULL,
+    ソースID VARCHAR(100) NOT NULL,
+    処理結果 JSONB,
+    処理日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    有効期限 TIMESTAMP NOT NULL
+);
+CREATE INDEX idx_冪等キー_有効期限 ON 冪等キー (有効期限);
+-- 期限切れキーの自動削除
+CREATE OR REPLACE FUNCTION fn_冪等キー_クリーンアップ()
+RETURNS void AS $$
+BEGIN
+    DELETE FROM 冪等キー WHERE 有効期限 < CURRENT_TIMESTAMP;
+END;
+$$ LANGUAGE plpgsql;
+-- 冪等処理の実行関数
+CREATE OR REPLACE FUNCTION fn_冪等処理(
+    p_冪等キー VARCHAR,
+    p_処理種別 VARCHAR,
+    p_ソースID VARCHAR,
+    p_有効期間_日数 INTEGER DEFAULT 7
+) RETURNS TABLE (
+    処理可能 BOOLEAN,
+    既存結果 JSONB
+) AS $$
+DECLARE
+    v_existing RECORD;
+BEGIN
+    -- 既存キーを検索（ロック付き）
+    SELECT * INTO v_existing
+    FROM 冪等キー
+    WHERE 冪等キー = p_冪等キー
+    FOR UPDATE;
+    IF v_existing IS NOT NULL THEN
+        -- 既に処理済み
+        RETURN QUERY SELECT FALSE, v_existing.処理結果;
+    ELSE
+        -- 新規キーを登録
+        INSERT INTO 冪等キー (冪等キー, 処理種別, ソースID, 有効期限)
+        VALUES (
+            p_冪等キー,
+            p_処理種別,
+            p_ソースID,
+            CURRENT_TIMESTAMP + (p_有効期間_日数 || ' days')::INTERVAL
+        );
+        RETURN QUERY SELECT TRUE, NULL::JSONB;
+    END IF;
+END;
+$$ LANGUAGE plpgsql;
+-- 処理結果の記録関数
+CREATE OR REPLACE FUNCTION fn_冪等結果記録(
+    p_冪等キー VARCHAR,
+    p_処理結果 JSONB
+) RETURNS void AS $$
+BEGIN
+    UPDATE 冪等キー
+    SET 処理結果 = p_処理結果
+    WHERE 冪等キー = p_冪等キー;
+END;
+$$ LANGUAGE plpgsql;
+```
+</details>
+<details>
+<summary>Java 実装例 - 冪等性サービス</summary>
+```java
+// 冪等性サービス
+@Service
+public class IdempotencyService {
+    private final JdbcTemplate jdbcTemplate;
+    /**
+     * 冪等処理を実行
+     * @return true: 処理可能, false: 既に処理済み
+     */
+    @Transactional
+    public IdempotencyResult checkAndLock(
+            String idempotencyKey,
+            String processType,
+            String sourceId) {
+        // 既存キーをチェック
+        Map<String, Object> result = jdbcTemplate.queryForMap(
+            "SELECT * FROM fn_冪等処理(?, ?, ?)",
+            idempotencyKey, processType, sourceId
+        );
+        boolean canProcess = (Boolean) result.get("処理可能");
+        String existingResult = (String) result.get("既存結果");
+        return new IdempotencyResult(canProcess, existingResult);
+    }
+    /**
+     * 処理結果を記録
+     */
+    @Transactional
+    public void recordResult(String idempotencyKey, Object result) {
+        try {
+            String jsonResult = new ObjectMapper().writeValueAsString(result);
+            jdbcTemplate.update(
+                "SELECT fn_冪等結果記録(?, ?::JSONB)",
+                idempotencyKey, jsonResult
+            );
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("結果のJSON変換に失敗", e);
+        }
+    }
+}
+// 冪等性デコレーター
+@Aspect
+@Component
+public class IdempotencyAspect {
+    private final IdempotencyService idempotencyService;
+    @Around("@annotation(idempotent)")
+    public Object ensureIdempotency(
+            ProceedingJoinPoint joinPoint,
+            Idempotent idempotent) throws Throwable {
+        // 冪等キーを取得
+        String idempotencyKey = extractIdempotencyKey(joinPoint, idempotent);
+        String processType = joinPoint.getSignature().getName();
+        String sourceId = extractSourceId(joinPoint, idempotent);
+        // 冪等チェック
+        IdempotencyResult check = idempotencyService.checkAndLock(
+            idempotencyKey, processType, sourceId
+        );
+        if (!check.canProcess()) {
+            log.info("冪等スキップ: {} (既存結果: {})",
+                idempotencyKey, check.existingResult());
+            return check.existingResult();
+        }
+        try {
+            // 処理実行
+            Object result = joinPoint.proceed();
+            // 結果記録
+            idempotencyService.recordResult(idempotencyKey, result);
+            return result;
+        } catch (Exception e) {
+            // エラー時は冪等キーを削除（再試行可能に）
+            idempotencyService.removeKey(idempotencyKey);
+            throw e;
+        }
+    }
+    private String extractIdempotencyKey(
+            ProceedingJoinPoint joinPoint, Idempotent idempotent) {
+        // アノテーションの keyExpression から冪等キーを抽出
+        // SpEL で引数から動的に取得
+        // ...
+    }
+}
+// 冪等アノテーション
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface Idempotent {
+    String keyExpression();  // SpEL式: "#args[0].id"
+    String sourceIdExpression() default "";
+}
+// 使用例
+@Service
+public class JournalIntegrationService {
+    @Idempotent(keyExpression = "'SALES_JOURNAL_' + #sales.salesNumber")
+    @Transactional
+    public JournalEntry createJournalFromSales(SalesData sales) {
+        // この処理は同じ売上番号に対して1回だけ実行される
+        return journalService.createFromSales(sales);
+    }
+}
+// Upsert による冪等性
+@Repository
+public class JournalRepository {
+    @Transactional
+    public void upsertFromIntegration(JournalEntry journal) {
+        String sql = """
+            INSERT INTO 仕訳 (
+                伝票番号, 伝票日付, 借方勘定, 借方金額,
+                貸方勘定, 貸方金額, 摘要, ソース種別, ソースID
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+            ON CONFLICT (ソース種別, ソースID) DO UPDATE SET
+                伝票日付 = EXCLUDED.伝票日付,
+                借方勘定 = EXCLUDED.借方勘定,
+                借方金額 = EXCLUDED.借方金額,
+                貸方勘定 = EXCLUDED.貸方勘定,
+                貸方金額 = EXCLUDED.貸方金額,
+                摘要 = EXCLUDED.摘要,
+                更新日時 = CURRENT_TIMESTAMP
+            """;
+        jdbcTemplate.update(sql,
+            journal.getJournalNumber(),
+            journal.getJournalDate(),
+            journal.getDebitAccount(),
+            journal.getDebitAmount(),
+            journal.getCreditAccount(),
+            journal.getCreditAmount(),
+            journal.getDescription(),
+            journal.getSourceType(),
+            journal.getSourceId()
+        );
+    }
+}
+```
+</details>
+### 連携監視ダッシュボード
+```plantuml
+@startuml
+title 連携監視ダッシュボードの構成
+rectangle "監視ダッシュボード" as dashboard {
+    rectangle "リアルタイム監視" as realtime {
+        rectangle "実行中ジョブ" as running
+        rectangle "キュー滞留" as queue_depth
+        rectangle "エラー発生" as errors
+    }
+    rectangle "統計情報" as stats {
+        rectangle "日次処理件数" as daily_count
+        rectangle "成功率推移" as success_rate
+        rectangle "平均処理時間" as avg_time
+    }
+    rectangle "アラート" as alerts {
+        rectangle "エラー閾値超過" as error_alert
+        rectangle "遅延アラート" as delay_alert
+        rectangle "滞留アラート" as backlog_alert
+    }
+}
+database "連携履歴DB" as history_db
+queue "メッセージキュー" as mq
+history_db --> stats : 集計
+mq --> queue_depth : 監視
+history_db --> errors : エラー検出
+alerts --> "通知サービス" : Slack/Email
+@enduml
+```
+<details>
+<summary>SQL 定義 - 監視用ビュー</summary>
+```sql
+-- 日次連携サマリービュー
+CREATE VIEW v_日次連携サマリー AS
+SELECT
+    DATE(e.開始日時) AS 実行日,
+    j.ジョブ名,
+    COUNT(*) AS 実行回数,
+    SUM(CASE WHEN e.ステータス = 'SUCCESS' THEN 1 ELSE 0 END) AS 成功回数,
+    SUM(CASE WHEN e.ステータス = 'FAILED' THEN 1 ELSE 0 END) AS 失敗回数,
+    SUM(e.抽出件数) AS 総抽出件数,
+    SUM(e.成功件数) AS 総成功件数,
+    SUM(e.エラー件数) AS 総エラー件数,
+    ROUND(
+        SUM(e.成功件数)::NUMERIC / NULLIF(SUM(e.抽出件数), 0) * 100, 2
+    ) AS 成功率,
+    AVG(EXTRACT(EPOCH FROM (e.終了日時 - e.開始日時))) AS 平均処理時間_秒
+FROM 連携実行履歴 e
+JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
+WHERE e.開始日時 >= CURRENT_DATE - INTERVAL '30 days'
+GROUP BY DATE(e.開始日時), j.ジョブ名
+ORDER BY 実行日 DESC, j.ジョブ名;
+-- リアルタイム監視ビュー
+CREATE VIEW v_リアルタイム監視 AS
+SELECT
+    j.ジョブ名,
+    e.実行ID,
+    e.ステータス,
+    e.開始日時,
+    EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - e.開始日時)) AS 経過時間_秒,
+    e.抽出件数,
+    e.成功件数,
+    e.エラー件数,
+    ROUND(
+        e.成功件数::NUMERIC / NULLIF(e.抽出件数, 0) * 100, 2
+    ) AS 進捗率
+FROM 連携実行履歴 e
+JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
+WHERE e.ステータス = 'RUNNING'
+ORDER BY e.開始日時;
+-- エラー傾向分析ビュー
+CREATE VIEW v_エラー傾向 AS
+SELECT
+    j.ジョブ名,
+    ed.エラー種別,
+    COUNT(*) AS 発生件数,
+    MIN(ed.発生日時) AS 初回発生,
+    MAX(ed.発生日時) AS 最終発生
+FROM 連携エラー詳細 ed
+JOIN 連携対象データ d ON ed.データID = d.データID
+JOIN 連携実行履歴 e ON d.実行ID = e.実行ID
+JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
+WHERE ed.発生日時 >= CURRENT_DATE - INTERVAL '7 days'
+GROUP BY j.ジョブ名, ed.エラー種別
+ORDER BY 発生件数 DESC;
+-- アラート条件チェック関数
+CREATE OR REPLACE FUNCTION fn_連携アラートチェック()
+RETURNS TABLE (
+    アラート種別 VARCHAR,
+    ジョブ名 VARCHAR,
+    メッセージ TEXT,
+    重要度 VARCHAR
+) AS $$
+BEGIN
+    -- エラー率アラート
+    RETURN QUERY
+    SELECT
+        'エラー率超過'::VARCHAR,
+        j.ジョブ名,
+        FORMAT('エラー率 %.1f%% (閾値: 10%%)',
+            e.エラー件数::NUMERIC / e.抽出件数 * 100),
+        'HIGH'::VARCHAR
+    FROM 連携実行履歴 e
+    JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
+    WHERE e.ステータス IN ('PARTIAL', 'FAILED')
+    AND e.開始日時 >= CURRENT_TIMESTAMP - INTERVAL '1 hour'
+    AND e.抽出件数 > 0
+    AND e.エラー件数::NUMERIC / e.抽出件数 > 0.1;
+    -- 長時間実行アラート
+    RETURN QUERY
+    SELECT
+        '長時間実行'::VARCHAR,
+        j.ジョブ名,
+        FORMAT('実行時間 %s 分 (閾値: 30分)',
+            EXTRACT(EPOCH FROM (CURRENT_TIMESTAMP - e.開始日時)) / 60),
+        'MEDIUM'::VARCHAR
+    FROM 連携実行履歴 e
+    JOIN 連携ジョブ j ON e.ジョブID = j.ジョブID
+    WHERE e.ステータス = 'RUNNING'
+    AND e.開始日時 < CURRENT_TIMESTAMP - INTERVAL '30 minutes';
+    -- 未実行アラート
+    RETURN QUERY
+    SELECT
+        'スケジュール遅延'::VARCHAR,
+        j.ジョブ名,
+        FORMAT('最終実行: %s',
+            COALESCE(MAX(e.開始日時)::TEXT, '実行履歴なし')),
+        'MEDIUM'::VARCHAR
+    FROM 連携ジョブ j
+    LEFT JOIN 連携実行履歴 e ON j.ジョブID = e.ジョブID
+    WHERE j.有効フラグ = TRUE
+    GROUP BY j.ジョブID, j.ジョブ名
+    HAVING MAX(e.開始日時) < CURRENT_TIMESTAMP - INTERVAL '1 day'
+        OR MAX(e.開始日時) IS NULL;
+END;
+$$ LANGUAGE plpgsql;
+```
+</details>
+---
+## 39.4 まとめ
+本章では、データ連携の具体的な実装パターンについて解説しました。
+### 学んだこと
+1. **バッチ連携**
+   - ファイル連携（CSV / XML / JSON）の設計と実装
+   - ETL 処理のパターン（Extract-Transform-Load）
+   - 差分抽出と全件抽出の使い分け
+2. **リアルタイム連携**
+   - Change Data Capture（CDC）による変更検知
+   - データベーストリガーの活用
+   - メッセージキューによる非同期連携
+3. **連携テーブルの設計**
+   - 連携ステータス管理の重要性
+   - エラーハンドリングとリトライ戦略
+   - 冪等性の確保方法
+### 連携パターンの選択指針
+| 要件 | バッチ連携 | リアルタイム連携 |
+|-----|----------|----------------|
+| データ量 | 大量 | 少〜中量 |
+| 即時性 | 不要 | 必要 |
+| 複雑な変換 | 適している | 向かない |
+| システム負荷 | 集中（定期実行） | 分散（常時） |
+| 障害復旧 | 容易 | やや複雑 |
+| 実装コスト | 低 | 中〜高 |
+### 信頼性確保のチェックリスト
+- [ ] 冪等性が確保されているか
+- [ ] リトライ機構が実装されているか
+- [ ] Dead Letter Queue が設定されているか
+- [ ] 監視・アラートが設定されているか
+- [ ] エラー発生時の通知が設定されているか
+- [ ] 手動リカバリ手順が文書化されているか
+### Part 5 の総括
+第5部「エンタープライズインテグレーション」では、基幹業務システム間の統合について体系的に学びました。
+- **第33章**：システム統合の概要と境界づけられたコンテキスト
+- **第34章**：メッセージングパターン（EIP）
+- **第35章**：システム間連携パターン（販売・財務・生産）
+- **第36章**：マスタデータ管理（MDM）
+- **第37章**：イベント駆動アーキテクチャ
+- **第38章**：API 設計とサービス連携
+- **第39章**：データ連携の実装パターン
+これらの知識を活用することで、疎結合で保守性の高い基幹業務システムの統合を実現できます。