LEFT (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database SíInstancia administrada de Azure SQL síAzure Synapse Analytics síAlmacenamiento de datos paralelos

Devuelve la parte izquierda de una cadena de caracteres con el número de caracteres especificado.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

LEFT ( character_expression , integer_expression )  

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

character_expression
Es una expresión de datos binarios o de caracteres. character_expression puede ser una constante, una variable o una columna. character_expression puede ser cualquier tipo de datos (excepto text o ntext) que se pueda convertir implícitamente a varchar o nvarchar. De lo contrario, use la función CAST para convertir character_expression explícitamente.

Nota

Si string_expression es de tipo binary o varbinary, LEFT realizará una conversión implícita a varchar y, por tanto, no conservará la entrada binaria.

integer_expression
Es un entero positivo que especifica cuántos caracteres de character_expression se van a devolver. Si integer_expression es negativo, se devuelve un error. Si integer_expression es de tipo bigint y contiene un valor grande, character_expression debe ser de un tipo de datos de gran tamaño, como varchar(max) .

El parámetro integer_expression cuenta un carácter suplente UTF 16 como un carácter.

Tipos de valor devuelto

Devuelve varchar cuando character_expression es de un tipo de datos de caracteres no Unicode.

Devuelve nvarchar cuando character_expression es de un tipo de datos de caracteres Unicode.

Observaciones

Al usar intercalaciones de SC, el parámetro integer_expression cuenta un par suplente UTF 16 como un carácter. Para más información, consulte Compatibilidad con la intercalación y Unicode.

Ejemplos

A. Utilizar LEFT con una columna

En el ejemplo siguiente se devuelven los cinco caracteres situados más a la izquierda de cada nombre de producto de la tabla Product de la base de datos AdventureWorks2012.

SELECT LEFT(Name, 5)   
FROM Production.Product  
ORDER BY ProductID;  
GO  

B. Utilizar LEFT con una cadena de caracteres

En el ejemplo siguiente se utiliza LEFT para devolver los dos caracteres situados más a la izquierda de la cadena de caracteres abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

El conjunto de resultados es el siguiente:

--   
ab   
  
(1 row(s) affected)  

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

C. Utilizar LEFT con una columna

En el ejemplo siguiente se devuelven los cinco caracteres situados más a la izquierda de cada nombre de producto.

-- Uses AdventureWorks  
  
SELECT LEFT(EnglishProductName, 5)   
FROM dbo.DimProduct  
ORDER BY ProductKey;  

D. Utilizar LEFT con una cadena de caracteres

En el ejemplo siguiente se utiliza LEFT para devolver los dos caracteres situados más a la izquierda de la cadena de caracteres abcdefg.

-- Uses AdventureWorks  
  
SELECT LEFT('abcdefg',2) FROM dbo.DimProduct;  

El conjunto de resultados es el siguiente:

--   
ab  

Consulte también

LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST y CONVERT (Transact-SQL)
Tipos de datos (Transact-SQL)
Funciones de cadena (Transact-SQL)