All Products
Search
Document Center

IoT Platform:Fungsi agregat

Last Updated:Jun 21, 2025

Fungsi agregat mengelompokkan beberapa catatan input menjadi satu catatan output dengan hubungan banyak-ke-satu. Topik ini menjelaskan sintaksis, parameter, dan contoh fungsi agregat yang didukung oleh fitur analisis data.

AVG

  • Sintaksis

    double avg(double <colname>)
    decimal avg(decimal <colname>)
  • Deskripsi

    Mengembalikan nilai rata-rata dari sebuah kolom.

  • Parameter

    nilai: wajib. Nilai parameter ini dapat berupa tipe DOUBLE atau DECIMAL. Jika nilai input adalah tipe STRING atau BIGINT, nilai tersebut secara implisit dikonversi ke tipe DOUBLE sebelum perhitungan. Jika nilai input adalah tipe data lain, kesalahan akan dikembalikan. Jika nilai dari parameter ini adalah NULL, nilai tersebut digunakan untuk perhitungan. Nilai tipe BOOLEAN tidak dapat digunakan untuk perhitungan.

  • Nilai Pengembalian

    Jika nilai input adalah tipe DECIMAL, nilai DECIMAL dikembalikan. Jika nilai input adalah tipe data valid lainnya, nilai DOUBLE dikembalikan.

  • Contoh

    Hitung nilai rata-rata suhu pada hari saat ini.

    avg(temperature);

COUNT

  • Sintaksis

    bigint count([distinct|all] <value>)
  • Deskripsi

    Mengembalikan jumlah catatan yang sesuai dengan kriteria yang ditentukan.

  • Parameter

    • distinct|all: opsional. Parameter ini menentukan apakah duplikat dihapus selama operasi penghitungan. Nilai default adalah all, yang mencakup semua catatan dalam perhitungan. Jika disetel ke distinct, hanya catatan dengan nilai unik yang dihitung.

    • nilai: wajib. Nilai parameter ini dapat berupa tipe data apa pun. Jika nilai dalam kolom yang ditentukan adalah NULL, baris yang berisi nilai tersebut tidak termasuk dalam perhitungan.

  • Nilai Pengembalian

    Nilai tipe BIGINT dikembalikan.

  • Contoh

    • Contoh 1: Hitung jumlah catatan suhu pada hari saat ini.

      count(temperature);
    • Contoh 2: Gunakan distinct untuk menghapus duplikat catatan suhu berdasarkan nilai suhu dan hitung jumlah nilai suhu.

      count(distinct temperature);

MAX

  • Sintaksis

    max(<colname>)
  • Deskripsi

    Mengembalikan nilai maksimum dari sebuah kolom.

  • Parameter

    nilai: wajib. Nama kolom. Kolom dapat berupa tipe data apa pun. Jika nilai dalam kolom yang ditentukan adalah NULL, baris yang berisi nilai tersebut tidak termasuk dalam perhitungan. Nilai tipe BOOLEAN tidak digunakan untuk perhitungan.

  • Nilai Pengembalian

    Fungsi ini mengembalikan nilai dengan tipe yang sama seperti nilai.

  • Contoh

    Hitung nilai suhu maksimum di antara catatan suhu pada hari saat ini.

    max(temperature);

MIN

  • Sintaksis

    min(<value>)
  • Deskripsi

    Mengembalikan nilai minimum dari sebuah kolom.

  • Parameter

    nilai: wajib. Nama kolom. Kolom dapat berupa tipe data apa pun. Jika nilai dalam kolom yang ditentukan adalah NULL, baris yang berisi nilai tersebut tidak termasuk dalam perhitungan. Nilai tipe BOOLEAN tidak digunakan untuk perhitungan.

  • Nilai Pengembalian

    Fungsi ini mengembalikan nilai dengan tipe yang sama seperti nilai.

  • Contoh

    Hitung nilai suhu minimum di antara catatan suhu pada hari saat ini.

    min(temperature);

SUM

  • Sintaksis

    sum(<value>)
  • Deskripsi

    Mengembalikan jumlah dari sebuah kolom.

  • Parameter

    nilai: wajib. Nama kolom. Kolom harus bertipe DOUBLE, DECIMAL, atau BIGINT. Jika nilai input adalah tipe STRING, nilai tersebut secara implisit dikonversi ke tipe DOUBLE sebelum perhitungan. Jika nilai dalam kolom yang ditentukan adalah NULL, baris yang berisi nilai tersebut tidak termasuk dalam perhitungan. Nilai tipe BOOLEAN tidak digunakan untuk perhitungan.

  • Nilai Pengembalian

    Jika parameter input adalah tipe BIGINT, nilai BIGINT dikembalikan. Jika parameter input adalah tipe DOUBLE atau STRING, nilai DOUBLE dikembalikan.

  • Contoh

    Menghitung jumlah semua nilai suhu pada hari saat ini.

    sum(temperature);