LEFT (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Mengembalikan bagian kiri string karakter dengan jumlah karakter yang ditentukan.

Konvensi Sintaksis T-SQL

Sintaks

LEFT ( character_expression , integer_expression )  

Catatan

Untuk melihat sintaks transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

character_expression
Adalah ekspresi karakter atau data biner. character_expression bisa berupa konstanta, variabel, atau kolom. character_expression dapat berupa jenis data apa pun, kecuali teks atau ntext, yang dapat dikonversi secara implisit ke varchar atau nvarchar. Jika tidak, gunakan fungsi CAST untuk mengonversi character_expression secara eksplisit.

Catatan

Jika string_expression berjenis biner atau varbinary, LEFT akan melakukan konversi implisit ke varchar, dan karenanya tidak akan mempertahankan input biner.

integer_expression
Adalah bilangan bulat positif yang menentukan berapa banyak karakter character_expression yang akan dikembalikan. Jika integer_expression negatif, kesalahan akan dikembalikan. Jika integer_expression adalah jenis bigint dan berisi nilai besar, character_expression harus dari jenis data besar seperti varchar(max).

Parameter integer_expression menghitung karakter pengganti UTF-16 sebagai satu karakter.

Jenis Pengembalian

Mengembalikan varchar saat character_expression adalah tipe data karakter non-Unicode.

Mengembalikan nvarchar saat character_expression adalah tipe data karakter Unicode.

Keterangan

Saat menggunakan kolase SC, parameter integer_expression menghitung pasangan pengganti UTF-16 sebagai satu karakter. Untuk informasi selengkapnya, lihat Kolajeasi dan Dukungan Unicode.

Contoh

A. Menggunakan LEFT dengan kolom

Contoh berikut mengembalikan lima karakter paling kiri dari setiap nama produk dalam Product tabel database AdventureWorks2012.

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

B. Menggunakan LEFT dengan string karakter

Contoh berikut menggunakan LEFT untuk mengembalikan dua karakter paling kiri dari string abcdefgkarakter .

SELECT LEFT('abcdefg',2);  
GO  

Berikut adalah hasil yang ditetapkan.

--   
ab   
  
(1 row(s) affected)  

Contoh: Azure Synapse Analytics and Analytics Platform System (PDW)

C. Menggunakan LEFT dengan kolom

Contoh berikut mengembalikan lima karakter paling kiri dari setiap nama produk.

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

D. Menggunakan LEFT dengan string karakter

Contoh berikut menggunakan LEFT untuk mengembalikan dua karakter paling kiri dari string abcdefgkarakter .

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

Berikut adalah hasil yang ditetapkan.

--   
ab  

Lihat juga

LTRIM (SQL bertransaksi)
KANAN (SQL bertransaksi)
RTRIM (SQL Bertransaksi)
STRING_SPLIT (SQL Bertransaksi)
SUBSTRING (SQL Bertransaksi)
TRIM (SQL Bertransaksi)
CAST dan CONVERT (SQL Transact)
Tipe Data (Transact-SQL)
Fungsi String (SQL Transact)