AddColumns レポートと警告への対応
パラメータ -r を指定して AddColumns ツールを実行すると、指定したタイプのすべての列情報を含むレポートが返されます。このレポートでは、指定したタイプに対するデータベース、ローカル属性列スキーマファイル (AddColumnsSchema.xml)、イントロスペクションファイル、および指定したタイプのクラスファイルが比較され、以下が報告されます。
• 各列データタイプの列数:
◦ データタイプの列の総数。
◦ データタイプに予約済みの列数 (PTC によって最初から提供されている属性用に予約済みの列の数)。
◦ データタイプに割り当てられていない列の数 (まだ使用されていない列の数)。
• 列の順序。
• 文字列データタイプの列のサイズ。
• そのタイプに使用されている列の総数。これには、レポートにリストされているローカル属性列と、そのタイプのその他すべての列が含まれます。
• 列の最大許容数に達する前に、列データタイプに基づいて、そのタイプに追加可能な列の数。
データベース、ローカル属性列スキーマファイル、イントロスペクションファイル、クラスファイル、wt.properties ファイル (文字列列サイズのみ) の間でこの情報に不一致がある場合、情報が矛盾していることがレポートで警告され、各ソースで見つかった詳しい情報が返ります。
すべての情報が一致している場合のタイプのレポートの例を次に示します。
Total String column count = 20
Reserved String column count = 0
Unallocated String column count = 11
Total Long column count = 21
Reserved Long column count = 0
Unallocated Long column count = 19
Total Double column count = 20
Reserved Double column count = 0
Unallocated Double column count = 20
Total Boolean column count = 20
Reserved Boolean column count = 0
Unallocated Boolean column count = 20
Total Timestamp column count = 20
Reserved Timestamp column count = 0
Unallocated Timestamp column count = 20
Total ObjectReference column count = 3
Reserved ObjectReference column count = 0
Unallocated ObjectReference column count = 3
Total VersionReference column count = 3
Reserved VersionReference column count = 0
Unallocated VersionReference column count = 2
Total InlineBLOB column count = 20
Reserved InlineBLOB column count = 0
Unallocated InlineBLOB column count = 20
All Column Counts Match.
Column Order Matches.
String column size: 500 Bytes (Database)
String column size: 500 Characters (AddColumnsSchema.xml)
String column size: 500 Characters (wt.properties)
String column size: 500 Characters (Introspection)
String column size: 500 Characters (Class)
This type has a total of 159 database columns.
You may continue to add an additional 96 columns of String, Long, Double, Boolean
or an additional 48 columns of InlineBLOB
or an additional 30 columns of ObjectReference, VersionReference
before the maximum allowed database columns is reached.
あるデータタイプの列の総数が一致していない場合のレポートの一部の例を次に示します。
Total Long column count = 20 (Database) **WARNING
Total Long column count = 20 (AddColumnsSchema.xml) **WARNING
Total Long column count = 21 (Introspection) **WARNING
Total Long column count = 21 (Class) **WARNING
Reserved Long column count = 0
Unallocated Long column count = 11
パラメータ -a を指定してこのツールを実行した後で、パラメータ -u を指定してこのコマンドを実行しなかった場合、クラスファイルとイントロスペクションファイルの列数がデータベースと AddColumnsSchema.xml ファイルよりも多いことがレポートで報告されます。
• 追加の列を保持する場合、パラメータ -u を指定して AddColumns ツールを実行します。
• 追加の列を保持しない場合、パラメータ -syncFromDB を指定して AddColumns ツールを実行します。
|
|
データベースが更新された後で、AddColumns ツールをプレーンモードで実行するか、パラメータ -u を指定して AddColumns ツールを実行することで、データベースが完全に更新されます。列がいったんデータベースに追加された後で列を除去する方法はありません。
|
レポートで列の順序の不一致が警告された場合、パラメータ -syncFromDB を指定して AddColumns ツールを実行してから、試みた変更を再び適用します。列の順序の不一致に関する警告は次のように表示されます。
The column at index 1 does not match:
IDA3B2TYPEINFOWTPART IDA3B2 (Database) **WARNING
VersionReference (AddColumnsSchema.xml) **WARNING
ptc_ref_2.key.id idA3B2 (Introspection) **WARNING
ptc_ref_2 idA3B2 (Class) **WARNING
あるタイプの文字列データタイプの列サイズとしてプロパティ com.ptc.core.lwc.string.ColumnSizes をより大きい値に設定したが、パラメータ -stringSize を指定して AddColumns ツールを実行することで、列を追加して既存の文字列データタイプの列サイズをまだ更新していない場合、レポートには次のような警告が表示されます。
String column size: 500 Bytes (Database)
String column size: 500 Characters (AddColumnsSchema.xml)
String column size: 600 Characters (wt.properties)
String column size: 500 Characters(Introspection)
String column size: 500 Characters (Class)
WARNING: The String column size does not match in all sources. Investigate the mismatch and fix as needed.
パラメータ -stringSize を指定して AddColumns ツールを実行することで、そのタイプに列を追加し、そのタイプの既存の文字列データタイプの列サイズを更新すると、文字列の列のサイズの値が一致します。
