| Excerpt |
|---|
Matches the right set of characters in a string, as specified by parameter. The string can be specified as a column reference or a string literal. |
- Since the
RIGHT function matches based on fixed numeric values, changes to the length or structure of a data field can cause your recipe to fail to properly execute. - The
RIGHT function requires an integer value for the number of characters to match. If you need to match strings using patterns, you should use the ENDSWITH transform instead. See ENDSWITH Function.
Column reference example:
| D lang syntax |
|---|
| RawWrangle | true |
|---|
| Type | ref |
|---|
| showNote | true |
|---|
| WrangleText | derive type:single value:right(MyString,3) |
|---|
|
right(MyString,3) |
Output: Returns the rightmost (last) three letters of the MyName column value.
String literal example:
| D lang syntax |
|---|
| RawWrangle | true |
|---|
| Type | ref |
|---|
| showNote | true |
|---|
| WrangleText | derive type:single value:right('Hello, World',5) |
|---|
|
right('Hello, World',5) |
Output: Returns the string: World.
| D lang syntax |
|---|
| RawWrangle | true |
|---|
| Type | syntax |
|---|
| showNote | true |
|---|
| WrangleText | derive type:single value:right(column_string,end_count) |
|---|
|
right(column_string,end_count) |
| Argument | Required? | Data Type | Description |
|---|
| column_string | Y | string | Name of the column or string literal to be applied to the function |
| end_count | Y | integer (positive) | Count of characters from the end of the source string to apply to the match |
column_string
Name of the column or string constant to be searched.
- Missing string or column values generate missing string results.
- String constants must be quoted (
'Hello, World'). - Multiple columns and wildcards are not supported.
| Required? | Data Type | Example Value |
|---|
| Yes | String literal or column reference | myColumn |
end_count
Count of characters from the right end of the string to include in the match.
- Value must a non-negative integer. If the value is
0, then the match fails for all strings. - If this value is greater than the length of the string, then the match is the entire string.
- References to columns of integer data type are not supported.
| Required? | Data Type | Example Value |
|---|
| Yes | Integer (non-negative) | 5 |
Example - Parse segments of social security numbers
Social security numbers follow a regular format:
Each of the separate numeric groups corresponds to a specific meaning:
- XXX - Area value that corresponds to a geographic location that surrounds the SSN applicant's address
- XX - Group number identifies the order in which the numbers are assigned within an area
- XXX - Serial number of the individual within the area and group groupings.
- For more information, see http://www.usrecordsearch.com/ssn.htm.
Source:
You want to analyze some social security numbers for area, group, and serial information. However, your social security number data is messy:
| Info |
|---|
NOTE: The following sample contains invalid social security numbers for privacy reasons. If you use this data in the application, it fails validation for the SSN data type. |
| ParticipantId | SocialNum |
|---|
| 1001 | 805-88-2013 |
| 1002 | 845221914 |
| 1003 | 865 22 9291 |
| 1004 | 892-732213 |
Transformation:
When the above data is imported, the SocialNum column might or might not be inferred as SSN data type. Either way, you should clean up your data, using the following transforms:
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | '' |
|---|
| Type | step |
|---|
| WrangleText | replace col: SocialNum on: '-' with: '' global: true |
|---|
| p01Name | Column |
|---|
| p01Value | SocialNum |
|---|
| p02Name | Find |
|---|
| p02Value | '-' |
|---|
| p03Name | Replace with |
|---|
| p04Value | true |
|---|
| p04Name | Match all occurrences |
|---|
| SearchTerm | Replace text or pattern |
|---|
|
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | '' |
|---|
| Type | step |
|---|
| WrangleText | replace col: SocialNum on: ' ' with: '' global: true |
|---|
| p01Name | Column |
|---|
| p01Value | SocialNum |
|---|
| p02Name | Find |
|---|
| p02Value | ' ' |
|---|
| p03Name | Replace with |
|---|
| p04Value | true |
|---|
| p04Name | Match all occurrences |
|---|
| SearchTerm | Replace text or pattern |
|---|
|
At this point, your SocialNum data should be inferred as SSN type and consistently formatted as a set of digits:
| ParticipantId | SocialNum |
|---|
| 1001 | 805882013 |
| 1002 | 845221914 |
| 1003 | 865229291 |
| 1004 | 892732213 |
From this more consistent data, you can now break out the area, group, and serial values from the column:
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | 'SSN_area' |
|---|
| Type | step |
|---|
| WrangleText | derive type:single value: left(SocialNum, 3) as: 'SSN_area' |
|---|
| p01Name | Formula type |
|---|
| p01Value | Single row formula |
|---|
| p02Name | Formula |
|---|
| p02Value | left(SocialNum, 3) |
|---|
| p03Name | New column name |
|---|
| SearchTerm | New formula |
|---|
|
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | 'SSN_group' |
|---|
| Type | step |
|---|
| WrangleText | derive type:single value: substring(SocialNum, 3,5) as: 'SSN_group' |
|---|
| p01Name | Formula type |
|---|
| p01Value | Single row formula |
|---|
| p02Name | Formula |
|---|
| p02Value | substring(SocialNum, 3,5) |
|---|
| p03Name | New column name |
|---|
| SearchTerm | New formula |
|---|
|
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | 'SSN_serial' |
|---|
| Type | step |
|---|
| WrangleText | derive type:single value: right(SocialNum, 4) as: 'SSN_serial' |
|---|
| p01Name | Formula type |
|---|
| p01Value | Single row formula |
|---|
| p02Name | Formula |
|---|
| p02Value | right(SocialNum, 4) |
|---|
| p03Name | New column name |
|---|
| SearchTerm | New formula |
|---|
|
If desired, you can re-order the three new columns and delete the source column:
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | SSN_area |
|---|
| Type | step |
|---|
| WrangleText | move col: SSN_serial after: SSN_area |
|---|
| p01Name | Column(s) |
|---|
| p01Value | SSN_serial |
|---|
| p02Name | Option |
|---|
| p02Value | After |
|---|
| p03Name | Column |
|---|
| SearchTerm | Move columns |
|---|
|
| D trans |
|---|
| RawWrangle | true |
|---|
| p03Value | SSN_area |
|---|
| Type | step |
|---|
| WrangleText | move col: SSN_group after: SSN_area |
|---|
| p01Name | Column(s) |
|---|
| p01Value | SSN_group |
|---|
| p02Name | Option |
|---|
| p02Value | After |
|---|
| p03Name | Column |
|---|
| SearchTerm | Move columns |
|---|
|
| D trans |
|---|
| RawWrangle | true |
|---|
| Type | step |
|---|
| WrangleText | drop col:SocialNum |
|---|
| p01Name | Columns |
|---|
| p01Value | SocialNum |
|---|
| p02Name | Action |
|---|
| p02Value | Delete selected columns |
|---|
| SearchTerm | Delete columns |
|---|
|
Results:
If you complete the previous transform steps, your data should look like the following:
| ParticipantId | SSN_area | SSN_group | SSN_serial |
|---|
| 1001 | 805 | 88 | 2013 |
| 1002 | 845 | 22 | 1914 |
| 1003 | 865 | 22 | 9291 |
| 1004 | 892 | 73 | 2213 |
