try_ip_host Fonction

S’applique à :check marqué oui Databricks Runtime 18.2 et versions ultérieures

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Retourne la représentation canonique d’une adresse IPv4 ou IPv6. Retourne NULL au lieu de déclencher une erreur si l’entrée n’est pas valide.

Syntax

try_ip_host ( ip )

Arguments

  • ip: valeur STRING représentant BINARY une adresse IPv4 ou IPv6. La notation CIDR n’est pas autorisée.

Returns

Le même type que l’entrée (STRING ou BINARY), représentant la forme canonique de l’adresse.

La fonction retourne NULL si l’entrée est NULL ou non valide.

Examples

> SELECT try_ip_host('192.168.1.5');
  192.168.1.5

> SELECT try_ip_host('2001:0db8:0000:0000:0000:0000:0000:0001');
  2001:db8::1

> SELECT try_ip_host('2001:DB8::1');
  2001:db8::1

> SELECT try_ip_host('::ffff:192.0.2.128');
  ::ffff:192.0.2.128

> SELECT hex(try_ip_host(X'C0A80101'));
  C0A80101

> SELECT try_ip_host('invalid');
  NULL

> SELECT try_ip_host(X'');
  NULL

> SELECT try_ip_host(NULL);
  NULL