Funciones de red en SQL estándar

NET.IP_FROM_STRING

NET.IP_FROM_STRING(addr_str)

Descripción

Convierte una dirección IPv4 o IPv6 de formato de texto (STRING) a formato binario (BYTES) en orden de bytes de red.

Esta función admite los siguientes formatos para addr_str:

  • IPv4: notación en cuatro segmentos separados por puntos. Por ejemplo, 10.1.2.3
  • IPv6: formato separado por dos puntos. Por ejemplo, 1234:5678:90ab:cdef:1234:5678:90ab:cdef. Para obtener más ejemplos, consulta arquitectura de direccionamiento de IP versión 6.

Esta función no admite la notación CIDR, como 10.1.2.3/32.

Si esta función recibe una entrada NULL, muestra NULL. Si la entrada se considera no válida, se produce un error OUT_OF_RANGE.

Tipo de datos que se muestran

BYTES

Ejemplo

SELECT
  addr_str, FORMAT("%T", NET.IP_FROM_STRING(addr_str)) AS ip_from_string
FROM UNNEST([
  '48.49.50.51',
  '::1',
  '3031:3233:3435:3637:3839:4041:4243:4445',
  '::ffff:192.0.2.128'
]) AS addr_str;
addr_str ip_from_string
48.49.50.51 b"0123"
::1 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01"
3031:3233:3435:3637:3839:4041:4243:4445 b"0123456789@ABCDE"
::ffff:192.0.2.128 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xff\xff\xc0\x00\x02\x80"

NET.SAFE_IP_FROM_STRING

NET.SAFE_IP_FROM_STRING(addr_str)

Descripción

Similar a NET.IP_FROM_STRING, pero muestra NULL en lugar de arrojar un error si la entrada no es válida.

Tipo de datos que se muestran

BYTES

Ejemplo

SELECT
  addr_str,
  FORMAT("%T", NET.SAFE_IP_FROM_STRING(addr_str)) AS safe_ip_from_string
FROM UNNEST([
  '48.49.50.51',
  '::1',
  '3031:3233:3435:3637:3839:4041:4243:4445',
  '::ffff:192.0.2.128',
  '48.49.50.51/32',
  '48.49.50',
  '::wxyz'
]) AS addr_str;
addr_str safe_ip_from_string
48.49.50.51 b"0123"
::1 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01"
3031:3233:3435:3637:3839:4041:4243:4445 b"0123456789@ABCDE"
::ffff:192.0.2.128 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xff\xff\xc0\x00\x02\x80"
48.49.50.51/32 NULL
48.49.50 NULL
::wxyz NULL

NET.IP_TO_STRING

NET.IP_TO_STRING(addr_bin)

Descripción Convierte una dirección IPv4 o IPv6 de formato binario (BYTES) en formato de orden de bytes de red a texto (STRING).

Si la entrada es de 4 bytes, esta función muestra una dirección IPv4 como una STRING. Si la entrada es de 16 bytes, muestra una dirección IPv6 como STRING.

Si esta función recibe una entrada NULL, muestra NULL. Si la entrada tiene una longitud diferente de 4 o 16, se produce un error OUT_OF_RANGE.

Tipo de datos que se muestran

STRING

Ejemplo

SELECT FORMAT("%T", x) AS addr_bin, NET.IP_TO_STRING(x) AS ip_to_string
FROM UNNEST([
  b"0123",
  b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01",
  b"0123456789@ABCDE",
  b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xff\xff\xc0\x00\x02\x80"
]) AS x;
addr_bin ip_to_string
b"0123" 48.49.50.51
b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01" ::1
b"0123456789@ABCDE" 3031:3233:3435:3637:3839:4041:4243:4445
b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xff\xff\xc0\x00\x02\x80" ::ffff:192.0.2.128

NET.IP_NET_MASK

NET.IP_NET_MASK(num_output_bytes, prefix_length)

Descripción

Muestra una máscara de red: una secuencia de bytes con una longitud igual a num_output_bytes, en la que los primeros bits de prefix_length se establecen en 1 y los otros bits se establecen en 0. num_output_bytes y prefix_length son INT64. Esta función arroja un error si num_output_bytes no es 4 (para IPv4) o 16 (para IPv6). También arroja un error si prefix_length es negativo o mayor que 8 * num_output_bytes.

Tipo de datos que se muestran

BYTES

Ejemplo

SELECT x, y, FORMAT("%T", NET.IP_NET_MASK(x, y)) AS ip_net_mask
FROM UNNEST([
  STRUCT(4 as x, 0 as y),
  (4, 20),
  (4, 32),
  (16, 0),
  (16, 1),
  (16, 128)
]);
x s ip_net_mask
4 0 b"\x00\x00\x00\x00"
4 20 b"\xff\xff\xf0\x00"
4 32 b"\xff\xff\xff\xff"
16 0 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
16 1 b"\x80\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
16 128 b"\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"

