Oracle APEXからOCI Object Storageへファイルをアップロード・ダウンロード・削除する実装例

はじめに

Oracle APEXでファイル管理機能を実装する場合、ファイルをBLOBとしてデータベースに保存する方法が一般的です。

しかし、運用が進むにつれて以下のような課題が発生します。

データベース容量が急激に増加する
バックアップ時間が長くなる
大容量ファイルの管理が難しい
ストレージコストが増加する

そこで今回は、OCI Object Storage を利用し、Oracle APEXからファイルを管理する方法を紹介します。

本記事では以下の機能を実装します。

ファイルアップロード
ファイルダウンロード
ファイル削除

システム構成

Oracle APEX
    ↓
PL/SQL
    ↓
OCI REST API
    ↓
OCI Object Storage

実際のファイルはObject Storageへ保存し、データベースにはファイルパスやメタ情報のみを保存します。

ファイルアップロード

処理の流れ

File Browse
    ↓
APEX_APPLICATION_TEMP_FILES
    ↓
BLOB取得
    ↓
OCIへPUT

サンプルコード

DECLARE
    l_blob         BLOB;
    l_file_name    VARCHAR2(500);
    l_object_name  VARCHAR2(1000);
BEGIN

    SELECT blob_content,
           filename
      INTO l_blob,
           l_file_name
      FROM apex_application_temp_files
     WHERE name = :P10_FILE;

    l_object_name :=
        'documents/' ||
        TO_CHAR(SYSDATE,'YYYYMMDDHH24MISS') ||
        '_' ||
        l_file_name;

    apex_web_service.g_request_headers.delete;

    apex_web_service.g_request_headers(1).name :=
        'Content-Type';

    apex_web_service.g_request_headers(1).value :=
        'application/octet-stream';

    apex_web_service.make_rest_request_b(
        p_url =>
            'https://objectstorage.ap-tokyo-1.oraclecloud.com/n/<namespace>/b/<bucket>/o/' ||
            utl_url.escape(l_object_name, TRUE),
        p_http_method => 'PUT',
        p_body_blob => l_blob,
        p_credential_static_id => 'OCI_CREDENTIAL'
    );

END;
/

ファイルダウンロード

Object Storageからファイルを取得し、ブラウザへ返却します。

サンプルコード

DECLARE
    l_blob BLOB;
BEGIN

    l_blob :=
        apex_web_service.make_rest_request_b(
            p_url =>
                'https://objectstorage.ap-tokyo-1.oraclecloud.com/n/<namespace>/b/<bucket>/o/' ||
                utl_url.escape(:P10_FILE_PATH, TRUE),
            p_http_method => 'GET',
            p_credential_static_id => 'OCI_CREDENTIAL'
        );

    owa_util.mime_header(
        'application/octet-stream',
        FALSE
    );

    htp.p(
        'Content-Disposition: attachment; filename="' ||
        :P10_FILE_NAME ||
        '"'
    );

    owa_util.http_header_close;

    wpg_docload.download_file(l_blob);

    apex_application.stop_apex_engine;

END;
/

Interactive Reportへの実装例

レポートにダウンロードアイコンを追加します。

<span class="fa fa-download"></span>

クリック時にApplication Processを呼び出し、ファイルをダウンロードします。

ファイル削除

不要になったファイルはOCI Object Storageから削除できます。

サンプルコード

DECLARE
    l_response CLOB;
BEGIN

    l_response :=
        apex_web_service.make_rest_request(
            p_url =>
                'https://objectstorage.ap-tokyo-1.oraclecloud.com/n/<namespace>/b/<bucket>/o/' ||
                utl_url.escape(:P10_FILE_PATH, TRUE),
            p_http_method => 'DELETE',
            p_credential_static_id => 'OCI_CREDENTIAL'
        );

END;
/

削除成功時はHTTPステータス 204 No Content が返却されます。

APEXでの実装例

Upload

File Browse
    ↓
Uploadボタン
    ↓
OCI Object Storage

Download

Interactive Report
    ↓
Downloadアイコン
    ↓
Application Process

Delete

Interactive Report
    ↓
Deleteアイコン
    ↓
Ajax Callback
    ↓
OCI Object Storage

テーブル設計例

ファイル本体はObject Storageに保存するため、DBにはメタ情報のみを保持します。

CREATE TABLE FILE_MASTER (
    ID              NUMBER GENERATED BY DEFAULT AS IDENTITY,
    FILE_NAME       VARCHAR2(500),
    FILE_PATH       VARCHAR2(1000),
    CREATED_DATE    DATE DEFAULT SYSDATE
);

保存例

FILE_NAME	FILE_PATH
report.pdf	documents/20260622100000_report.pdf

運用上の注意点

ファイル名の重複対策

同じファイル名がアップロードされる可能性があります。

例えば、

report.pdf

が複数回アップロードされる場合、上書きが発生する可能性があります。

推奨例：

20260622103000_report.pdf

または

550e8400-e29b-41d4-a716-446655440000_report.pdf

BLOBをDBへ保存しない

大量ファイルをBLOB保存すると、

テーブルサイズ肥大化
バックアップ時間増加
パフォーマンス低下

につながります。

Object Storageへ保存することで、DB負荷を大幅に削減できます。

IAM権限の設定

APEXからObject Storageへアクセスするため、適切なIAM Policyが必要です。

例：

Allow group ApexUsers to manage objects in compartment MyCompartment

まとめ

OCI Object Storageを利用することで、Oracle APEXのファイル管理機能をシンプルかつスケーラブルに実装できます。

今回紹介した方法により、

Upload（PUT）
Download（GET）
Delete（DELETE）

をすべてPL/SQLだけで実現できます。

ファイルをデータベースへ保存する方式と比較して、容量・性能・保守性の面で大きなメリットがあるため、OCI環境でのAPEX開発ではObject Storageの活用をおすすめします。