ip_cidr_contains Função

Aplica-se a: Databricks Runtime 18.2 e superior

Retorna TRUE se um endereço IP ou bloco CIDR estiver contido em outro bloco CIDR, FALSE caso contrário.

Syntax

ip_cidr_contains ( cidr, needle )

Argumentos

• cidr: um STRING valor ou BINARY um valor que representa um bloco CIDR válido.
• needle: um STRING ou BINARY valor que representa um endereço IP válido ou um bloco CIDR.

Tipos de entrada mistos (STRING e BINARY) são permitidos.

Returns

Um BOOLEAN.

Retorna TRUE se needle estiver contido dentro cidr, FALSE caso contrário.

A função retornará NULL se um dos argumentos for NULL.

Condições de erro

• Se cidr não for um bloco CIDR válido, a função retornará INVALID_CIDR_BLOCK.
• Se needle não for um endereço IP válido ou um bloco CIDR, a função retornará INVALID_IP_ADDRESS_OR_CIDR_BLOCK.

Exemplos

> SELECT ip_cidr_contains('192.168.1.0/24', '192.168.2.1');
  false

> SELECT ip_cidr_contains('2001:db8::/32', '2001:db8::1');
  true

> SELECT ip_cidr_contains('::ffff:192.168.1.0/120', '192.168.1.100');
  true

> SELECT ip_cidr_contains(X'C0A8010018', X'C0A80164');
  true

> SELECT ip_cidr_contains('192.168.1.0/24', X'C0A80164');
  true

> SELECT ip_cidr_contains(NULL, '192.168.1.1');
  NULL

> SELECT ip_cidr_contains('192.168.1.0/24', NULL);
  NULL

> SELECT ip_cidr_contains(NULL, NULL);
  NULL

> SELECT ip_cidr_contains('invalid', '192.168.1.1');
  Error: INVALID_CIDR_BLOCK

Funções relacionadas

• ip_network função
• ip_network_last função
• ip_prefix_length função