NET.IP_TRUNC

NET.IP_TRUNC(addr_bin, prefix_length)

Descripción Toma addr_bin, una dirección IPv4 o IPv6 en formato binario (BYTES) en orden de bytes de red, y muestra una dirección de subred en el mismo formato. El resultado tiene la misma longitud que addr_bin, en el que los primeros bits de prefix_length son iguales a los de addr_bin y los bits restantes son 0.

Esta función arroja un error si LENGTH(addr_bin) no es 4 o 16, o si prefix_len es negativo o mayor que LENGTH(addr_bin) * 8.

Tipo de datos que se muestran

BYTES

Ejemplo

SELECT
  FORMAT("%T", x) as addr_bin, prefix_length,
  FORMAT("%T", NET.IP_TRUNC(x, prefix_length)) AS ip_trunc
FROM UNNEST([
  STRUCT(b"\xAA\xBB\xCC\xDD" as x, 0 as prefix_length),
  (b"\xAA\xBB\xCC\xDD", 11), (b"\xAA\xBB\xCC\xDD", 12),
  (b"\xAA\xBB\xCC\xDD", 24), (b"\xAA\xBB\xCC\xDD", 32),
  (b'0123456789@ABCDE', 80)
]);
addr_bin prefix_length ip_trunc
b"\xaa\xbb\xcc\xdd" 0 b"\x00\x00\x00\x00"
b"\xaa\xbb\xcc\xdd" 11 b"\xaa\xa0\x00\x00"
b"\xaa\xbb\xcc\xdd" 12 b"\xaa\xb0\x00\x00"
b"\xaa\xbb\xcc\xdd" 24 b"\xaa\xbb\xcc\x00"
b"\xaa\xbb\xcc\xdd" 32 b"\xaa\xbb\xcc\xdd"
b"0123456789@ABCDE" 80 b"0123456789\x00\x00\x00\x00\x00\x00"

NET.IPV4_FROM_INT64

NET.IPV4_FROM_INT64(integer_value)

Descripción

Convierte una dirección IPv4 de formato de número entero en formato binario (BYTES) en orden de bytes de red. En la entrada de número entero, el bit de menos importancia de la dirección IP se almacena en el bit menos importante del número entero, independientemente de la arquitectura del host o del cliente. Por ejemplo, 1 significa 0.0.0.1 y 0x1FF significa 0.0.1.255.

Esta función comprueba que todos los 32 bits más importantes sean 0 o que todos los 33 bits más importantes sean 1 (signo extendido desde un número entero de 32 bits). En otras palabras, la entrada debe estar en el rango [-0x80000000, 0xFFFFFFFF]. De lo contrario, esta función arroja un error.

Esta función no es compatible con IPv6.

Tipo de datos que se muestran

BYTES

Ejemplo

SELECT x, x_hex, FORMAT("%T", NET.IPV4_FROM_INT64(x)) AS ipv4_from_int64
FROM (
  SELECT CAST(x_hex AS INT64) x, x_hex
  FROM UNNEST(["0x0", "0xABCDEF", "0xFFFFFFFF", "-0x1", "-0x2"]) AS x_hex
);
x x_hex ipv4_from_int64
0 0x0 b"\x00\x00\x00\x00"
11259375 0xABCDEF b"\x00\xab\xcd\xef"
4294967295 0xFFFFFFFF b"\xff\xff\xff\xff"
-1 -0x1 b"\xff\xff\xff\xff"
-2 -0x2 b"\xff\xff\xff\xfe"

NET.IPV4_TO_INT64

NET.IPV4_TO_INT64(addr_bin)

Descripción

Convierte una dirección IPv4 de formato binario (BYTES) en orden de bytes de red al formato de número entero. En la salida del número entero, el bit menos importante de la dirección IP se almacena en el bit menos importante del entero, independientemente de la arquitectura del host o del cliente. Por ejemplo, 1 significa 0.0.0.1 y 0x1FF significa 0.0.1.255. La salida está en el rango [0, 0xFFFFFFFF].

Si la longitud de entrada no es 4, esta función produce un error.

Esta función no es compatible con IPv6.

Tipo de datos que se muestran

INT64

Ejemplo

SELECT
  FORMAT("%T", x) AS addr_bin,
  FORMAT("0x%X", NET.IPV4_TO_INT64(x)) AS ipv4_to_int64
FROM
UNNEST([b"\x00\x00\x00\x00", b"\x00\xab\xcd\xef", b"\xff\xff\xff\xff"]) AS x;
addr_bin ipv4_to_int64
b"\x00\x00\x00\x00" 0x0
b"\x00\xab\xcd\xef" 0xABCDEF
b"\xff\xff\xff\xff" 0xFFFFFFFF

