Descripción general
Las funciones mencionadas en esta sección están optimizadas para ofrecer el máximo rendimiento y, en su mayor parte, no siguen el estándar RFC-3986.
Las funciones que implementan RFC-3986 llevan
RFC al final del nombre y, por lo general, son más lentas.RFC al trabajar con dominios registrados públicamente que no contienen ni cadenas de información de usuario ni símbolos @.
La tabla siguiente detalla qué símbolos de una URL pueden (✔) o no pueden (✗) analizarse con las respectivas variantes RFC y sin RFC:
Los símbolos marcados con
* son subdelimitadores en RFC 3986 y están permitidos en la información de usuario después del símbolo @.
Hay dos tipos de funciones de URL:
- Funciones que extraen partes de una URL. Si la parte correspondiente no está presente en una URL, se devuelve una cadena vacía.
- Funciones que eliminan una parte de una URL. Si la URL no tiene nada parecido, la URL permanece sin cambios.
Las funciones que aparecen a continuación se generan a partir de la tabla del sistema
system.functions.URLHierarchy
Introducido en: v1.1.0 Devuelve un array que contiene la URL truncada al final en los símbolos/, ? y # de la ruta y la cadena de consulta. Los caracteres separadores consecutivos se consideran uno solo. El resultado incluye el protocolo y el host como primer elemento, seguido de rutas cada vez más largas que forman una jerarquía.
Sintaxis
url— La URL que se debe procesar.String
Array(String)
Ejemplos
Uso básico
Query
Response
URLPathHierarchy
Introducido en: v1.1.0 Devuelve un array que contiene el componente de ruta de la URL, truncado al final por los símbolos/, ? y #. A diferencia de URLHierarchy, el resultado no incluye el protocolo ni el host; empieza en la ruta. Los caracteres separadores consecutivos se cuentan como uno.
Sintaxis
url— La URL que se va a procesar.String
Array(String)
Ejemplos
Uso básico
Query
Response
cutFragment
Introducido en: v1.1.0 Elimina el identificador de fragmento, incluida la almohadilla, de una URL. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutQueryString
Introducido en: v1.1.0 Elimina la cadena de consulta de una URL, incluido el signo de interrogación. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutQueryStringAndFragment
Introducido en: v1.1.0 Elimina la cadena de consulta y el identificador de fragmento de una URL, incluidos el signo de interrogación y el signo #. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomain
Introducido en: v1.1.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el primer subdominio significativo. Sintaxisurl— URL o cadena de dominio para procesar.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomainCustom
Introducido en: v21.1.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el primer subdominio significativo. Acepta el nombre de una lista de TLD personalizada. Esta función puede resultar útil si necesitas una lista de TLD actualizada o si tienes una lista personalizada. Ejemplo de configuraciónurl— URL o cadena de dominio que se va a procesar.Stringtld_list_name— Nombre de la lista de TLD personalizada configurada en ClickHouse.const String
String
Ejemplos
Uso de una lista de TLD personalizada para dominios no estándar
Query
Response
cutToFirstSignificantSubdomainCustomRFC
Introducido en: v22.10.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el primer subdominio significativo. Acepta el nombre de una lista de TLD personalizada. Esta función puede ser útil si necesitas una lista de TLD actualizada o si tienes una lista personalizada. Similar a cutToFirstSignificantSubdomainCustom, pero conforme con RFC 3986. Ejemplo de configuraciónurl— URL o cadena de dominio que se procesará según la RFC 3986. -tld_list_name— Nombre de la lista de TLD personalizada configurada en ClickHouse.
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomainCustomWithWWW
Introducido en: v21.1.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el primer subdominio significativo, sin eliminar ‘www’. Acepta el nombre de una lista de TLD personalizada. Puede ser útil si necesita una lista de TLD actualizada o si tiene una lista personalizada. Ejemplo de configuraciónurl— URL o cadena de dominio que se procesará. -tld_list_name— Nombre de la lista de TLD personalizada configurada en ClickHouse.
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomainCustomWithWWWRFC
Introducido en: v22.10.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el primer subdominio significativo, sin eliminarwww.
Acepta un nombre de lista de TLD personalizada.
Puede resultar útil si necesitas una lista de TLD actualizada o si tienes una lista personalizada.
Es similar a cutToFirstSignificantSubdomainCustomWithWWW, pero cumple con RFC 3986.
Ejemplo de configuración
url— URL o cadena de dominio que se procesará conforme a RFC 3986. -tld_list_name— Nombre de la lista de TLD personalizada configurada en ClickHouse.
www. String
Ejemplos
Análisis según RFC 3986 que conserva www con una lista de TLD personalizada
Query
Response
cutToFirstSignificantSubdomainRFC
Introducido en: v22.10.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el “primer subdominio significativo”. Es similar acutToFirstSignificantSubdomain, pero cumple con RFC 3986.
Sintaxis
url— URL o cadena de dominio que se va a procesar según la RFC 3986.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomainWithWWW
Introducido en: v20.12.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el “primer subdominio significativo”, sin eliminar ‘www.’. Es similar acutToFirstSignificantSubdomain, pero conserva el prefijo ‘www.’ si está presente.
Sintaxis
url— URL o cadena de dominio que se va a procesar.String
String
Ejemplos
Ejemplo de uso
Query
Response
cutToFirstSignificantSubdomainWithWWWRFC
Introducido en: v22.10.0 Devuelve la parte del dominio que incluye los subdominios de nivel superior hasta el “primer subdominio significativo”, sin eliminar ‘www’. Es similar acutToFirstSignificantSubdomainWithWWW, pero cumple con RFC 3986.
Sintaxis
url— URL o cadena de dominio que se procesará según la RFC 3986.
String
Ejemplos
Ejemplo de uso
Query
Response
cutURLParameter
Introducido en: v1.1.0 Elimina la primera aparición dename=value de cada parámetro solicitado de una URL.
Solo se buscan parámetros escritos como name=, por lo que un parámetro de indicador sin valor se deja intacto; por ejemplo, cutURLParameter('http://bigmir.net/?a&c=d', 'a') devuelve la URL sin cambios.
Esta función no codifica ni descodifica los caracteres de los nombres de los parámetros; por ejemplo, Client ID y Client%20ID se tratan como nombres de parámetro distintos.
Sintaxis
url— URL.Stringname— Nombre del parámetro de la URL.StringoArray(String)
name=value de cada parámetro solicitado eliminada. String
Ejemplos
Ejemplo de uso
Query
Response
cutWWW
Introducido en: v1.1.0 Elimina el prefijowww. del dominio de la URL, si está presente.
Sintaxis
url— URL.String
www. eliminado del dominio. String
Ejemplos
Ejemplo de uso
Query
Response
decodeURLComponent
Introducido en: v1.1.0 Toma una cadena codificada en URL como entrada y la decodifica para devolverla a su forma original y legible. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
decodeURLFormComponent
Introducido en: v1.1.0 Decodifica cadenas codificadas en URL según las reglas de codificación de formularios (RFC-1866), donde los signos+ se convierten en espacios y se decodifican los caracteres codificados mediante porcentaje.
Sintaxis
url_decode
Argumentos
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
domain
Introducido en: v1.1.0 Extrae el hostname de una URL. La URL puede especificarse con o sin protocolo. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
domainRFC
Introducido en: v22.10.0 Extrae el hostname de una URL. Similar adomain, pero cumple con RFC 3986.
Sintaxis
url_extract_host
Argumentos
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
domainWithoutWWW
Introducido en: v1.1.0 Devuelve el dominio de una URL sin el prefijowww., si está presente.
Sintaxis
url— URL.String
www. al principio); de lo contrario, devuelve una cadena vacía. String
Ejemplos
Ejemplo de uso
Query
Response
domainWithoutWWWRFC
Introducido en: v1.1.0 Devuelve el dominio sinwww. al principio, si está presente. Es similar a domainWithoutWWW, pero cumple con la RFC 3986.
Sintaxis
url— URL.String
www. al principio); de lo contrario, devuelve una cadena vacía. String
Ejemplos
Ejemplo de uso
Query
Response
encodeURLComponent
Introducido en: v22.3.0 Toma una cadena normal y la convierte a un formato codificado para URL (codificación porcentual), en el que los caracteres especiales se reemplazan por sus equivalentes de codificación porcentual. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
encodeURLFormComponent
Introducido en: v22.3.0 Codifica cadenas según las reglas de codificación de formularios (RFC-1866), donde los espacios se convierten en signos + y los caracteres especiales se codifican mediante codificación porcentual. Sintaxisurl_encode
Argumentos
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
extractURLParameter
Introducido en: v1.1.0 Devuelve el valor del parámetroname de la URL, si está presente; de lo contrario, devuelve una cadena vacía.
Si hay varios parámetros con este nombre, se devuelve la primera coincidencia.
La función asume que el parámetro del argumento url está codificado de la misma forma que el argumento name.
Sintaxis
String
Ejemplos
Ejemplo de uso
Query
Response
extractURLParameterNames
Introducido en: v1.1.0 Devuelve un array con las cadenas correspondientes a los nombres de los parámetros de URL. Los valores no se decodifican. Sintaxisurl— URL.String
Array(String)
Ejemplos
Ejemplo de uso
Query
Response
extractURLParameters
Introducido en: v1.1.0 Devuelve un array de cadenasname=value correspondientes a los parámetros de URL.
Los valores no se decodifican.
Sintaxis
url— URL.String
name=value correspondiente a los parámetros de URL. Array(String)
Ejemplos
Ejemplo de uso
Query
Response
firstSignificantSubdomain
Introducido en: v1.1.0 Devuelve el “primer subdominio significativo”. El primer subdominio significativo es un dominio de segundo nivel si es ‘com’, ‘net’, ‘org’ o ‘co’. En caso contrario, es un dominio de tercer nivel. Por ejemplo, firstSignificantSubdomain(‘https://news.clickhouse.com/') = ‘clickhouse’, firstSignificantSubdomain (‘https://news.clickhouse.com.tr/') = ‘clickhouse’. La lista de dominios de segundo nivel “insignificantes” y otros detalles de implementación podrían cambiar en el futuro. Sintaxis- Ninguno.
Query
Response
firstSignificantSubdomainCustom
Introducido en: v21.1.0 Devuelve el primer subdominio significativo de una URL a partir de una lista personalizada de TLD (dominios de nivel superior). El nombre de la lista personalizada de TLD hace referencia a una configuración que define qué sufijos de dominio deben tratarse como dominios de nivel superior. Esto resulta útil para jerarquías de TLD no estándar. La función utiliza un algoritmo simplificado de análisis de URL que asume que se han eliminado el protocolo y todo lo que le sigue. Sintaxisurl— La URL de la que se extrae el subdominio.Stringtld_list_name— Nombre de la lista personalizada de TLD de la configuración.String
String
Ejemplos
Uso básico
Query
Response
firstSignificantSubdomainCustomRFC
Introducido en: v22.10.0 Similar afirstSignificantSubdomainCustom, pero utiliza un análisis de URL compatible con RFC 3986 en lugar del algoritmo simplificado.
Sintaxis
url— La URL de la que extraer el subdominio.Stringtld_list_name— Nombre de la lista de TLD personalizada de la configuración.String
String
Ejemplos
Uso básico
Query
Response
firstSignificantSubdomainRFC
Introducido en: v22.10.0 Devuelve el “primer subdominio significativo” de acuerdo con la RFC 1034. Sintaxis- Ninguno.
fragment
Introducido en: v1.1.0 Devuelve el identificador del fragmento sin el símbolo hash inicial. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
netloc
Introducido en: v20.5.0 Extrae la ubicación de red (username:password@host:port) de una URL.
Sintaxis
url— URL.String
username:password@host:port a partir de una URL dada. String
Ejemplos
Ejemplo de uso
Query
Response
path
Introducido en: v1.1.0 Devuelve la ruta de una URL sin la cadena de consulta. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
pathFull
Introducido en: v1.1.0 Igual quepath, pero incluye la cadena de consulta y el fragmento de la URL.
Sintaxis
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
port
Introducido en: v20.5.0 Devuelve el puerto de una URL, odefault_port si la URL no incluye ningún puerto o no se puede analizar.
Sintaxis
url— URL.Stringdefault_port— Opcional. Número de puerto predeterminado que se devolverá.0de forma predeterminada.UInt16
UInt16
Ejemplos
Ejemplo de uso
Query
Response
portRFC
Introducido en: v22.10.0 Devuelve el puerto odefault_port si la URL no contiene ningún puerto o no se puede analizar.
Similar a port, pero conforme a RFC 3986.
Sintaxis
url— URL.Stringdefault_port— Opcional. Número de puerto predeterminado que se devuelve.0de forma predeterminada.UInt16
UInt16
Ejemplos
Ejemplo de uso
Query
Response
protocol
Introducido en: v1.1.0 Extrae el protocolo de una URL. Ejemplos de valores devueltos habituales: http, https, ftp, mailto, tel, magnet. Sintaxisurl_extract_protocol
Argumentos
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
queryString
Introducido en: v1.1.0 Devuelve la cadena de consulta de una URL sin el signo de interrogación inicial, el# ni nada de lo que aparece después de #.
Sintaxis
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
queryStringAndFragment
Introducido en: v1.1.0 Devuelve la cadena de consulta y el identificador de fragmento de una URL. Sintaxisurl— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
topLevelDomain
Introducido en: v1.1.0 Extrae el dominio de nivel superior de una URL.La URL puede especificarse con o sin protocolo.
Por ejemplo:
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response
topLevelDomainRFC
Introducido en: v22.10.0 Extrae el dominio de nivel superior de una URL. Similar atopLevelDomain, pero conforme con la RFC 3986.
Sintaxis
url— URL.String
String
Ejemplos
Ejemplo de uso
Query
Response