to_protobuf Fonction

S'applique à :coché Databricks SQL coché Databricks Runtime 16.1 et version ultérieure

Convertit a STRUCT en une valeur encodée BINARY en Protobuf en utilisant la définition spécifiée du message Protobuf.

Syntax

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

Arguments

  • data: Une STRUCT expression à encoder.
  • messageName: Une expression constante STRING nommant le message Protobuf à encoder.
  • descFilePath: Un chemin constant STRING optionnel vers un fichier descripteur Protobuf ou une valeur constante BINARY contenant le fichier descripteur. Générez le fichier descripteur avec protoc --descriptor_set_out et --include_imports. Omettez-le descFilePath uniquement lors options de la configuration d’un registre de schéma.
  • options: Une expression constante MAP<STRING, STRING> optionnelle contenant des options de conversion.

Returns

Une valeur codée BINARY en Protobuf.

Si data est NULL, le résultat est NULL.

Le schéma de data doit correspondre à la définition spécifiée du message Protobuf.

Options

Pour obtenir la liste complète des options, consultez Protobuf.

Exemples

L’exemple suivant utilise un fichier descripteur généré à partir de ce message Protobuf :

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

Codez une structure comme une valeur binaire Protobuf :

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