NET.HOST

NET.HOST(url)

Descripción

Toma una URL como STRING y muestra el host como STRING. Para obtener los mejores resultados, los valores de URL deben cumplir con el formato definido por RFC 3986. Si el valor de la URL no cumple con el formato RFC 3986, esta función hace el mejor esfuerzo para analizar la entrada y mostrar un resultado relevante. Si la función no puede analizar la entrada, muestra NULL.

Nota: La función no realiza ninguna normalización.

Tipo de datos que se muestran

STRING

Ejemplo

SELECT
  FORMAT("%T", input) AS input,
  description,
  FORMAT("%T", NET.HOST(input)) AS host,
  FORMAT("%T", NET.PUBLIC_SUFFIX(input)) AS suffix,
  FORMAT("%T", NET.REG_DOMAIN(input)) AS domain
FROM (
  SELECT "" AS input, "invalid input" AS description
  UNION ALL SELECT "http://abc.xyz", "standard URL"
  UNION ALL SELECT "//user:password@a.b:80/path?query",
                   "standard URL with relative scheme, port, path and query, but no public suffix"
  UNION ALL SELECT "https://[::1]:80", "standard URL with IPv6 host"
  UNION ALL SELECT "http://例子.卷筒纸.中国", "standard URL with internationalized domain name"
  UNION ALL SELECT "    www.Example.Co.UK    ",
                   "non-standard URL with spaces, upper case letters, and without scheme"
  UNION ALL SELECT "mailto:?to=&subject=&body=", "URI rather than URL--unsupported"
);
entrada descripción host sufijo dominio
"" entrada no válida NULL NULL NULL
"http://abc.xyz" URL estándar "abc.xyz" "xyz" "abc.xyz"
"//user:password@a.b:80/path?query" URL estándar con esquema relativo, puerto, ruta y consulta, pero sin sufijo público "a.b" NULL NULL
"https://[::1]:80" URL estándar con host IPv6 "[::1]" NULL NULL
"http://例子.卷筒纸.中国" URL estándar con nombre de dominio internacionalizado "例子.卷筒纸.中国" "中国" "卷筒纸.中国"
"    www.Example.Co.UK    " URL no estándar con espacios, letras mayúsculas y sin esquema "www.Example.Co.UK" "Co.UK" "Example.Co.UK"
"mailto:?to=&subject=&body=" URI en lugar de URL: no compatible "mailto" NULL NULL

NET.PUBLIC_SUFFIX

NET.PUBLIC_SUFFIX(url)

Descripción

Toma una URL como STRING y muestra el sufijo público (como com, org o net) como STRING. Un sufijo público es un dominio de la ICANN registrado en publicsuffix.org. Para obtener los mejores resultados, los valores de URL deben cumplir con el formato definido por RFC 3986. Si el valor de la URL no cumple con el formato RFC 3986, esta función hace el mejor esfuerzo para analizar la entrada y mostrar un resultado relevante.

Esta función muestra NULL si se cumple alguna de las siguientes condiciones:

  • No puede analizar el host a partir de la entrada ingresada;
  • El host analizado contiene puntos adyacentes en el medio (no al principio ni al final); o bien
  • El host analizado no contiene ningún sufijo público.

Antes de buscar el sufijo público, esta función normaliza temporalmente el host por medio de la conversión de las letras en inglés en mayúsculas a minúsculas y la codificación de todos los caracteres que no son ASCII con Punycode. La función luego muestra el sufijo público como parte del host original en lugar del host normalizado.

Nota: La función no realiza la normalización de Unicode.

Nota: Los datos del sufijo público en publicsuffix.org también contienen dominios privados. Esta función ignora los dominios privados.

Nota: Los datos del sufijo público pueden cambiar con el tiempo. En consecuencia, la entrada que produce un resultado NULL ahora puede producir un valor distinto de NULL en el futuro.

Tipo de datos que se muestran

STRING

Ejemplo

SELECT
  FORMAT("%T", input) AS input,
  description,
  FORMAT("%T", NET.HOST(input)) AS host,
  FORMAT("%T", NET.PUBLIC_SUFFIX(input)) AS suffix,
  FORMAT("%T", NET.REG_DOMAIN(input)) AS domain
