# REGEXP_SUBSTR

> Função REGEXP_SUBSTR no StackQL: extrair a substring de uma entrada que corresponde a uma expressão regular.

Source: https://stackql.io/pt-br/language-spec/functions/re/regexp_substr

Retorna uma substring de uma string de entrada que corresponde a um padrão especificado.  

Veja também:  
[[` SELECT `]](/language-spec/select) [[ Referência de expressões regulares ]](/language-spec/functions/re/reference) 

* * * 

## Sintaxe

```sql
SELECT REGEXP_SUBSTR(source, pattern) FROM <multipartIdentifier>;
```

## Argumentos

__*source*__  
Uma string literal ou coluna de string da qual você deseja extrair uma substring com base em um padrão definido por uma expressão regular (`pattern`).  

__*pattern*__  
O padrão de expressão regular a ser procurado.  

## Valor(es) retornado(s)
Retorna uma string.

* * *

## Exemplos

### Extrair uma substring com base em uma expressão regular

**StackQL**

```sql
select name,
json_extract(properties, '$.storageProfile.imageReference.offer') as os,
regexp_substr(
  json_extract(properties, '$.storageProfile.imageReference.exactVersion'), 
  '[0-9][0-9]\.[0-9][0-9]') as os_version 
from azure.compute.virtual_machines 
WHERE subscription_id = '273769f6-545f-45b2-8ab8-2f14ec5768dc';
```

**Resultados**

```
|------|---------------|------------|
| name |      os       | os_version |
|------|---------------|------------|
| vm0  | UbuntuServer  |      16.04 |
|------|---------------|------------|
| vm1  | UbuntuServer  |      16.04 |
|------|---------------|------------|
| vm2  | UbuntuServer  |      20.04 |
|------|---------------|------------|
```

Para obter mais informações, consulte [https://github.com/nalgeon/sqlean/blob/main/docs/re.md](https://github.com/nalgeon/sqlean/blob/main/docs/re.md)
