Skip to content

Commit e9c4cb3

Browse files
andypeetersckadluba
authored andcommitted
Add note about truncating data of the Exception column, fix maximum value settings of the Message and MessageTemplate columns, and rename trimming to truncating
1 parent c70b1b2 commit e9c4cb3

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -460,13 +460,13 @@ _BigInt data type:_ For very large log tables, if you absolutely require an iden
460460

461461
This column stores the formatted output (property placeholders are replaced with property values). It defaults to `nvarchar(max)`. The `DataType` property can only be set to character-storage types.
462462

463-
In case `DataLength` is set to a specific value different from -1 or 0, any message longer than that length will be effectively trimmed down to that size. Example: `DataLength` is set to 15 and the message is "this is a very long message" (without the quotes), the trimmed text stored in the database will be: "this is a ve..." (again without quotes).
463+
In case `DataLength` is set to a specific value different from -1, any message longer than that length will be effectively truncated to that size. Example: `DataLength` is set to 15 and the message is "this is a very long message" (without the quotes), the truncated text stored in the database will be: "this is a ve..." (again without quotes).
464464

465465
### MessageTemplate
466466

467467
This column stores the log event message with the property placeholders. It defaults to `nvarchar(max)`. The `DataType` property can only be set to character-storage types.
468468

469-
In case `DataLength` is set to a specific value different from -1 or 0, any template text longer than that length will be effectively trimmed down to that size. Any trimming ignores all differences between the tokens in the template meaning that a template might get cut off in the middle of a property token. Example: `DataLength` is set to 20 and the message template is "a long {NumberOfCharacters} template text" (without the quotes), the final template stored in the database will be: "a long {NumberOfC..." (again without quotes).
469+
In case `DataLength` is set to a specific value different from -1, any template text longer than that length will be effectively truncated to that size. Any truncating ignores all differences between the tokens in the template meaning that a template might get cut off in the middle of a property token. Example: `DataLength` is set to 20 and the message template is "a long {NumberOfCharacters} template text" (without the quotes), the final template stored in the database will be: "a long {NumberOfC..." (again without quotes).
470470

471471
### Level
472472

@@ -496,6 +496,8 @@ When the `ConvertToUtc` property is set to `true`, the time stamp is adjusted to
496496

497497
When an exception is logged as part of the log event, the exception message is stored here automatically. The `DataType` must be `nvarchar`.
498498

499+
Similar to the columns `Message` and `MessageTemplate`, setting `DataLength` of `Exception` to a specific value different from -1 will effectively truncate any exception message to the stated length in `DataLength`.
500+
499501
### Properties
500502

501503
This column stores log event property values as XML. Typically you will use either this column or the JSON-based `LogEvent` column, but not both.

0 commit comments

Comments
 (0)