Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.
SUBSTRING
Retorna parte de uma expressão de caracteres ou binária. SUBSTR é um alias de SUBSTRING.
Veja também:
[SELECT] [ Tipos de dados ]
Para extrair um campo de um objeto JSON, use a função JSON_EXTRACT.
Sintaxe
SELECT SUBSTRING(expression, start[, length]) FROM <multipartIdentifier>;
SELECT SUBSTR(expression, start[, length]) FROM <multipartIdentifier>;
Argumentos
expression
Uma string ASCII ou um BLOB.
Se expression for uma string, os índices de caracteres se referem a caracteres UTF-8 reais. Se expression for um BLOB, os índices se referem a bytes.
start
Um inteiro que representa o primeiro caractere ou byte da subsequência da expressão de entrada a ser retornada. Se start for negativo, o primeiro caractere da substring é encontrado contando a partir da direita, e não da esquerda.
O caractere mais à esquerda de expression é o número 1.
length
Um valor inteiro opcional que representa o comprimento da subsequência a ser retornada após o valor start. Se length for omitido, a função retorna todos os caracteres até o final da string ou do BLOB especificado por expression.
Se length for negativo, a função usa o valor absoluto de length.
Valor(es) retornado(s)
Retorna uma string ou um valor BLOB, dependendo do tipo de expression.
Exemplos
Retornar os primeiros n caracteres de uma coluna
SELECT SUBSTRING(name, 1, 5) as "first five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
Truncar os primeiros n caracteres de uma coluna
SELECT SUBSTR(name, 5) as "from char 5"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
Retornar os últimos n caracteres de uma coluna
SELECT SUBSTRING(name, -5) as "last five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
Para obter mais informações, consulte https://www.sqlite.org/lang_corefunc.html#substr