`](/ja/reference/settings/server-settings/settings#macros)セクションで定義され、ホスト名が複雑な場合でも、わかりやすい名前でサーバーを識別するために使用できます。
この関数を分散テーブル上で実行すると、各分片に対応する値を持つ通常のカラムが生成されます。
**構文**
```sql theme={null}
getMacro(name)
```
**引数**
* `name` — 取得するマクロの名前。[`const String`](/ja/reference/data-types/string)
**戻り値**
指定したマクロの値を返します。[`String`](/ja/reference/data-types/string)
**例**
**基本的な使い方**
```sql title=Query theme={null}
SELECT getMacro('test');
```
```response title=Response theme={null}
┌─getMacro('test')─┐
│ Value │
└──────────────────┘
```
## getMaxTableNameLengthForDatabase
導入バージョン: v25.1.0
指定したデータベース内のテーブル名の最大長を返します。
**構文**
```sql theme={null}
getMaxTableNameLengthForDatabase(database_name)
```
**引数**
* `database_name` — 指定したデータベースの名前。[`String`](/ja/reference/data-types/string)
**戻り値**
最大のテーブル名の長さを表す整数値を返します
**例**
**一般的な例**
```sql title=Query theme={null}
SELECT getMaxTableNameLengthForDatabase('default');
```
```response title=Response theme={null}
┌─getMaxTableNameLengthForDatabase('default')─┐
│ 206 │
└─────────────────────────────────────────────┘
```
## getMergeTreeSetting
導入バージョン: v25.6.0
MergeTree設定の現在の値を返します。
**構文**
```sql theme={null}
getMergeTreeSetting(setting_name)
```
**引数**
* `setting_name` — 設定の名前。 [`String`](/ja/reference/data-types/string)
**戻り値**
MergeTree 設定の現在の値を返します。
**例**
**使用例**
```sql title=Query theme={null}
SELECT getMergeTreeSetting('index_granularity');
```
```response title=Response theme={null}
┌─getMergeTreeSetting('index_granularity')─┐
│ 8192 │
└──────────────────────────────────────────┘
```
## getOSKernelVersion
導入バージョン: v21.11.0
OS カーネルのバージョンを含む文字列を返します。
**構文**
```sql theme={null}
getOSKernelVersion()
```
**引数**
* なし
**戻り値**
現在の OS カーネルのバージョンを返します。 [`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT getOSKernelVersion();
```
```response title=Response theme={null}
┌─getOSKernelVersion()────┐
│ Linux 4.15.0-55-generic │
└─────────────────────────┘
```
## getServerPort
導入バージョン: v21.10.0
指定したプロトコルのサーバーのポート番号を返します。
**構文**
```sql theme={null}
getServerPort(port_name)
```
**引数**
* `port_name` — ポート名。[`String`](/ja/reference/data-types/string)
**戻り値**
サーバーのポート番号を返します。[`UInt16`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT getServerPort('tcp_port');
```
```response title=Response theme={null}
┌─getServerPort('tcp_port')─┐
│ 9000 │
└───────────────────────────┘
```
## getServerSetting
導入バージョン: v25.6.0
サーバー設定の名前を指定すると、現在設定されている値を返します。
**構文**
```sql theme={null}
getServerSetting(setting_name')
```
**引数**
* `setting_name` — サーバー設定の名前。[`String`](/ja/reference/data-types/string)
**戻り値**
サーバー設定の現在の値を返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
SELECT getServerSetting('allow_use_jemalloc_memory');
```
```response title=Response theme={null}
┌─getServerSetting('allow_use_jemalloc_memory')─┐
│ true │
└───────────────────────────────────────────────┘
```
## getSetting
導入バージョン: v20.7.0
設定の現在の値を返します。
**構文**
```sql theme={null}
getSetting(setting_name)
```
**引数**
* `setting_Name` — 設定名。 [`const String`](/ja/reference/data-types/string)
**戻り値**
設定の現在の値を返します。 [`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
SELECT getSetting('enable_analyzer');
SET enable_analyzer = false;
SELECT getSetting('enable_analyzer');
```
```response title=Response theme={null}
┌─getSetting('⋯_analyzer')─┐
│ true │
└──────────────────────────┘
┌─getSetting('⋯_analyzer')─┐
│ false │
└──────────────────────────┘
```
## getSettingOrDefault
導入バージョン: v24.10.0
設定の現在の値を返します。現在のプロファイルでその設定が指定されていない場合は、2 番目の引数で指定されたデフォルト値を返します。
**構文**
```sql theme={null}
getSettingOrDefault(setting_name, default_value)
```
**引数**
* `setting_name` — 設定名。[`String`](/ja/reference/data-types/string)
* `default_value` — custom\_setting が設定されていない場合に返される値。値には任意のデータ型または Null を指定できます。
**戻り値**
指定した設定の現在の値を返します。設定されていない場合は `default_value` を返します。
**例**
**使用例**
```sql title=Query theme={null}
SELECT getSettingOrDefault('custom_undef1', 'my_value');
SELECT getSettingOrDefault('custom_undef2', 100);
SELECT getSettingOrDefault('custom_undef3', NULL);
```
```response title=Response theme={null}
my_value
100
NULL
```
## getSizeOfEnumType
導入バージョン: v1.1.0
指定された[`Enum`](/ja/reference/data-types/enum)に含まれるフィールドの数を返します。
**構文**
```sql theme={null}
getSizeOfEnumType(x)
```
**引数**
* `x` — `Enum` 型の値。[`Enum`](/ja/reference/data-types/enum)
**戻り値**
`Enum` 型の入力値を持つフィールドの数を返します。[`UInt8/16`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT getSizeOfEnumType(CAST('a' AS Enum8('a' = 1, 'b' = 2))) AS x;
```
```response title=Response theme={null}
┌─x─┐
│ 2 │
└───┘
```
## getSubcolumn
導入バージョン: v23.3.0
式または識別子と、サブカラム名を表す定数文字列を受け取ります。
式から抽出した指定のサブカラムを返します。
**構文**
```sql theme={null}
getSubcolumn(nested_value, subcolumn_name)
```
**引数**
* なし。
**戻り値**
**例**
**getSubcolumn**
```sql title=Query theme={null}
SELECT getSubcolumn(array_col, 'size0'), getSubcolumn(tuple_col, 'elem_name')
```
```response title=Response theme={null}
```
## getTypeSerializationStreams
導入バージョン: v22.6.0
データ型のストリームパスを列挙します。
この関数は開発目的での使用を想定しています。
**構文**
```sql theme={null}
getTypeSerializationStreams(col)
```
**引数**
* `col` — データ型を検出する対象の、カラム、またはデータ型の文字列表現。[`Any`](/ja/reference/data-types/index)
**戻り値**
すべてのシリアライゼーションのサブストリームパスを含む配列を返します。[`Array(String)`](/ja/reference/data-types/array)
**例**
**tuple**
```sql title=Query theme={null}
SELECT getTypeSerializationStreams(tuple('a', 1, 'b', 2))
```
```response title=Response theme={null}
['{TupleElement(1), Regular}','{TupleElement(2), Regular}','{TupleElement(3), Regular}','{TupleElement(4), Regular}']
```
**map**
```sql title=Query theme={null}
SELECT getTypeSerializationStreams('Map(String, Int64)')
```
```response title=Response theme={null}
['{ArraySizes}','{ArrayElements, TupleElement(keys), Regular}','{ArrayElements, TupleElement(values), Regular}']
```
## globalVariable
導入バージョン: v20.5.0
定数の文字列引数を受け取り、その名前を持つグローバル変数の値を返します。この関数は MySQL との互換性のためのもので、ClickHouse の通常の運用では必要でも有用でもありません。定義されているダミーのグローバル変数はごくわずかです。
**構文**
```sql theme={null}
globalVariable(name)
```
**引数**
* `name` — グローバル変数の名前。[`String`](/ja/reference/data-types/string)
**戻り値**
変数 `name` の値を返します。[`Any`](/ja/reference/data-types/index)
**例**
**globalVariable**
```sql title=Query theme={null}
SELECT globalVariable('max_allowed_packet')
```
```response title=Response theme={null}
67108864
```
## hasColumnInTable
導入バージョン: v1.1.0
データベース内のテーブルに特定のカラムが存在するかどうかを確認します。
ネストされたデータ構造内の要素については、この関数はカラムの存在を確認します。
ネストされたデータ構造そのものに対しては、この関数は `0` を返します。
**構文**
```sql theme={null}
hasColumnInTable([hostname[, username[, password]],]database, table, column)
```
**引数**
* `database` — データベース名。[`const String`](/ja/reference/data-types/string)
* `table` — テーブル名。[`const String`](/ja/reference/data-types/string)
* `column` — カラム名。[`const String`](/ja/reference/data-types/string)
* `hostname` — 任意。確認を実行するリモートサーバー名。[`const String`](/ja/reference/data-types/string)
* `username` — 任意。リモートサーバーのユーザー名。[`const String`](/ja/reference/data-types/string)
* `password` — 任意。リモートサーバーのパスワード。[`const String`](/ja/reference/data-types/string)
**戻り値**
指定したカラムが存在する場合は `1`、存在しない場合は `0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**既存のカラムを確認する**
```sql title=Query theme={null}
SELECT hasColumnInTable('system','metrics','metric')
```
```response title=Response theme={null}
1
```
**存在しないカラムをチェックする**
```sql title=Query theme={null}
SELECT hasColumnInTable('system','metrics','non-existing_column')
```
```response title=Response theme={null}
0
```
## hasThreadFuzzer
導入バージョン: v20.6.0
thread fuzzer が有効になっているかどうかを返します。
この関数は、テストとデバッグにのみ有用です。
**構文**
```sql theme={null}
hasThreadFuzzer()
```
**引数**
* なし。
**戻り値**
Thread Fuzzer が有効になっているかどうかを返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**Thread Fuzzer の状態を確認する**
```sql title=Query theme={null}
SELECT hasThreadFuzzer()
```
```response title=Response theme={null}
┌─hasThreadFuzzer()─┐
│ 0 │
└───────────────────┘
```
## highlightQuery
導入バージョン: v26.5.0
ClickHouse SQLのクエリ文字列を解析し、構文ハイライト用の範囲の配列を返します。
各範囲は、開始位置 (バイト単位) 、終了位置、ハイライトの種類を含む名前付きタプルです。
ハイライトの種類は、その部分の構文上の役割 (キーワード、識別子、関数など) を表し、
UIで色を割り当てるために使用できます。LIKE および REGEXP の文字列パターン内では、メタ文字
とエスケープ文字は個別にハイライトされます。
**構文**
```sql theme={null}
highlightQuery(query)
```
**引数**
* `query` — ClickHouse SQLのクエリ文字列。String。
**戻り値**
ハイライトされた範囲を表す、名前付きタプル `(begin UInt64, end UInt64, type Enum8(...))` の配列。[`Array(Tuple(begin UInt64, end UInt64, type Enum8(...)))`](/ja/reference/data-types/array)
**例**
**シンプル**
```sql title=Query theme={null}
SELECT highlightQuery('SELECT 1')
```
```response title=Response theme={null}
[(0,6,'keyword'),(7,8,'number')]
```
## hostName
導入バージョン: v20.5.0
この関数が実行されたホスト名を返します。
関数がリモートサーバー上で実行される場合 (分散処理) 、そのリモートサーバー名が返されます。
関数が分散テーブルのコンテキストで実行される場合は、各分片に対応する値を持つ通常のカラムを生成します。
それ以外の場合は、定数値を返します。
**構文**
```sql theme={null}
hostName()
```
**別名**: `hostname`
**引数**
* ありません。
**戻り値**
ホスト名を返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT hostName()
```
```response title=Response theme={null}
┌─hostName()─┐
│ clickhouse │
└────────────┘
```
## icebergBucket
導入バージョン: v25.5.0
[iceberg bucket transform](https://iceberg.apache.org/spec/#bucket-transform-details.)のロジックを実装しています。
**構文**
```sql theme={null}
icebergBucket(N, value)
```
**引数**
* `N` — バケット数 (法) 。[`const (U)Int*`](/ja/reference/data-types/int-uint)
* `value` — 変換元の値。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Bool`](/ja/reference/data-types/boolean) または [`Decimal`](/ja/reference/data-types/decimal) または [`Float*`](/ja/reference/data-types/float) または [`String`](/ja/reference/data-types/string) または [`FixedString`](/ja/reference/data-types/fixedstring) または [`UUID`](/ja/reference/data-types/uuid) または [`Date`](/ja/reference/data-types/date) または [`Time`](/ja/reference/data-types/time) または [`DateTime`](/ja/reference/data-types/datetime)
**戻り値**
変換元の値の 32 ビットハッシュを返します。[`Int32`](/ja/reference/data-types/int-uint)
**例**
**例**
```sql title=Query theme={null}
SELECT icebergBucket(5, 1.0 :: Float32)
```
```response title=Response theme={null}
4
```
## icebergTruncate
導入バージョン: v25.3.0
Iceberg の truncate transform のロジックを実装しています: [https://iceberg.apache.org/spec/#truncate-transform-details](https://iceberg.apache.org/spec/#truncate-transform-details).
**構文**
```sql theme={null}
icebergTruncate(N, value)
```
**引数**
* `value` — 変換対象の値。[`String`](/ja/reference/data-types/string) または [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Decimal`](/ja/reference/data-types/decimal)
**戻り値**
引数と同じ型
**例**
**例**
```sql title=Query theme={null}
SELECT icebergTruncate(3, 'iceberg')
```
```response title=Response theme={null}
ice
```
## identity
導入バージョン: v1.1.0
この関数は、渡された引数をそのまま返します。デバッグやテストに便利です。これを使うと、索引の使用を回避して、代わりにフルスキャンのパフォーマンスを確認できます。クエリアナライザは、使用する索引を探す際に `identity` 関数内の内容をすべて無視し、定数畳み込みも無効にします。
**構文**
```sql theme={null}
identity(x)
```
**引数**
* `x` — 入力値。[`Any`](/ja/reference/data-types/index)
**戻り値**
入力値をそのまま返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
SELECT identity(42)
```
```response title=Response theme={null}
42
```
## ignore
導入バージョン: v1.1.0
任意の引数を受け取り、常に `0` を返します。
**構文**
```sql theme={null}
ignore(x)
```
**引数**
* `x` — 構文エラーを回避するためだけに渡され、実際には使用されない入力値です。[`Any`](/ja/reference/data-types/index)
**戻り値**
常に `0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT ignore(0, 'ClickHouse', NULL)
```
```response title=Response theme={null}
┌─ignore(0, 'ClickHouse', NULL)─┐
│ 0 │
└───────────────────────────────┘
```
## indexHint
導入バージョン: v1.1.0
この関数は、デバッグと内部診断を目的としています。
引数は無視され、常に 1 を返します。
引数は評価されません。
索引解析では、この関数の引数は `indexHint` でラップされていないものとして扱われます。
これにより、対応する条件に基づいて索引範囲内のデータを選択できますが、その条件による追加の絞り込みは行われません。
ClickHouse の索引はスパースであるため、`indexHint` を使用すると、同じ条件を直接指定した場合よりも多くのデータが返されます。
次を実行すると:
```sql theme={null}
SELECT * FROM test WHERE key = 123;
```
ClickHouse は次の 2 つを行います:
1. 索引を使って、`key = 123` を含む可能性のあるグラニュール (約 8192 行のブロック) を見つける
2. それらのグラニュールを読み取り、`key = 123` の行だけを返すように行ごとにフィルタする
そのため、ディスクから 8,192 行を読み取っても、実際に一致する 1 行だけが返されます。
一方、`indexHint` を使って次を実行すると:
```sql theme={null}
SELECT * FROM test WHERE indexHint(key = 123);
```
ClickHouse が行うのは 1 つだけです:
1. 索引を使って key = 123 を含む可能性のあるグラニュールを見つけ、それらのグラニュールから **フィルタせずに** すべての行を返す
`key = 456` や `key = 789` などの行も含め、8,192 行すべてが返されます。 (同じグラニュールにたまたま格納されていたものがすべて返されます。)
`indexHint()` はパフォーマンスのためのものではありません。これは、ClickHouse の索引がどのように機能するかをデバッグし、理解するためのものです:
* 自分の条件はどのグラニュールを選択しているか
* それらのグラニュールには何行あるか
* 自分の索引は効果的に使われているか
注: `indexHint` 関数を使ってクエリを最適化することはできません。`indexHint` 関数はクエリ解析に追加情報を与えないため、クエリを最適化しません。`indexHint` 関数の中に式を入れても、`indexHint` 関数を使わない場合と比べて何ら有利ではありません。`indexHint` 関数は内部診断とデバッグの目的でのみ使用でき、パフォーマンスを改善するものではありません。ClickHouse のコントリビューター以外が `indexHint` を使っているのを見かけた場合、それはおそらく誤りなので削除すべきです。
**構文**
```sql theme={null}
indexHint(expression)
```
**引数**
* `expression` — 索引範囲の選択に使用する任意の式。[`式`](/ja/reference/data-types/special-data-types/expression)
**戻り値**
常に `1` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**日付でフィルタリングする使用例**
```sql title=Query theme={null}
SELECT FlightDate AS k, count() FROM ontime WHERE indexHint(k = '2025-09-15') GROUP BY k ORDER BY k ASC;
```
```response title=Response theme={null}
┌──────────k─┬─count()─┐
│ 2025-09-14 │ 7071 │
│ 2025-09-15 │ 16428 │
│ 2025-09-16 │ 1077 │
│ 2025-09-30 │ 8167 │
└────────────┴─────────┘
```
## initialQueryID
導入バージョン: v1.1.0
現在の初期クエリの ID を返します。
クエリのその他のパラメータは、[`system.query_log`](/ja/reference/system-tables/query_log) の `initial_query_id` フィールドから取得できます。
[`queryID`](/ja/reference/functions/regular-functions/other-functions#queryID) 関数とは異なり、`initialQueryID` は異なる分片でも同じ結果を返します。
**構文**
```sql theme={null}
initialQueryID()
```
**別名**: `initial_query_id`
**引数**
* なし。
**戻り値**
現在のクエリの元となる初期クエリの ID を返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT initialQueryID() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
```
```response title=Response theme={null}
┌─count(DISTINCT t)─┐
│ 1 │
└───────────────────┘
```
## initialQueryStartTime
導入バージョン: v25.4.0
初期クエリの開始時刻を返します。
`initialQueryStartTime` は、異なる分片でも同じ結果を返します。
**構文**
```sql theme={null}
initialQueryStartTime()
```
**別名**: `initial_query_start_time`
**引数**
* なし。
**戻り値**
現在の初期クエリの開始時刻を返します。[`DateTime`](/ja/reference/data-types/datetime)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT initialQueryStartTime() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
```
```response title=Response theme={null}
┌─count(DISTINCT t)─┐
│ 1 │
└───────────────────┘
```
## initializeAggregation
導入バージョン: v20.6.0
単一の値に基づいて、集約関数の結果を計算します。
この関数は、[-State](/ja/reference/functions/aggregate-functions/combinators#-state) コンビネータを持つ集約関数を初期化するために使用できます。
集約関数の状態を作成して、それを [`AggregateFunction`](/ja/reference/data-types/aggregatefunction) 型のカラムに挿入したり、初期化された集約をデフォルト値として使用したりできます。
**Syntax**
```sql theme={null}
initializeAggregation(aggregate_function, arg1[, arg2, ...])
```
**引数**
* `aggregate_function` — 初期化する集約関数の名前。 [`String`](/ja/reference/data-types/string)
* `arg1[, arg2, ...]` — 集約関数の引数。 [`Any`](/ja/reference/data-types/index)
**戻り値**
関数に渡された各行について、集約結果を返します。戻り値の型は、`initializeAggregation` の第1引数として指定する関数の戻り値の型と同じです。 [`Any`](/ja/reference/data-types/index)
**例**
**uniqState を使った基本的な使い方**
```sql title=Query theme={null}
SELECT uniqMerge(state) FROM (SELECT initializeAggregation('uniqState', number % 3) AS state FROM numbers(10000));
```
```response title=Response theme={null}
┌─uniqMerge(state)─┐
│ 3 │
└──────────────────┘
```
**sumState と finalizeAggregation の使用**
```sql title=Query theme={null}
SELECT finalizeAggregation(state), toTypeName(state) FROM (SELECT initializeAggregation('sumState', number % 3) AS state FROM numbers(5));
```
```response title=Response theme={null}
┌─finalizeAggregation(state)─┬─toTypeName(state)─────────────┐
│ 0 │ AggregateFunction(sum, UInt8) │
│ 1 │ AggregateFunction(sum, UInt8) │
│ 2 │ AggregateFunction(sum, UInt8) │
│ 0 │ AggregateFunction(sum, UInt8) │
│ 1 │ AggregateFunction(sum, UInt8) │
└────────────────────────────┴───────────────────────────────┘
```
## isConstant
導入バージョン: v20.3.0
引数が定数式であるかどうかを返します。
定数式とは、その結果がクエリ分析中、つまり実行前に確定している式です。
たとえば、[リテラル](/ja/reference/syntax#literals)からなる式は定数式です。
この関数は主に、開発、デバッグ、デモンストレーションを目的としています。
**構文**
```sql theme={null}
isConstant(x)
```
**引数**
* `x` — 確認する式。[`Any`](/ja/reference/data-types/index)
**戻り値**
`x` が定数であれば `1`、定数でなければ `0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**定数式**
```sql title=Query theme={null}
SELECT isConstant(x + 1)
FROM (SELECT 43 AS x)
```
```response title=Response theme={null}
┌─isConstant(plus(x, 1))─┐
│ 1 │
└────────────────────────┘
```
**関数を伴う定数**
```sql title=Query theme={null}
WITH 3.14 AS pi
SELECT isConstant(cos(pi))
```
```response title=Response theme={null}
┌─isConstant(cos(pi))─┐
│ 1 │
└─────────────────────┘
```
**非定数式**
```sql title=Query theme={null}
SELECT isConstant(number)
FROM numbers(1)
```
```response title=Response theme={null}
┌─isConstant(number)─┐
│ 0 │
└────────────────────┘
```
**now() 関数の動作**
```sql title=Query theme={null}
SELECT isConstant(now())
```
```response title=Response theme={null}
┌─isConstant(now())─┐
│ 1 │
└───────────────────┘
```
## isDecimalOverflow
導入バージョン: v20.8.0
10進数が、指定された精度の Decimal データ型に収まるには桁数が多すぎるかどうかを判定します。
**構文**
```sql theme={null}
isDecimalOverflow(value[, precision])
```
**引数**
* `value` — チェック対象の Decimal 値。[`Decimal`](/ja/reference/data-types/decimal)
* `precision` — 任意。Decimal 型の精度です。省略した場合は、最初の引数の元の精度が使用されます。[`UInt8`](/ja/reference/data-types/int-uint)
**戻り値**
Decimal 値の桁数がその精度で許容される桁数を超えている場合は `1`、指定された精度を満たしている場合は `0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT isDecimalOverflow(toDecimal32(1000000000, 0), 9),
isDecimalOverflow(toDecimal32(1000000000, 0)),
isDecimalOverflow(toDecimal32(-1000000000, 0), 9),
isDecimalOverflow(toDecimal32(-1000000000, 0));
```
```response title=Response theme={null}
┌─isDecimalOverflow(toDecimal32(1000000000, 0), 9)─┬─isDecimalOverflow(toDecimal32(1000000000, 0))─┬─isDecimalOverflow(toDecimal32(-1000000000, 0), 9)─┬─isDecimalOverflow(toDecimal32(-1000000000, 0))─┐
│ 1 │ 1 │ 1 │ 1 │
└──────────────────────────────────────────────────┴───────────────────────────────────────────────┴───────────────────────────────────────────────────┴────────────────────────────────────────────────┘
```
## joinGet
導入バージョン: v18.16.0
Dictionary と同様に、テーブルからデータを取得できます。
指定した結合キーを使って Join テーブルからデータを取得します。
`ENGINE = Join(ANY, LEFT, )` [ステートメント](/ja/reference/engines/table-engines/special/join) で作成されたテーブルのみサポートしています。
**構文**
```sql theme={null}
joinGet(join_storage_table_name, value_column, join_keys)
```
**引数**
* `join_storage_table_name` — 検索対象を示す識別子です。この識別子はデフォルトデータベース内で検索されます (設定ファイルのパラメータ `default_database` を参照) 。デフォルトデータベースを変更するには、`USE database_name` クエリを使用するか、`database_name.table_name` のようにデータベース名とテーブル名をドットで指定します。[`String`](/ja/reference/data-types/string)
* `value_column` — 必要なデータを含むtableのカラム名です。[`const String`](/ja/reference/data-types/string)
* `join_keys` — 結合キーのリストです。[`Any`](/ja/reference/data-types/index)
**戻り値**
キーのリストに対応する値のリストを返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE db_test.id_val(`id` UInt32, `val` UInt32) ENGINE = Join(ANY, LEFT, id);
INSERT INTO db_test.id_val VALUES (1,11)(2,12)(4,13);
SELECT joinGet(db_test.id_val, 'val', toUInt32(1));
```
```response title=Response theme={null}
┌─joinGet(db_test.id_val, 'val', toUInt32(1))─┐
│ 11 │
└─────────────────────────────────────────────┘
```
**現在のデータベース内のテーブルを使用する場合**
```sql title=Query theme={null}
USE db_test;
SELECT joinGet(id_val, 'val', toUInt32(2));
```
```response title=Response theme={null}
┌─joinGet(id_val, 'val', toUInt32(2))─┐
│ 12 │
└─────────────────────────────────────┘
```
**結合キーとしてArrayを使用する**
```sql title=Query theme={null}
CREATE TABLE some_table (id1 UInt32, id2 UInt32, name String) ENGINE = Join(ANY, LEFT, id1, id2);
INSERT INTO some_table VALUES (1, 11, 'a') (2, 12, 'b') (3, 13, 'c');
SELECT joinGet(some_table, 'name', 1, 11);
```
```response title=Response theme={null}
┌─joinGet(some_table, 'name', 1, 11)─┐
│ a │
└────────────────────────────────────┘
```
## joinGetOrNull
導入バージョン: v20.4.0
Dictionary と同様の方法で、テーブルからデータを取得できます。
指定した結合キーを使用して Join テーブルからデータを取得します。
[`joinGet`](#joinGet) とは異なり、キーが存在しない場合は `NULL` を返します。
`ENGINE = Join(ANY, LEFT, )` [ステートメント](/ja/reference/engines/table-engines/special/join) で作成されたテーブルのみサポートします。
**構文**
```sql theme={null}
joinGetOrNull(join_storage_table_name, value_column, join_keys)
```
**引数**
* `join_storage_table_name` — 検索を実行する場所を指定する識別子です。この識別子はデフォルトデータベース内で検索されます (設定ファイルの default\_database パラメータを参照) 。デフォルトデータベースを変更するには、`USE database_name` クエリを使用するか、`database_name.table_name` のようにドット区切りでデータベース名とテーブル名を指定します。[`String`](/ja/reference/data-types/string)
* `value_column` — 必要なデータを含むテーブルのカラム名です。[`const String`](/ja/reference/data-types/string)
* `join_keys` — 結合キーのリストです。[`Any`](/ja/reference/data-types/index)
**戻り値**
キーのリストに対応する値のリストを返します。キーが見つからない場合は `NULL` を返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE db_test.id_val(`id` UInt32, `val` UInt32) ENGINE = Join(ANY, LEFT, id);
INSERT INTO db_test.id_val VALUES (1,11)(2,12)(4,13);
SELECT joinGetOrNull(db_test.id_val, 'val', toUInt32(1)), joinGetOrNull(db_test.id_val, 'val', toUInt32(999));
```
```response title=Response theme={null}
┌─joinGetOrNull(db_test.id_val, 'val', toUInt32(1))─┬─joinGetOrNull(db_test.id_val, 'val', toUInt32(999))─┐
│ 11 │ ᴺᵁᴸᴸ │
└───────────────────────────────────────────────────┴─────────────────────────────────────────────────────┘
```
## lowCardinalityIndices
導入バージョン: v18.12.0
[LowCardinality](/ja/reference/data-types/lowcardinality) カラムの辞書内での値の位置を返します。位置は 1 から始まります。LowCardinality ではパーツごとに辞書が作成されるため、この関数はパーツが異なると同じ値に対しても異なる位置を返す場合があります。
**構文**
```sql theme={null}
lowCardinalityIndices(col)
```
**引数**
* `col` — 低カーディナリティのカラム。[`LowCardinality`](/ja/reference/data-types/lowcardinality)
**戻り値**
現在のパートの Dictionary 内における値の位置。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
DROP TABLE IF EXISTS test;
CREATE TABLE test (s LowCardinality(String)) ENGINE = Memory;
-- 2つのパーツを作成する:
INSERT INTO test VALUES ('ab'), ('cd'), ('ab'), ('ab'), ('df');
INSERT INTO test VALUES ('ef'), ('cd'), ('ab'), ('cd'), ('ef');
SELECT s, lowCardinalityIndices(s) FROM test;
```
```response title=Response theme={null}
┌─s──┬─lowCardinalityIndices(s)─┐
│ ab │ 1 │
│ cd │ 2 │
│ ab │ 1 │
│ ab │ 1 │
│ df │ 3 │
└────┴──────────────────────────┘
┌─s──┬─lowCardinalityIndices(s)─┐
│ ef │ 1 │
│ cd │ 2 │
│ ab │ 3 │
│ cd │ 2 │
│ ef │ 1 │
└────┴──────────────────────────┘
```
## lowCardinalityKeys
導入バージョン: v18.12.0
[LowCardinality](/ja/reference/data-types/lowcardinality) カラムの辞書値を返します。
ブロックが辞書サイズより小さい、または大きい場合、結果は切り詰められるか、デフォルト値で拡張されます。
LowCardinality はパーツごとに辞書を持つため、この関数はパーツによって異なる辞書値を返す場合があります。
**構文**
```sql theme={null}
lowCardinalityKeys(col)
```
**引数**
* `col` — 低カーディナリティのカラムです。[`LowCardinality`](/ja/reference/data-types/lowcardinality)
**戻り値**
辞書キーを返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**lowCardinalityKeys**
```sql title=Query theme={null}
DROP TABLE IF EXISTS test;
CREATE TABLE test (s LowCardinality(String)) ENGINE = Memory;
-- 2つのパーツを作成する:
INSERT INTO test VALUES ('ab'), ('cd'), ('ab'), ('ab'), ('df');
INSERT INTO test VALUES ('ef'), ('cd'), ('ab'), ('cd'), ('ef');
SELECT s, lowCardinalityKeys(s) FROM test;
```
```response title=Response theme={null}
┌─s──┬─lowCardinalityKeys(s)─┐
│ ef │ │
│ cd │ ef │
│ ab │ cd │
│ cd │ ab │
│ ef │ │
└────┴───────────────────────┘
┌─s──┬─lowCardinalityKeys(s)─┐
│ ab │ │
│ cd │ ab │
│ ab │ cd │
│ ab │ df │
│ df │ │
└────┴───────────────────────┘
```
## materialize
導入バージョン: v1.1.0
定数を、単一の値を含むフルカラムに変換します。
フルカラムと定数は、メモリ内では異なる形で表現されます。
関数は通常、通常の引数と定数引数に対して異なるコードを実行しますが、結果は一般に同じになるはずです。
この関数は、この動作をデバッグするために使用できます。
**構文**
```sql theme={null}
materialize(x)
```
**引数**
* `x` — 定数。[`Any`](/ja/reference/data-types/index)
**戻り値**
定数値を含む通常のカラムを返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
-- In the example below the `countMatches` function expects a constant second argument.
-- This behaviour can be debugged by using the `materialize` function to turn a constant into a full column,
-- verifying that the function throws an error for a non-constant argument.
SELECT countMatches('foobarfoo', 'foo');
SELECT countMatches('foobarfoo', materialize('foo'));
```
```response title=Response theme={null}
2
Code: 44. DB::Exception: Received from localhost:9000. DB::Exception: Illegal type of argument #2 'pattern' of function countMatches, expected constant String, got String
```
## minSampleSizeContinuous
導入バージョン: v23.10.0
2 つのサンプルにおける連続値メトリクスの平均を比較する A/B テストに必要な最小サンプルサイズを計算します。
[この記事](https://towardsdatascience.com/required-sample-size-for-a-b-testing-6f6608dd330a)で説明されている式を使用します。
介入群と対照群のサイズが等しいことを前提としています。
1 グループあたりに必要なサンプルサイズを返します (つまり、実験全体で必要なサンプルサイズは戻り値の 2 倍です) 。
また、テスト対象メトリクスの分散が介入群と対照群で等しいことも前提としています。
**構文**
```sql theme={null}
minSampleSizeContinuous(baseline, sigma, mde, power, alpha)
```
**別名**: `minSampleSizeContinous`
**引数**
* `baseline` — メトリックのベースライン値。 [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
* `sigma` — メトリックのベースライン標準偏差。 [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
* `mde` — ベースライン値に対する割合としての最小検出効果 (MDE) (例: ベースライン値が 112.25 の場合、MDE が 0.03 であれば、112.25 ± 112.25\*0.03 への変化を想定します) 。 [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
* `power` — テストに必要な統計的検出力 (1 - 第 II 種過誤の確率) 。 [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
* `alpha` — テストに必要な有意水準 (第 I 種過誤の確率) 。 [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float)
**戻り値**
3 つの要素 `minimum_sample_size`、`detect_range_lower`、`detect_range_upper` を持つ名前付き Tuple を返します。これらはそれぞれ、必要なサンプルサイズ、返される必要サンプルサイズでは検出できない値の範囲の下限 (`baseline * (1 - mde)` として計算) 、および返される必要サンプルサイズでは検出できない値の範囲の上限 (`baseline * (1 + mde)` として計算) です (Float64) 。 [`Tuple(Float64, Float64, Float64)`](/ja/reference/data-types/tuple)
**例**
**minSampleSizeContinuous**
```sql title=Query theme={null}
SELECT minSampleSizeContinuous(112.25, 21.1, 0.03, 0.80, 0.05) AS sample_size
```
```response title=Response theme={null}
(616.2931945826209,108.8825,115.6175)
```
## minSampleSizeConversion
導入バージョン: v22.6.0
2 つのサンプルにおけるコンバージョン率 (比率) を比較する A/B テストで、必要な最小サンプルサイズを計算します。
[この記事](https://towardsdatascience.com/required-sample-size-for-a-b-testing-6f6608dd330a)で説明されている式を使用します。介入群と対照群のサイズが等しいことを前提としています。戻り値は一方のグループに必要なサンプルサイズです (つまり、実験全体に必要なサンプルサイズはこの戻り値の 2 倍です) 。
**構文**
```sql theme={null}
minSampleSizeConversion(baseline, mde, power, alpha)
```
**引数**
* `baseline` — ベースラインのコンバージョン率。[`Float*`](/ja/reference/data-types/float)
* `mde` — パーセンテージポイントで表した最小検出可能効果 (MDE) 。 (例: ベースラインのコンバージョン率が 0.25 の場合、MDE が 0.03 であれば、0.25 ± 0.03 への変化を想定します。) [`Float*`](/ja/reference/data-types/float)
* `power` — テストで必要な統計的検出力 (1 - 第 II 種過誤の確率) 。[`Float*`](/ja/reference/data-types/float)
* `alpha` — テストで必要な有意水準 (第 I 種過誤の確率) 。[`Float*`](/ja/reference/data-types/float)
**戻り値**
3 つの要素 `minimum_sample_size`、`detect_range_lower`、`detect_range_upper` を持つ名前付きTupleを返します。これらはそれぞれ、必要なサンプルサイズ、返される必要サンプルサイズでは検出できない値の範囲の下限 (`baseline - mde` として計算) 、返される必要サンプルサイズでは検出できない値の範囲の上限 (`baseline + mde` として計算) を表します。[`Tuple(Float64, Float64, Float64)`](/ja/reference/data-types/tuple)
**例**
**minSampleSizeConversion**
```sql title=Query theme={null}
SELECT minSampleSizeConversion(0.25, 0.03, 0.80, 0.05) AS sample_size
```
```response title=Response theme={null}
(3396.077603219163,0.22,0.28)
```
## neighbor
導入バージョン: v20.1.0
現在の行から指定したオフセット位置にあるカラムの値を返します。
この関数は非推奨です。`data block` の物理的な順序に基づいて動作するため、ユーザーが想定する論理的な順序と一致しない可能性があり、エラーを引き起こしやすくなっています。
代わりに、適切なウィンドウ関数の使用を検討してください。
この関数は、`allow_deprecated_error_prone_window_functions = 1` を設定することで有効にできます。
**構文**
```sql theme={null}
neighbor(column, offset[, default_value])
```
**引数**
* `column` — 対象のカラム。[`Any`](/ja/reference/data-types/index)
* `offset` — 現在の行からのオフセット。正の値は後方を、負の値は前方を参照します。[`Integer`](/ja/reference/data-types/int-uint)
* `default_value` — 任意。オフセットがデータ範囲外になった場合に返す値です。指定しない場合は、カラム型のデフォルト値が使用されます。[`Any`](/ja/reference/data-types/index)
**戻り値**
指定したオフセット位置の値を返します。範囲外の場合はデフォルト値を返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
SELECT number, neighbor(number, 2) FROM system.numbers LIMIT 10;
```
```response title=Response theme={null}
┌─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 title=Query theme={null}
SELECT number, neighbor(number, 2, 999) FROM system.numbers LIMIT 10;
```
```response title=Response theme={null}
┌─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 │
└────────┴──────────────────────────┘
```
## normalizeQuery
導入バージョン: v20.8.0
リテラル、リテラルの並び、および複雑な別名 (空白を含むもの、3 桁以上の数字を含むもの、または UUID のように 36 バイト以上の長さを持つもの) をプレースホルダー `?` に置き換えます。
**構文**
```sql theme={null}
normalizeQuery(x)
```
**引数**
* `x` — 文字列。[`String`](/ja/reference/data-types/string)
**戻り値**
プレースホルダーに置き換えた指定の文字列を返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT normalizeQuery('[1, 2, 3, x]') AS query
```
```response title=Response theme={null}
┌─query────┐
│ [?.., x] │
└──────────┘
```
## normalizeQueryKeepNames
導入バージョン: v21.2.0
リテラルおよびリテラルの並びをプレースホルダー `?` に置き換えますが、複雑な別名 (空白を含むもの、3 桁以上の数字を含むもの、または UUID などのように 36 バイト以上の長さを持つもの) は置き換えません。
これにより、複雑なクエリログをより適切に分析しやすくなります。
**構文**
```sql theme={null}
normalizeQueryKeepNames(x)
```
**引数**
* `x` — 文字列。[`String`](/ja/reference/data-types/string)
**戻り値**
指定された文字列をプレースホルダー付きで返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT normalizeQuery('SELECT 1 AS aComplexName123'), normalizeQueryKeepNames('SELECT 1 AS aComplexName123')
```
```response title=Response theme={null}
┌─normalizeQuery('SELECT 1 AS aComplexName123')─┬─normalizeQueryKeepNames('SELECT 1 AS aComplexName123')─┐
│ SELECT ? AS `?` │ SELECT ? AS aComplexName123 │
└───────────────────────────────────────────────┴────────────────────────────────────────────────────────┘
```
## normalizedQueryHash
導入バージョン: v20.8.0
類似したクエリに対して、リテラル値を除外した同一の64ビットハッシュ値を返します。
クエリログの分析に役立ちます。
**構文**
```sql theme={null}
normalizedQueryHash(x)
```
**引数**
* `x` — 文字列。[`String`](/ja/reference/data-types/string)
**戻り値**
64ビットのハッシュ値を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT normalizedQueryHash('SELECT 1 AS `xyz`') != normalizedQueryHash('SELECT 1 AS `abc`') AS res
```
```response title=Response theme={null}
┌─res─┐
│ 1 │
└─────┘
```
## normalizedQueryHashKeepNames
導入バージョン: v21.2.0
[`normalizedQueryHash`](#normalizedQueryHash) と同様に、類似したクエリに対してはリテラル値を除いた同一の64ビットのハッシュ値を返しますが、ハッシュ化の前に複雑な別名 (空白を含む、3桁以上の数字を含む、または UUID のように36バイト以上の長さがあるもの) をプレースホルダーに置き換えることはありません。
クエリログの分析に役立ちます。
**構文**
```sql theme={null}
normalizedQueryHashKeepNames(x)
```
**引数**
* `x` — 文字列。[`String`](/ja/reference/data-types/string)
**戻り値**
64 ビットのハッシュ値を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT normalizedQueryHash('SELECT 1 AS `xyz123`') != normalizedQueryHash('SELECT 1 AS `abc123`') AS normalizedQueryHash;
SELECT normalizedQueryHashKeepNames('SELECT 1 AS `xyz123`') != normalizedQueryHashKeepNames('SELECT 1 AS `abc123`') AS normalizedQueryHashKeepNames;
```
```response title=Response theme={null}
┌─normalizedQueryHash─┐
│ 0 │
└─────────────────────┘
┌─normalizedQueryHashKeepNames─┐
│ 1 │
└──────────────────────────────┘
```
## obfuscateQuery
導入バージョン: v26.4.0
識別子をランダムな単語に、リテラルをランダムな値に置き換えつつ、クエリ構造を維持したまま SQL クエリを難読化します。
この関数は、デバッグ目的でクエリをログに記録したり共有したりする前に、クエリを匿名化するのに役立ちます。
同じ入力クエリであっても、行が異なれば異なる難読化結果が生成されるため、
複数のクエリを扱う際のプライバシー保護に役立ちます。
オプションの `tag` パラメータは、同じ関数呼び出しが
1 つのクエリ内で複数回使われる場合に、共通部分式除去を防ぎます。これにより、呼び出しごとに異なる難読化結果が生成されます。
特長:
* テーブル名、カラム名、別名をランダムな単語に置き換えます
* 数値リテラルと文字列リテラルをランダムな値に置き換えます
* クエリ全体の構造と SQL 構文を保持します
* 行ごとに異なる結果を生成します
**構文**
```sql theme={null}
obfuscateQuery(query[, tag])
```
**引数**
* `query` — 難読化する SQL クエリ。[`String`](/ja/reference/data-types/string)
* `tag` — 任意。同じ関数呼び出しが複数回使用される場合に、共通部分式除去を防ぐための値です。
**戻り値**
識別子とリテラルを置き換えつつ、元のクエリ構造を保持した難読化済みクエリ。[`String`](/ja/reference/data-types/string)
**例**
**基本的な使い方**
```sql title=Query theme={null}
SELECT obfuscateQuery('SELECT name, age FROM users WHERE age > 30')
```
```response title=Response theme={null}
SELECT fruit, number FROM table WHERE number > 12
```
**共通部分式除去を防ぐためのタグ付き**
```sql title=Query theme={null}
SELECT obfuscateQuery('SELECT * FROM t', 1), obfuscateQuery('SELECT * FROM t', 2)
```
```response title=Response theme={null}
SELECT a FROM b, SELECT c FROM d
```
**行が異なると結果も異なります**
```sql title=Query theme={null}
SELECT obfuscateQuery('SELECT 1') AS a, obfuscateQuery('SELECT 1') AS b
```
```response title=Response theme={null}
A B
```
## obfuscateQueryWithSeed
導入バージョン: v26.4.0
指定した seed を使って SQL クエリを難読化し、決定論的な結果を得られます。
`obfuscateQuery()` とは異なり、この関数は同じ seed を指定すると常に同じ結果を返します。
そのため、複数回の実行にわたって一貫した難読化が必要な場合や、
テストやデバッグのために同じ難読化済みクエリを再現したい場合に役立ちます。
特徴:
* 指定した seed に基づく決定論的な難読化
* 同じ seed からは常に同じ難読化結果を生成
* 異なる seed からは異なる結果を生成
* `obfuscateQuery()` と同様にクエリの構造を保持
使用例:
* 再現可能なテストケース
* 複数回の実行で一貫した匿名化
* 一貫した難読化済みクエリを用いたデバッグ
**構文**
```sql theme={null}
obfuscateQueryWithSeed(query, seed)
```
**引数**
* `query` — 難読化する SQL クエリ。 [`String`](/ja/reference/data-types/string)
* `seed` — 難読化に使用するシード。同じシードを指定すると、決定論的な結果が生成されます。 [`Integer`](/ja/reference/data-types/int-uint) または [`String`](/ja/reference/data-types/string)
**戻り値**
指定したシードに基づいて決定論的に生成された、難読化済みのクエリ。 [`String`](/ja/reference/data-types/string)
**例**
**整数シードを使用した決定論的な難読化**
```sql title=Query theme={null}
SELECT obfuscateQueryWithSeed('SELECT name FROM users', 42)
```
```response title=Response theme={null}
SELECT fruit FROM table
```
**文字列シードによる決定論的な難読化**
```sql title=Query theme={null}
SELECT obfuscateQueryWithSeed('SELECT id, value FROM data', 'myseed')
```
```response title=Response theme={null}
SELECT a, b FROM c
```
**同じシードなら同じ結果になる**
```sql title=Query theme={null}
SELECT obfuscateQueryWithSeed('SELECT 1', 100) = obfuscateQueryWithSeed('SELECT 1', 100)
```
```response title=Response theme={null}
true
```
## parseReadableSize
導入バージョン: v24.6.0
バイトサイズを表す文字列と、その単位として `B`、`KiB`、`KB`、`MiB`、`MB` など (つまり [ISO/IEC 80000-13](https://en.wikipedia.org/wiki/ISO/IEC_80000) または 10 進バイト単位) が与えられると、この関数は対応するバイト数を返します。
この関数が入力値を解析できない場合は、例外をスローします。
この関数の逆演算は [`formatReadableSize`](#formatReadableSize) と [`formatReadableDecimalSize`](#formatReadableDecimalSize) です。
**構文**
```sql theme={null}
parseReadableSize(x)
```
**引数**
* `x` — ISO/IEC 80000-13 または 10 進のバイト単位を使用した、読みやすいサイズ表記。[`String`](/ja/reference/data-types/string)
**戻り値**
最も近い整数に切り上げられたバイト数を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB']) AS readable_sizes, parseReadableSize(readable_sizes) AS sizes;
```
```response title=Response theme={null}
┌─readable_sizes─┬───sizes─┐
│ 1 B │ 1 │
│ 1 KiB │ 1024 │
│ 3 MB │ 3000000 │
│ 5.314 KiB │ 5442 │
└────────────────┴─────────┘
```
## parseReadableSizeOrNull
導入バージョン: v24.6.0
バイトサイズを表す文字列と、その単位として `B`、`KiB`、`KB`、`MiB`、`MB` など (つまり [ISO/IEC 80000-13](https://en.wikipedia.org/wiki/ISO/IEC_80000) または10進のバイト単位) を受け取り、対応するバイト数を返します。
入力値を解析できない場合、この関数は `NULL` を返します。
この関数の逆演算は [`formatReadableSize`](#formatReadableSize) と [`formatReadableDecimalSize`](#formatReadableDecimalSize) です。
**構文**
```sql theme={null}
parseReadableSizeOrNull(x)
```
**引数**
* `x` — ISO/IEC 80000-13 または 10 進バイト単位で表された、人が読みやすい形式のサイズ。[`String`](/ja/reference/data-types/string)
**戻り値**
バイト数を返します。最も近い整数に切り上げられ、入力を解析できない場合は `NULL` を返します。[`Nullable(UInt64)`](/ja/reference/data-types/nullable)
**例**
**使用例**
```sql title=Query theme={null}
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB', 'invalid']) AS readable_sizes, parseReadableSizeOrNull(readable_sizes) AS sizes;
```
```response title=Response theme={null}
┌─readable_sizes─┬───sizes─┐
│ 1 B │ 1 │
│ 1 KiB │ 1024 │
│ 3 MB │ 3000000 │
│ 5.314 KiB │ 5442 │
│ invalid │ ᴺᵁᴸᴸ │
└────────────────┴─────────┘
```
## parseReadableSizeOrZero
導入バージョン: v24.6.0
バイトサイズを表す文字列を受け取り、単位として `B`、`KiB`、`KB`、`MiB`、`MB` など (つまり [ISO/IEC 80000-13](https://en.wikipedia.org/wiki/ISO/IEC_80000) または 10 進バイト単位) を含む場合、この関数は対応するバイト数を返します。
この関数が入力値を解析できない場合は、`0` を返します。
この関数の逆関数にあたるのは [`formatReadableSize`](#formatReadableSize) と [`formatReadableDecimalSize`](#formatReadableDecimalSize) です。
**構文**
```sql theme={null}
parseReadableSizeOrZero(x)
```
**引数**
* `x` — ISO/IEC 80000-13 または 10 進のバイト単位による、人間が読みやすいサイズ。[`String`](/ja/reference/data-types/string)
**戻り値**
最も近い整数に切り上げたバイト数を返します。入力をパースできない場合は `0` を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT arrayJoin(['1 B', '1 KiB', '3 MB', '5.314 KiB', 'invalid']) AS readable_sizes, parseReadableSizeOrZero(readable_sizes) AS sizes;
```
```response title=Response theme={null}
┌─readable_sizes─┬───sizes─┐
│ 1 B │ 1 │
│ 1 KiB │ 1024 │
│ 3 MB │ 3000000 │
│ 5.314 KiB │ 5442 │
│ invalid │ 0 │
└────────────────┴─────────┘
```
## parseTimeDelta
導入バージョン: v22.7.0
数値の並びの後に時間単位に類する文字列が続く値を解析します。
time delta 文字列では、次の時間単位指定を使用できます。
* `years`, `year`, `yr`, `y`
* `months`, `month`, `mo`
* `weeks`, `week`, `w`
* `days`, `day`, `d`
* `hours`, `hour`, `hr`, `h`
* `minutes`, `minute`, `min`, `m`
* `seconds`, `second`, `sec`, `s`
* `milliseconds`, `millisecond`, `millisec`, `ms`
* `microseconds`, `microsecond`, `microsec`, `μs`, `µs`, `us`
* `nanoseconds`, `nanosecond`, `nanosec`, `ns`
複数の時間単位は、区切り文字 (空白、`;`、`-`、`+`、`,`、`:`) を使って組み合わせることができます。
年と月の長さは概算です。1 年は 365 日、1 か月は 30.5 日として扱います。
**構文**
```sql theme={null}
parseTimeDelta(timestr)
```
**引数**
* `timestr` — 数字の並びに、時間の単位を表す文字列が続く値。[`String`](/ja/reference/data-types/string)
**戻り値**
秒数を表す値。[`Float64`](/ja/reference/data-types/float)
**例**
**使用例**
```sql title=Query theme={null}
SELECT parseTimeDelta('11s+22min')
```
```response title=Response theme={null}
┌─parseTimeDelta('11s+22min')─┐
│ 1331 │
└─────────────────────────────┘
```
**複合時間単位**
```sql title=Query theme={null}
SELECT parseTimeDelta('1yr2mo')
```
```response title=Response theme={null}
┌─parseTimeDelta('1yr2mo')─┐
│ 36806400 │
└──────────────────────────┘
```
## partitionId
導入バージョン: v21.4.0
[パーティション ID](/ja/reference/engines/table-engines/mergetree-family/custom-partitioning-key)を計算します。
この関数は低速なため、大量の行に対しては呼び出さないでください。
**構文**
```sql theme={null}
partitionId(column1[, column2, ...])
```
**別名**: `partitionID`
**引数**
* `column1, column2, ...` — パーティション ID を返す対象となるカラム。
**戻り値**
その行が属するパーティション ID を返します。 [`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
DROP TABLE IF EXISTS tab;
CREATE TABLE tab
(
i int,
j int
)
ENGINE = MergeTree
PARTITION BY i
ORDER BY tuple();
INSERT INTO tab VALUES (1, 1), (1, 2), (1, 3), (2, 4), (2, 5), (2, 6);
SELECT i, j, partitionId(i), _partition_id FROM tab ORDER BY i, j;
```
```response title=Response theme={null}
┌─i─┬─j─┬─partitionId(i)─┬─_partition_id─┐
│ 1 │ 1 │ 1 │ 1 │
│ 1 │ 2 │ 1 │ 1 │
│ 1 │ 3 │ 1 │ 1 │
│ 2 │ 4 │ 2 │ 2 │
│ 2 │ 5 │ 2 │ 2 │
│ 2 │ 6 │ 2 │ 2 │
└───┴───┴────────────────┴───────────────┘
```
## queryID
導入バージョン: v21.9.0
現在のクエリの ID を返します。
クエリの他のパラメータは、[`system.query_log`](/ja/reference/system-tables/query_log) テーブルの `query_id` フィールドから取得できます。
[`initialQueryID`](#initialQueryID) 関数とは異なり、`queryID` は分片ごとに異なる結果を返す場合があります。
**構文**
```sql theme={null}
queryID()
```
**別名**: `query_id`
**引数**
* なし。
**戻り値**
現在のクエリIDを返します。 [`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE tmp (str String) ENGINE = Log;
INSERT INTO tmp (*) VALUES ('a');
SELECT count(DISTINCT t) FROM (SELECT queryID() AS t FROM remote('127.0.0.{1..3}', currentDatabase(), 'tmp') GROUP BY queryID());
```
```response title=Response theme={null}
┌─count(DISTINCT t)─┐
│ 3 │
└───────────────────┘
```
## revision
導入バージョン: v22.7.0
現在の ClickHouse server のリビジョン番号を返します。
**構文**
```sql theme={null}
revision()
```
**引数**
* なし。
**戻り値**
現在のClickHouseサーバーのリビジョンを返します。[`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT revision()
```
```response title=Response theme={null}
┌─revision()─┐
│ 54485 │
└────────────┘
```
## rowNumberInAllBlocks
導入バージョン: v1.1.0
処理される各行に対して一意の行番号を返します。
**構文**
```sql theme={null}
rowNumberInAllBlocks()
```
**引数**
* なし。
**戻り値**
データブロック内の行番号を、`0` から始まる序数で返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT rowNumberInAllBlocks()
FROM
(
SELECT *
FROM system.numbers_mt
LIMIT 10
)
SETTINGS max_block_size = 2
```
```response title=Response theme={null}
┌─rowNumberInAllBlocks()─┐
│ 0 │
│ 1 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│ 4 │
│ 5 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│ 2 │
│ 3 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│ 6 │
│ 7 │
└────────────────────────┘
┌─rowNumberInAllBlocks()─┐
│ 8 │
│ 9 │
└────────────────────────┘
```
## rowNumberInBlock
導入バージョン: v1.1.0
`rowNumberInBlock` は、処理対象の各[ブロック](/ja/resources/develop-contribute/introduction/architecture#block)について、現在の行の番号を返します。
返される番号は、各ブロックごとに 0 から始まります。
**構文**
```sql theme={null}
rowNumberInBlock()
```
**引数**
* なし。
**戻り値**
`0` から始まるデータブロック内の行の序数を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT rowNumberInBlock()
FROM
(
SELECT *
FROM system.numbers_mt
LIMIT 10
) SETTINGS max_block_size = 2
```
```response title=Response theme={null}
┌─rowNumberInBlock()─┐
│ 0 │
│ 1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│ 0 │
│ 1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│ 0 │
│ 1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│ 0 │
│ 1 │
└────────────────────┘
┌─rowNumberInBlock()─┐
│ 0 │
│ 1 │
└────────────────────┘
```
## runningAccumulate
導入バージョン: v1.1.0
データブロックの各行について、集約関数の状態を累積します。
**非推奨**
状態は新しいデータブロックごとにリセットされます。
この挙動は誤りを招きやすいため、この関数は非推奨となっており、代わりに[ウィンドウ関数](/ja/reference/functions/window-functions/index)を使用することを推奨します。
この関数の使用を許可するには、設定[`allow_deprecated_error_prone_window_functions`](/ja/reference/settings/session-settings#allow_deprecated_error_prone_window_functions)を使用できます。
**構文**
```sql theme={null}
runningAccumulate(agg_state[, grouping])
```
**引数**
* `agg_state` — 集約関数の状態。[`AggregateFunction`](/ja/reference/data-types/aggregatefunction)
* `grouping` — 任意。グループ化キー。`grouping` の値が変わると、関数の状態はリセットされます。等価演算子が定義されている任意のサポート対象データ型を指定できます。[`Any`](/ja/reference/data-types/index)
**戻り値**
各行の累積結果を返します。[`Any`](/ja/reference/data-types/index)
**例**
**initializeAggregation を使用した使用例**
```sql title=Query theme={null}
WITH initializeAggregation('sumState', number) AS one_row_sum_state
SELECT
number,
finalizeAggregation(one_row_sum_state) AS one_row_sum,
runningAccumulate(one_row_sum_state) AS cumulative_sum
FROM numbers(5);
```
```response title=Response theme={null}
┌─number─┬─one_row_sum─┬─cumulative_sum─┐
│ 0 │ 0 │ 0 │
│ 1 │ 1 │ 1 │
│ 2 │ 2 │ 3 │
│ 3 │ 3 │ 6 │
│ 4 │ 4 │ 10 │
└────────┴─────────────┴────────────────┘
```
## runningConcurrency
導入バージョン: v21.3.0
同時実行されているイベント数を計算します。
各イベントには開始時刻と終了時刻があります。
開始時刻はイベントに含まれますが、終了時刻は含まれません。
開始時刻と終了時刻のカラムは、同じデータ型である必要があります。
この関数は、各イベントの開始時刻ごとに、アクティブな (同時実行中の) イベントの総数を計算します。
**要件**
イベントは開始時刻の昇順で並んでいる必要があります。
この要件に違反すると、関数は例外をスローします。
各データブロックは個別に処理されます。
異なるデータブロックに属するイベントが重なっている場合、正しく処理できません。
**非推奨**
代わりに [ウィンドウ関数](/ja/reference/functions/window-functions/index) を使用することを推奨します。
**構文**
```sql theme={null}
runningConcurrency(start, end)
```
**引数**
* `start` — イベントの開始時刻を表すカラム。[`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime) または [`DateTime64`](/ja/reference/data-types/datetime64)
* `end` — イベントの終了時刻を表すカラム。[`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime) または [`DateTime64`](/ja/reference/data-types/datetime64)
**戻り値**
各イベントの開始時点で同時に発生しているイベント数を返します。[`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT start, runningConcurrency(start, end) FROM example_table;
```
```response title=Response theme={null}
┌──────start─┬─runningConcurrency(start, end)─┐
│ 2025-03-03 │ 1 │
│ 2025-03-06 │ 2 │
│ 2025-03-07 │ 3 │
│ 2025-03-11 │ 2 │
└────────────┴────────────────────────────────┘
```
## runningDifference
導入バージョン: v1.1.0
データブロック内で連続する2つの行の値の差を計算します。
最初の行には `0` を返し、2 行目以降は直前の行との差を返します。
**非推奨**
現在処理中のデータブロック内の差分しか返しません。
この挙動は誤りを招きやすいため、この関数は非推奨です。
代わりに [ウィンドウ関数](/ja/reference/functions/window-functions/index) を使用することを推奨します。
この関数の使用を許可するには、設定 [`allow_deprecated_error_prone_window_functions`](/ja/reference/settings/session-settings#allow_deprecated_error_prone_window_functions) を使用できます。
この関数の結果は、対象となるデータブロックと、そのブロック内でのデータの順序に依存します。
`runningDifference()` の計算時の行の順序は、ユーザーに返される行の順序と異なる場合があります。
これを防ぐには、[`ORDER BY`](/ja/reference/statements/select/order-by) を含むサブクエリを作成し、その外側でこの関数を呼び出します。
ブロックサイズが結果に影響する点に注意してください。
`runningDifference` の内部状態は、新しいブロックごとにリセットされます。
**構文**
```sql theme={null}
runningDifference(x)
```
**引数**
* `x` — 連続する値の差分を計算する対象のカラム。[`Any`](/ja/reference/data-types/index)
**戻り値**
連続する値どうしの差分を返します。最初の行は 0 です。
**例**
**使用例**
```sql title=Query theme={null}
SELECT
EventID,
EventTime,
runningDifference(EventTime) AS delta
FROM
(
SELECT
EventID,
EventTime
FROM events
WHERE EventDate = '2025-11-24'
ORDER BY EventTime ASC
LIMIT 5
);
```
```response title=Response theme={null}
┌─EventID─┬───────────EventTime─┬─delta─┐
│ 1106 │ 2025-11-24 00:00:04 │ 0 │
│ 1107 │ 2025-11-24 00:00:05 │ 1 │
│ 1108 │ 2025-11-24 00:00:05 │ 0 │
│ 1109 │ 2025-11-24 00:00:09 │ 4 │
│ 1110 │ 2025-11-24 00:00:10 │ 1 │
└─────────┴─────────────────────┴───────┘
```
**ブロックサイズの影響の例**
```sql title=Query theme={null}
SELECT
number,
runningDifference(number + 1) AS diff
FROM numbers(100000)
WHERE diff != 1;
```
```response title=Response theme={null}
┌─number─┬─diff─┐
│ 0 │ 0 │
└────────┴──────┘
┌─number─┬─diff─┐
│ 65536 │ 0 │
└────────┴──────┘
```
## runningDifferenceStartingWithFirstValue
導入バージョン: v1.1.0
データブロック内で連続する行の値の差を計算しますが、[`runningDifference`](#runningDifference) とは異なり、最初の行については `0` ではなく実際の値を返します。
**非推奨**
現在処理中のデータブロック内の差分しか返しません。
この挙動はエラーを招きやすいため、この関数は非推奨です。
代わりに [ウィンドウ関数](/ja/reference/functions/window-functions/index) を使用することを推奨します。
この関数の使用を許可するには、設定 `allow_deprecated_error_prone_window_functions` を使用できます。
**構文**
```sql theme={null}
runningDifferenceStartingWithFirstValue(x)
```
**引数**
* `x` — 連続する値の差分を計算する対象のカラム。[`Any`](/ja/reference/data-types/index)
**戻り値**
連続する値同士の差を返します。先頭の行については、その行の値を返します。[`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
SELECT
number,
runningDifferenceStartingWithFirstValue(number) AS diff
FROM numbers(5);
```
```response title=Response theme={null}
┌─number─┬─diff─┐
│ 0 │ 0 │
│ 1 │ 1 │
│ 2 │ 1 │
│ 3 │ 1 │
│ 4 │ 1 │
└────────┴──────┘
```
## serverUUID
導入バージョン: v20.1.0
server の初回起動時に生成される、ランダムで一意な UUID (v4) を返します。
この UUID は永続化されるため、2 回目、3 回目以降に server を起動しても、同じ UUID が返されます。
**構文**
```sql theme={null}
serverUUID()
```
**引数**
* なし。
**戻り値**
サーバーのランダムなUUIDを返します。[`UUID`](/ja/reference/data-types/uuid)
**例**
**使用例**
```sql title=Query theme={null}
SELECT serverUUID();
```
```response title=Response theme={null}
┌─serverUUID()─────────────────────────────┐
│ 7ccc9260-000d-4d5c-a843-5459abaabb5f │
└──────────────────────────────────────────┘
```
## shardCount
導入バージョン: v21.9.0
分散クエリにおける分片の総数を返します。
クエリが分散されていない場合は、定数値 `0` が返されます。
**構文**
```sql theme={null}
shardCount()
```
**引数**
* なし。
**戻り値**
分片の総数、または `0` を返します。[`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
-- shardCount()も示している上記のshardNum()の例を参照してください。
CREATE TABLE shard_count_example (dummy UInt8)
ENGINE=Distributed(test_cluster_two_shards_localhost, system, one, dummy);
SELECT shardCount() FROM shard_count_example;
```
```response title=Response theme={null}
┌─shardCount()─┐
│ 2 │
│ 2 │
└──────────────┘
```
## shardNum
導入バージョン: v21.9.0
分散クエリでデータの一部を処理する分片の番号を返します。
番号は `1` から始まります。
クエリが分散クエリでない場合は、定数値 `0` が返されます。
**構文**
```sql theme={null}
shardNum()
```
**引数**
* なし。
**戻り値**
分片の索引、または定数 `0` を返します。[`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE shard_num_example (dummy UInt8)
ENGINE=Distributed(test_cluster_two_shards_localhost, system, one, dummy);
SELECT dummy, shardNum(), shardCount() FROM shard_num_example;
```
```response title=Response theme={null}
┌─dummy─┬─shardNum()─┬─shardCount()─┐
│ 0 │ 1 │ 2 │
│ 0 │ 2 │ 2 │
└───────┴────────────┴──────────────┘
```
## showCertificate
導入バージョン: v22.6.0
設定されている場合は、現在のサーバーの Secure Sockets Layer (SSL) 証明書に関する情報を表示します。
接続の検証に OpenSSL 証明書を使用するように ClickHouse を設定する方法について詳しくは、[TLS の設定](/ja/concepts/features/security/tls/configuring-tls) を参照してください。
**構文**
```sql theme={null}
showCertificate()
```
**引数**
* なし。
**戻り値**
設定された SSL 証明書に関連するキー・バリューのペアを格納したマップを返します。[`Map(String, String)`](/ja/reference/data-types/map)
**例**
**使用例**
```sql title=Query theme={null}
SELECT showCertificate() FORMAT LineAsString;
```
```response title=Response theme={null}
{'version':'1','serial_number':'2D9071D64530052D48308473922C7ADAFA85D6C5','signature_algo':'sha256WithRSAEncryption','issuer':'/CN=marsnet.local CA','not_before':'May 7 17:01:21 2024 GMT','not_after':'May 7 17:01:21 2025 GMT','subject':'/CN=chnode1','pkey_algo':'rsaEncryption'}
```
## sleep
導入バージョン: v1.1.0
指定した秒数だけクエリの実行を一時停止します。
この関数は主に、テストやデバッグのために使用されます。
`sleep()` 関数は、クエリのパフォーマンスやシステムの応答性に悪影響を及ぼす可能性があるため、通常、本番環境では使用すべきではありません。
ただし、次のような場面では有用です。
1. **テスト**: ClickHouse のテストやベンチマークを行う際に、遅延をシミュレートしたり一時停止を挟んだりして、特定の条件下でシステムがどのように動作するかを観察したい場合があります。
2. **デバッグ**: 特定の時点におけるシステムの状態やクエリの実行状況を確認する必要がある場合は、`sleep()` を使って一時停止を入れることで、関連情報を調査または収集できます。
3. **シミュレーション**: ネットワークレイテンシーや外部システムへの依存関係など、遅延や一時停止が発生する実際の状況をシミュレートしたい場合があります。
`sleep()` 関数は、ClickHouse システム全体のパフォーマンスや応答性に影響を及ぼすおそれがあるため、本当に必要な場合にのみ慎重に使用することが重要です。
セキュリティ上の理由により、この関数を実行できるのは、デフォルトのユーザープロファイル (`allow_sleep` が有効な場合) のみです。
**構文**
```sql theme={null}
sleep(seconds)
```
**引数**
* `seconds` — クエリの実行を最大 3 秒まで一時停止する秒数です。小数秒を指定するには、浮動小数点値も使用できます。[`const UInt*`](/ja/reference/data-types/int-uint) または [`const Float*`](/ja/reference/data-types/float)
**戻り値**
`0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
-- このクエリは完了するまで2秒間一時停止します。
-- この間、結果は返されず、クエリはハングまたは応答なしの状態に見えます。
SELECT sleep(2);
```
```response title=Response theme={null}
┌─sleep(2)─┐
│ 0 │
└──────────┘
1 行 in set. Elapsed: 2.012 sec.
```
## sleepEachRow
導入バージョン: v1.1.0
結果セットの各行ごとに、指定した秒数だけクエリの実行を一時停止します。
`sleepEachRow()` 関数は、[`sleep()`](#sleep) 関数と同様に、主にテストやデバッグのために使用されます。
この関数を使うと、各行の処理ごとに遅延や一時停止を発生させることができ、次のような場面で役立ちます。
1. **テスト**: 特定の条件下で ClickHouse の性能をテストまたはベンチマークする際に、`sleepEachRow()` を使って、処理される各行ごとに遅延や一時停止を発生させることができます。
2. **デバッグ**: 処理される各行について、システムの状態やクエリの実行状況を確認する必要がある場合は、`sleepEachRow()` で一時停止を入れることで、関連情報を調査したり収集したりできます。
3. **シミュレーション**: 場合によっては、外部システムやネットワーク遅延を扱うケースのように、処理される各行ごとに遅延や一時停止が発生する実運用に近い状況をシミュレートしたいことがあります。
`sleep()` 関数と同様に、`sleepEachRow()` は必要な場合にのみ慎重に使用することが重要です。特に大きな結果セットを扱う場合、ClickHouse システム全体の性能や応答性に大きな影響を与える可能性があります。
**構文**
```sql theme={null}
sleepEachRow(seconds)
```
**引数**
* `seconds` — 結果セットの各行に対して、クエリの実行を最大 3 秒まで一時停止する秒数です。小数秒を指定するには浮動小数点値を使用できます。[`const UInt*`](/ja/reference/data-types/int-uint) または [`const Float*`](/ja/reference/data-types/float)
**戻り値**
各行に `0` を返します。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
-- 出力は遅延し、各行の間に0.5秒の停止が入ります。
SELECT number, sleepEachRow(0.5) FROM system.numbers LIMIT 5;
```
```response title=Response theme={null}
┌─number─┬─sleepEachRow(0.5)─┐
│ 0 │ 0 │
│ 1 │ 0 │
│ 2 │ 0 │
│ 3 │ 0 │
│ 4 │ 0 │
└────────┴───────────────────┘
```
## structureToCapnProtoSchema
導入バージョン: v23.8.0
ClickHouseのテーブル構造をCapnProtoフォーマットのスキーマに変換する関数
**構文**
```sql theme={null}
structureToCapnProtoSchema(table_structure, message)
```
**引数**
* なし。
**戻り値**
**例**
**ランダム**
```sql title=Query theme={null}
SELECT structureToCapnProtoSchema('s String, x UInt32', 'MessageName') format TSVRaw
```
```response title=Response theme={null}
struct MessageName
{
s @0 : Data;
x @1 : UInt32;
}
```
## structureToProtobufSchema
導入バージョン: v23.8.0
ClickHouseのテーブル構造をProtobufフォーマットのスキーマに変換します。
この関数は、ClickHouseのテーブル構造定義を受け取り、proto3構文の
Protocol Buffers (Protobuf) スキーマ定義に変換します。これは、データ交換用にClickHouseの
テーブル構造に対応したProtobufスキーマを生成する際に役立ちます。
**構文**
```sql theme={null}
structureToProtobufSchema(structure, message_name)
```
**引数**
* `structure` — 文字列で指定する ClickHouse テーブルの構造定義です (例: 'column1 Type1, column2 Type2') 。[`String`](/ja/reference/data-types/string)
* `message_name` — 生成されるスキーマ内の Protobuf メッセージ型の名前です。[`String`](/ja/reference/data-types/string)
**戻り値**
入力された ClickHouse テーブル構造に対応する、proto3 構文の Protobuf スキーマ定義を返します。[`String`](/ja/reference/data-types/string)
**例**
**ClickHouse テーブル構造を Protobuf スキーマに変換する**
```sql title=Query theme={null}
SELECT structureToProtobufSchema('s String, x UInt32', 'MessageName') FORMAT TSVRaw;
```
```response title=Response theme={null}
syntax = "proto3";
message MessageName
{
bytes s = 1;
uint32 x = 2;
}
```
## tcpPort
導入バージョン: v20.12.0
サーバーが待ち受けている[ネイティブインターフェイス](/ja/concepts/features/interfaces/tcp)のTCPポート番号を返します。
分散テーブルに対して実行された場合、この関数は各分片に対応する値を持つ通常のカラムを生成します。
それ以外の場合は、定数値を返します。
**構文**
```sql theme={null}
tcpPort()
```
**引数**
* ありません。
**戻り値**
TCPポート番号を返します。[`UInt16`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT tcpPort()
```
```response title=Response theme={null}
┌─tcpPort()─┐
│ 9000 │
└───────────┘
```
## throwIf
導入バージョン: v1.1.0
引数 x が true の場合、例外をスローします。
`error_code` 引数を使用するには、設定パラメータ `allow_custom_error_code_in_throw` を有効にする必要があります。
**構文**
```sql theme={null}
throwIf(x[, message[, error_code]])
```
**引数**
* `x` — 確認する条件。[`Any`](/ja/reference/data-types/index)
* `message` — 任意。カスタムエラーメッセージ。[`const String`](/ja/reference/data-types/string)
* `error_code` — 任意。カスタムエラーコード。[`const Int8/16/32`](/ja/reference/data-types/int-uint)
**戻り値**
条件が `false` の場合は `0` を返し、条件が `true` の場合は例外がスローされます。[`UInt8`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT throwIf(number = 3, 'Too many') FROM numbers(10);
```
```response title=Response theme={null}
↙ 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.
```
## toColumnTypeName
導入バージョン: v1.1.0
指定された値のデータ型の内部名を返します。
関数 [`toTypeName`](#toTypeName) とは異なり、返されるデータ型には `Const` や `LowCardinality` などの内部ラッパーのカラムが含まれる場合があります。
**構文**
```sql theme={null}
toColumnTypeName(value)
```
**引数**
* `value` — 内部データ型を返す対象となる値。[`Any`](/ja/reference/data-types/index)
**戻り値**
値を表現するために使用される内部データ型を返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT toColumnTypeName(CAST('2025-01-01 01:02:03' AS DateTime));
```
```response title=Response theme={null}
┌─toColumnTypeName(CAST('2025-01-01 01:02:03', 'DateTime'))─┐
│ Const(UInt32) │
└───────────────────────────────────────────────────────────┘
```
## toTypeName
導入バージョン: v1.1.0
渡された引数の型名を返します。
`NULL` が渡された場合、この関数は型 `Nullable(Nothing)` を返します。これは ClickHouse の内部的な `NULL` 表現に対応します。
**構文**
```sql theme={null}
toTypeName(x)
```
**引数**
* `x` — 任意の型の値。[`Any`](/ja/reference/data-types/index)
**戻り値**
入力値の型名を返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT toTypeName(123)
```
```response title=Response theme={null}
┌─toTypeName(123)─┐
│ UInt8 │
└─────────────────┘
```
## tokenizeQuery
導入バージョン: v26.5.0
ClickHouse SQL のクエリ文字列をトークン化し、トークンの配列を返します。
各トークンは、開始位置 (バイト単位) 、終了位置、およびトークンの型を持つ名前付きタプルです。
**構文**
```sql theme={null}
tokenizeQuery(query)
```
**引数**
* `query` — ClickHouse SQLクエリの文字列。String。
**戻り値**
クエリのトークンを表す、名前付きタプル `(begin UInt64, end UInt64, type Enum8(...))` の配列。[`Array(Tuple(begin UInt64, end UInt64, type Enum8(...)))`](/ja/reference/data-types/array)
**例**
**シンプル**
```sql title=Query theme={null}
SELECT tokenizeQuery('SELECT 1')
```
```response title=Response theme={null}
[(0,6,'BareWord'),(6,7,'Whitespace'),(7,8,'Number')]
```
## transactionID
導入バージョン: v22.6.0
トランザクションの ID を返します。
この関数は実験的機能の一部です。
実験的なトランザクションサポートを有効にするには、次の設定を [設定](/ja/concepts/features/configuration/server-config/configuration-files) に追加してください。
```xml theme={null}
1
```
詳しくは、[Transactional (ACID) support](/ja/concepts/features/operations/insert/transactions#transactions-commit-and-rollback) のページを参照してください。
**構文**
```sql theme={null}
transactionID()
```
**引数**
* なし。
**戻り値**
`start_csn`、`local_tid`、`host_id` で構成されるタプルを返します。
* `start_csn`: グローバルな連番。このトランザクションの開始時点で確認されていた最新のコミットタイムスタンプです。
* `local_tid`: ローカルな連番。特定の start\_csn 内で、このホストによって開始された各トランザクションごとに一意です。
* `host_id`: このトランザクションを開始したホストの UUID。
[`Tuple(UInt64, UInt64, UUID)`](/ja/reference/data-types/tuple)
**例**
**使用例**
```sql title=Query theme={null}
BEGIN TRANSACTION;
SELECT transactionID();
ROLLBACK;
```
```response title=Response theme={null}
┌─transactionID()────────────────────────────────┐
│ (32,34,'0ee8b069-f2bb-4748-9eae-069c85b5252b') │
└────────────────────────────────────────────────┘
```
## transactionLatestSnapshot
導入バージョン: v22.6.0
読み取りに利用可能な[トランザクション](/ja/concepts/features/operations/insert/transactions#transactions-commit-and-rollback)の最新のスナップショット (Commit Sequence Number) を返します。
この関数は実験的な機能群の一部です。実験的なトランザクションサポートを有効にするには、設定に次の項目を追加してください。
```xml theme={null}
1
```
詳細については、[Transactional (ACID) support](/ja/concepts/features/operations/insert/transactions#transactions-commit-and-rollback)のページを参照してください。
**構文**
```sql theme={null}
transactionLatestSnapshot()
```
**引数**
* なし。
**戻り値**
トランザクションの最新スナップショット (CSN) を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
BEGIN TRANSACTION;
SELECT transactionLatestSnapshot();
ROLLBACK;
```
```response title=Response theme={null}
┌─transactionLatestSnapshot()─┐
│ 32 │
└─────────────────────────────┘
```
## transactionOldestSnapshot
導入バージョン: v22.6.0
実行中の[トランザクション](/ja/concepts/features/operations/insert/transactions#transactions-commit-and-rollback)から参照可能な、最も古いスナップショット (Commit Sequence Number) を返します。
この関数は実験的機能セットの一部です。以下の設定を構成に追加して、実験的なトランザクションサポートを有効にしてください。
```xml theme={null}
1
```
詳細は、[Transactional (ACID) support](/ja/concepts/features/operations/insert/transactions#transactions-commit-and-rollback) のページを参照してください。
**構文**
```sql theme={null}
transactionOldestSnapshot()
```
**引数**
* なし。
**戻り値**
トランザクションの最も古いスナップショット (CSN) を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
BEGIN TRANSACTION;
SELECT transactionOldestSnapshot();
ROLLBACK;
```
```response title=Response theme={null}
┌─transactionOldestSnapshot()─┐
│ 32 │
└─────────────────────────────┘
```
## transform
導入バージョン: v1.1.0
明示的に定義された要素間のマッピングに基づいて、値を変換します。
この関数には 2 つのバリエーションがあります。
* `transform(x, array_from, array_to, default)` - マッピング用の配列を使って `x` を変換し、一致しない要素にはデフォルト値を返します
* `transform(x, array_from, array_to)` - 同じ変換を行いますが、一致する要素が見つからない場合は元の `x` を返します
この関数は `array_from` 内で `x` を検索し、同じ索引の `array_to` にある対応する要素を返します。
`x` が `array_from` 内で見つからない場合は、`default` の値 (4 パラメータ版) または元の `x` (3 パラメータ版) を返します。
`array_from` に一致する要素が複数ある場合は、最初の一致に対応する要素を返します。
要件:
* `array_from` と `array_to` は同じ数の要素を持っている必要があります
* 4 パラメータ版: `transform(T, Array(T), Array(U), U) -> U` - ここで `T` と `U` には、互換性のある異なる型を使用できます
* 3 パラメータ版: `transform(T, Array(T), Array(T)) -> T` - ここですべての型は同じである必要があります
**構文**
```sql theme={null}
transform(x, array_from, array_to[, default])
```
**引数**
* `x` — 変換対象の値。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Decimal`](/ja/reference/data-types/decimal) または [`Float*`](/ja/reference/data-types/float) または [`String`](/ja/reference/data-types/string) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime)
* `array_from` — 一致する値を検索する対象の定数配列。[`Array((U)Int*)`](/ja/reference/data-types/array) または [`Array(Decimal)`](/ja/reference/data-types/array) または [`Array(Float*)`](/ja/reference/data-types/array) または [`Array(String)`](/ja/reference/data-types/array) または [`Array(Date)`](/ja/reference/data-types/array) または [`Array(DateTime)`](/ja/reference/data-types/array)
* `array_to` — `array_from` 内で対応する一致が見つかった場合に返される値の定数配列。[`Array((U)Int*)`](/ja/reference/data-types/array) または [`Array(Decimal)`](/ja/reference/data-types/array) または [`Array(Float*)`](/ja/reference/data-types/array) または [`Array(String)`](/ja/reference/data-types/array) または [`Array(Date)`](/ja/reference/data-types/array) または [`Array(DateTime)`](/ja/reference/data-types/array)
* `default` — 任意。`x` が `array_from` 内に見つからない場合に返す値。省略した場合は、`x` をそのまま返します。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Decimal`](/ja/reference/data-types/decimal) または [`Float*`](/ja/reference/data-types/float) または [`String`](/ja/reference/data-types/string) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime)
**戻り値**
`x` が `array_from` の要素に一致する場合は `array_to` の対応する値を返し、それ以外の場合は `default` (指定されている場合) または `x` (`default` が指定されていない場合) を返します。[`Any`](/ja/reference/data-types/index)
**例**
**transform(T, Array(T), Array(U), U) -> U**
```sql title=Query theme={null}
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
```
```response title=Response theme={null}
┌─title─────┬──────c─┐
│ Yandex │ 498635 │
│ Google │ 229872 │
│ Other │ 104472 │
└───────────┴────────┘
```
**transform(T, Array(T), Array(T)) -> T**
```sql title=Query theme={null}
SELECT
transform(domain(Referer), ['yandex.ru', 'google.ru', 'vkontakte.ru'], ['www.yandex', 'example.com', 'vk.com']) AS s, count() AS c
FROM test.hits
GROUP BY domain(Referer)
ORDER BY count() DESC
LIMIT 10
```
```response title=Response theme={null}
┌─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 │
└────────────────┴─────────┘
```
## uniqThetaIntersect
導入バージョン: v22.9.0
2 つの uniqThetaSketch オブジェクト に対して積集合の計算 (集合演算 ∩) を行い、その結果として新しい uniqThetaSketch を返します。
**構文**
```sql theme={null}
uniqThetaIntersect(uniqThetaSketch,uniqThetaSketch)
```
**引数**
* `uniqThetaSketch` — uniqThetaSketch オブジェクト。[`Tuple`](/ja/reference/data-types/tuple) または [`Array`](/ja/reference/data-types/array) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime) または [`String`](/ja/reference/data-types/string) または [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal`](/ja/reference/data-types/decimal)
**戻り値**
積集合の結果を含む新しい uniqThetaSketch。 [`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT finalizeAggregation(uniqThetaIntersect(a, b)) AS a_intersect_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [1, 2]) AS a, arrayReduce('uniqThetaState', [2, 3, 4]) AS b);
```
```response title=Response theme={null}
┌─a_intersect_b─┬─a_cardinality─┬─b_cardinality─┐
│ 1 │ 2 │ 3 │
└───────────────┴───────────────┴───────────────┘
```
## uniqThetaNot
導入バージョン: v22.9.0
2 つの uniqThetaSketch オブジェクトに対して a\_not\_b 計算 (集合演算 ×) を実行し、その結果として新しい uniqThetaSketch を返します。
**構文**
```sql theme={null}
uniqThetaNot(uniqThetaSketch,uniqThetaSketch)
```
**引数**
* `uniqThetaSketch` — uniqThetaSketch オブジェクト。[`Tuple`](/ja/reference/data-types/tuple) または [`Array`](/ja/reference/data-types/array) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime) または [`String`](/ja/reference/data-types/string) または [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal`](/ja/reference/data-types/decimal)
**戻り値**
a\_not\_b の結果を含む、新しい uniqThetaSketch を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT finalizeAggregation(uniqThetaNot(a, b)) AS a_not_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [2, 3, 4]) AS a, arrayReduce('uniqThetaState', [1, 2]) AS b);
```
```response title=Response theme={null}
┌─a_not_b─┬─a_cardinality─┬─b_cardinality─┐
│ 2 │ 3 │ 2 │
└─────────┴───────────────┴───────────────┘
```
## uniqThetaUnion
導入バージョン: v22.9.0
2 つの uniqThetaSketch オブジェクトに対してユニオン計算 (集合演算 ∪) を行い、結果として新しい uniqThetaSketch を返します。
**構文**
```sql theme={null}
uniqThetaUnion(uniqThetaSketch,uniqThetaSketch)
```
**引数**
* `uniqThetaSketch` — uniqThetaSketch オブジェクト。[`Tuple`](/ja/reference/data-types/tuple) または [`Array`](/ja/reference/data-types/array) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime) または [`String`](/ja/reference/data-types/string) または [`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal`](/ja/reference/data-types/decimal)
**戻り値**
ユニオン結果を含む新しい uniqThetaSketch を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT finalizeAggregation(uniqThetaUnion(a, b)) AS a_union_b, finalizeAggregation(a) AS a_cardinality, finalizeAggregation(b) AS b_cardinality
FROM
(SELECT arrayReduce('uniqThetaState', [1, 2]) AS a, arrayReduce('uniqThetaState', [2, 3, 4]) AS b);
```
```response title=Response theme={null}
┌─a_union_b─┬─a_cardinality─┬─b_cardinality─┐
│ 4 │ 2 │ 3 │
└───────────┴───────────────┴───────────────┘
```
## 稼働時間
導入バージョン: v1.1.0
サーバーの稼働時間を秒単位で返します。
分散テーブルに対して実行すると、この関数は各分片に対応する値を持つ通常のカラムを生成します。
それ以外の場合は、定数値を生成します。
**構文**
```sql theme={null}
uptime()
```
**引数**
* ありません。
**戻り値**
serverの稼働時間を秒単位で返します。 [`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT uptime() AS Uptime
```
```response title=Response theme={null}
┌─Uptime─┐
│ 55867 │
└────────┘
```
## variantElement
導入バージョン: v25.2.0
`Variant` カラムから、指定した型のカラムを抽出します。
**構文**
```sql theme={null}
variantElement(variant, type_name[, default_value])
```
**引数**
* `variant` — Variant カラム。 [`Variant`](/ja/reference/data-types/variant)
* `type_name` — 抽出する Variant 型の名前。 [`String`](/ja/reference/data-types/string)
* `default_value` — `variant` に指定した型の値がない場合に使用されるデフォルト値。任意の型を指定できます。省略可能です。 [`Any`](/ja/reference/data-types/index)
**戻り値**
Variant カラムから指定した Variant 型の値を抽出したカラムを返します。 [`Any`](/ja/reference/data-types/index)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE test (v Variant(UInt64, String, Array(UInt64))) ENGINE = Memory;
INSERT INTO test VALUES (NULL), (42), ('Hello, World!'), ([1, 2, 3]);
SELECT v, variantElement(v, 'String'), variantElement(v, 'UInt64'), variantElement(v, 'Array(UInt64)') FROM test;
```
```response title=Response theme={null}
┌─v─────────────┬─variantElement(v, 'String')─┬─variantElement(v, 'UInt64')─┬─variantElement(v, 'Array(UInt64)')─┐
│ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ [] │
│ 42 │ ᴺᵁᴸᴸ │ 42 │ [] │
│ Hello, World! │ Hello, World! │ ᴺᵁᴸᴸ │ [] │
│ [1,2,3] │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ [1,2,3] │
└───────────────┴─────────────────────────────┴─────────────────────────────┴────────────────────────────────────┘
```
## variantType
導入バージョン: v24.2.0
`Variant` カラムの各行について、Variant 型名を返します。行に NULL が含まれている場合、その行については 'None' を返します。
**構文**
```sql theme={null}
variantType(variant)
```
**引数**
* `variant` — Variant カラム。[`Variant`](/ja/reference/data-types/variant)
**戻り値**
各行の Variant 型名を格納した Enum カラムを返します。[`Enum`](/ja/reference/data-types/enum)
**例**
**使用例**
```sql title=Query theme={null}
CREATE TABLE test (v Variant(UInt64, String, Array(UInt64))) ENGINE = Memory;
INSERT INTO test VALUES (NULL), (42), ('Hello, World!'), ([1, 2, 3]);
SELECT variantType(v) FROM test;
```
```response title=Response theme={null}
┌─variantType(v)─┐
│ None │
│ UInt64 │
│ String │
│ Array(UInt64) │
└────────────────┘
```
## version
導入バージョン: v1.1.0
ClickHouse の現在のバージョンを、`major_version.minor_version.patch_version.number_of_commits_since_the_previous_stable_release` 形式の文字列として返します。
分散テーブル上で実行された場合、この関数は各分片に対応する値を持つ通常のカラムを生成します。
それ以外の場合は、定数値を返します。
**構文**
```sql theme={null}
version()
```
**引数**
* ありません。
**戻り値**
現在の ClickHouse のバージョンを返します。[`String`](/ja/reference/data-types/string)
**例**
**使用例**
```sql title=Query theme={null}
SELECT version()
```
```response title=Response theme={null}
┌─version()─┐
│ 24.2.1.1 │
└───────────┘
```
## visibleWidth
導入バージョン: v1.1.0
値をテキスト形式 (タブ区切り) でコンソールに出力する際の、おおよその幅を計算します。
この関数は、システムが Pretty フォーマットを実装するために使用されます。
`NULL` は、Pretty フォーマットでは `NULL` に対応する文字列として表現されます。
**構文**
```sql theme={null}
visibleWidth(x)
```
**引数**
* `x` — 任意のデータ型の値。[`Any`](/ja/reference/data-types/index)
**戻り値**
テキストフォーマットで表示した場合のおおよその幅を返します。[`UInt64`](/ja/reference/data-types/int-uint)
**例**
**NULL の表示幅を計算**
```sql title=Query theme={null}
SELECT visibleWidth(NULL)
```
```response title=Response theme={null}
┌─visibleWidth(NULL)─┐
│ 4 │
└────────────────────┘
```
## zookeeperSessionUptime
導入バージョン: v21.11.0
現在のZooKeeperセッションの稼働時間を秒単位で返します。
**構文**
```sql theme={null}
zookeeperSessionUptime()
```
**引数**
* なし。
**戻り値**
現在の ZooKeeper セッションの稼働時間を秒単位で返します。 [`UInt32`](/ja/reference/data-types/int-uint)
**例**
**使用例**
```sql title=Query theme={null}
SELECT zookeeperSessionUptime();
```
```response title=Response theme={null}
┌─zookeeperSessionUptime()─┐
│ 286 │
└──────────────────────────┘
```