Array

SAFE_OFFSET

BigQueryBigQuery

Mengakses elemen array dengan zero-based index, mengembalikan NULL jika out of bounds.

Tipe hasil: Element type or NULLDiperbarui: 16 Mei 2026

Syntax

SQL
array[SAFE_OFFSET(zero_based_index)]

Parameter

zero_based_indexINT64wajib

Index dimulai dari 0

Contoh Penggunaan

Safe Access by Offset

SQL
1SELECT
2  arr[SAFE_OFFSET(0)] as first,
3  arr[SAFE_OFFSET(10)] as out_of_bounds
4FROM (SELECT ['a', 'b', 'c'] as arr);

Akses aman tanpa error.

Hasil
firstout_of_bounds
aNULL

Pertanyaan Umum tentang SAFE_OFFSET

Apa itu fungsi SAFE_OFFSET di BigQuery?
Mengakses elemen array dengan zero-based index, mengembalikan NULL jika out of bounds. Di BigQuery, fungsi SAFE_OFFSET termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan SAFE_OFFSET di BigQuery?
Gunakan sintaks berikut: array[SAFE_OFFSET(zero_based_index)]. Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi SAFE_OFFSET?
Fungsi SAFE_OFFSET mengembalikan nilai bertipe Element type or NULL. Pastikan tipe data hasil sudah sesuai dengan kebutuhan query atau formula kamu. Jika input mengandung nilai NULL, perilaku fungsi dapat berbeda — selalu periksa dokumentasi untuk memastikan hasilnya sesuai ekspektasi.
Apa saja parameter fungsi SAFE_OFFSET?
Fungsi ini memiliki 1 parameter wajib. Parameter yang digunakan: zero_based_index (INT64, wajib): Index dimulai dari 0.
Kembali ke BigQuery Functions