Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

NULLIF

Menerima dua argumen dan mengembalikan nilai NULL jika keduanya sama; jika tidak, argumen pertama akan dikembalikan.

Fungsi NULLIF setara dengan CASE WHEN expression1 = expression2 THEN NULL ELSE expression1 END

NULLIF berguna dengan fungsi agregat seperti AVG, MAX, MIN, SUM, dan COUNT jika kumpulan hasil berisi nilai khusus yang bukan NULL, tetapi ingin Anda perlakukan sebagai NULL untuk keperluan agregasi.

Lihat juga:
[SELECT] [COALESCE] [IFNULL]


Sintaksis​

SELECT NULLIF(expression1, expression2) FROM <multipartIdentifier>;

Argumen​

expression
Dua ekspresi dengan tipe data apa pun yang menghasilkan nilai NULL atau bukan NULL.

Fungsi NULLIF menelusuri argumennya dari kiri ke kanan untuk menemukan argumen yang mendefinisikan fungsi kolasi, lalu menggunakan fungsi kolasi tersebut untuk semua perbandingan string. Jika tidak ada argumen yang mendefinisikan fungsi kolasi, kolasi BINARY akan digunakan.

Nilai yang dikembalikan​

Mengembalikan NULL jika kedua argumen expression menghasilkan nilai yang sama; jika tidak, nilai pertama akan dikembalikan.


Contoh​

Menghitung baris dengan field yang tidak sama dengan nilai tertentu​

SELECT COUNT(NULLIF(name, 'controller-0'))
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/*
equivalent to:
SELECT COUNT(*) FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
AND name != 'controller-0';
*/

Untuk informasi selengkapnya, lihat https://www.sqlite.org/lang_corefunc.html#nullif