mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-18 13:42:02 +00:00
1206 lines
38 KiB
Markdown
1206 lines
38 KiB
Markdown
---
|
||
machine_translated: true
|
||
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
|
||
toc_priority: 66
|
||
toc_title: "\u305D\u306E\u4ED6"
|
||
---
|
||
|
||
# その他の機能 {#other-functions}
|
||
|
||
## ホスト名() {#hostname}
|
||
|
||
この関数が実行されたホストの名前を持つ文字列を返します。 分散処理の場合、関数がリモートサーバーで実行される場合、これはリモートサーバーホストの名前です。
|
||
|
||
## getMacro {#getmacro}
|
||
|
||
から名前付きの値を取得します [マクロ](../../operations/server-configuration-parameters/settings.md#macros) サーバー構成のセクション。
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
getMacro(name);
|
||
```
|
||
|
||
**パラメータ**
|
||
|
||
- `name` — Name to retrieve from the `macros` セクション [文字列](../../sql-reference/data-types/string.md#string).
|
||
|
||
**戻り値**
|
||
|
||
- 指定されたマクロの値。
|
||
|
||
タイプ: [文字列](../../sql-reference/data-types/string.md).
|
||
|
||
**例**
|
||
|
||
例 `macros` サーバー設定ファイルのセクション:
|
||
|
||
``` xml
|
||
<macros>
|
||
<test>Value</test>
|
||
</macros>
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT getMacro('test');
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─getMacro('test')─┐
|
||
│ Value │
|
||
└──────────────────┘
|
||
```
|
||
|
||
同じ値を取得する別の方法:
|
||
|
||
``` sql
|
||
SELECT * FROM system.macros
|
||
WHERE macro = 'test';
|
||
```
|
||
|
||
``` text
|
||
┌─macro─┬─substitution─┐
|
||
│ test │ Value │
|
||
└───────┴──────────────┘
|
||
```
|
||
|
||
## 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 │
|
||
└────────────────────┘
|
||
```
|
||
|
||
## トータイプ名(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 │
|
||
└───────────────┘
|
||
```
|
||
|
||
## isConstant {#is-constant}
|
||
|
||
引数が定数式かどうかを確認します。
|
||
|
||
A constant expression means an expression whose resulting value is known at the query analysis (i.e. before execution). For example, expressions over [リテラル](../syntax.md#literals) は定数式です。
|
||
|
||
この機能は開発のアプリケーションのデバッグおよびデモンストレーション
|
||
|
||
**構文**
|
||
|
||
``` sql
|
||
isConstant(x)
|
||
```
|
||
|
||
**パラメータ**
|
||
|
||
- `x` — Expression to check.
|
||
|
||
**戻り値**
|
||
|
||
- `1` — `x` 定数です。
|
||
- `0` — `x` は定数ではありません。
|
||
|
||
タイプ: [UInt8](../data-types/int-uint.md).
|
||
|
||
**例**
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT isConstant(x + 1) FROM (SELECT 43 AS x)
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─isConstant(plus(x, 1))─┐
|
||
│ 1 │
|
||
└────────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
WITH 3.14 AS pi SELECT isConstant(cos(pi))
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─isConstant(cos(pi))─┐
|
||
│ 1 │
|
||
└─────────────────────┘
|
||
```
|
||
|
||
クエリ:
|
||
|
||
``` sql
|
||
SELECT isConstant(number) FROM numbers(1)
|
||
```
|
||
|
||
結果:
|
||
|
||
``` text
|
||
┌─isConstant(number)─┐
|
||
│ 0 │
|
||
└────────────────────┘
|
||
```
|
||
|
||
## isFinite(x) {#isfinitex}
|
||
|
||
Float32とFloat64を受け入れ、引数が無限でなくNaNでない場合は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`.
|
||
|
||
## イスナン(x) {#isnanx}
|
||
|
||
Float32とFloat64を受け入れ、引数がNaNの場合はUInt8が1、それ以外の場合は0を返します。
|
||
|
||
## hasColumnInTable(\[‘hostname’\[, ‘username’\[, ‘password’\]\],\] ‘database’, ‘table’, ‘column’) {#hascolumnintablehostname-username-password-database-table-column}
|
||
|
||
データベース名、テーブル名、および列名の定数文字列を受け入れます。 列がある場合はUInt8定数式を1、それ以外の場合は0を返します。 Hostnameパラメータが設定されている場合、テストはリモートサーバーで実行されます。
|
||
テーブルが存在しない場合、この関数は例外をスローします。
|
||
入れ子になったデータ構造の要素の場合、関数は列の存在をチェックします。 入れ子になったデータ構造自体の場合、関数は0を返します。
|
||
|
||
## バー {#function-bar}
|
||
|
||
Unicodeアート図を作成できます。
|
||
|
||
`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` 数値、文字列、または日付またはDateTime型を指定できます。
|
||
同じ文字が示されている場合（TまたはU）、数値型の場合、これらは一致する型ではなく、共通の型を持つ型である可能性があります。
|
||
たとえば、最初の引数はInt64型で、二番目の引数は配列(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}
|
||
|
||
サーバーのタイムゾーンを返します。
|
||
|
||
## ブロックナンバー {#blocknumber}
|
||
|
||
行があるデータブロックのシーケンス番号を返します。
|
||
|
||
## rowNumberInBlock {#function-rownumberinblock}
|
||
|
||
データブロック内の行の序数を返します。 異なるデータブロックは常に再計算されます。
|
||
|
||
## ローナンバリンブロック() {#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` 現在の行からの距離if `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 │
|
||
└────────────┴───────┴───────────┴────────────────┘
|
||
```
|
||
|
||
## runningDifference(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(十六進形式のコロン区切りの数値)の形式で返します。
|
||
|
||
## マクストリングトナム(s) {#macstringtonums}
|
||
|
||
MACNumToStringの逆関数。 MACアドレスの形式が無効な場合は、0を返します。
|
||
|
||
## マクストリングトゥーイ(s) {#macstringtoouis}
|
||
|
||
AA:BB:CC:DD:EE:FF(十六進形式のコロン区切りの数字)の形式でMACアドレスを受け入れます。 Uint64番号として最初の三つのオクテットを返します。 MACアドレスの形式が無効な場合は、0を返します。
|
||
|
||
## getSizeOfEnumType {#getsizeofenumtype}
|
||
|
||
フィールドの数を返します。 [Enum](../../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` 数字のために。
|
||
- 文字列の場合は空の文字列です。
|
||
- `ᴺᵁᴸᴸ` のために [Null可能](../../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}
|
||
|
||
単一の値を持つ配列を作成します。
|
||
|
||
内部実装のために使用される [アレイジョイン](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}
|
||
|
||
この関数を使用すると、aと同じ方法でテーブルからデータを抽出できます [辞書](../../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 │
|
||
└──────────────┘
|
||
```
|
||
|
||
## randomPrintableASCII {#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-->
|