LEFT (Transact-SQL)

Si applica a: SQL Server (tutte le versioni supportate) Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Restituisce la parte iniziale di una stringa di caratteri, di lunghezza pari al numero di caratteri specificato.

Icona collegamento argomentoConvenzioni relative alla sintassi Transact-SQL

Sintassi

LEFT ( character_expression , integer_expression )  

Nota

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

Argomenti

character_expression
Espressione di dati di tipo carattere o binario. character_expression può essere una costante, una variabile o una colonna. character_expression può essere di qualsiasi tipo di dati, eccetto text o ntext, implicitamente convertibile in varchar o nvarchar. In alternativa usare la funzione CAST per convertire in modo esplicito character_expression.

Nota

Se string_expression è di tipo binary o varbinary, LEFT eseguirà una conversione implicita in varchar e pertanto non manterrà l'input binario.

integer_expression
Valore Integer positivo che specifica quanti caratteri di character_expression verranno restituiti. Se l'argomento integer_expression è negativo, viene restituito un errore. Se integer_expression è di tipo bigint e contiene un valore elevato, character_expression deve essere di un tipo di dati di grandi dimensioni, ad esempio varchar(max) .

Il parametro integer_expression considera un carattere surrogato UTF-16 come un solo carattere.

Tipi restituiti

Restituisce varchar quando character_expression è un tipo di dati carattere non Unicode.

Restituisce nvarchar quando character_expression è un tipo di dati carattere Unicode.

Osservazioni

Quando si usano le regole di confronto SC, il parametro integer_expression considera una coppia di surrogati UTF-16 come un solo carattere. Per altre informazioni, vedere Collation and Unicode Support.

Esempi

R. Utilizzo di LEFT con una colonna

Nell'esempio seguente vengono restituiti i primi cinque caratteri di ciascun nome di prodotto nella tabella Product del database AdventureWorks2019.

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

B. Utilizzo di LEFT con una stringa di caratteri

Nell'esempio seguente viene utilizzata la funzione LEFT per ottenere i primi due caratteri della stringa di caratteri abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

Questo è il set di risultati.

--   
ab   
  
(1 row(s) affected)  

Esempi: Azure Synapse Analytics e piattaforma di strumenti analitici (PDW)

C. Utilizzo di LEFT con una colonna

Nell'esempio seguente vengono restituiti i primi cinque caratteri di ogni nome di prodotto.

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

D. Utilizzo di LEFT con una stringa di caratteri

Nell'esempio seguente viene utilizzata la funzione LEFT per ottenere i primi due caratteri della stringa di caratteri abcdefg.

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

Questo è il set di risultati.

--   
ab  

Vedere anche

LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST e CONVERT (Transact-SQL)
Tipi di dati (Transact-SQL)
Funzioni per i valori stringa (Transact-SQL)