日日是Oracle APEX: 簡単なファイル管理アプリケーションの作成(4) - ファイルをオブジェクト・ストレージに保存する

2022年12月7日水曜日

簡単なファイル管理アプリケーションの作成(4) - ファイルをオブジェクト・ストレージに保存する

Always FreeのAutonomous Databaseのストレージは20GBなので、ちょっとファイルをアップロードすると容量が足りなくなります。ファイルを保存するために、高速なストレージを消費するのも勿体無い話ですし、それだけのために有料インスタンスにアップグレードするのも勿体無い気がします。

とういうことで、ファイルの実体をオブジェクト・ストレージに保存するようにAPEXアプリケーションを改変してみます。

アップロードされたファイルは、オブジェクト・ストレージに以下のように保存されます。

準備

今までの記事に従って、ファイル管理アプリケーションが作成済みであることを前提としています。今回はオブジェクト・ストレージを使うため、以下の記事の記載に従って準備します。

ユーザー、グループ、ポリシーなどの作成を行います。

APEXからOCIオブジェクト・ストレージを操作する(1) - APIユーザーの作成

バケットはapex_file_storageを使います。

APEXからOCIオブジェクト・ストレージを操作する(2) - バケットの作成

PL/SQL SDKを使用するため、以下の記事にあるクリデンシャルの作成とワークスペース・スキーマへの権限の付与も実施します。

APEXからオブジェクト・ストレージをPL/SQL SDKで操作する(1) - 準備

作成されるクリデンシャルはMY_OCI_CREDになります。

表SFM_CONTENTSの変更

オブジェクト・ストレージにファイルを保存すると、全文検索索引の再作成ができなくなります。そのため、索引作成のソースとなる文字列を表SFM_CONTENTSに保存しておきます。

全文検索索引のソースを保存する列TEXT_INDEX_SOURCEを表SFM_CONTENTSに追加します。

alter table sfm_contents add (text_index_source blob);

また、変更回数を記録する列VERSIONも追加します。

alter table sfm_contents add (version number default 0 not null);

クイックSQLのモデルは以下のように変わります。

# prefix: sfm
# pk: guid
contents
    title vc80 /nn
    abstract vc800
    content file
    text_index_source blob
    version num /default 0 /nn

ファイルから全文検索索引のソースとなる文字列を抽出するプロシージャSFM_CONTENTS_DOCは以下に変更します。

ファイルがデータベースにアップロードされたときに、ファイルから文字列を抽出し列TEXT_INDEX_SOURCEに保存していることが前提です。索引を作成する際にファイルのデータを必要としないため、ファイルがオブジェクト・ストレージにあっても全文検索索引を作ることができます。

全文検索索引のソースは文字データなので圧縮することで容量を節約していますが、表自体が圧縮されている場合は不要かもしれません。そうすると列TEXT_INDEX_SOURCEはCLOBで定義できますが、今回は手が込んでいる方がサンプルとして使い勝手が良いだろうと判断し、圧縮して保存するようにしています。

表SFM_CONTENTSに列が追加されたため、ページ番号３のフォームSfm Contentでページ・アイテムの同期化を実行すると、ページ・アイテムP3_TEXT_INDEX_SOURCEとP3_VERSIONが追加されます。このページ・アイテムにユーザーがデータを入力することは無いため、ビルド・オプションでコメント・アウトしておきます。

オブジェクト・ストレージのアクセス情報の設定

ファイルを保存するオブジェクト・ストレージに関する情報を、アプリケーション定義の置換文字列として設定します。

G_REGION - リージョン（今回の例ではus-ashburn-1）

G_NAMESPACE - オブジェクト・ストレージのネームスペース

G_BUCKET - バケット名（今回の例ではapex_file_storage）

G_CREDENTIAL - クリデンシャル（今回の例ではMY_OCI_CRED）

置換文字列の設定では前後の空白はトリムされないため、不要な空白が入っていないか注意が必要です。

プロシージャとパッケージの作成

列TEXT_INDEX_SOURCEにデータを保存するプロシージャretrieve_text_index_sourceを作成します。このデータが全文検索索引の作成時に使用されます。

SQLワークショップのSQLコマンドに貼り付けて実行します。

次に、オブジェクト・ストレージにファイルをアップロードするプロシージャupload_fileとダウンロードするプロシージャdownload_file、および削除するプロシージャdelete_fileを実装したパッケージsfm_file_utilを作成します。

コードは以下になります。

SQLワークショップのSQLスクリプトとして実行します。

確認画面が開くので、即時実行をクリックします。

パッケージとパッケージ本体が作成されたことを確認します。

アップロード処理の変更

ページ・デザイナにてページ番号３のフォームのページを開きます。

プロシージャretrieve_text_index_sourceを呼び出すプロセスを作成します。

プロセスの作成を実行し、新規に作成されたプロセスをプロセス・フォームSfm Contentの下に配置します。

識別の名前を文字列の抽出とし、タイプにAPIの呼び出しを選択します。設定のタイプとしてPL/SQL Procedure or Function、所有者をParsing Schemaとし、プロシージャまたはファンクションとしてRETRIEVE_TEXT_INDEX_SOURCEを選択します。

サーバー側の条件のタイプとしてリクエストは値に含まれるを選択し、値にCREATE SAVEを入力します。ボタン作成および変更の適用を押したとき（ボタン削除では実行しない）に、プロセス文字列の抽出を実行します。