La siguiente documentación se genera a partir de la tabla del sistema
system.functions.dotProduct
Introducido en: v21.11.0 Calcula el producto escalar (también llamado producto punto) de dos vectores (tuplas o arrays del mismo tamaño). Devuelve la suma de los productos de los elementos correspondientes. SintaxisscalarProduct
Argumentos
vector1— Primer vector.Array(T)oTuple(T)vector2— Segundo vector. Debe tener el mismo tamaño que el primer vector.Array(T)oTuple(T)
BFloat16 acumulan en Float32 y devuelven Float32. (U)Int* o Float* o Decimal
Ejemplos
Uso básico
Query
Response
flattenTuple
Introducido en: v22.6.0 Aplana una tupla nombrada y anidada. Los elementos de la tupla resultante son las rutas de la tupla de entrada. Sintaxisinput— Tupla nombrada y anidada que se va a aplanar.Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
Ejemplos
Ejemplo de uso
Query
Response
tuple
Introducido en: v1.1.0 Devuelve una tupla agrupando los argumentos de entrada. Para las columnas C1, C2, … con los tipos T1, T2, …, devuelve una tupla con nombre de tipo Tuple(C1 T1, C2 T2, …) que contiene estas columnas si sus nombres son únicos y pueden tratarse como identificadores sin comillas; de lo contrario, devuelve una Tuple(T1, T2, …). La ejecución de la función no tiene ningún coste. Las tuplas se usan normalmente como valores intermedios para un argumento de los operadores IN o para crear una lista de parámetros formales de funciones lambda. Las tuplas no se pueden escribir en una tabla. La función implementa el operador(x, y, ...).
Sintaxis
- Ninguno.
Query
Response
tupleConcat
Introducido en: v23.8.0 Combina las tuplas que se pasan como argumentos. SintaxistupleN— Número arbitrario de argumentos de tipo Tuple.Tuple(T)
Tuple(T)
Ejemplos
Ejemplo de uso
Query
Response
tupleDivide
Introducido en: v21.11.0 Calcula la división elemento a elemento de dos o más tuplas del mismo tamaño, de izquierda a derecha.La división por cero devuelve
inf.t1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
tupleDivideByNumber
Introducido en: v21.11.0 Devuelve una tupla cuyos elementos se dividen por un número.La división por cero devuelve
inf.tuple— Tupla que se divide.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)number— Divisor.(U)Int*oFloat*oDecimal
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
tupleElement
Introducido en: v1.1.0 Extrae un elemento de una tupla por índice o por nombre. Para acceder por índice, se espera un índice numérico que empieza en 1. Para acceder por nombre, el nombre del elemento puede proporcionarse como una cadena (solo funciona con tuplas con nombre). Se admiten índices negativos. En este caso, se selecciona el elemento correspondiente, numerado desde el final. Por ejemplo,tuple.-1 es el último elemento de la tupla.
Un tercer argumento opcional especifica un valor predeterminado que se devuelve en lugar de lanzar una excepción cuando el elemento al que se accede no existe.
Todos los argumentos deben ser constantes.
Esta función tiene un coste de ejecución nulo e implementa los operadores x.index y x.name.
Sintaxis
tuple— Una tupla o un array de tuplas.Tuple(T)oArray(Tuple(T))index— Índice de columna, empezando por 1.const UInt8/16/32/64name— Nombre del elemento.const Stringdefault_value— Valor predeterminado que se devuelve cuando el índice está fuera de rango o el elemento no existe.Any
Any
Ejemplos
Acceso por índice
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
Introducido en: v21.1.0 Devuelve la distancia de Hamming entre dos tuplas del mismo tamaño.El tipo del resultado se determina del mismo modo que en las funciones aritméticas, en función del número de elementos de las tuplas de entrada.
UInt8/16/32/64
Ejemplos
Ejemplo de uso
Query
Response
Query
Response
tupleIntDiv
Introducido en: v23.8.0 Realiza la división entera elemento por elemento de dos o más tuplas del mismo tamaño, de izquierda a derecha. Devuelve una tupla de cocientes. Si alguna tupla contiene elementos no enteros, el resultado se calcula redondeando al entero más cercano cada numerador o divisor no entero. La división por 0 genera una excepción. Sintaxist1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
Introducido en: v23.8.0 Realiza la división entera de una tupla de numeradores entre un denominador dado y devuelve una tupla con los cocientes. Si alguno de los parámetros de entrada contiene elementos no enteros, el resultado se calcula redondeando al entero más cercano cada numerador o divisor no entero. Se generará un error en caso de división por 0. Sintaxistuple_num— Tuple de valores del numerador.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)div— El valor del divisor.(U)Int*oFloat*oDecimal
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
Query
Response
tupleIntDivOrZero
Introducido en: v23.8.0 Al igual quetupleIntDiv, realiza la división entera elemento por elemento de dos o más tuplas del mismo tamaño, aplicada de izquierda a derecha.
En caso de división por 0, devuelve 0 para ese elemento en lugar de generar una excepción.
Si alguna de las tuplas contiene elementos no enteros, el resultado se calcula redondeando al entero más cercano cada numerador o divisor no entero.
Sintaxis
t1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las Tuple deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Con divisores iguales a cero
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
Introducido en: v23.8.0 Al igual quetupleIntDivByNumber, realiza la división entera de una tupla de numeradores entre un denominador dado y devuelve una tupla con los cocientes.
No genera un error si el divisor es cero, sino que devuelve el cociente como cero.
Si la tupla o el divisor contienen elementos no enteros, el resultado se calcula redondeando al entero más cercano cada numerador o divisor no entero.
Sintaxis
tuple_num— Tupla de valores del numerador.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)div— El valor del divisor.(U)Int*oFloat*oDecimal
0 en los casos en que el divisor es 0. Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
Query
Response
tupleMinus
Introducido en: v21.11.0 Calcula la diferencia entre los elementos correspondientes de dos o más tuplas del mismo tamaño, de izquierda a derecha. SintaxisvectorDifference
Argumentos
t1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
tupleModulo
Introducido en: v23.8.0 Devuelve una tupla de restos, elemento por elemento, al dividir dos o más tuplas del mismo tamaño, de izquierda a derecha. Sintaxist1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
tupleModuloByNumber
Introducido en: v23.8.0 Devuelve una tupla con los módulos (restos) de dividir una tupla entre un divisor dado. Sintaxistuple_num— Tupla con los elementos del numerador.Tuple((U)Int*)orTuple(Float*)orTuple(Decimal)div— El valor del divisor.(U)Int*orFloat*orDecimal
Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
tupleMultiply
Introducido en: v21.11.0 Calcula el producto elemento por elemento de dos o más tuplas del mismo tamaño. Sintaxist1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
tupleMultiplyByNumber
Introducido en: v21.11.0 Devuelve una tupla con todos sus elementos multiplicados por un número. Sintaxistuple— Tupla que se va a multiplicar.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)number— Multiplicador.(U)Int*oFloat*oDecimal
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
tupleNames
Introducido en: v24.8.0 Convierte una tupla en un array de nombres de columnas. Para una tupla con la formaTuple(a T, b T, ...), devuelve un array de cadenas que representan los nombres de las columnas de la tupla. Si los elementos de la tupla no tienen nombres explícitos, se usarán sus índices como nombres de columna.
Sintaxis
- Ninguno.
Query
Response
tupleNegate
Introducido en: v21.11.0 Calcula la negación de los elementos de la tupla. Sintaxist— Tuple que se va a negar.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
tuplePlus
Introducido en: v21.11.0 Calcula la suma de los elementos correspondientes de dos o más tuplas del mismo tamaño. SintaxisvectorSum
Argumentos
t1— Primera tupla de entrada.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)t2, ..., tN— Una o más tuplas de entrada adicionales. Todas las tuplas deben tener el mismo tamaño.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Dos tuplas
Query
Response
Query
Response
tuplePositiveModuloByNumber
Introducido en: v26.4.0 Devuelve una tupla con los módulos positivos (restos) de las divisiones entre una tupla y un divisor dado. A diferencia de tupleModuloByNumber, el resultado siempre es no negativo. Sintaxistuple_num— Tuple de valores del numerador.Tuple((U)Int*)oTuple(Float*)oTuple(Decimal)div— El valor del divisor.(U)Int*oFloat*oDecimal
Tuple((U)Int*) o Tuple(Float*) o Tuple(Decimal)
Ejemplos
Uso básico
Query
Response
tupleToNameValuePairs
Introducido en: v21.9.0 Convierte una tupla en un Array de pares(name, value).
Por ejemplo, la tupla Tuple(n1 T1, n2 T2, ...) se convierte en Array(Tuple('n1', T1), Tuple('n2', T2), ...).
Todos los valores de la tupla deben ser del mismo tipo.
Sintaxis
tuple— Tupla con nombre con valores de cualquier tipo.Tuple(n1 T1[, n2 T2, ...])
(name, value). Array(Tuple(String, T))
Ejemplos
Tupla con nombre
Query
Response
Query
Response
untuple
Realiza la sustitución sintáctica de los elementos de tuple en el lugar donde se invoca. Los nombres de las columnas de resultado dependen de la implementación y pueden cambiar. No asuma nombres de columna específicos después deuntuple.
Sintaxis
EXCEPT para omitir columnas en el resultado de la consulta.
Argumentos
x— Una funcióntuple, una columna o una tupla de elementos. Tuple.
- Ninguno.
Tuple como parámetro de la función untuple:
Query
Response
EXCEPT:
Query
Response