【Oracle】SQL*Loader（sqlldr）完全ガイド｜コントロールファイル・APPEND/REPLACE・ダイレクトパスロード・BADファイル・エラー対処まで解説

# 基本構文
sqlldr userid=ユーザー名/パスワード@接続文字列 control=コントロールファイル

# 例: ローカル接続
sqlldr userid=scott/tiger control=load_emp.ctl

# 例: TNS 接続文字列指定
sqlldr userid=scott/tiger@ORCL control=load_emp.ctl

# 主要オプション一覧
sqlldr userid=scott/tiger@ORCL \
  control=load_emp.ctl   \   # コントロールファイル（必須）
  log=load_emp.log       \   # ログファイル（デフォルト: control名.log）
  bad=load_emp.bad       \   # BADファイル（ロード失敗行の出力先）
  discard=load_emp.dsc   \   # DISCARDファイル（WHEN句で除外された行の出力先）
  errors=100             \   # 許容エラー件数（超えると中断、デフォルト: 50）
  skip=1                 \   # 先頭から指定行をスキップ（ヘッダー行の読み飛ばし）
  rows=10000             \   # ダイレクトパス時のコミット間隔（行数）
  direct=true                # ダイレクトパスロードで高速化

-- load_emp.ctl
LOAD DATA
INFILE 'employees.csv'       -- 読み込むデータファイルのパス
APPEND                       -- ロードモード（後述）
INTO TABLE employees         -- ロード先テーブル
FIELDS TERMINATED BY ','     -- 区切り文字: カンマ
OPTIONALLY ENCLOSED BY '"'   -- 囲み文字: ダブルクォート（省略可能）
TRAILING NULLCOLS             -- 末尾の列がない場合は NULL として扱う
(
    employee_id,             -- 列名（テーブルの列と対応）
    first_name,
    last_name,
    email,
    hire_date    DATE "YYYY/MM/DD",   -- 日付フォーマットを指定
    salary,
    department_id
)

1001,田中,太郎,tanaka@example.com,2020/04/01,350000,10
1002,佐藤,花子,sato@example.com,2021/07/15,300000,20
1003,鈴木,一郎,suzuki@example.com,2022/01/10,280000,10

# ロード実行
sqlldr userid=scott/tiger control=load_emp.ctl log=load_emp.log skip=1

# ログファイルで結果確認
cat load_emp.log
# → "3 Rows successfully loaded." など結果が記載される
# → エラーがあれば "Row 2: Rejected" などの詳細が記録される

-- タブ区切りの場合
FIELDS TERMINATED BY X'09'     -- タブ文字（16進数 09）
FIELDS TERMINATED BY '\t'      -- または \t（バージョンにより対応）

-- パイプ区切りの場合
FIELDS TERMINATED BY '|'

-- 固定長ファイルの場合（POSITION で列の開始・終了バイトを指定）
LOAD DATA
INFILE 'employees_fixed.dat'
APPEND
INTO TABLE employees
(
    employee_id   POSITION(1:6)   INTEGER EXTERNAL,
    first_name    POSITION(7:26)  CHAR,
    last_name     POSITION(27:46) CHAR,
    hire_date     POSITION(47:56) DATE "YYYY/MM/DD",
    salary        POSITION(57:65) DECIMAL EXTERNAL
)

-- 複数ファイルを一度にロードする
LOAD DATA
INFILE 'data_jan.csv'
INFILE 'data_feb.csv'
INFILE 'data_mar.csv'
APPEND
INTO TABLE monthly_sales
FIELDS TERMINATED BY ','
( year, month, amount )

LOAD DATA
INFILE 'orders.csv'
APPEND
INTO TABLE orders
FIELDS TERMINATED BY ','
TRAILING NULLCOLS
(
    order_id,
    customer_id,
    -- NULLIF: 値が空文字列または特定値の場合に NULL として扱う
    amount        NULLIF amount=BLANKS,       -- 空白なら NULL
    discount      NULLIF discount='0',         -- '0' なら NULL

    -- 定数値を埋め込む（ファイルに列がない場合）
    created_date  SYSDATE,                     -- 常に現在日時（SYSDATE は SQL*Loader のキーワード）
    data_source   CONSTANT 'CSV_IMPORT',      -- 固定文字列（シングルクォート・CONSTANT キーワード）

    -- ファイルの列を読み飛ばす（FILLER: ダミー列）
    dummy_col     FILLER,                      -- この列のデータは捨てる

    -- 文字変換: SQL 関数は使えないが DECODE 式は使える
    status_code   "DECODE(:status_code,'1','ACTIVE','0','INACTIVE','UNKNOWN')"
)

-- WHEN 句: 条件に一致する行だけロードする（複数テーブルへの振り分けも可能）
LOAD DATA
INFILE 'employees_all.csv'
APPEND
INTO TABLE employees_sales
WHEN department_id = '10'      -- 部門コード 10 のみロード
FIELDS TERMINATED BY ','
( employee_id, first_name, last_name, department_id, salary )

INTO TABLE employees_hr
WHEN department_id = '20'      -- 部門コード 20 のみ別テーブルへ
FIELDS TERMINATED BY ','
( employee_id, first_name, last_name, department_id, salary )

# DIRECT=TRUE で高速ロード
# NOLOGGING と組み合わせると更に高速化（REDO 最小化）
sqlldr userid=scott/tiger@ORCL \
  control=load_orders.ctl \
  direct=true \
  rows=50000 \
  log=load_orders.log

# NOLOGGING の設定（事前にテーブルを NOLOGGING に変更）
# ALTER TABLE orders NOLOGGING;
# ダイレクトパス後に LOGGING に戻す場合:
# ALTER TABLE orders LOGGING;
# ※ NOLOGGING 設定中にメディアリカバリが必要になると、そのデータは復旧できない
# → 本番では RMAN バックアップの直後に行うか、データ再ロードで対応できる場合のみ使用

# 初回ロード: 一部の行が型変換エラーでBADファイルに書き出される
sqlldr userid=scott/tiger control=load_emp.ctl log=load_emp.log bad=load_emp.bad

# ログファイルで結果確認
grep -E "Rows (successfully|not loaded)" load_emp.log
# → "100 Rows successfully loaded."
# → "3 Rows not loaded due to data errors."

# BADファイルの中身を確認（失敗した行のデータがそのまま残っている）
cat load_emp.bad

# BADファイルを修正して再ロード（APPEND モードで追加）
# vi load_emp.bad  # 日付フォーマット等を修正
sqlldr userid=scott/tiger control=load_emp.ctl log=reload.log bad=reload.bad

# データをロードせずにコントロールファイルの検証のみ行う
# LOAD=0 で行数を 0 に指定すると実際のロードをスキップできる
sqlldr userid=scott/tiger control=load_emp.ctl rows=0 log=validate.log

# ログで "Elapsed time was:" と "0 Rows loaded" が出れば構文は正常
cat validate.log