On January 27, 2021, Google is changing the required permissions for attaching IAM roles to service accounts. If you are using IAM roles for your Google service accounts, please see Changes to User Management.
Converts an input string to propercase. Input can be a column reference or a string literal.
Propercase is strict title case. If the first character of any non-breaking segment of letters in the string is an alphabetical character, it is capitalized. Otherwise, the string is unchanged. See the examples below.
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:
proper(MyName)
Output: Returns the string values in the MyName
column value written in Proper Case.
String literal example:
proper('Hello, world')
Output: The string Hello, World
is written to the new column.
Syntax and Arguments
proper(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 |
Tip: For additional examples, see Common Tasks.Examples
Example - uppercase, lowercase, propercase functions
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 | Edit column with formula |
---|---|
Parameter: Columns | uppercase |
Parameter: Formula | UPPER(input) |
Transformation Name | Edit column with formula |
---|---|
Parameter: Columns | lowercase |
Parameter: Formula | LOWER(input) |
Transformation Name | Edit column with formula |
---|---|
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. |
This page has no comments.