| name | dotnet-access-to-oracle-migration |
| description | こんなときに使う: Migrate Access SQL to Oracle, generate .NET C# code. Use when converting Access queries to Oracle.
|
| license | MIT |
| metadata | {"author":"RyoMurakami1983","tags":["dotnet","oracle","access","csharp","database-migration"],"invocable":false} |
Access SQLからOracle移行
AccessデータベースクエリをOracleに移行し、.NET（C#）IOracle実装クラスを生成するためのエンドツーエンドワークフロー。TNS解決、VIEW/SYNONYM検出、SQL変換、レコード数検証をカバー。
こんなときに使う
以下の場合にこのスキルを使用してください：
- .NETアプリケーション向けにAccessデータベースクエリをOracleに移行する場合
- Access SQLをOracle互換SQLに変換する場合（適切なクォート処理付き）
- 検証済みOracle SQLからC# IOracle実装クラスを生成する場合
- Accessリンクテーブルが隠すVIEW/SYNONYM構造を検出する場合
- tnspingとEZ Connect形式でOracle接続を検証する場合
- AccessとOracle間のデータ整合性をNear Equal検証で確認する場合
Related Skills
skill — 公開前のスキル検証・改善skill-writing-guide — スキル作成のベストプラクティス
Core Principles
- Error-Driven Approach — ORA-*エラーからDSN・認証・スキーマの問題を学ぶ（基礎と型）
- Structural Awareness — TABLEと決めつけずVIEW/SYNONYMを検出する（ニュートラル）
- Access Naming Translation —
. → _変換を逆転してOracle形式に戻す（基礎と型）
- Progressive Validation — 接続 → 検出 → 検証 → 変換 → 生成（継続は力）
- Near Equal Tolerance — タイミング/データ更新による±5件差を許容（成長の複利）
Dependencies
- .NET 6.0+ + Oracle.ManagedDataAccess.Core（NuGet）
- Oracle Instant Client（
tnspingコマンド用）
- Accessデータベース（リンクテーブル付き）
Workflow: Access SQLからOracle移行
Step 1 — 情報収集
Oracle接続を試行する前に、必要な情報をすべて事前に収集する。
ユーザーから収集する項目：
- Access SQL: 完全なクエリ（Access構文）
- レコード数: Accessからの件数
- TNS/DSN名: 例：PROD_DSN
- Oracle認証情報: ユーザー名とパスワード
Why: 事前に情報を集めないと、複数回の往復が発生する（TNS名違い → 再確認、認証情報不足 → 再確認）。一括収集により1パスで移行完了できる。
Values: 基礎と型 / 継続は力
Step 2 — tnspingでTNS名を解決
tnspingを実行して、TNS/DSN名をOracle.ManagedDataAccess.Coreが必要とするEZ Connect形式に変換する。
# ✅ 正解 — TNS名をEZ Connect形式に解決
tnsping PROD_DSN
出力から抽出:
- HOST:
192.0.2.10, PORT: 1521, SERVICE_NAME: prod_service
- EZ Connect:
192.0.2.10:1521/prod_service
Why: Oracle.ManagedDataAccess.CoreはEZ Connect形式を要求する。形式を推測するとORA-50201エラーが発生し、デバッグ時間を浪費する。
Values: 基礎と型 / ニュートラル
Step 3 — 接続テストとエラー処理
ORA-*エラーコードを学習シグナルとして活用し、DSN・認証・ネットワークの問題を修正する。
# ✅ 正解 — エラーハンドリング付き接続テスト
Add-Type -Path "Oracle.ManagedDataAccess.dll"
$conn = New-Object Oracle.ManagedDataAccess.Client.OracleConnection
$conn.ConnectionString = "User Id=SCHEMA_A;Password=your_password;Data Source=192.0.2.10:1521/prod_service"
try {
$conn.Open()
Write-Host "✓ 接続成功"
$conn.Close()
} catch {
Write-Host "Error: $($_.Exception.Message)"
}
| Error Code | Cause | Solution |
|---|
| ORA-50201 | DSN形式不正 | tnspingでEZ Connect取得 |
| ORA-01017 | 認証情報誤り | ユーザー名/パスワード再確認 |
| ORA-12154/12545 | TNS/ネットワーク問題 | EZ Connectまたはファイアウォール確認 |
Values: 基礎と型 / 成長の複利
Step 4 — Accessテーブル名の変換
Accessの . → _ 変換を逆転：SCHEMA_A_production_info → SCHEMA_A."production_info"
var parts = "SCHEMA_A_production_info".Split('_', 2);
string oracleFormat = $"{parts[0]}.\"{parts[1]}\"";
Why: Accessはリンクテーブル名の.を暗黙的に_に変換する。これを逆転しなければ、すべてのOracleクエリが「テーブルが見つからない」エラーになる。
Values: 基礎と型
Step 5 — VIEW/SYNONYM構造の検出
TABLEと決めつけずオブジェクトタイプを確認する。Accessはすべてのリンクオブジェクトを「テーブル」として表示し、Oracleの実際の構造を隠す。
SELECT owner, object_name, object_type
FROM all_objects
WHERE object_name IN ('production_info', 'detasheet_info')
AND owner IN ('SCHEMA_A', 'SCHEMA_B', 'PUBLIC')
ORDER BY owner, object_name;
Why: このステップを飛ばすと、カラムクエリとSQL変換で連鎖的なエラーが発生する。
Values: ニュートラル / 基礎と型
Step 6 — カラム存在検証
実際のテーブル所有者（SYNONYM所有者ではない）でall_tab_columnsを照会し、正確なカラム名を取得する。
SELECT column_id, column_name, data_type, data_length
FROM all_tab_columns
WHERE table_name = 'production_info'
AND owner = 'SCHEMA_B'
ORDER BY column_id;
Why: Oracleのカラム名は大文字小文字を区別する。カラムの欠落やスペルミスはサイレントなデータ損失やクエリエラーの原因になる。
Values: 基礎と型 / 継続は力
Step 7 — SQL構文変換（3ルール）
3つのルールを一貫して適用し、Access SQLをOracle SQLに変換する。
Rule 1: テーブル名 — SCHEMA_A_production_info → SCHEMA_A."production_info"
Rule 2: カラム名 — ship_date → "ship_date"
Rule 3: 文字列リテラル — "202601" → '202601'
SELECT SCHEMA_A_production_info.ship_date
FROM SCHEMA_A_production_info
WHERE SCHEMA_A_production_info.ship_date >= "202601"
SELECT s."ship_date"
FROM SCHEMA_A."production_info" s
WHERE s."ship_date" >= '202601'
Why: AccessとOracleは逆のクォート規則を使用する。3ルールを一貫して適用することで、最も一般的なSQL変換エラーを防止できる。
Values: 基礎と型 / ニュートラル
Step 8 — Near Equal検証
変換したSQLをOracleで実行し、レコード数をAccess件数と比較する。±5件差を許容。
# ✅ 正解 — Oracleレコード数を取得して比較
$cmd = $conn.CreateCommand()
$cmd.CommandText = 'SELECT COUNT(*) FROM SCHEMA_A."production_info" s WHERE s."ship_date" >= ''202601'''
$oracleCount = [int]$cmd.ExecuteScalar()
$accessCount = 178
$diff = [Math]::Abs($oracleCount - $accessCount)
if ($diff -le 5) {
Write-Host "✓ Near Equal: Access=$accessCount, Oracle=$oracleCount (diff=$diff)"
} else {
Write-Host "⚠ Difference too large (diff=$diff)"
}
Why: 正確な件数一致は稀である（AccessとOracleは異なるタイミングでクエリを実行するため）。Near Equalは同一スナップショットを要求せずに正確性を検証する。
Values: 成長の複利 / 継続は力
Step 9 — C# IOracle実装の生成
検証済みOracle SQLを使用して、IOracleインターフェースを実装するC#クラスを作成する。
using System;
namespace OracleApp
{
internal class SampleDataExtractor : IOracle
{
string IOracle.User => Environment.GetEnvironmentVariable("ORA_USER") ?? "SCHEMA_A";
string IOracle.Password => Environment.GetEnvironmentVariable("ORA_PW") ?? "your_password";
string IOracle.Dsn => Environment.GetEnvironmentVariable("ORA_DSN") ?? "192.0.2.10:1521/prod_service";
public string Sql => @"
SELECT
s.""ship_date"",
s.""prod_number""
FROM SCHEMA_A.""production_info"" s
WHERE s.""ship_date"" >= '202601'";
}
}
C#文字列エスケープルール: Oracle "ship_date" → C# @""ship_date""（引用符を二重にする！）
Why: コード生成は最終ステップ。SQL検証前にコードを生成すると、SQLレベルの失敗より追跡が困難なランタイムエラーが発生する。
Values: 継続は力 / 成長の複利
Good Practices
1. 接続解決にはtnspingを必ず使用
What: 接続前にtnspingを実行してTNS/DSN名をEZ Connect形式に解決する。
Why: ORA-50201エラーを排除し、正確なHOST/PORT/SERVICE_NAMEを取得できる。
Values: 基礎と型（再現可能な型）
2. クエリ前にオブジェクトタイプを検出
What: カラムやデータをクエリする前にall_objectsとall_synonymsを確認する。
Why: AccessはOracleのVIEW/SYNONYM構造を隠す。TABLEと決めつけると連鎖的なエラーが発生する。
Values: ニュートラル（偏らない検証）/ 基礎と型
3. SQL変換前にカラムを検証
What: SQL変換前にすべてのAccessカラムがOracleに正確なスペルで存在することを確認する。
Why: 大文字小文字区別のカラム名はサイレントなデータ損失を引き起こす。早期検証が遅い失敗を防ぐ。
Values: 継続は力（段階的検証）
Common Pitfalls
1. ODBC DSNを直接使用
Problem: Oracle.ManagedDataAccess.CoreにData Source=PROD_DSNを渡す。
var connStr = "User Id=SCHEMA_A;Password=your_password;Data Source=PROD_DSN";
Solution: tnspingでEZ Connect形式を取得する。
var connStr = "User Id=SCHEMA_A;Password=your_password;Data Source=192.0.2.10:1521/prod_service";
2. タイプ検出せずテーブルと決めつけ
Problem: 実際のテーブルがSCHEMA_Bにあるのにowner = 'SCHEMA_A'でall_tab_columnsをクエリ。
Solution: まずall_objectsを確認し、次にall_synonymsで実際のテーブル所有者を取得。
3. C#でダブルクォートのエスケープ忘れ
Problem: Oracle SQLをC#にコピー＆ペーストする際に引用符を二重にしない。
Solution: C# @""文字列内のすべての"を二重にする: s."ship_date" → s.""ship_date""
Anti-Patterns
tnspingを省略してEZ Connectを推測
What: Data Source=PROD_DSNがData Source=someserver:1521/PROD_DSNを意味すると仮定する。
Why It's Wrong: TNS名は予測可能なパターンに従わない。ホスト名はIP、DNS名、エイリアスの場合がある。
Better Approach: 常にtnspingを実行して正確なHOST/PORT/SERVICE_NAMEを取得する。
Quick Reference
移行チェックリスト
変換チートシート
| Access | Oracle | C# @"" 文字列 |
|---|
SCHEMA_A_production_info | SCHEMA_A."production_info" | SCHEMA_A.""production_info"" |
ship_date | "ship_date" | ""ship_date"" |
"202601" | '202601' | '202601' |
Resources
Changelog
Version 2.0.0 (2026-02-15)
- Breaking: パターン形式からワークフロー形式に変換
- Core PrinciplesとすべてのステップにValues統合を追加
- Good Practices、Common Pitfalls、Anti-Patternsセクションを追加
- 依存関係セクションと移行チェックリストを追加
Version 1.0.0 (2026-02-12)
- 初期リリース（パターン形式）
- 完全な移行ワークフローをカバーする9パターン
