LEFT (Transact-SQL) - SQL Server | Microsoft Docs

03/13/2017
2 minuti per leggere
- c
- j
- r
- M
- r
- +8

Si applica a: QL Server (tutte le versioni supportate) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

Riporta la parte sinistra di una stringa di caratteri con il numero di caratteri specificato.

Icona collegamento argomento Convenzioni sintassi Transact-SQL

Sintassi

LEFT ( character_expression , integer_expression )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 e precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

character_expression
È un’espressione di carattere o di dati binari. character_expression può essere una costante, una variabile o una colonna. character_expression può essere di qualsiasi tipo di dati, tranne text o ntext, che può essere implicitamente convertito in varchar o nvarchar. Altrimenti, usate la funzione CAST per convertire esplicitamente character_expression.

Nota

Se string_expression è di tipo binario o varbinario, LEFT eseguirà una conversione implicita in varchar, e quindi non conserverà l’input binario.

integer_expression
È un numero intero positivo che specifica quanti caratteri di character_expression saranno restituiti. Se integer_expression è negativo, viene restituito un errore. Se integer_expression è di tipo bigint e contiene un valore grande, character_expression deve essere di un tipo di dati grande come varchar(max).

Il parametro integer_expression conta un carattere surrogato UTF-16 come un carattere.

Tipi di ritorno

Ritorna varchar quando character_expression è un tipo di dati non Unicode.

Ritorna nvarchar quando character_expression è un tipo di dati Unicode.

Remarks

Quando si usano le ordinazioni SC, il parametro integer_expression conta una coppia surrogata UTF-16 come un carattere. Per maggiori informazioni, vedi Supporto per ordinamento e Unicode.

Esempi

A. Usare LEFT con una colonna

L’esempio seguente restituisce i cinque caratteri più a sinistra di ogni nome di prodotto nella tabella Product del database AdventureWorks2012.

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

B. Uso di LEFT con una stringa di caratteri

L’esempio seguente usa LEFT per restituire i due caratteri più a sinistra della stringa di caratteri abcdefg.

SELECT LEFT('abcdefg',2); GO

Ecco il set di risultati.

-- ab (1 row(s) affected)

Esempi: Azure Synapse Analytics e Parallel Data Warehouse

C. Usare LEFT con una colonna

L’esempio seguente restituisce i cinque caratteri più a sinistra di ogni nome di prodotto.

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

D. Usare LEFT con una stringa di caratteri