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.

Syntax

ip_host ( ip )

Arguments

  • ip: valeur STRING représentant BINARY une adresse IPv4 ou IPv6 valide. 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.

Conditions de l’erreur

  • Si l’entrée n’est pas une adresse IPv4 ou IPv6 valide, la fonction retourne INVALID_IP_ADDRESS.

Examples

> SELECT ip_host('192.168.1.5');
  192.168.1.5

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

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

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

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

> SELECT ip_host(NULL);
  NULL

> SELECT ip_host('invalid.ip');
  Error: INVALID_IP_ADDRESS