LEFT (Transact-SQL)

Artigo
10/16/2024

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento en Microsoft Fabric

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

LEFT ( character_expression , integer_expression )

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 AdventureWorks2022.

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

Este es el conjunto de resultados.

--   
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