UPPER Function
All alphabetical characters in the input value are converted to uppercase in the output value.
Input can be a column reference or a string literal.
Wrangle vs. SQL: This function is part of Wrangle , a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language .
Basic Usage
Column reference example:
upper(MyName)
Output:
Returns the values from the MyName
column written in UPPER.
String literal example:
upper('Hello, World')
Output:
Returns the string: HELLO, WORLD
.
Syntax and Arguments
upper(column_string)
| Argument |
Required? |
Data Type |
Description |
|---|---|---|---|
| column_string |
Y |
string |
Name of the column or string literal to be applied to the function |
For more information on syntax standards, see Language Documentation Syntax Notes .
column_string
Name of the column or string constant to be converted.
-
Missing string or column values generate missing string results.
-
String constants must be quoted (
'Hello, World'). -
Multiple columns and wildcards are not supported.
Usage Notes:
| Required? |
Data Type |
Example Value |
|---|---|---|
| Yes |
String literal or column reference |
myColumn |
Examples
Tip
For additional examples, see Common Tasks .
Example - uppercase, lowercase, propercase functions
This example demonstrates functions that can be used to change the case of String values.
Functions:
| Item |
Description |
|---|---|
| UPPER Function |
All alphabetical characters in the input value are converted to uppercase in the output value. |
| LOWER Function |
All alphabetical characters in the input value are converted to lowercase in the output value. |
| PROPER Function |
Converts an input string to propercase. Input can be a column reference or a string literal. |
Source:
In the following example, you can see a number of input values in the leftmost column. The output columns are blank.
| input |
uppercase |
lowercase |
propercase |
|---|---|---|---|
| AbCdEfGh IjKlMnO |
|||
| go West, young man! |
|||
| Oh, *(*$%(&! That HURT! |
|||
| A11 w0rk and n0 0play makes Jack a dull boy. |
Transformation:
To generate uppercase, lowercase, and propercase values in the output columns, use the following transforms:
| Transformation Name |
|
|---|---|
| Parameter: Columns |
uppercase |
| Parameter: Formula |
UPPER(input) |
| Transformation Name |
|
|---|---|
| Parameter: Columns |
lowercase |
| Parameter: Formula |
LOWER(input) |
| Transformation Name |
|
|---|---|
| Parameter: Columns |
propercase |
| Parameter: Formula |
PROPER(input) |
Results:
| input |
uppercase |
lowercase |
propercase |
|---|---|---|---|
| AbCdEfGh IjKlMnO |
ABCDEFGH IJKLMNO |
abcdefgh ijklmno |
Abcdefgh Ijklmno |
| go West, young man! |
GO WEST, YOUNG MAN! |
go west, young man! |
Go West, Young Man! |
| Oh, *(*$%(&! That HURT! |
OH, *(*$%(&! THAT HURT! |
oh, *(*$%(&! that hurt! |
Oh, *(*$%(&! That Hurt! |
| A11 w0rk and n0 0play makes Jack a dull boy. |
A11 W0RK AND N0 0PLAY MAKES JACK A DULL BOY. |
a11 w0rk and n0 0play makes jack a dull boy. |
A11 W0rk And N0 0play Makes Jack A Dull Boy. |

