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

03/13/2017
2 minuten om te lezen
- c
- j
- r
- M
- r
- +8

Geldt voor: SQL Server (alle ondersteunde versies) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

Haalt het linkerdeel van een tekenreeks met het opgegeven aantal tekens terug.

Topic link icon Transact-SQL Syntax Conventions

Syntax

LEFT ( character_expression , integer_expression )

Note

Om de Transact-SQL syntax voor SQL Server 2014 en eerder te bekijken, raadpleegt u de documentatie voor eerdere versies.

Argumenten

karakter_expressie
Is een expressie van teken- of binaire gegevens. karakter_expressie kan een constante, variabele of kolom zijn. karakter_expressie kan van elk gegevenstype zijn, behalve tekst of ntext, dat impliciet kan worden geconverteerd naar varchar of nvarchar. Gebruik anders de CAST-functie om character_expression expliciet te converteren.

Note

Als string_expression van het type binair of varbinary is, zal LEFT een impliciete conversie naar varchar uitvoeren, en dus de binaire invoer niet behouden.

integer_expression
Is een positief geheel getal dat specificeert hoeveel tekens van de character_expression worden geretourneerd. Als integer_expression negatief is, wordt een fout geretourneerd. Als integer_expression van het type bigint is en een grote waarde bevat, moet character_expression van een groot gegevenstype zijn, zoals varchar(max).

De parameter integer_expression telt een UTF-16 surrogaatteken als één teken.

Return Types

Returns varchar wanneer character_expression een niet-Unicode character datatype is.

Returns nvarchar wanneer character_expression een Unicode character datatype is.

Remarks

Wanneer u SC-collaties gebruikt, telt de parameter integer_expression een UTF-16 surrogaatteken als één teken. Zie Collation and Unicode Support voor meer informatie.

Voorbeelden

A. LINKS gebruiken met een kolom

Het volgende voorbeeld geeft de vijf meest linkse tekens van elke productnaam in de Product tabel van de AdventureWorks2012 database.

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

B. LINKS gebruiken met een tekenreeks

Het volgende voorbeeld gebruikt LEFT om de twee meest linkse tekens van de tekenreeks abcdefg terug te geven.

SELECT LEFT('abcdefg',2); GO

Hier is de resultatenset.

-- ab (1 row(s) affected)

Voorbeelden: Azure Synapse Analytics en Parallel Data Warehouse

C. LINKS gebruiken met een kolom

Het volgende voorbeeld retourneert de vijf meest linkse tekens van elke productnaam.

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

D. LINKS gebruiken met een tekenreeks