Partilhar via


Função regexp_substr

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

Retorna a primeira substring que str corresponde a regexp.

Sintaxe

regexp_substr( str, regexp )

Argumentos

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

Devoluções

A STRING.

A regexp cadeia de caracteres deve ser uma expressão regular Java. Os literais de cadeia de caracteres não escapam. Por exemplo, para corresponder '\abc'a , uma expressão regular para regexp pode ser '^\\abc$'.

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

Se o argumento 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