String

REGEXP_INSTR

BigQueryBigQuery

Mengembalikan posisi (1-based) dari substring yang cocok dengan regular expression. Return 0 jika tidak ada match.

Tipe hasil: INT64Diperbarui: 16 Mei 2026

Syntax

SQL
REGEXP_INSTR(source_value, regexp [, position [, occurrence [, occurrence_position]]])

Parameter

source_valueSTRINGwajib

String yang akan dicari

regexpSTRINGwajib

Regular expression pattern

positionINT64opsional

Posisi awal pencarian

Default: 1

occurrenceINT64opsional

Occurrence ke-n yang dicari

Default: 1

occurrence_positionINT64opsional

0=awal match, 1=akhir match

Default: 0

Contoh Penggunaan

Find Pattern Position

SQL
1SELECT
2 text,
3 REGEXP_INSTR(text, r'[0-9]+') as number_pos
4FROM `project.dataset.data`;

Temukan posisi angka pertama.

Hasil
textnumber_pos
abc123def4
no numbers0

Find Second Occurrence

SQL
1SELECT
2 REGEXP_INSTR('abc123def456', r'[0-9]+', 1, 2) as second_num_pos;

Posisi occurrence kedua dari pattern.

Hasil
10

Get End Position

SQL
1SELECT
2 REGEXP_INSTR('abc123def', r'[0-9]+', 1, 1, 1) as after_number;

Posisi setelah match berakhir.

Hasil
7

Pertanyaan Umum tentang REGEXP_INSTR

Apa itu fungsi REGEXP_INSTR di BigQuery?
Mengembalikan posisi (1-based) dari substring yang cocok dengan regular expression. Return 0 jika tidak ada match. Di BigQuery, fungsi REGEXP_INSTR termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan REGEXP_INSTR di BigQuery?
Gunakan sintaks berikut: REGEXP_INSTR(source_value, regexp [, position [, occurrence [, occurrence_position]]]). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi REGEXP_INSTR?
Fungsi REGEXP_INSTR mengembalikan nilai bertipe INT64. 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 REGEXP_INSTR?
Fungsi ini memiliki 2 parameter wajib dan 3 parameter opsional. Parameter yang digunakan: source_value (STRING, wajib): String yang akan dicari; regexp (STRING, wajib): Regular expression pattern; position (INT64, opsional): Posisi awal pencarian; occurrence (INT64, opsional): Occurrence ke-n yang dicari; occurrence_position (INT64, opsional): 0=awal match, 1=akhir match.