Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S'applique à :
Databricks SQL Databricks Runtime 16.1 et version ultérieure
Convertit une valeur binaire de Protobuf en a STRUCT en utilisant la définition spécifiée du message Protobuf.
Syntax
from_protobuf(data, messageName [, descFilePath [, options] ])
from_protobuf(data, messageName, options)
Arguments
-
data: UneBINARYexpression contenant un message Protobuf. -
messageName: Une expression constanteSTRINGnommant le message Protobuf à décoder. -
descFilePath: Un chemin constantSTRINGoptionnel vers un fichier descripteur Protobuf ou une valeur constanteBINARYcontenant le fichier descripteur. Générez le fichier descripteur avecprotoc --descriptor_set_outet--include_imports. Omettez-ledescFilePathuniquement lorsoptionsde la configuration d’un registre de schéma. -
options: Une expression constanteMAP<STRING, STRING>optionnelle contenant des options de conversion.
Returns
A dont les champs et types correspondent STRUCT à la définition du message Protobuf.
Si data est NULL, le résultat est NULL.
La définition du message Protobuf doit correspondre au schéma de data. Si les schémas ne correspondent pas, la fonction peut échouer ou retourner un résultat arbitraire.
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;
}
Décodez une valeur binaire de Protobuf :
> SELECT from_protobuf(
unhex('0A05416C696365102A'),
'Person',
'/path/to/person.desc');
{"name":"Alice","id":42}