REPLACE (Transact-SQL)REPLACE (Transact-SQL)

ESTE TÓPICO APLICA-SE A: simSQL Server (a partir de 2008)simBanco de Dados SQL do Microsoft AzuresimAzure SQL Data Warehouse simParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Substitui todas as ocorrências de um valor da cadeia de caracteres especificado por outro valor de cadeia de caracteres.Replaces all occurrences of a specified string value with another string value.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

REPLACE ( string_expression , string_pattern , string_replacement )  

ArgumentosArguments

string_expressionstring_expression
É a expression de cadeia de caracteres a ser pesquisada.Is the string expression to be searched. string_expression pode ser de um tipo de dados de caractere ou binários.string_expression can be of a character or binary data type.

string_ patternstring_ pattern
É a subcadeia de caracteres a ser localizada.Is the substring to be found. string_pattern pode ser de um caractere ou de tipo de dados binários.string_pattern can be of a character or binary data type. string_pattern não pode ser uma cadeia de caracteres vazia (") e não deve exceder o número máximo de bytes que cabem em uma página.string_pattern cannot be an empty string (''), and must not exceed the maximum number of bytes that fits on a page.

string_ replacementstring_ replacement
É a cadeia de caracteres de substituição.Is the replacement string. string_replacement pode ser de um tipo de dados de caractere ou binários.string_replacement can be of a character or binary data type.

Tipos de retornoReturn Types

Retorna nvarchar se um dos argumentos de entrada é do tipo de dados nvarchar; caso contrário, REPLACE retorna varchar.Returns nvarchar if one of the input arguments is of the nvarchar data type; otherwise, REPLACE returns varchar.

Retornará NULL se qualquer um dos argumentos for NULL.Returns NULL if any one of the arguments is NULL.

Se string_expression não for do tipo varchar(max) ou nvarchar(max), REPLACE truncará o valor retornado em 8.000 bytes.If string_expression is not of type varchar(max) or nvarchar(max), REPLACE truncates the return value at 8,000 bytes. Para retornar valores com mais de 8.000 bytes, string_expression deve ser convertida explicitamente em um tipo de dados de valor grande.To return values greater than 8,000 bytes, string_expression must be explicitly cast to a large-value data type.

RemarksRemarks

REPLACE efetua comparações com base no agrupamento da entrada.REPLACE performs comparisons based on the collation of the input. Para fazer uma comparação em um agrupamento especificado, use COLLATE para aplicar um agrupamento explícito à entrada.To perform a comparison in a specified collation, you can use COLLATE to apply an explicit collation to the input.

0x0000 (char(0)) é um caractere indefinido em agrupamentos do Windows e não pode ser incluído em REPLACE.0x0000 (char(0)) is an undefined character in Windows collations and cannot be included in REPLACE.

ExemplosExamples

O exemplo a seguir substitui a cadeia de caracteres cde em abcdefghi por xxx.The following example replaces the string cde in abcdefghi with xxx.

SELECT REPLACE('abcdefghicde','cde','xxx');  
GO  

Aqui está o conjunto de resultados.Here is the result set.

------------  
abxxxfghixxx  
(1 row(s) affected)  

O exemplo a seguir usa a função COLLATE.The following example uses the COLLATE function.

SELECT REPLACE('This is a Test'  COLLATE Latin1_General_BIN,  
'Test', 'desk' );  
GO  

Aqui está o conjunto de resultados.Here is the result set.

------------  
This is a desk  
(1 row(s) affected)  

Consulte TambémSee Also

CONCAT (Transact-SQL)CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)FORMATMESSAGE (Transact-SQL)
QUOTENAME (Transact-SQL)QUOTENAME (Transact-SQL)
REVERSE (Transact-SQL)REVERSE (Transact-SQL)
STRING_AGG (Transact-SQL)STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)STRING_ESCAPE (Transact-SQL)
STUFF (Transact-SQL)STUFF (Transact-SQL)
TRANSLATE (Transact-SQL)TRANSLATE (Transact-SQL)
Tipos de dados (Transact-SQL) Data Types (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)String Functions (Transact-SQL)