データベースを手動で変更するための例外ファイルの使用

このトピックでは、例外ファイルを定義する手順について説明します。組織のDBAが、テーブル、インデックス、ストアドプロシージャ、カラム、その他のオブジェクトなどのオブジェクトをデータベーススキーマに追加した場合は、例外ファイルを使用します。

概要

例外ファイルは、データベーススキーマへの手動追加が原因で発行されたエラーを無視するようにALM Octaneに指示します。これらのエラーは通常、インストールまたはアップグレードプロセスを停止します。

例外ファイルを使用して、追加のテーブル、ビュー、カラム、およびシーケンスのエラーを無視できます。その他の問題については、データベース管理者に相談してください。

注意: スキーマに手動で追加されたオブジェクトのエラーを無視するために例外ファイルを使用すると、データベースユーザースキーマの安定性と有効性が損なわれる可能性があります。

例外ファイルは、ALM Octaneの新規インストール時、アップグレード時、およびスペースの作成時に使用できます。 

トップに戻る

例外ファイルの定義

インストール前、アップグレード前、または新しいスペースを作成する前に、例外ファイルを定義します。

例外ファイルを定義するには:

  1. ALM Octaneインストールディレクトリから両方のmqm_exception.xmlファイルをコピーします。名前を変更できます。

  2. ファイルのMQM_EXCEPTIONS部分を見つけます。

    <MQM_EXCEPTIONS>
    <exceptions>
        <declaration>
            <!--<object pattern="TABLE_1_EXAMPLE" type="missing" />-->
            <!--<object pattern=" TABLE_1_EXAMPLE" type="extra" />-->
        </declaration>
    </exceptions>
</MQM_EXCEPTIONS>

  3. <declaration>を次のいずれかに変更します。必要な数の宣言を追加します。

    • TableMissing

    • ViewMissing

    • ColumnMissing

    • ConstraintMissing

    • IndexMissing

    • PartitionFunctionMissing

    • PartitionSchemeMissing

    • ProcedureMissing

    • SequenceMissing

    • TriggerMissing

  4. オブジェクトパターンごとに、次のいずれかのタイプを指定できます。 

    missing オブジェクトは必要ですが、欠落しています。
    extra このオブジェクトは、ALM Octaneのインストール後、またはアップグレード前に作成されたため、余分です。

  • 追加のテーブルの場合: 

    <TableMissing>
         <object pattern="MY_Table" type="extra"/> 
</TableMissing>

  • 追加のビューについて: 

    <ViewMissing>
         <object pattern="MY_VIEW" type="extra"/> 
</ViewMissing>

  • 追加のカラムの場合: 

    <ColumnMissing>
         <object pattern="MY_COLUMN" type="extra"/> 
</ColumnMissing>

  • 追加のシーケンスの場合: 

    <SequenceMissing>
         <object pattern="MY_SEQUENCE" type="extra"/> 
</SequenceMissing>

トップに戻る

例外ファイルの使用を設定する

このトピックでは、ALM Octaneをインストールするとき、または新しいスペースを作成するときに例外ファイルを使用する方法について説明します。

初回インストール時の例外ファイルの使用

ALM Octaneに新しいスキーマを作成させる代わりに、既存のスキーマ/データベースを使用してALM Octaneをインストールするときに例外ファイルを使用できます。これはFILL_EXISTINGインストールオプションであり、octane.confファイルで設定されます。

  1. インストール中に、構成フォルダー内の/opt/conf/octane.confファイルを構成するときに、エディターを使用して次の2つの設定を追加します。 

    MqmExceptionsSiteAdminPath

    サイトの例外ファイル。

    /opt/tmp/site/mqm_exceptions.xml
    MqmExceptionsSharedSpacePath

    標準設定スペースの例外ファイル。

    /opt/tmp/shared_space/mqm_exceptions.xml

  2. インストールを続行します。

  3. インストール後、ALM Octaneサーバーが起動していて、サイトと標準設定スペースに適切にアクセスできることを確認してください。

アップグレード時の例外ファイルの使用

ALM Octaneをアップグレードするときに例外ファイルを使用できます。

インストール後、例外ファイルがリポジトリフォルダにコピーされます。したがって、アップグレードするときは、構成フォルダー内のファイルではなく、リポジトリフォルダー内の例外ファイルのコピーを変更してください。

  1. アップグレード中に、リポジトリフォルダー内のoctane.confファイルを構成するときに、エディターを使用して次の2つの設定を追加または変更します。 

    サイトの例外ファイル

    /opt/octane/repo/storage/schema/maintenance/exceptions/site_admin/mqm_exception.xml
    新しいスペースの例外ファイル

    /opt/octane/repo/storage/schema/maintenance/exceptions/shared_space/mqm_exception.xml

  2. アップグレードを続行します。

  3. アップグレード後、ALM Octaneサーバーが起動していること、およびサイトと標準設定スペースに適切にアクセスできることを確認してください。

スペースを作成するときの例外ファイルの使用

ALM Octaneは、新しいスペースを追加するときにも例外ファイルを処理します。

インストール後、例外ファイルがリポジトリフォルダにコピーされます。

新しいスペースを追加する前に、構成フォルダー内のファイルではなく、リポジトリフォルダー内の例外ファイルのコピーを変更してください。

  1. エディターを使用して、必要に応じて例外ファイルに例外を追加します。

    サイトの例外ファイル

    /opt/octane/repo/storage/schema/maintenance/exceptions/site_admin/mqm_exception.xml
    新しいスペースの例外ファイル

    /opt/octane/repo/storage/schema/maintenance/exceptions/shared_space/mqm_exception.xml

  2. ALM Octane設定領域で、既存のスキーマを使用してスペースを追加します。詳細については、ALM Octaneヘルプセンターのサイト用のスペースの作成を参照してください。

  3. スペースに適切にアクセスできることを確認してください。

トップに戻る

参照情報: