Apa saja parameter fungsi SAFE_ORDINAL?

Fungsi ini memiliki 1 parameter wajib. Parameter yang digunakan: one_based_index (INT64, wajib): Index dimulai dari 1.

Array

SAFE_ORDINAL

BigQuery

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

Tipe hasil: Element type or NULLDiperbarui: 16 Mei 2026

Syntax

SQL

array[SAFE_ORDINAL(one_based_index)]

Parameter

one_based_indexINT64wajib

Index dimulai dari 1

Contoh Penggunaan

Safe Access by Ordinal

SQL

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

Akses aman dengan one-based index.

Hasil

first	out_of_bounds
a	NULL

Pertanyaan Umum tentang SAFE_ORDINAL

Apa itu fungsi SAFE_ORDINAL di BigQuery?

Mengakses elemen array dengan one-based index, mengembalikan NULL jika out of bounds. Di BigQuery, fungsi SAFE_ORDINAL termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.

Bagaimana cara menggunakan SAFE_ORDINAL di BigQuery?

Gunakan sintaks berikut: array[SAFE_ORDINAL(one_based_index)]. Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.

Apa nilai yang dikembalikan oleh fungsi SAFE_ORDINAL?

Fungsi SAFE_ORDINAL 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.

Ngulik Langsung

Sudah paham SAFE_ORDINAL? Latih langsung di browser

Latihan interaktif, langsung di browser.

Latihan Langsung →

Kembali ke BigQuery Functions

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