AddColumns 報告及解決警告
使用 -r 參數執行 AddColumns 工具會傳回指定類型的所有欄資訊的報告。報告會比較資料庫、本機屬性欄結構描述檔案 (AddColumnsSchema.xml)、Introspection 檔案與特定類型的類別檔案，並報告下列內容：
• 每個欄資料類型的欄計數：
◦ 資料類型的總欄計數。
◦ 保留的資料類型欄計數 (為 PTC 所提供之現成屬性保留的欄數)。
◦ 資料類型的未分配欄計數 (尚未使用的欄數)。
• 欄順序。
• 字串資料類型欄大小。
• 類型的使用中總欄計數。這包括報告中所列的本機屬性欄與類型的其他所有欄。
• 根據欄資料類型，在達到最大允許欄計數之前仍可針對類型新增的欄數。
如果在資料庫、本機屬性欄結構描述檔案、Introspection 檔案和類別檔案，與 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 參數執行指令，報告會顯示類別與 Introspection 檔案的欄計數比資料庫與 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 工具以將其他欄新增至該類型並更新該類型的現有「字串」資料類型欄大小之後，「字串」欄大小計數會相符。
