fungsi from_protobuf

Berlaku untuk:ditandai dengan ya Databricks SQL ditandai dengan ya Databricks Runtime 16.1 ke atas

Mengonversi nilai biner Protobuf menjadi menggunakan STRUCT definisi pesan Protobuf yang ditentukan.

Syntax

from_protobuf(data, messageName [, descFilePath [, options] ])
from_protobuf(data, messageName, options)

Arguments

  • data: Sebuah BINARY ekspresi yang berisi pesan Protobuf.
  • messageName: Ekspresi konstan STRING yang menamai pesan Protobuf untuk didekode.
  • descFilePath: Jalur konstanta STRING opsional ke file deskriptor Protobuf atau nilai konstan BINARY yang berisi file deskriptor. Buat file deskriptor dengan protoc --descriptor_set_out dan --include_imports. Hilangkan hanya descFilePath saat options mengonfigurasi Schema Registry.
  • options: Ekspresi konstanta MAP<STRING, STRING> opsional yang berisi opsi konversi.

Returns

A STRUCT yang bidang dan tipenya-tipenya sesuai dengan definisi pesan Protobuf.

Jika dataNULL, hasilnya adalah NULL.

Definisi pesan Protobuf harus sesuai dengan skema .data Jika skema tidak cocok, fungsi dapat gagal atau mengembalikan hasil sembarangan.

Opsi

Untuk daftar lengkap opsi, lihat Protobuf.

Examples

Contoh berikut menggunakan file deskriptor yang dihasilkan dari pesan Protobuf ini:

message Person {
  string name = 1;
  int32 id = 2;
}

Dekode nilai biner Protobuf:

> SELECT from_protobuf(
    unhex('0A05416C696365102A'),
    'Person',
    '/path/to/person.desc');
  {"name":"Alice","id":42}