Compartilhar via


Função regexp_substr

Aplica-se a:verificação marcada como sim SQL do Databricks caixa de seleção marcada Databricks Runtime 11.3 LTS e versões posteriores

Retorna a primeira substring em str que combine regexp.

Sintaxe

regexp_substr( str, regexp )

Argumentos

  • str: uma expressão STRING a ser correspondida.
  • regexp: uma expressão STRING com um padrão.

Retornos

Um STRING.

A cadeia de caracteres regexp deve ser uma expressão regular Java. Os literais de cadeia de caracteres não têm caracteres de escape. Por exemplo, para fazer a correspondência de '\abc', uma expressão regular para regexp pode ser '^\\abc$'.

No caso de um regexp malformado, a função retorna um erro INVALID_PARAMETER_VALUE.

Se um dos argumentos for NULL ou o padrão não for encontrado, o resultado será NULL.

Exemplos

> SELECT regexp_substr('Steven Jones and Stephen Smith are the best players', 'Ste(v|ph)en');
 Steven

> SELECT regexp_substr('Mary had a little lamb', 'Ste(v|ph)en');
 NULL

> SELECT regexp_substr(NULL, 'Ste(v|ph)en');
 NULL

> SELECT regexp_substr('Mary had a little lamb', NULL);
 NULL