TRIM (Transact-SQL)

Berlaku untuk: SQL Server 2017 (14.x) dan yang lebih baru Azure SQL DatabaseAzure SQL Managed InstanceTitik akhir analitik Azure Synapse AnalyticsSQL di Microsoft FabricWarehouse di Microsoft Fabric

Menghapus karakter spasi atau karakter char(32) tertentu lainnya dari awal dan akhir string.

Secara opsional menghapus karakter spasi atau karakter char(32) tertentu lainnya dari awal, akhir, atau kedua sisi string.

Dimulai dengan SQL Server 2022 (16.x), secara opsional menghapus karakter spasi atau karakter char(32) tertentu lainnya dari awal, akhir, atau kedua sisi string.

Konvensi sintaks transact-SQL

Sintaks

Sintaks untuk SQL Server 2022 (16.x) dan versi yang lebih lama, Azure SQL Database, dan Azure Synapse Analytics:

TRIM ( [ characters FROM ] string )

Sintaks untuk SQL Server 2022 (16.x) dan versi yang lebih baru, Azure SQL Managed Instance, dan Microsoft Fabric:

Penting

Anda memerlukan tingkat kompatibilitas database Anda diatur ke 160 untuk menggunakan LEADINGkata kunci , , TRAILINGatau BOTH .

TRIM ( [ LEADING | TRAILING | BOTH ] [characters FROM ] string )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

[ LEADING | TRAILING | KEDUANYA ]

Berlaku untuk: SQL Server 2022 (16.x) dan versi yang lebih baru, Azure SQL Managed Instance, dan Microsoft Fabric:

Argumen pertama opsional menentukan sisi string mana yang akan dipangkas:

  • LEADING menghapus karakter yang ditentukan dari awal string.

  • TRAILING menghapus karakter yang ditentukan dari akhir string.

  • BOTH (perilaku posisi default) menghapus karakter yang ditentukan dari awal dan akhir string.

Karakter

Panggilan literal, variabel, atau fungsi dari jenis karakter non-LOB apa pun (nvarchar, varchar, nchar, atau char) yang berisi karakter yang harus dihapus. Jenis nvarchar(max) dan varchar(max) tidak diizinkan.

string

Ekspresi jenis karakter apa pun (nvarchar, varchar, nchar, atau char) di mana karakter harus dihapus.

Jenis yang dikembalikan

Mengembalikan ekspresi karakter dengan jenis argumen string di mana karakter spasi atau karakter char(32) tertentu lainnya dihapus dari kedua sisi. Mengembalikan NULL jika string input adalah NULL.

Keterangan

Secara default, TRIM fungsi menghapus karakter spasi dari awal dan akhir string. Perilaku ini setara dengan LTRIM(RTRIM(@string)).

Untuk mengaktifkan argumen opsional LEADING, , atau BOTH posisi di SQL Server 2022 (16.x), Anda harus mengaktifkan tingkat 160 kompatibilitas database pada database yang Anda sambungkan TRAILINGsaat menjalankan kueri.

  • Dengan argumen posisi opsional LEADING , perilaku setara dengan LTRIM(@string, characters).
  • Dengan argumen posisi opsional TRAILING , perilaku setara dengan RTRIM(@string, characters).

Contoh

J. Menghapus karakter spasi dari kedua sisi string

Contoh berikut menghapus spasi dari sebelum dan sesudah kata test.

SELECT TRIM( '     test    ') AS Result;

Berikut adalah hasil yang ditetapkan.

test

B. Menghapus karakter tertentu dari kedua sisi string

Contoh berikut menyediakan daftar karakter yang mungkin dihapus dari string.

SELECT TRIM( '.,! ' FROM '     #     test    .') AS Result;

Berikut adalah hasil yang ditetapkan.

#     test

Dalam contoh ini, hanya periode dan spasi berikutnya dari sebelum # dan sesudah kata test dihapus. Karakter lain diabaikan karena tidak ada dalam string.

C. Menghapus karakter yang ditentukan dari awal string

Penting

Anda memerlukan tingkat kompatibilitas database Anda diatur ke 160 untuk menggunakan LEADINGkata kunci , , TRAILINGatau BOTH .

Contoh berikut menghapus awal . dari awal string sebelum kata test.

SELECT TRIM(LEADING '.,! ' FROM  '     .#     test    .') AS Result;

Berikut adalah hasil yang ditetapkan.

# test .

D. Menghapus karakter yang ditentukan dari akhir string

Penting

Anda memerlukan tingkat kompatibilitas database Anda diatur ke 160 untuk menggunakan LEADINGkata kunci , , TRAILINGatau BOTH .

Contoh berikut menghapus trailing . dari akhir string setelah kata test.

SELECT TRIM(TRAILING '.,! ' FROM '     .#     test    .') AS Result;

Berikut adalah hasil yang ditetapkan.

.#     test

E. Menghapus karakter yang ditentukan dari awal dan akhir string

Penting

Anda memerlukan tingkat kompatibilitas database Anda diatur ke 160 untuk menggunakan LEADINGkata kunci , , TRAILINGatau BOTH .

Contoh berikut menghapus karakter 123 dari awal dan akhir string 123abc123.

SELECT TRIM(BOTH '123' FROM '123abc123') AS Result;

Berikut adalah hasil yang ditetapkan.

abc