La documentation ci-dessous est générée à partir de la table système
system.functions.dotProduct
Introduit dans : v21.11.0 Calcule le produit scalaire (ou produit interne) de deux vecteurs (tuples ou tableaux de même taille). Renvoie la somme des produits des éléments correspondants. SyntaxescalarProduct
Arguments
vector1— Premier vecteur.Array(T)ouTuple(T)vector2— Deuxième vecteur. Doit être de même taille que le premier vecteur.Array(T)ouTuple(T)
BFloat16 accumulent en Float32 et renvoient un Float32. (U)Int* ou Float* ou Decimal
Exemples
Utilisation de base
Query
Response
flattenTuple
Introduit dans : v22.6.0 Aplatit un tuple nommé et imbriqué. Les éléments du tuple renvoyé correspondent aux chemins du tuple d’entrée. Syntaxeinput— Tuple nommé et imbriqué à aplatir.Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
Exemples
Exemple d’utilisation
Query
Response
tuple
Introduit dans : v1.1.0 Renvoie un tuple en regroupant les arguments d’entrée. Pour les colonnes C1, C2, … de types T1, T2, …, la fonction renvoie un tuple de type nommé Tuple(C1 T1, C2 T2, …) contenant ces colonnes si leurs noms sont uniques et peuvent être interprétés comme des identifiants non quotés ; sinon, elle renvoie un Tuple(T1, T2, …). L’exécution de la fonction n’entraîne aucun coût. Les tuples sont généralement utilisés comme valeurs intermédiaires pour un argument des opérateurs IN, ou pour créer une liste de paramètres formels de fonctions lambda. Les tuples ne peuvent pas être écrits dans une table. La fonction implémente l’opérateur(x, y, ...).
Syntaxe
- Aucun.
Query
Response
tupleConcat
Introduit dans : v23.8.0 Concatène les tuples passés en arguments. SyntaxetupleN— Nombre arbitraire d’arguments de type Tuple.Tuple(T)
Tuple(T)
Exemples
Exemple d’utilisation
Query
Response
tupleDivide
Introduit dans : v21.11.0 Calcule la division élément par élément de deux tuples de même taille ou plus, en l’appliquant de gauche à droite.Une division par zéro renvoie
inf.t1— Premier tuple en entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples supplémentaires en entrée. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
tupleDivideByNumber
Introduit dans : v21.11.0 Renvoie un tuple dont chaque élément est divisé par un nombre.Une division par zéro renverra
inf.tuple— Tuple à diviser.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)number— Diviseur.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
tupleElement
Introduit dans : v1.1.0 Extrait un élément d’un tuple par index ou par nom. Pour l’accès par index, un index numérique basé sur 1 est attendu. Pour l’accès par nom, le nom de l’élément peut être fourni sous forme de chaîne (fonctionne uniquement pour les tuples nommés). Les index négatifs sont pris en charge. Dans ce cas, l’élément correspondant est sélectionné en comptant depuis la fin. Par exemple,tuple.-1 est le dernier élément du tuple.
Un troisième argument facultatif spécifie une valeur par défaut, qui est renvoyée au lieu de lever une exception lorsque l’élément demandé n’existe pas.
Tous les arguments doivent être des constantes.
Cette fonction n’a aucun coût à l’exécution et implémente les opérateurs x.index et x.name.
Syntaxe
tuple— Un tuple ou un tableau de tuples.Tuple(T)ouArray(Tuple(T))index— Indice de colonne, à partir de 1.const UInt8/16/32/64name— Nom de l’élément.const Stringdefault_value— Valeur par défaut renvoyée lorsque l’indice est hors limites ou que l’élément n’existe pas.Any
Any
Exemples
Accès par index
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
Introduit dans : v21.1.0 Renvoie la distance de Hamming entre deux tuples de même taille.Le type du résultat est déterminé de la même manière que pour les fonctions arithmétiques, en fonction du nombre d’éléments des tuples d’entrée.
UInt8/16/32/64
Exemples
Exemple d’utilisation
Query
Response
Query
Response
tupleIntDiv
Introduit dans : v23.8.0 Effectue la division entière élément par élément de deux tuples ou plus de même taille, de gauche à droite. Renvoie un tuple de quotients. Si un tuple contient des éléments non entiers, le résultat est calculé en arrondissant chaque numérateur ou diviseur non entier à l’entier le plus proche. Une division par 0 entraîne une exception. Syntaxet1— Premier tuple en entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples en entrée supplémentaires. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
Introduit dans : v23.8.0 Effectue la division entière d’un tuple de numérateurs par un dénominateur donné et renvoie un tuple de quotients. Si l’un des paramètres d’entrée contient des éléments non entiers, le résultat est calculé en arrondissant à l’entier le plus proche chaque numérateur ou diviseur non entier. Une erreur est levée en cas de division par 0. Syntaxetuple_num— Tuple de valeurs du numérateur.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— La valeur du diviseur.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
Query
Response
tupleIntDivOrZero
Introduit dans : v23.8.0 CommetupleIntDiv, effectue une division entière élément par élément sur deux tuples ou plus de même taille, en l’appliquant de gauche à droite.
En cas de division par 0, renvoie 0 pour l’élément concerné au lieu de lever une exception.
Si un tuple contient des éléments non entiers, le résultat est calculé en arrondissant à l’entier le plus proche chaque numérateur ou diviseur non entier.
Syntaxe
t1— Premier tuple d’entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples d’entrée supplémentaires. Tous les tuples doivent avoir la même longueur.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Avec des diviseurs nuls
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
Introduit dans : v23.8.0 CommetupleIntDivByNumber, cette fonction effectue la division entière d’un Tuple de numérateurs par un dénominateur donné et renvoie un Tuple de quotients.
Elle ne génère pas d’erreur en cas de diviseur nul, mais renvoie à la place un quotient de zéro.
Si le Tuple ou le diviseur contient des éléments non entiers, le résultat est calculé en arrondissant chaque numérateur ou diviseur non entier à l’entier le plus proche.
Syntaxe
tuple_num— Tuple des valeurs du numérateur.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— La valeur du diviseur.(U)Int*ouFloat*ouDecimal
0 pour ceux dont le diviseur est 0. Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
Query
Response
tupleMinus
Introduit dans : v21.11.0 Calcule, de gauche à droite, la différence élément par élément entre deux tuples ou plus de même taille. SyntaxevectorDifference
Arguments
t1— Premier tuple en entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples en entrée supplémentaires. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
tupleModulo
Introduit dans : v23.8.0 Renvoie un tuple de restes calculés élément par élément en divisant deux tuples ou plus de même taille, de gauche à droite. Syntaxet1— Premier tuple en entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples en entrée supplémentaires. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
tupleModuloByNumber
Introduit dans : v23.8.0 Renvoie un tuple des modulos (restes) des divisions d’un tuple par un diviseur donné. Syntaxetuple_num— Tuple des éléments du numérateur.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— La valeur du diviseur.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
tupleMultiply
Introduit dans : v21.11.0 Calcule le produit élément par élément de deux tuples ou plus de même taille. Syntaxet1— Premier tuple d’entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples d’entrée supplémentaires. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
tupleMultiplyByNumber
Introduit dans : v21.11.0 Renvoie un tuple dont tous les éléments sont multipliés par un nombre. Syntaxetuple— Tuple à multiplier.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)number— Multiplicateur.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
tupleNames
Introduit dans : v24.8.0 Convertit un tuple en tableau de noms de colonnes. Pour un tuple de la formeTuple(a T, b T, ...), renvoie un tableau de chaînes de caractères représentant les noms des colonnes du tuple. Si les éléments du tuple n’ont pas de noms explicites, leurs indices sont utilisés à la place comme noms de colonnes.
Syntaxe
- Aucun.
Query
Response
tupleNegate
Introduit dans : v21.11.0 Calcule l’opposé des éléments du tuple. Syntaxet— Tuple dont il faut prendre l’opposé.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
tuplePlus
Introduit dans : v21.11.0 Calcule la somme élément par élément de deux tuples ou plus de même taille. SyntaxevectorSum
Arguments
t1— Premier tuple en entrée.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)t2, ..., tN— Un ou plusieurs tuples en entrée supplémentaires. Tous les tuples doivent avoir la même taille.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Deux tuples
Query
Response
Query
Response
tuplePositiveModuloByNumber
Introduit dans : v26.4.0 Renvoie un tuple des modulos positifs (restes) des divisions d’un tuple par un diviseur donné. Contrairement à tupleModuloByNumber, le résultat est toujours non négatif. Syntaxetuple_num— Tuple contenant les valeurs du numérateur.Tuple((U)Int*)ouTuple(Float*)ouTuple(Decimal)div— La valeur du diviseur.(U)Int*ouFloat*ouDecimal
Tuple((U)Int*) ou Tuple(Float*) ou Tuple(Decimal)
Exemples
Utilisation de base
Query
Response
tupleToNameValuePairs
Introduit dans : v21.9.0 Convertit un tuple en un tableau de paires(nom, valeur).
Par exemple, le tuple Tuple(n1 T1, n2 T2, ...) est converti en Array(Tuple('n1', T1), Tuple('n2', T2), ...).
Toutes les valeurs du tuple doivent être du même type.
Syntaxe
tuple— tuple nommé contenant des valeurs de tout type.Tuple(n1 T1[, n2 T2, ...])
(name, value). Array(Tuple(String, T))
Exemples
tuple nommé
Query
Response
Query
Response
untuple
Effectue une substitution syntaxique des éléments tuple dans l’appel. Les noms des colonnes du résultat dépendent de l’implémentation et peuvent changer. Ne supposez pas de noms de colonnes spécifiques aprèsuntuple.
Syntaxe
EXCEPT pour exclure des colonnes du résultat de la requête.
Arguments
x— Une fonctiontuple, une colonne ou un tuple d’éléments. Tuple.
- Aucune.
Tuple comme paramètre de la fonction untuple :
Query
Response
EXCEPT :
Query
Response