All Products
Search

This Product

    MaxCompute:REGEXP_EXTRACT

    Document Center

    MaxCompute:REGEXP_EXTRACT

    Last Updated:Oct 23, 2025

    Fungsi REGEXP_EXTRACT mencari sumber string untuk kecocokan dengan ekspresi reguler pola dan mengembalikan isi dari kelompok yang ditentukan oleh group_id.

    Catatan penggunaan

    Fungsi REGEXP_EXTRACT mengikuti spesifikasi ekspresi reguler Java untuk edisi tipe data kompatibel Hive. Untuk edisi 1.0 dan 2.0 tipe data, fungsi ini mengikuti spesifikasi MaxCompute.

    Sintaks

    STRING REGEXP_EXTRACT(STRING <sumber>, STRING <pola>[, BIGINT <group_id>])

    Parameter

    • sumber: Diperlukan. Nilai bertipe STRING. Parameter ini menentukan string yang akan dicari.

    • pola: Diperlukan. Konstanta atau ekspresi reguler bertipe STRING. Parameter ini menentukan pola untuk pencocokan. Untuk informasi lebih lanjut tentang cara menulis ekspresi reguler, lihat Spesifikasi Ekspresi Reguler.

    • group_id: Opsional. Nilai bertipe BIGINT. Nilainya harus lebih besar dari atau sama dengan 0.

      • Jika group_id tidak ditentukan, nilai default adalah 1, dan fungsi mengembalikan kelompok pertama yang cocok.

      • Jika group_id ditentukan, fungsi mengembalikan isi dari kelompok yang cocok group_id.

      • Jika group_id adalah 0, fungsi mengembalikan substring yang cocok dengan seluruh pola.

    Catatan

    Data disimpan dalam format UTF-8. Rentang kode heksadesimal untuk karakter Cina adalah [\\x{4e00},\\x{9fa5}].

    Nilai pengembalian

    Nilai bertipe STRING dikembalikan. Aturan berikut berlaku:

    • Jika pola adalah string kosong, atau jika pola tidak mengandung kelompok penangkapan dan group_id tidak ditentukan, kesalahan akan dikembalikan.

      Catatan

      Jalankan SET odps.sql.bigquery.compatible=true; untuk mengaktifkan mode kompatibel BigQuery. Jika pola tidak mengandung kelompok dan group_id tidak ditentukan, fungsi mengembalikan substring yang cocok dengan seluruh pola.

    • Jika group_id bukan bertipe BIGINT atau kurang dari 0, kesalahan akan dikembalikan.

    • Jika sumber, pola, atau group_id adalah NULL, NULL akan dikembalikan.

    Fungsi terkait

    REGEXP_EXTRACT adalah fungsi string. Untuk informasi lebih lanjut tentang fungsi string lainnya, lihat Fungsi String.