Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL Server 2025 (17.x) Banco de Dados SQL do AzurePonto de extremidade de análise deSQL da Instância Gerenciada de SQL do Azureno Microsoft Fabric e Warehouse noBanco de Dados SQL do Microsoft Fabric no Microsoft Fabric
A REGEXP_REPLACE função escalar de expressão regular retorna uma cadeia fonte modificada substituída por uma cadeia de substituição, onde a ocorrência do padrão de expressão regular é encontrada. Se nenhuma correspondência for encontrada, a função retornará a cadeia de caracteres original.
REGEXP_REPLACE
(
string_expression,
pattern_expression [ , string_replacement [ , start [ , occurrence [ , flags ] ] ] ]
)
Arguments
string_expression
Uma expressão de uma cadeia de caracteres.
Pode ser uma constante, variável ou coluna de cadeia de caracteres.
Tipos de dados: char, nchar, varcharou nvarchar.
Note
As REGEXP_* funções suportam tipos LOB (varchar(max) e nvarchar(max)) de até 2 MB para o parâmetro string_expression .
pattern_expression
Padrão de expressão regular a ser correspondido. Normalmente, um literal de texto.
Tipos de dados: char, nchar, varcharou nvarchar. pattern_expression dá suporte a um comprimento máximo de caractere de 8.000 bytes.
string_replacement
Expressão de cadeia de caracteres que especifica a cadeia de caracteres de substituição para as subcadeias de caracteres correspondentes e substitui as subcadeias de caracteres correspondentes ao padrão. Podem string_replacement ser de tipos de dados char, varchar, nchar, nvarchar, varchar(max) ou nvarchar(max) (tipos LOB são suportados de até 2 MB). Se uma cadeia de caracteres vazia ('') for especificada, a função removerá todas as subcadeias de caracteres correspondentes e retornará a cadeia de caracteres resultante. A cadeia de caracteres de substituição padrão é a cadeia de caracteres vazia ('').
O string_replacement pode conter \n, em que n é de 1 a 9, para indicar que a subcadeia de caracteres de origem que corresponde ao grupo parêntese n'th (subexpressão) do padrão deve ser inserida e pode conter & para indicar que a subcadeia de caracteres que corresponde a todo o padrão deve ser inserida. Gravação \ se você precisar colocar uma barra invertida literal no texto de substituição.
Por exemplo
REGEXP_REPLACE('123-456-7890', '(\d{3})-(\d{3})-(\d{4})', '(\1) \2-\3')
Returns:
(123) 456-7890
Se o fornecido \n for string_replacement maior que o número de grupos no pattern_expression, a função ignorará o valor.
Por exemplo:
REGEXP_REPLACE('123-456-7890', '(\d{3})-(\d{3})-(\d{4})', '(\1) (\4)-xxxx')
Returns:
(123) ()-xxxx
start
Especifique a posição inicial da pesquisa dentro da cadeia de caracteres de pesquisa. Optional. O tipo é int ou bigint.
A numeração é baseada em 1, o que significa que o primeiro caractere na expressão é 1 e o valor deve ser >= 1. Se a expressão inicial for menor que 1, retornará o erro. Se a expressão inicial for maior que o comprimento de string_expression, a função retornará string_expression. O padrão é 1.
occurrence
Uma expressão (inteiro positivo) que especifique qual ocorrência da expressão do padrão na cadeia de origem deve ser pesquisada ou substituída. O valor padrão é 0, o que significa que todas as ocorrências do pattern_expression são substituídas. Para um inteiro npositivo , ele busca string_expression a nésima ocorrência, continuando a busca a partir do caractere imediatamente após cada correspondência anterior.
flags
Um ou mais caracteres que especificam os modificadores usados para pesquisar correspondências. O tipo é varchar ou char, com um máximo de 30 caracteres.
Por exemplo, ims. O padrão é c. Se uma cadeia de caracteres vazia (' ') for fornecida, ela será tratada como o valor padrão ('c'). Forneça c ou qualquer outra expressão de caractere. Se o sinalizador contiver vários caracteres contraditórios, o SQL Server usará o último caractere.
Por exemplo, se você especificar ic o regex retornará correspondência que diferencia maiúsculas de minúsculas.
Se o valor contiver um caractere diferente daqueles listados em valores de sinalizador com suporte, a consulta retornará um erro como o exemplo a seguir:
Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
Valores de sinalizador com suporte
| Flag | Description |
|---|---|
i |
Não diferencia maiúsculas de minúsculas (padrão false) |
m |
Modo de várias linhas: ^ e $ corresponder à linha de início/término, além do texto de início/término (padrão false) |
s |
Permitir . correspondência \n (padrão false) |
c |
Diferencia maiúsculas de minúsculas (padrão true) |
Valor de retorno
Expression.
Suporte da plataforma
- Em Instância Gerenciada de SQL do Azure, as funções de expressão regular do T-SQL estão disponíveis apenas com a políticade atualização de data SQL Server 2025 ou Always-up-to -date.
- Funções de expressão regular do T-SQL estão disponíveis no Banco de Dados SQL do Azure, SQL Database no Fabric e a partir do SQL Server 2025.
- As funções de expressão regular do T-SQL não estão disponíveis no SQL Server 2022 ou versões anteriores.
- Funções escalares de expressões regulares do T-SQL estão disponíveis como recurso de pré-visualização em Fabric Data Warehouse. Para mais informações, veja Funções de expressões regulares em Fabric Data Warehouse. Funções de tabela com valores de expressão regular no T-SQL não estão disponíveis em Fabric Data Warehouse.
Examples
Substitua todas as ocorrências de a ou e por X nos nomes dos produtos.
SELECT REGEXP_REPLACE(PRODUCT_NAME, '[ae]', 'X', 1, 0, 'i')
FROM PRODUCTS;
Substitua a primeira ocorrência de cat ou dog por pet nas descrições do produto
SELECT REGEXP_REPLACE(PRODUCT_DESCRIPTION, 'cat|dog', 'pet', 1, 1, 'i')
FROM PRODUCTS;
Substituir os últimos quatro dígitos dos números de telefone por asteriscos
SELECT REGEXP_REPLACE(PHONE_NUMBER, '\d{4}$', '****')
FROM CUSTOMERS;