to_protobuf fonksiyon

Şunlar için geçerlidir:evet olarak işaretlendi Databricks SQL evet olarak işaretlendi Databricks Runtime 16.1 ve üzeri

A'yı STRUCT belirtilen Protobuf mesaj tanımı kullanılarak Protobuf kodlanmış BINARY bir değere dönüştürür.

Syntax

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

Arguments

  • data: Kodlanacak bir STRUCT ifade.
  • messageName: Protobuf mesajını kodlamak için adlandıran sabit STRING bir ifade.
  • descFilePath: Protobuf tanımlayıcı dosyasına veya tanımlayıcı dosyayı içeren sabit BINARY bir değere isteğe bağlı sabit STRING bir yol. Tanımlayıcı dosyayı ve protoc --descriptor_set_out--include_importsile oluşturun. Yalnızca bir Şema Kaydı yapılandırıldığında options çıkardescFilePath.
  • options: Dönüştürme seçenekleri içeren isteğe bağlı sabit MAP<STRING, STRING> bir ifade.

Returns

Protobuf kodlanmış BINARY bir değer.

Eğer dataNULL ise, sonuç NULL olur.

Şeması, data belirtilen Protobuf mesaj tanımıyla eşleşmelidir.

Options

Seçeneklerin tam listesi için bkz. Protobuf.

Examples

Aşağıdaki örnek, bu Protobuf mesajından oluşturulan bir tanımlayıcı dosyayı kullanır:

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

Bir strukturu ikili Protobuf değeri olarak kodlayın:

> SELECT hex(to_protobuf(
    named_struct('name', 'Alice', 'id', 42),
    'Person',
    '/path/to/person.desc'));
  0A05416C696365102A