A documentação abaixo é gerada a partir da tabela de sistema
system.functions.dotProduct
Introduzido em: v21.11.0 Calcula o produto escalar (produto interno) de dois vetores (tuplas ou arrays de mesmo tamanho). Retorna a soma dos produtos dos elementos correspondentes. SintaxescalarProduct
Argumentos
vector1— Primeiro vetor.Array(T)ouTuple(T)vector2— Segundo vetor. Deve ter o mesmo tamanho do primeiro vetor.Array(T)ouTuple(T)
BFloat16 acumulam e retornam Float32. (U)Int* ou Float* ou Decimal
Exemplos
Uso básico
Query
Response
flattenTuple
Introduzido em: v22.6.0 Achata uma tupla nomeada e aninhada. Os elementos da tupla retornada são os caminhos da tupla de entrada. Sintaxeinput— Tupla nomeada e aninhada a ser achatada.Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
Exemplos
Exemplo de uso
Query
Response
tuple
Introduzido em: v1.1.0 Retorna uma tupla agrupando os argumentos de entrada. Para as colunas C1, C2, … com os tipos T1, T2, …, retorna uma tupla do tipo nomeado Tuple(C1 T1, C2 T2, …) contendo essas colunas se os nomes forem únicos e puderem ser tratados como identificadores sem aspas; caso contrário, retorna Tuple(T1, T2, …). Não há custo para executar a função. Tuplas normalmente são usadas como valores intermediários para um argumento de operadores IN ou para criar uma lista de parâmetros formais de funções lambda. Tuplas não podem ser gravadas em uma tabela. A função implementa o operador(x, y, ...).
Sintaxe
- Nenhum.
Query
Response
tupleConcat
Introduzido em: v23.8.0 Combina as tuplas passadas como argumentos. SintaxetupleN— Quantidade arbitrária de argumentos do tipo Tuple.Tuple(T)
Tuple(T)
Exemplos
Exemplo de uso
Query
Response
tupleDivide
Introduzido em: v21.11.0 Calcula a divisão elemento a elemento de duas ou mais tuplas do mesmo tamanho, da esquerda para a direita.A divisão por zero retornará
inf.t1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
tupleDivideByNumber
Introduzido em: v21.11.0 Retorna uma tupla com todos os elementos divididos por um número.A divisão por zero retorna
inf.tuple— tupla a ser dividida.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)number— Divisor.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
tupleElement
Introduzido em: v1.1.0 Extrai um elemento de uma tupla por índice ou nome. Para acesso por índice, espera-se um índice numérico com base 1. Para acesso por nome, o nome do elemento pode ser fornecido como uma string (funciona apenas para tuplas nomeadas). Índices negativos são suportados. Nesse caso, o elemento correspondente é selecionado, numerado a partir do fim. Por exemplo,tuple.-1 é o último elemento da tupla.
Um terceiro argumento opcional especifica um valor padrão, retornado em vez de lançar uma exceção quando o elemento acessado não existe.
Todos os argumentos devem ser constantes.
Esta função não tem custo em tempo de execução e implementa os operadores x.index e x.name.
Sintaxe
tuple— Uma tupla ou um array de tuplas.Tuple(T)ouArray(Tuple(T))index— Índice da coluna, a partir de 1.const UInt8/16/32/64name— Nome do elemento.const Stringdefault_value— Valor padrão retornado quando o índice está fora dos limites ou o elemento não existe.Any
Any
Exemplos
Acesso por índice
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
Introduzido em: v21.1.0 Retorna a distância de Hamming entre duas tuplas do mesmo tamanho.O tipo do resultado é determinado da mesma forma que nas funções aritméticas, com base no número de elementos nas tuplas de entrada.
UInt8/16/32/64
Exemplos
Exemplo de uso
Query
Response
Query
Response
tupleIntDiv
Introduzido em: v23.8.0 Executa a divisão inteira elemento a elemento de duas ou mais tuplas do mesmo tamanho, da esquerda para a direita. Retorna uma tupla de quocientes. Se alguma tupla contiver elementos não inteiros, o resultado será calculado arredondando cada numerador ou divisor não inteiro para o inteiro mais próximo. A divisão por 0 faz com que uma exceção seja lançada. Sintaxet1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
Introduzido em: v23.8.0 Realiza a divisão inteira de uma tupla de numeradores por um determinado denominador e retorna uma tupla com os quocientes. Se qualquer um dos parâmetros de entrada contiver elementos não inteiros, o resultado será calculado arredondando cada numerador ou divisor não inteiro para o inteiro mais próximo. Um erro será gerado em caso de divisão por 0. Sintaxetuple_num— tupla de valores do numerador.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— O valor do divisor.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
Query
Response
tupleIntDivOrZero
Introduzido na versão: v23.8.0 Assim comotupleIntDiv, realiza a divisão inteira elemento a elemento entre duas ou mais tuplas do mesmo tamanho, aplicada da esquerda para a direita.
Em caso de divisão por 0, retorna 0 para esse elemento em vez de gerar uma exceção.
Se qualquer uma das tuplas contiver elementos não inteiros, o resultado será calculado arredondando cada numerador ou divisor não inteiro para o inteiro mais próximo.
Sintaxe
t1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Com divisores iguais a zero
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
Introduzido em: v23.8.0 Assim comotupleIntDivByNumber, faz a divisão inteira de uma tupla de numeradores por um denominador especificado e retorna uma tupla com os quocientes.
Não gera um erro em caso de divisor zero; em vez disso, retorna zero como quociente.
Se a tupla ou div contiver elementos não inteiros, o resultado será calculado arredondando cada numerador ou divisor não inteiro para o inteiro mais próximo.
Sintaxe
tuple_num— tupla de valores do numerador.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— O valor do divisor.(U)Int*ouFloat*ouDecimal
0 para os quocientes cujo divisor é 0. Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
Query
Response
tupleMinus
Introduzido em: v21.11.0 Calcula a diferença elemento a elemento entre duas ou mais tuplas do mesmo tamanho, da esquerda para a direita. SintaxevectorDifference
Argumentos
t1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
tupleModulo
Introduzido em: v23.8.0 Retorna uma tupla com os restos da divisão, elemento a elemento, entre duas ou mais tuplas do mesmo tamanho, aplicada da esquerda para a direita. Sintaxet1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
tupleModuloByNumber
Introduzido em: v23.8.0 Retorna uma tupla com os módulos (restos) das operações de divisão entre uma tupla e um divisor especificado. Sintaxetuple_num— tupla dos elementos do numerador.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— O valor do divisor.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
tupleMultiply
Introduzido na versão: v21.11.0 Calcula o produto elemento a elemento de duas ou mais tuplas do mesmo tamanho. Sintaxet1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais tuplas de entrada adicionais. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
tupleMultiplyByNumber
Introduzido em: v21.11.0 Retorna uma tupla com todos os elementos multiplicados por um número. Sintaxetuple— Tupla a ser multiplicada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)number— Multiplicador.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
tupleNames
Introduzido em: v24.8.0 Converte uma tupla em um array de nomes de colunas. Para uma tupla na formaTuple(a T, b T, ...), retorna um array de strings que representam os nomes das colunas da tupla. Se os elementos da tupla não tiverem nomes explícitos, seus índices serão usados como nomes de colunas.
Sintaxe
- Nenhum.
Query
Response
tupleNegate
Introduzido em: v21.11.0 Calcula o oposto dos elementos da tupla. Sintaxet— tupla a ser negada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
tuplePlus
Introduzido em: v21.11.0 Calcula a soma elemento a elemento de duas ou mais tuplas do mesmo tamanho. SintaxevectorSum
Argumentos
t1— Primeira tupla de entrada.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Uma ou mais outras tuplas de entrada. Todas as tuplas devem ter o mesmo tamanho.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Duas tuplas
Query
Response
Query
Response
tuplePositiveModuloByNumber
Introduzido em: v26.4.0 Retorna uma tupla com os módulos positivos (restos) das divisões entre uma tupla e um determinado divisor. Diferentemente de tupleModuloByNumber, o resultado é sempre não negativo. Sintaxetuple_num— tupla com valores do numerador.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— O valor do divisor.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemplos
Uso básico
Query
Response
tupleToNameValuePairs
Introduzido em: v21.9.0 Converte uma tupla em um array de pares(name, value).
Por exemplo, a tupla Tuple(n1 T1, n2 T2, ...) é convertida em Array(Tuple('n1', T1), Tuple('n2', T2), ...).
Todos os valores da tupla devem ser do mesmo tipo.
Sintaxe
tuple— Tupla nomeada com valores de qualquer tipo.Tuple(n1 T1[, n2 T2, ...])
(name, value). Array(Tuple(String, T))
Exemplos
Tupla nomeada
Query
Response
Query
Response
untuple
Realiza a substituição sintática de elementos tupla no ponto da chamada. Os nomes das colunas resultantes são específicos da implementação e podem mudar. Não presuma nomes de colunas específicos apósuntuple.
Sintaxe
EXCEPT para omitir colunas no resultado da consulta.
Argumentos
x— Uma funçãotuple, uma coluna ou uma tupla de elementos. Tuple.
- Nenhum.
Tuple como parâmetro da função untuple:
Query
Response
EXCEPT:
Query
Response