Partager via


to_binary

Convertit l’entrée col en valeur binaire en fonction de l’élément fourni format. Il format peut s’agir d’un littéral de chaîne non sensible à la casse « hex », « utf-8 », « utf8 » ou « base64 ». Par défaut, le format binaire pour la conversion est « hexadécimal » s’il format est omis. La fonction retourne NULL si au moins un des paramètres d’entrée est NULL.

Pour obtenir plus de détails sur la fonction SQL de Databricks correspondante, consultez to_binary.

Syntaxe

from pyspark.databricks.sql import functions as dbf

dbf.to_binary(col=<col>, format=<format>)

Paramètres

Paramètre Type Descriptif
col pyspark.sql.Column ou str Colonne ou chaînes d’entrée.
format pyspark.sql.Column ou str, optional format à utiliser pour convertir des valeurs binaires.

Examples

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([("abc",)], ["e"])
df.select(dbf.try_to_binary(df.e, dbf.lit("utf-8")).alias('r')).collect()
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([("414243",)], ["e"])
df.select(dbf.try_to_binary(df.e).alias('r')).collect()