Share via

substring_index function

  • Article

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime

Returns the substring of expr before the count occurrence of the delimiter delim.

Syntax

substring_index(expr, delim, count)

Arguments

  • expr: A STRING or BINARY expression.
  • delim: An expression matching the type of expr specifying the delimiter.
  • count: An INTEGER expression to count the delimiters.

Returns

The result matches the type of expr.

If count is positive, everything to the left of the final delimiter (counting from the left) is returned.

If count is negative, everything to the right of the final delimiter (counting from the right) is returned.

Examples

> SELECT substring_index('www.apache.org', '.', 2);
 www.apache

> SELECT substring_index('555A66A777' COLLATE UTF8_BINARY, 'a', 2);
 555A66A777

> SELECT substring_index('555A66A777' COLLATE UTF8_LCASE, 'a', 2);
 555A66