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

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