KIRI (T-SQL)

Artikel
11/15/2023

Berlaku untuk:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Titik akhir analitik SQL di Microsoft Fabric Warehouse di Microsoft Fabric

Mengembalikan bagian kiri string karakter dengan jumlah karakter yang ditentukan.

Konvensi sintaks transact-SQL

Sintaksis

LEFT ( character_expression , integer_expression )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi 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 oleh karena itu 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(maks).

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

Jenis Kembalian

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

Mengembalikan nvarchar ketika character_expression adalah jenis data karakter Unicode.

Keterangan

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

Contoh

J. Menggunakan LEFT dengan kolom

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

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