FROM (
  SELECT "" AS input, "invalid input" AS description
  UNION ALL SELECT "http://abc.xyz", "standard URL"
  UNION ALL SELECT "//user:password@a.b:80/path?query",
                   "standard URL with relative scheme, port, path and query, but no public suffix"
  UNION ALL SELECT "https://[::1]:80", "standard URL with IPv6 host"
  UNION ALL SELECT "http://例子.卷筒纸.中国", "standard URL with internationalized domain name"
  UNION ALL SELECT "    www.Example.Co.UK    ",
                   "non-standard URL with spaces, upper case letters, and without scheme"
  UNION ALL SELECT "mailto:?to=&subject=&body=", "URI rather than URL--unsupported"
);
entrada descripción host sufijo dominio
"" entrada no válida NULL NULL NULL
"http://abc.xyz" URL estándar "abc.xyz" "xyz" "abc.xyz"
"//user:password@a.b:80/path?query" URL estándar con esquema relativo, puerto, ruta y consulta, pero sin sufijo público "a.b" NULL NULL
"https://[::1]:80" URL estándar con host IPv6 "[::1]" NULL NULL
"http://例子.卷筒纸.中国" URL estándar con nombre de dominio internacionalizado "例子.卷筒纸.中国" "中国" "卷筒纸.中国"
"    www.Example.Co.UK    " URL no estándar con espacios, letras mayúsculas y sin esquema "www.Example.Co.UK" "Co.UK" "Example.Co.UK
"mailto:?to=&subject=&body=" URI en lugar de URL: no compatible "mailto" NULL NULL

NET.REG_DOMAIN

NET.REG_DOMAIN(url)

Descripción

Toma una URL como STRING y muestra el dominio registrado o registrable (el sufijo público más una etiqueta anterior), como STRING. Para obtener los mejores resultados, los valores de URL deben cumplir con el formato definido por RFC 3986. Si el valor de la URL no cumple con el formato RFC 3986, esta función hace el mejor esfuerzo para analizar la entrada y mostrar un resultado relevante.

Esta función muestra NULL si se cumple alguna de las siguientes condiciones:

  • No puede analizar el host a partir de la entrada ingresada;
  • El host analizado contiene puntos adyacentes en el medio (no al principio ni al final);
  • El host analizado no contiene ningún sufijo público; o bien
  • El host analizado contiene solo un sufijo público sin ninguna etiqueta anterior.

Antes de buscar el sufijo público, esta función normaliza temporalmente el host por medio de la conversión de las letras mayúsculas en inglés a minúsculas y la codificación de todos los caracteres no ASCII con Punycode. Luego, la función muestra el dominio registrado o registrable como parte del host original en lugar del host normalizado.

Nota: La función no realiza la normalización de Unicode.

Nota: Los datos del sufijo público en publicsuffix.org también contienen dominios privados. Esta función no trata un dominio privado como un sufijo público. Por ejemplo, si "us.com" es un dominio privado en los datos del sufijo público, NET.REG_DOMAIN ("foo.us.com") muestra "us.com" (el sufijo público "com" más la etiqueta anterior "us") en lugar de "foo.us.com" (el dominio privado "us.com" más la etiqueta anterior "foo").

Nota: Los datos del sufijo público pueden cambiar con el tiempo. En consecuencia, la entrada que produce un resultado NULL ahora puede producir un valor distinto de NULL en el futuro.

Tipo de datos que se muestran

STRING

Ejemplo

SELECT
  FORMAT("%T", input) AS input,
  description,
  FORMAT("%T", NET.HOST(input)) AS host,
  FORMAT("%T", NET.PUBLIC_SUFFIX(input)) AS suffix,
  FORMAT("%T", NET.REG_DOMAIN(input)) AS domain
FROM (
  SELECT "" AS input, "invalid input" AS description
  UNION ALL SELECT "http://abc.xyz", "standard URL"
  UNION ALL SELECT "//user:password@a.b:80/path?query",
                   "standard URL with relative scheme, port, path and query, but no public suffix"
  UNION ALL SELECT "https://[::1]:80", "standard URL with IPv6 host"
  UNION ALL SELECT "http://例子.卷筒纸.中国", "standard URL with internationalized domain name"
  UNION ALL SELECT "    www.Example.Co.UK    ",
                   "non-standard URL with spaces, upper case letters, and without scheme"
  UNION ALL SELECT "mailto:?to=&subject=&body=", "URI rather than URL--unsupported"
);
entrada descripción host sufijo dominio
"" entrada no válida NULL NULL NULL
"http://abc.xyz" URL estándar "abc.xyz" "xyz" "abc.xyz"
"//user:password@a.b:80/path?query" URL estándar con esquema relativo, puerto, ruta y consulta, pero sin sufijo público "a.b" NULL NULL
"https://[::1]:80" URL estándar con host IPv6 "[::1]" NULL NULL
"http://例子.卷筒纸.中国" URL estándar con nombre de dominio internacionalizado "例子.卷筒纸.中国" "中国" "卷筒纸.中国"
"    www.Example.Co.UK    " URL no estándar con espacios, letras mayúsculas y sin esquema "www.Example.Co.UK" "Co.UK" "Example.Co.UK"
"mailto:?to=&subject=&body=" URI en lugar de URL: no compatible "mailto" NULL NULL
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.