LEFT (Transact-SQL)

Articolo
10/16/2024

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL in Microsoft Fabric Warehouse in Microsoft Fabric

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

Convenzioni relative alla sintassi Transact-SQL

Sintassi

LEFT ( character_expression , integer_expression )

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 ulteriori informazioni, vedi Supporto per Unicode e regole di confronto.

Esempi

R. Utilizzo di LEFT con una colonna

Nell'esempio seguente vengono restituiti i cinque caratteri più a sinistra di ogni nome prodotto nella Product tabella del database AdventureWorks2022.

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

Il set di risultati è il seguente.

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