Categorias:: Funções de cadeia de caracteres e binários (General)

CONCAT_WS¶

Concatena duas ou mais cadeias de caracteres, ou concatena dois ou mais valores binários. Se qualquer um dos valores for nulo, o resultado também será nulo.

O operador CONCAT_WS requer pelo menos dois argumentos, e usa o primeiro argumento para separar todos os argumentos seguintes.

Consulte também:: CONCAT

Sintaxe¶

CONCAT_WS( <separator> , <expression1> [ , <expressionN> ... ] )

Copy

Argumentos¶

separator: O separador deve atender às mesmas exigências que expressionN.
expressionN: As expressões de entrada devem ser todas cadeias de caracteres, ou todas serem valores binários.

Retornos¶

A função retorna um VARCHAR ou BINARY que contém do segundo até n argumentos, separados pelo primeiro argumento.

O tipo de dados do valor retornado é o mesmo que o tipo de dados do(s) valor(es) de entrada.

Notas de uso¶

Funções de metadados tais como GET_DDL aceitam apenas constantes como entrada. A entrada concatenada gera um erro.
CONCAT_WS coloca os separadores entre os argumentos, não depois do último argumento. Se CONCAT_WS é chamado com apenas um argumento após o separador, então nenhum separador é anexado.

Detalhes do agrupamento¶

The collation specifications of all input arguments must be compatible.
The collation of the result of the function is the highest-precedence collation of the inputs.

Exemplos¶

Concatenar três cadeias de caracteres com separador:

SELECT CONCAT_WS(',', 'one', 'two', 'three');
+---------------------------------------+
| CONCAT_WS(',', 'ONE', 'TWO', 'THREE') |
|---------------------------------------|
| one,two,three                         |
+---------------------------------------+

Copy

Quando há apenas uma cadeia de caracteres para concatenar, CONCAT_WS não anexa um separador:

SELECT CONCAT_WS(',', 'one');
+-----------------------+
| CONCAT_WS(',', 'ONE') |
|-----------------------|
| one                   |
+-----------------------+

Copy