mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-29 13:10:48 +00:00
d91c97d15d
* Replace underscores with hyphens * remove temporary code * fix style check * fix collapse
1080 lines
35 KiB
Markdown
1080 lines
35 KiB
Markdown
---
|
||
machine_translated: true
|
||
machine_translated_rev: d734a8e46ddd7465886ba4133bff743c55190626
|
||
toc_priority: 66
|
||
toc_title: "\u305D\u306E\u4ED6"
|
||
---
|
||
|
||
# その他の機能 {#other-functions}
|
||
|
||
## ホスト名() {#hostname}
|
||
|
||
この関数が実行されたホストの名前を持つ文字列を返します。 分散処理の場合、機能がリモートサーバー上で実行される場合、これはリモートサーバーホストの名前です。
|
||
|
||
## FQDN {#fqdn}
|
||
|
||
完全修飾ドメイン名を返します。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
fqdn();
|
||
```
|
||
|
||
この関数は、大文字と小文字を区別しません。
|
||
|
||
**戻り値**
|
||
|
||
- 完全修飾ドメイン名の文字列。
|
||
|
||
タイプ: `String`.
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT FQDN();
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─FQDN()──────────────────────────┐
|
||
│ clickhouse.ru-central1.internal │
|
||
└─────────────────────────────────┘
|
||
```
|
||
|
||
## ベース名 {#basename}
|
||
|
||
最後のスラッシュまたはバックスラッシュの後の文字列の末尾の部分を抽出します。 この関数は、パスからファイル名を抽出するためによく使用されます。
|
||
|
||
``` sql
|
||
basename( expr )
|
||
```
|
||
|
||
**パラメータ**
|
||
|
||
- `expr` — Expression resulting in a [文字列](../../sql-reference/data-types/string.md) タイプ値。 すべての円記号は、結果の値でエスケープする必要があります。
|
||
|
||
**戻り値**
|
||
|
||
以下を含む文字列:
|
||
|
||
- 最後のスラッシュまたはバックスラッシュの後の文字列の末尾の部分。
|
||
|
||
If the input string contains a path ending with slash or backslash, for example, `/` or `c:\`, the function returns an empty string.
|
||
|
||
- スラッシュまたはバックスラッシュがない場合は、元の文字列。
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT 'some/long/path/to/file' AS a, basename(a)
|
||
```
|
||
|
||
``` text
|
||
┌─a──────────────────────┬─basename('some\\long\\path\\to\\file')─┐
|
||
│ some\long\path\to\file │ file │
|
||
└────────────────────────┴────────────────────────────────────────┘
|
||
```
|
||
|
||
``` sql
|
||
SELECT 'some\\long\\path\\to\\file' AS a, basename(a)
|
||
```
|
||
|
||
``` text
|
||
┌─a──────────────────────┬─basename('some\\long\\path\\to\\file')─┐
|
||
│ some\long\path\to\file │ file │
|
||
└────────────────────────┴────────────────────────────────────────┘
|
||
```
|
||
|
||
``` sql
|
||
SELECT 'some-file-name' AS a, basename(a)
|
||
```
|
||
|
||
``` text
|
||
┌─a──────────────┬─basename('some-file-name')─┐
|
||
│ some-file-name │ some-file-name │
|
||
└────────────────┴────────────────────────────┘
|
||
```
|
||
|
||
## visibleWidth(x) {#visiblewidthx}
|
||
|
||
テキスト形式（タブ区切り）でコンソールに値を出力するときのおおよその幅を計算します。
|
||
この関数は、システムがpretty形式を実装するために使用します。
|
||
|
||
`NULL` に対応する文字列として表される。 `NULL` で `Pretty` フォーマット。
|
||
|
||
``` sql
|
||
SELECT visibleWidth(NULL)
|
||
```
|
||
|
||
``` text
|
||
┌─visibleWidth(NULL)─┐
|
||
│ 4 │
|
||
└────────────────────┘
|
||
```
|
||
|
||
## toTypeName(x) {#totypenamex}
|
||
|
||
渡された引数の型名を含む文字列を返します。
|
||
|
||
もし `NULL` 入力として関数に渡され、その後、それが返されます `Nullable(Nothing)` 内部に対応するタイプ `NULL` ClickHouseでの表現。
|
||
|
||
## ブロックサイズ() {#function-blocksize}
|
||
|
||
ブロックのサイズを取得します。
|
||
ClickHouseでは、クエリは常にブロック(列部分のセット)で実行されます。 この関数は、それを呼び出したブロックのサイズを取得することができます。
|
||
|
||
## マテリアライズ(x) {#materializex}
|
||
|
||
一つの値だけを含む完全な列に定数を変換します。
|
||
ClickHouseでは、完全な列と定数はメモリ内で異なる方法で表されます。 関数は定数引数と通常の引数（異なるコードが実行される）では異なる動作をしますが、結果はほとんど常に同じです。 この関数は、この動作のデバッグ用です。
|
||
|
||
## ignore(…) {#ignore}
|
||
|
||
以下を含む任意の引数を受け取る `NULL`. 常に0を返します。
|
||
ただし、引数はまだ評価されます。 これはベンチマークに使用できます。
|
||
|
||
## スリープ(秒) {#sleepseconds}
|
||
|
||
眠る ‘seconds’ 各データブロックの秒。 整数または浮動小数点数を指定できます。
|
||
|
||
## sleepEachRow(秒) {#sleepeachrowseconds}
|
||
|
||
眠る ‘seconds’ 各行の秒。 整数または浮動小数点数を指定できます。
|
||
|
||
## currentDatabase() {#currentdatabase}
|
||
|
||
現在のデータベースの名前を返します。
|
||
この関数は、データベースを指定する必要があるcreate tableクエリのテーブルエンジンパラメーターで使用できます。
|
||
|
||
## currentUser() {#other-function-currentuser}
|
||
|
||
現在のユーザーのログインを返します。 ユーザのログインは、そのクエリを開始し、ケースdistibutedクエリで返されます。
|
||
|
||
``` sql
|
||
SELECT currentUser();
|
||
```
|
||
|
||
エイリアス: `user()`, `USER()`.
|
||
|
||
**戻り値**
|
||
|
||
- 現在のユーザーのログイン。
|
||
- クエリを開始したユーザーのログイン。
|
||
|
||
タイプ: `String`.
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT currentUser();
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─currentUser()─┐
|
||
│ default │
|
||
└───────────────┘
|
||
```
|
||
|
||
## isFinite(x) {#isfinitex}
|
||
|
||
引数が無限でなくnanでない場合はfloat32とfloat64を受け取り、uint8を1に返します（それ以外の場合は0）。
|
||
|
||
## イシンフィナイト(x) {#isinfinitex}
|
||
|
||
引数が無限の場合はfloat32とfloat64を受け取り、uint8を1に戻し、それ以外の場合は0を返します。 nanの場合は0が返されることに注意してください。
|
||
|
||
## ifNotFinite {#ifnotfinite}
|
||
|
||
浮動小数点値が有限かどうかをチェックします。
|
||
|
||
**構文**
|
||
|
||
ifNotFinite(x,y)
|
||
|
||
**パラメータ**
|
||
|
||
- `x` — Value to be checked for infinity. Type: [フロート\*](../../sql-reference/data-types/float.md).
|
||
- `y` — Fallback value. Type: [フロート\*](../../sql-reference/data-types/float.md).
|
||
|
||
**戻り値**
|
||
|
||
- `x` もし `x` 有限です。
|
||
- `y` もし `x` 有限ではない。
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
SELECT 1/0 as infimum, ifNotFinite(infimum,42)
|
||
|
||
結果:
|
||
|
||
┌─infimum─┬─ifNotFinite(divide(1, 0), 42)─┐
|
||
│ inf │ 42 │
|
||
└─────────┴───────────────────────────────┘
|
||
|
||
同様の結果を得るには、次のようにします [三項演算子](conditional-functions.md#ternary-operator): `isFinite(x) ? x : y`.
|
||
|
||
## isNaN(x) {#isnanx}
|
||
|
||
引数がnanの場合はfloat32とfloat64を受け取り、uint8を1に返します。
|
||
|
||
## hasColumnInTable(\[‘hostname’\[, ‘username’\[, ‘password’\]\],\] ‘database’, ‘table’, ‘column’) {#hascolumnintablehostname-username-password-database-table-column}
|
||
|
||
データベース名、テーブル名、列名などの定数文字列を受け入れます。 列がある場合はuint8定数式を1に、それ以外の場合は0を返します。 hostnameパラメーターを設定すると、テストはリモートサーバーで実行されます。
|
||
テーブルが存在しない場合、関数は例外をスローします。
|
||
入れ子になったデータ構造内の要素の場合、この関数は列の存在をチェックします。 入れ子になったデータ構造自体の場合、関数は0を返します。
|
||
|
||
## バー {#function-bar}
|
||
|
||
ユニコードアート図を作成できます。
|
||
|
||
`bar(x, min, max, width)` に比例する幅を持つバンドを描画します `(x - min)` とに等しい `width` 文字の場合 `x = max`.
|
||
|
||
パラメータ:
|
||
|
||
- `x` — Size to display.
|
||
- `min, max` — Integer constants. The value must fit in `Int64`.
|
||
- `width` — Constant, positive integer, can be fractional.
|
||
|
||
バンドは、シンボルの第八に精度で描かれています。
|
||
|
||
例えば:
|
||
|
||
``` sql
|
||
SELECT
|
||
toHour(EventTime) AS h,
|
||
count() AS c,
|
||
bar(c, 0, 600000, 20) AS bar
|
||
FROM test.hits
|
||
GROUP BY h
|
||
ORDER BY h ASC
|
||
```
|
||
|
||
``` text
|
||
┌──h─┬──────c─┬─bar────────────────┐
|
||
│ 0 │ 292907 │ █████████▋ │
|
||
│ 1 │ 180563 │ ██████ │
|
||
│ 2 │ 114861 │ ███▋ │
|
||
│ 3 │ 85069 │ ██▋ │
|
||
│ 4 │ 68543 │ ██▎ │
|
||
│ 5 │ 78116 │ ██▌ │
|
||
│ 6 │ 113474 │ ███▋ │
|
||
│ 7 │ 170678 │ █████▋ │
|
||
│ 8 │ 278380 │ █████████▎ │
|
||
│ 9 │ 391053 │ █████████████ │
|
||
│ 10 │ 457681 │ ███████████████▎ │
|
||
│ 11 │ 493667 │ ████████████████▍ │
|
||
│ 12 │ 509641 │ ████████████████▊ │
|
||
│ 13 │ 522947 │ █████████████████▍ │
|
||
│ 14 │ 539954 │ █████████████████▊ │
|
||
│ 15 │ 528460 │ █████████████████▌ │
|
||
│ 16 │ 539201 │ █████████████████▊ │
|
||
│ 17 │ 523539 │ █████████████████▍ │
|
||
│ 18 │ 506467 │ ████████████████▊ │
|
||
│ 19 │ 520915 │ █████████████████▎ │
|
||
│ 20 │ 521665 │ █████████████████▍ │
|
||
│ 21 │ 542078 │ ██████████████████ │
|
||
│ 22 │ 493642 │ ████████████████▍ │
|
||
│ 23 │ 400397 │ █████████████▎ │
|
||
└────┴────────┴────────────────────┘
|
||
```
|
||
|
||
## 変換 {#transform}
|
||
|
||
いくつかの要素の明示的に定義されたマッピングに従って値を他の要素に変換します。
|
||
この関数には二つの違いがあります:
|
||
|
||
### transform(x,array\_from,array\_to,デフォルト) {#transformx-array-from-array-to-default}
|
||
|
||
`x` – What to transform.
|
||
|
||
`array_from` – Constant array of values for converting.
|
||
|
||
`array_to` – Constant array of values to convert the values in ‘from’ に。
|
||
|
||
`default` – Which value to use if ‘x’ 値のいずれにも等しくありません。 ‘from’.
|
||
|
||
`array_from` と `array_to` – Arrays of the same size.
|
||
|
||
タイプ:
|
||
|
||
`transform(T, Array(T), Array(U), U) -> U`
|
||
|
||
`T` と `U` 数値、文字列、または日付または日時の型を指定できます。
|
||
同じ文字（tまたはu）が示されている場合、数値型の場合、これらは一致する型ではなく、共通の型を持つ型である可能性があります。
|
||
たとえば、最初の引数はint64型を持つことができ、二番目の引数はarray(uint16)型を持つことができます。
|
||
|
||
この ‘x’ 値は、次のいずれかの要素に等しくなります。 ‘array\_from’ 配列の場合は、既存の要素(同じ番号が付けられています)を返します。 ‘array\_to’ 配列だ それ以外の場合は、 ‘default’. 一致する要素が複数ある場合 ‘array\_from’、それはマッチのいずれかを返します。
|
||
|
||
例えば:
|
||
|
||
``` sql
|
||
SELECT
|
||
transform(SearchEngineID, [2, 3], ['Yandex', 'Google'], 'Other') AS title,
|
||
count() AS c
|
||
FROM test.hits
|
||
WHERE SearchEngineID != 0
|
||
GROUP BY title
|
||
ORDER BY c DESC
|
||
```
|
||
|
||
``` text
|
||
┌─title─────┬──────c─┐
|
||
│ Yandex │ 498635 │
|
||
│ Google │ 229872 │
|
||
│ Other │ 104472 │
|
||
└───────────┴────────┘
|
||
```
|
||
|
||
### トランスフォーム(x,array\_from,array\_to) {#transformx-array-from-array-to}
|
||
|
||
最初のバリエーションとは異なります ‘default’ 引数は省略する。
|
||
この ‘x’ 値は、次のいずれかの要素に等しくなります。 ‘array\_from’ 配列の場合は、マッチする要素(同じ番号を付けられた要素)を返します。 ‘array\_to’ 配列だ それ以外の場合は、 ‘x’.
|
||
|
||
タイプ:
|
||
|
||
`transform(T, Array(T), Array(T)) -> T`
|
||
|
||
例えば:
|
||
|
||
``` sql
|
||
SELECT
|
||
transform(domain(Referer), ['yandex.ru', 'google.ru', 'vk.com'], ['www.yandex', 'example.com']) AS s,
|
||
count() AS c
|
||
FROM test.hits
|
||
GROUP BY domain(Referer)
|
||
ORDER BY count() DESC
|
||
LIMIT 10
|
||
```
|
||
|
||
``` text
|
||
┌─s──────────────┬───────c─┐
|
||
│ │ 2906259 │
|
||
│ www.yandex │ 867767 │
|
||
│ ███████.ru │ 313599 │
|
||
│ mail.yandex.ru │ 107147 │
|
||
│ ██████.ru │ 100355 │
|
||
│ █████████.ru │ 65040 │
|
||
│ news.yandex.ru │ 64515 │
|
||
│ ██████.net │ 59141 │
|
||
│ example.com │ 57316 │
|
||
└────────────────┴─────────┘
|
||
```
|
||
|
||
## formatReadableSize(x) {#formatreadablesizex}
|
||
|
||
サイズ(バイト数)を受け入れます。 サフィックス(kib、mibなど)を含む丸められたサイズを返します。)文字列として。
|
||
|
||
例えば:
|
||
|
||
``` sql
|
||
SELECT
|
||
arrayJoin([1, 1024, 1024*1024, 192851925]) AS filesize_bytes,
|
||
formatReadableSize(filesize_bytes) AS filesize
|
||
```
|
||
|
||
``` text
|
||
┌─filesize_bytes─┬─filesize───┐
|
||
│ 1 │ 1.00 B │
|
||
│ 1024 │ 1.00 KiB │
|
||
│ 1048576 │ 1.00 MiB │
|
||
│ 192851925 │ 183.92 MiB │
|
||
└────────────────┴────────────┘
|
||
```
|
||
|
||
## 少なくとも(a,b) {#leasta-b}
|
||
|
||
Aとbの最小値を返します。
|
||
|
||
## 最大(a,b) {#greatesta-b}
|
||
|
||
Aとbの最大値を返します。
|
||
|
||
## アップタイム() {#uptime}
|
||
|
||
サーバーの稼働時間を秒単位で返します。
|
||
|
||
## バージョン() {#version}
|
||
|
||
サーバーのバージョンを文字列として返します。
|
||
|
||
## タイムゾーン() {#timezone}
|
||
|
||
サーバーのタイムゾーンを返します。
|
||
|
||
## bloknumber {#blocknumber}
|
||
|
||
行があるデータブロックのシーケンス番号を返します。
|
||
|
||
## rowNumberInBlock {#function-rownumberinblock}
|
||
|
||
データブロック内の行の序数を返します。 異なるデータブロックは常に再計算されます。
|
||
|
||
## rowNumberInAllBlocks() {#rownumberinallblocks}
|
||
|
||
データブロック内の行の序数を返します。 この機能のみを考慮した影響のデータブロックとなります。
|
||
|
||
## 隣人 {#neighbor}
|
||
|
||
指定された列の現在の行の前または後に来る指定されたオフセットで行へのアクセスを提供するウィンドウ関数。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
neighbor(column, offset[, default_value])
|
||
```
|
||
|
||
関数の結果は、影響を受けるデータブロックと、ブロック内のデータの順序によって異なります。
|
||
ORDER BYを使用してサブクエリを作成し、サブクエリの外部から関数を呼び出すと、期待される結果を得ることができます。
|
||
|
||
**パラメータ**
|
||
|
||
- `column` — A column name or scalar expression.
|
||
- `offset` — The number of rows forwards or backwards from the current row of `column`. [Int64](../../sql-reference/data-types/int-uint.md).
|
||
- `default_value` — Optional. The value to be returned if offset goes beyond the scope of the block. Type of data blocks affected.
|
||
|
||
**戻り値**
|
||
|
||
- の値 `column` で `offset` 現在の行からの距離 `offset` 値はブロック境界の外側ではありません。
|
||
- のデフォルト値 `column` もし `offset` 値はブロック境界の外側です。 もし `default_value` 与えられ、それが使用されます。
|
||
|
||
型:影響を受けるデータブロックの種類または既定値の種類。
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT number, neighbor(number, 2) FROM system.numbers LIMIT 10;
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─number─┬─neighbor(number, 2)─┐
|
||
│ 0 │ 2 │
|
||
│ 1 │ 3 │
|
||
│ 2 │ 4 │
|
||
│ 3 │ 5 │
|
||
│ 4 │ 6 │
|
||
│ 5 │ 7 │
|
||
│ 6 │ 8 │
|
||
│ 7 │ 9 │
|
||
│ 8 │ 0 │
|
||
│ 9 │ 0 │
|
||
└────────┴─────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT number, neighbor(number, 2, 999) FROM system.numbers LIMIT 10;
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─number─┬─neighbor(number, 2, 999)─┐
|
||
│ 0 │ 2 │
|
||
│ 1 │ 3 │
|
||
│ 2 │ 4 │
|
||
│ 3 │ 5 │
|
||
│ 4 │ 6 │
|
||
│ 5 │ 7 │
|
||
│ 6 │ 8 │
|
||
│ 7 │ 9 │
|
||
│ 8 │ 999 │
|
||
│ 9 │ 999 │
|
||
└────────┴──────────────────────────┘
|
||
```
|
||
|
||
この関数は、年間指標の値を計算するために使用できます:
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
WITH toDate('2018-01-01') AS start_date
|
||
SELECT
|
||
toStartOfMonth(start_date + (number * 32)) AS month,
|
||
toInt32(month) % 100 AS money,
|
||
neighbor(money, -12) AS prev_year,
|
||
round(prev_year / money, 2) AS year_over_year
|
||
FROM numbers(16)
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌──────month─┬─money─┬─prev_year─┬─year_over_year─┐
|
||
│ 2018-01-01 │ 32 │ 0 │ 0 │
|
||
│ 2018-02-01 │ 63 │ 0 │ 0 │
|
||
│ 2018-03-01 │ 91 │ 0 │ 0 │
|
||
│ 2018-04-01 │ 22 │ 0 │ 0 │
|
||
│ 2018-05-01 │ 52 │ 0 │ 0 │
|
||
│ 2018-06-01 │ 83 │ 0 │ 0 │
|
||
│ 2018-07-01 │ 13 │ 0 │ 0 │
|
||
│ 2018-08-01 │ 44 │ 0 │ 0 │
|
||
│ 2018-09-01 │ 75 │ 0 │ 0 │
|
||
│ 2018-10-01 │ 5 │ 0 │ 0 │
|
||
│ 2018-11-01 │ 36 │ 0 │ 0 │
|
||
│ 2018-12-01 │ 66 │ 0 │ 0 │
|
||
│ 2019-01-01 │ 97 │ 32 │ 0.33 │
|
||
│ 2019-02-01 │ 28 │ 63 │ 2.25 │
|
||
│ 2019-03-01 │ 56 │ 91 │ 1.62 │
|
||
│ 2019-04-01 │ 87 │ 22 │ 0.25 │
|
||
└────────────┴───────┴───────────┴────────────────┘
|
||
```
|
||
|
||
## ランニングダイファレンス(x) {#other_functions-runningdifference}
|
||
|
||
Calculates the difference between successive row values in the data block.
|
||
最初の行に対して0を返し、後続の各行に対して前の行との差を返します。
|
||
|
||
関数の結果は、影響を受けるデータブロックと、ブロック内のデータの順序によって異なります。
|
||
ORDER BYを使用してサブクエリを作成し、サブクエリの外部から関数を呼び出すと、期待される結果を得ることができます。
|
||
|
||
例えば:
|
||
|
||
``` sql
|
||
SELECT
|
||
EventID,
|
||
EventTime,
|
||
runningDifference(EventTime) AS delta
|
||
FROM
|
||
(
|
||
SELECT
|
||
EventID,
|
||
EventTime
|
||
FROM events
|
||
WHERE EventDate = '2016-11-24'
|
||
ORDER BY EventTime ASC
|
||
LIMIT 5
|
||
)
|
||
```
|
||
|
||
``` text
|
||
┌─EventID─┬───────────EventTime─┬─delta─┐
|
||
│ 1106 │ 2016-11-24 00:00:04 │ 0 │
|
||
│ 1107 │ 2016-11-24 00:00:05 │ 1 │
|
||
│ 1108 │ 2016-11-24 00:00:05 │ 0 │
|
||
│ 1109 │ 2016-11-24 00:00:09 │ 4 │
|
||
│ 1110 │ 2016-11-24 00:00:10 │ 1 │
|
||
└─────────┴─────────────────────┴───────┘
|
||
```
|
||
|
||
ご注意-ブロックサイズは結果に影響します。 それぞれの新しいブロックでは、 `runningDifference` 状態がリセットされます。
|
||
|
||
``` sql
|
||
SELECT
|
||
number,
|
||
runningDifference(number + 1) AS diff
|
||
FROM numbers(100000)
|
||
WHERE diff != 1
|
||
```
|
||
|
||
``` text
|
||
┌─number─┬─diff─┐
|
||
│ 0 │ 0 │
|
||
└────────┴──────┘
|
||
┌─number─┬─diff─┐
|
||
│ 65536 │ 0 │
|
||
└────────┴──────┘
|
||
```
|
||
|
||
``` sql
|
||
set max_block_size=100000 -- default value is 65536!
|
||
|
||
SELECT
|
||
number,
|
||
runningDifference(number + 1) AS diff
|
||
FROM numbers(100000)
|
||
WHERE diff != 1
|
||
```
|
||
|
||
``` text
|
||
┌─number─┬─diff─┐
|
||
│ 0 │ 0 │
|
||
└────────┴──────┘
|
||
```
|
||
|
||
## runningDifferenceStartingWithFirstvalue {#runningdifferencestartingwithfirstvalue}
|
||
|
||
と同じ [runningDifference](./other-functions.md#other_functions-runningdifference)、差は、最初の行の値であり、最初の行の値を返し、後続の各行は、前の行からの差を返します。
|
||
|
||
## マクナムトストリング(num) {#macnumtostringnum}
|
||
|
||
UInt64番号を受け取ります。 ビッグエンディアンのMACアドレスとして解釈します。 対応するMACアドレスをAA:BB:CC:DD:EE:FF形式で含む文字列を返します。
|
||
|
||
## MACStringToNum(s) {#macstringtonums}
|
||
|
||
MACNumToStringの逆関数。 MACアドレスに無効な形式がある場合は、0を返します。
|
||
|
||
## MACStringToOUI(s) {#macstringtoouis}
|
||
|
||
AA:BB:CC:DD:EE:FF形式のMACアドレスを受け付けます。 最初の三つのオクテットをUInt64の数値として返します。 MACアドレスに無効な形式がある場合は、0を返します。
|
||
|
||
## getSizeOfEnumType {#getsizeofenumtype}
|
||
|
||
フィールドの数を返します [列挙型](../../sql-reference/data-types/enum.md).
|
||
|
||
``` sql
|
||
getSizeOfEnumType(value)
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `value` — Value of type `Enum`.
|
||
|
||
**戻り値**
|
||
|
||
- を持つフィールドの数 `Enum` 入力値。
|
||
- 型が型でない場合は、例外がスローされます `Enum`.
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT getSizeOfEnumType( CAST('a' AS Enum8('a' = 1, 'b' = 2) ) ) AS x
|
||
```
|
||
|
||
``` text
|
||
┌─x─┐
|
||
│ 2 │
|
||
└───┘
|
||
```
|
||
|
||
## blockSerializedSize {#blockserializedsize}
|
||
|
||
（圧縮を考慮せずに）ディスク上のサイズを返します。
|
||
|
||
``` sql
|
||
blockSerializedSize(value[, value[, ...]])
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `value` — Any value.
|
||
|
||
**戻り値**
|
||
|
||
- 値のブロックのためにディスクに書き込まれるバイト数(圧縮なし)。
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT blockSerializedSize(maxState(1)) as x
|
||
```
|
||
|
||
``` text
|
||
┌─x─┐
|
||
│ 2 │
|
||
└───┘
|
||
```
|
||
|
||
## toColumnTypeName {#tocolumntypename}
|
||
|
||
RAM内の列のデータ型を表すクラスの名前を返します。
|
||
|
||
``` sql
|
||
toColumnTypeName(value)
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `value` — Any type of value.
|
||
|
||
**戻り値**
|
||
|
||
- を表すために使用されるクラスの名前を持つ文字列 `value` RAMのデータ型。
|
||
|
||
**違いの例`toTypeName ' and ' toColumnTypeName`**
|
||
|
||
``` sql
|
||
SELECT toTypeName(CAST('2018-01-01 01:02:03' AS DateTime))
|
||
```
|
||
|
||
``` text
|
||
┌─toTypeName(CAST('2018-01-01 01:02:03', 'DateTime'))─┐
|
||
│ DateTime │
|
||
└─────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
``` sql
|
||
SELECT toColumnTypeName(CAST('2018-01-01 01:02:03' AS DateTime))
|
||
```
|
||
|
||
``` text
|
||
┌─toColumnTypeName(CAST('2018-01-01 01:02:03', 'DateTime'))─┐
|
||
│ Const(UInt32) │
|
||
└───────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
この例では、 `DateTime` データタイプはメモリに記憶として `Const(UInt32)`.
|
||
|
||
## dumpColumnStructure {#dumpcolumnstructure}
|
||
|
||
RAM内のデータ構造の詳細な説明を出力します
|
||
|
||
``` sql
|
||
dumpColumnStructure(value)
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `value` — Any type of value.
|
||
|
||
**戻り値**
|
||
|
||
- を表すために使用される構造体を記述する文字列。 `value` RAMのデータ型。
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT dumpColumnStructure(CAST('2018-01-01 01:02:03', 'DateTime'))
|
||
```
|
||
|
||
``` text
|
||
┌─dumpColumnStructure(CAST('2018-01-01 01:02:03', 'DateTime'))─┐
|
||
│ DateTime, Const(size = 1, UInt32(size = 1)) │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
## defaultValueOfArgumentType {#defaultvalueofargumenttype}
|
||
|
||
データ型の既定値を出力します。
|
||
|
||
ユーザーが設定したカスタム列の既定値は含まれません。
|
||
|
||
``` sql
|
||
defaultValueOfArgumentType(expression)
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `expression` — Arbitrary type of value or an expression that results in a value of an arbitrary type.
|
||
|
||
**戻り値**
|
||
|
||
- `0` 数字のために.
|
||
- 文字列の空の文字列。
|
||
- `ᴺᵁᴸᴸ` のために [Nullable](../../sql-reference/data-types/nullable.md).
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT defaultValueOfArgumentType( CAST(1 AS Int8) )
|
||
```
|
||
|
||
``` text
|
||
┌─defaultValueOfArgumentType(CAST(1, 'Int8'))─┐
|
||
│ 0 │
|
||
└─────────────────────────────────────────────┘
|
||
```
|
||
|
||
``` sql
|
||
SELECT defaultValueOfArgumentType( CAST(1 AS Nullable(Int8) ) )
|
||
```
|
||
|
||
``` text
|
||
┌─defaultValueOfArgumentType(CAST(1, 'Nullable(Int8)'))─┐
|
||
│ ᴺᵁᴸᴸ │
|
||
└───────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
## 複製 {#other-functions-replicate}
|
||
|
||
単一の値を持つ配列を作成します。
|
||
|
||
内部実装のために使用される [arrayJoin](array-join.md#functions_arrayjoin).
|
||
|
||
``` sql
|
||
SELECT replicate(x, arr);
|
||
```
|
||
|
||
**パラメータ:**
|
||
|
||
- `arr` — Original array. ClickHouse creates a new array of the same length as the original and fills it with the value `x`.
|
||
- `x` — The value that the resulting array will be filled with.
|
||
|
||
**戻り値**
|
||
|
||
値で満たされた配列 `x`.
|
||
|
||
タイプ: `Array`.
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT replicate(1, ['a', 'b', 'c'])
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─replicate(1, ['a', 'b', 'c'])─┐
|
||
│ [1,1,1] │
|
||
└───────────────────────────────┘
|
||
```
|
||
|
||
## filesystemAvailable {#filesystemavailable}
|
||
|
||
返金額の残存スペースのファイルシステムのファイルのデータベースはあります。 それは常に合計空き領域よりも小さいです ([filesystemFree](#filesystemfree) でもスペースはOS.
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
filesystemAvailable()
|
||
```
|
||
|
||
**戻り値**
|
||
|
||
- バイト単位で使用可能な残りのスペースの量。
|
||
|
||
タイプ: [UInt64](../../sql-reference/data-types/int-uint.md).
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT formatReadableSize(filesystemAvailable()) AS "Available space", toTypeName(filesystemAvailable()) AS "Type";
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─Available space─┬─Type───┐
|
||
│ 30.75 GiB │ UInt64 │
|
||
└─────────────────┴────────┘
|
||
```
|
||
|
||
## filesystemFree {#filesystemfree}
|
||
|
||
データベースのファイルがあるファイルシステム上の空き領域の合計を返します。 また見なさい `filesystemAvailable`
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
filesystemFree()
|
||
```
|
||
|
||
**戻り値**
|
||
|
||
- バイト単位の空き領域の量。
|
||
|
||
タイプ: [UInt64](../../sql-reference/data-types/int-uint.md).
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT formatReadableSize(filesystemFree()) AS "Free space", toTypeName(filesystemFree()) AS "Type";
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─Free space─┬─Type───┐
|
||
│ 32.39 GiB │ UInt64 │
|
||
└────────────┴────────┘
|
||
```
|
||
|
||
## filesystemCapacity {#filesystemcapacity}
|
||
|
||
ファイルシステムの容量をバイト単位で返します。 評価のために、 [パス](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-path) データディレク
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
filesystemCapacity()
|
||
```
|
||
|
||
**戻り値**
|
||
|
||
- ファイルシステムの容量情報(バイト単位)。
|
||
|
||
タイプ: [UInt64](../../sql-reference/data-types/int-uint.md).
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT formatReadableSize(filesystemCapacity()) AS "Capacity", toTypeName(filesystemCapacity()) AS "Type"
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─Capacity──┬─Type───┐
|
||
│ 39.32 GiB │ UInt64 │
|
||
└───────────┴────────┘
|
||
```
|
||
|
||
## finalizeAggregation {#function-finalizeaggregation}
|
||
|
||
集約関数の状態を取ります。 集計結果を返します(ファイナライズされた状態)。
|
||
|
||
## runningAccumulate {#function-runningaccumulate}
|
||
|
||
集約関数の状態を取り、値を持つ列を返します,ブロックラインのセットのためにこれらの状態の蓄積の結果であります,最初から現在の行へ.これ
|
||
たとえば、集計関数の状態（例：runningaccumulate（uniqstate（userid）））を取り、ブロックの各行について、前のすべての行と現在の行の状態をマージしたときの集計関数の結果を返しま
|
||
したがって、関数の結果は、ブロックへのデータの分割とブロック内のデータの順序に依存します。
|
||
|
||
## joinGet {#joinget}
|
||
|
||
この関数を使用すると、テーブルからのデータと同じ方法でデータを抽出できます [辞書](../../sql-reference/dictionaries/index.md).
|
||
|
||
データの取得 [参加](../../engines/table-engines/special/join.md#creating-a-table) 指定された結合キーを使用するテーブル。
|
||
|
||
サポートされているのは、 `ENGINE = Join(ANY, LEFT, <join_keys>)` 声明。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
joinGet(join_storage_table_name, `value_column`, join_keys)
|
||
```
|
||
|
||
**パラメータ**
|
||
|
||
- `join_storage_table_name` — an [識別子](../syntax.md#syntax-identifiers) 検索が実行される場所を示します。 識別子は既定のデータベースで検索されます(パラメータを参照 `default_database` の設定ファイル)。 デフォル `USE db_name` またはを指定しデータベースのテーブルのセパレータ `db_name.db_table`、例を参照してください。
|
||
- `value_column` — name of the column of the table that contains required data.
|
||
- `join_keys` — list of keys.
|
||
|
||
**戻り値**
|
||
|
||
キーのリストに対応する値のリストを返します。
|
||
|
||
ソーステーブルに特定のものが存在しない場合 `0` または `null` に基づいて返されます [join\_use\_nulls](../../operations/settings/settings.md#join_use_nulls) 設定。
|
||
|
||
詳細について `join_use_nulls` で [結合操作](../../engines/table-engines/special/join.md).
|
||
|
||
**例えば**
|
||
|
||
入力テーブル:
|
||
|
||
``` sql
|
||
CREATE DATABASE db_test
|
||
CREATE TABLE db_test.id_val(`id` UInt32, `val` UInt32) ENGINE = Join(ANY, LEFT, id) SETTINGS join_use_nulls = 1
|
||
INSERT INTO db_test.id_val VALUES (1,11)(2,12)(4,13)
|
||
```
|
||
|
||
``` text
|
||
┌─id─┬─val─┐
|
||
│ 4 │ 13 │
|
||
│ 2 │ 12 │
|
||
│ 1 │ 11 │
|
||
└────┴─────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT joinGet(db_test.id_val,'val',toUInt32(number)) from numbers(4) SETTINGS join_use_nulls = 1
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─joinGet(db_test.id_val, 'val', toUInt32(number))─┐
|
||
│ 0 │
|
||
│ 11 │
|
||
│ 12 │
|
||
│ 0 │
|
||
└──────────────────────────────────────────────────┘
|
||
```
|
||
|
||
## modelEvaluate(model\_name, …) {#function-modelevaluate}
|
||
|
||
外部モデルを評価します。
|
||
モデル名とモデル引数を受け取ります。 float64を返します。
|
||
|
||
## throwIf(x\[,custom\_message\]) {#throwifx-custom-message}
|
||
|
||
引数がゼロ以外の場合は例外をスローします。
|
||
custom\_message-オプションのパラメータです。
|
||
|
||
``` sql
|
||
SELECT throwIf(number = 3, 'Too many') FROM numbers(10);
|
||
```
|
||
|
||
``` text
|
||
↙ Progress: 0.00 rows, 0.00 B (0.00 rows/s., 0.00 B/s.) Received exception from server (version 19.14.1):
|
||
Code: 395. DB::Exception: Received from localhost:9000. DB::Exception: Too many.
|
||
```
|
||
|
||
## id {#identity}
|
||
|
||
引数として使用されたのと同じ値を返します。 デバッグに使用され、試験が可能でャックのクエリーの性能を満たします。 がクエリーの分析のために利用できる可能性指標分析装置が外部サンプリング方式な見てみよう `identity` 機能。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
identity(x)
|
||
```
|
||
|
||
**例えば**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT identity(42)
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─identity(42)─┐
|
||
│ 42 │
|
||
└──────────────┘
|
||
```
|
||
|
||
## randomprintableasii {#randomascii}
|
||
|
||
のランダムなセットを持つ文字列を生成します [ASCII](https://en.wikipedia.org/wiki/ASCII#Printable_characters) 印刷可能な文字。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
randomPrintableASCII(length)
|
||
```
|
||
|
||
**パラメータ**
|
||
|
||
- `length` — Resulting string length. Positive integer.
|
||
|
||
If you pass `length < 0`, behavior of the function is undefined.
|
||
|
||
**戻り値**
|
||
|
||
- のランダムなセットを持つ文字列 [ASCII](https://en.wikipedia.org/wiki/ASCII#Printable_characters) 印刷可能な文字。
|
||
|
||
タイプ: [文字列](../../sql-reference/data-types/string.md)
|
||
|
||
**例えば**
|
||
|
||
``` sql
|
||
SELECT number, randomPrintableASCII(30) as str, length(str) FROM system.numbers LIMIT 3
|
||
```
|
||
|
||
``` text
|
||
┌─number─┬─str────────────────────────────┬─length(randomPrintableASCII(30))─┐
|
||
│ 0 │ SuiCOSTvC0csfABSw=UcSzp2.`rv8x │ 30 │
|
||
│ 1 │ 1Ag NlJ &RCN:*>HVPG;PE-nO"SUFD │ 30 │
|
||
│ 2 │ /"+<"wUTh:=LjJ Vm!c&hI*m#XTfzz │ 30 │
|
||
└────────┴────────────────────────────────┴──────────────────────────────────┘
|
||
```
|
||
|
||
[元の記事](https://clickhouse.tech/docs/en/query_language/functions/other_functions/) <!--hide-->
|