AddColumns 报告和解决警告
AddColumns 工具和 -r 参数配合运行可返回一份包含指定类型所有列信息的报告。报告中会比较指定类型的数据库、局部属性列架构文件 (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 文件的列计数。
• 若要保留这些附加列，请将 AddColumns 工具与 -u 参数配合运行。
• 若不想保留这些附加列，请运行 AddColumns 工具，配合使用 -syncFromDB 参数。
|
|
若通过在普通模式下运行 AddColumns 工具或配合运行 AddColumns 工具与 -u 参数，以对数据库进行了更新，则数据库即被永久更新。无法再移除已添加到数据库的列。
|
如果报告警告列顺序不匹配，请配合运行 AddColumns 工具和 -syncFromDB 参数，然后重新进行之前尝试的所有更改。列顺序不匹配警告的显示类似下例：
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 属性设为较大值，但未配合运行 AddColumns 工具和 -stringSize 参数来添加附加列并更新现有的字符串数据类型列大小，则报告将显示如下警告：
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.
配合运行 AddColumns 工具和 -stringSize 参数向该类型添加附加列并更新现有字符串数据类型列大小后，字符串列大小计数将会匹配。
