Skip to main content
Version: 1.6

FASTBCP_UID_STRING_CASING

Overview​

The FASTBCP_UID_STRING_CASING environment variable controls whether UID (UUID) values are converted to lowercase or uppercase strings in the output.

The default is lowercase, which follows RFC 4122 standard formatting (e.g. 550e8400-e29b-41d4-a716-446655440000).

SQL Server backups

With --connectiontype backup_mssql, the variable applies since FastBCP 1.6.5. Earlier versions always write lowercase from a backup.

Syntax​

$env:FASTBCP_UID_STRING_CASING = "upper"

Configuration​

PropertyValue
Typelower / upper
Defaultlower
Applies toAll output formats that serialize UID columns as strings
SinceFastBCP 1.0

Values​

ValueOutput example
lower (default)550e8400-e29b-41d4-a716-446655440000
upper550E8400-E29B-41D4-A716-446655440000

Examples​

Export with uppercase UIDs​

$env:FASTBCP_UID_STRING_CASING = "upper"

fastbcp -S myserver.database.windows.net `
-d MyDatabase `
-T dbo.MyTable `
--fileoutput "output.csv"

Restore default lowercase (RFC 4122)​

$env:FASTBCP_UID_STRING_CASING = "lower"
Copyright © 2026 Architecture & Performance.