以下のドキュメントは、
system.functions システムテーブルから自動生成されています。dotProduct
導入バージョン: v21.11.0 2 つのベクトル (同じ長さのタプルまたは配列) の 内積 (スカラー積) を計算します。 対応する要素同士の積の総和を返します。 構文scalarProduct
引数
vector1— 1つ目のベクトル。Array(T)またはTuple(T)vector2— 2つ目のベクトル。1つ目のベクトルと同じサイズである必要があります。Array(T)またはTuple(T)
BFloat16 配列は Float32 として累積され、戻り値も Float32 になります。(U)Int* または Float* または Decimal
例
基本的な使い方
Query
Response
flattenTuple
導入バージョン: v22.6.0 名前付きのネストされたタプルを平坦化します。 返されるタプルの各要素は、入力タプルのパスです。 構文input— フラット化する名前付きのネストされたタプル。Tuple(n1 T1[, n2 T2, ... ])
Tuple(T)
例
使用例
Query
Response
tuple
導入バージョン: v1.1.0 入力引数をまとめて、タプルを返します。 型がそれぞれ T1, T2, … のカラム C1, C2, … に対し、それらの名前が一意で、かつ引用符なしの識別子として扱える場合は、それらのカラムを含む名前付き Tuple(C1 T1, C2 T2, …) 型のタプルを返します。そうでない場合は、Tuple(T1, T2, …) が返されます。この関数の実行コストはありません。 タプルは通常、IN 演算子の引数の中間値として、またはラムダ関数の仮引数のリストを作成するために使用されます。タプルはテーブルには書き込めません。 この関数は演算子(x, y, ...) を実装します。
構文
- なし。
Query
Response
tupleConcat
導入バージョン: v23.8.0 引数として渡された複数のタプルを結合します。 構文tupleN— Tuple 型の引数を任意個指定できます。Tuple(T)
Tuple(T)
例
使用例
Query
Response
tupleDivide
導入バージョン: v21.11.0 同じサイズの2つ以上のタプルに対して、左から右の順に要素ごとの除算を行います。ゼロで除算した場合は
inf が返されます。t1— 最初の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 追加の入力タプルを1つ以上指定します。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2つのタプル
Query
Response
Query
Response
tupleDivideByNumber
導入バージョン: v21.11.0 すべての要素を数値で割ったタプルを返します。ゼロで除算すると
inf を返します。tuple— 除算対象の タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)number— 除数。(U)Int*またはFloat*またはDecimal
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
基本的な使い方
Query
Response
tupleElement
導入バージョン: v1.1.0 インデックスまたは名前を指定して、タプルから要素を取り出します。 インデックスでアクセスする場合は、1 始まりの数値インデックスを指定する必要があります。 名前でアクセスする場合は、要素名を文字列として指定できます (名前付きタプルでのみ機能します) 。 負のインデックスもサポートされています。この場合、末尾から数えた対応する要素が選択されます。たとえば、tuple.-1 はタプルの最後の要素です。
省略可能な第 3 引数では、アクセスした要素が存在しない場合に、例外をスローする代わりに返すデフォルト値を指定します。
すべての引数は定数でなければなりません。
この関数のランタイムコストはゼロで、演算子 x.index と x.name を実装しています。
構文
tuple— タプル、またはタプルの配列。Tuple(T)またはArray(Tuple(T))index— 1 から始まるカラムのインデックス。const UInt8/16/32/64name— 要素名。const Stringdefault_value— インデックスが範囲外であるか、要素が存在しない場合に返されるデフォルト値。Any
Any
例
インデックスアクセス
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
tupleHammingDistance
導入バージョン: v21.1.0 同じサイズの 2 つのタプル間のハミング距離を返します。
構文
UInt8/16/32/64
例
使用例
Query
Response
Query
Response
tupleIntDiv
導入バージョン: v23.8.0 同じサイズの2つ以上のタプルに対して、左から右の順に要素ごとの整数除算を行います。結果として、商からなるタプルを返します。 いずれかのタプルに整数以外の要素が含まれる場合は、整数でない各被除数または除数を最も近い整数に丸めて結果を計算します。 0 で除算すると、例外がスローされます。 構文t1— 最初の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 追加の入力タプルを1つ以上。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2つのタプル
Query
Response
Query
Response
Query
Response
tupleIntDivByNumber
導入バージョン: v23.8.0 分子のタプルを指定された分母で整数除算し、商のタプルを返します。 入力引数のいずれかに整数以外の要素が含まれている場合は、整数でない各分子または除数を最も近い整数に丸めて結果を計算します。 0 で除算した場合はエラーがスローされます。 構文tuple_num— 分子の値からなる Tuple。Tuple((U)Int*)orTuple(Float*)orTuple(Decimal)div— 除数の値。(U)Int*orFloat*orDecimal
Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal)
例
基本的な使い方
Query
Response
Query
Response
tupleIntDivOrZero
導入バージョン: v23.8.0tupleIntDiv と同様に、同じサイズの 2 つ以上のタプルに対して、左から右に要素ごとの整数除算を行います。
0 で除算した場合は、例外をスローする代わりにその要素について 0 を返します。
いずれかのタプルに整数以外の要素が含まれている場合は、各非整数の分子または除数を最も近い整数に丸めて結果を計算します。
構文
t1— 最初の入力 Tuple。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 1 つ以上の追加の入力 Tuple。すべての Tuple は同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
除数が 0 の場合
Query
Response
Query
Response
tupleIntDivOrZeroByNumber
導入バージョン: v23.8.0tupleIntDivByNumber と同様に、分子のタプルを指定した分母で整数除算し、商のタプルを返します。
除数が 0 の場合でもエラーは発生させず、代わりに商として 0 を返します。
タプルまたは分母に整数以外の要素が含まれている場合は、整数でない各分子または除数を最も近い整数に丸めて結果を計算します。
構文
tuple_num— 分子の値からなる Tuple。Tuple((U)Int*)orTuple(Float*)orTuple(Decimal)div— 除数の値。(U)Int*orFloat*orDecimal
0 である商を 0 とした、商の Tuple を返します。Tuple((U)Int*) or Tuple(Float*) or Tuple(Decimal)
例
基本的な使い方
Query
Response
Query
Response
tupleMinus
導入バージョン: v21.11.0 同じサイズの2つ以上のタプルについて、左から右の順に、対応する要素同士の差を計算します。 構文vectorDifference
引数
t1— 1番目の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 2番目以降の入力タプルを1つ以上指定します。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2つのタプル
Query
Response
Query
Response
tupleModulo
導入バージョン: v23.8.0 同じサイズの2つ以上のタプル同士を左から右の順に割り算し、各要素ごとの剰余をまとめたタプルを返します。 構文t1— 最初の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 追加の入力タプルを 1 つ以上。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2 つのタプル
Query
Response
Query
Response
tupleModuloByNumber
導入バージョン: v23.8.0 タプルの各要素を指定された除数で割ったときの剰余 (剰余) からなるタプルを返します。 構文tuple_num— 分子要素のタプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)div— 除数の値。(U)Int*またはFloat*またはDecimal
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
基本的な使い方
Query
Response
tupleMultiply
導入バージョン: v21.11.0 同じサイズの2つ以上のタプルの要素ごとの積を計算します。 構文t1— 1つ目の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 2つ目以降の入力タプルを1つ以上指定します。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2つのタプル
Query
Response
Query
Response
tupleMultiplyByNumber
導入バージョン: v21.11.0 すべての要素に数値を乗算したタプルを返します。 構文tuple— 乗算対象の タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)number— 乗数。(U)Int*またはFloat*またはDecimal
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
基本的な使い方
Query
Response
tupleNames
導入バージョン: v24.8.0 タプルをカラム名の配列に変換します。Tuple(a T, b T, ...) 形式のタプルに対して、タプル内の名前付きカラムを表す文字列の配列を返します。タプル要素に明示的な名前がない場合は、代わりにそのインデックスがカラム名として使用されます。
構文
- なし。
Query
Response
tupleNegate
導入バージョン: v21.11.0 タプルの各要素の符号を反転した値を計算します。 構文t— 符号反転する タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
基本的な使い方
Query
Response
tuplePlus
導入バージョン: v21.11.0 同じサイズの2つ以上のタプルの要素ごとの合計を計算します。 構文vectorSum
引数
t1— 1番目の入力タプル。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)t2, ..., tN— 追加の入力タプルを1つ以上。すべてのタプルは同じサイズである必要があります。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
2つのタプル
Query
Response
Query
Response
tuplePositiveModuloByNumber
導入バージョン: v26.4.0 タプルの各要素を指定した除数で割ったときの正の剰余からなるタプルを返します。 tupleModuloByNumber とは異なり、結果は常に非負になります。 構文tuple_num— 分子の値からなる Tuple。Tuple((U)Int*)またはTuple(Float*)またはTuple(Decimal)div— 除数の値。(U)Int*またはFloat*またはDecimal
Tuple((U)Int*) または Tuple(Float*) または Tuple(Decimal)
例
基本的な使い方
Query
Response
tupleToNameValuePairs
導入バージョン: v21.9.0 タプルを(name, value) のペアからなる配列に変換します。
たとえば、タプル Tuple(n1 T1, n2 T2, ...) は Array(Tuple('n1', T1), Tuple('n2', T2), ...) に変換されます。
タプル内のすべての値は同じ型である必要があります。
構文
tuple— 任意の型の値を含む名前付きタプル。Tuple(n1 T1[, n2 T2, ...])
(name, value) のペアからなる配列を返します。Array(Tuple(String, T))
例
名前付きタプル
Query
Response
Query
Response
untuple
呼び出し箇所で、tuple の要素を構文的に置き換えます。 結果のカラム名は実装依存で、変更される可能性があります。untuple の後で特定のカラム名を前提にしないでください。
構文
EXCEPT 式を使用すると、クエリ結果からカラムを除外できます。
引数
x—tuple関数、カラム、または要素のタプル。Tuple。
- なし。
Tuple型のカラムをuntuple関数の引数として使用する例:
Query
Response
EXCEPT 式の使用例:
Query
Response