ClickHouse/docs/ja/sql-reference/table-functions/fuzzJSON.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

98 lines
3.3 KiB
Markdown
Raw Normal View History

2024-11-18 02:58:58 +00:00
---
slug: /ja/sql-reference/table-functions/fuzzJSON
sidebar_position: 75
sidebar_label: fuzzJSON
---
# fuzzJSON
JSON文字列にランダムな変動を加える。
``` sql
fuzzJSON({ named_collection [, option=value [,..]] | json_str[, random_seed] })
```
**引数**
- `named_collection` - [NAMED COLLECTION](/docs/ja/sql-reference/statements/create/named-collection.md)。
- `option=value` - Named collectionのオプションパラメータとその値。
- `json_str` (String) - JSONフォーマットで構造化データを表す元の文字列。
- `random_seed` (UInt64) - 安定した結果を生成するための手動ランダムシード。
- `reuse_output` (boolean) - 生成された出力を次のファズ処理の入力として再利用する。
- `malform_output` (boolean) - JSONオブジェクトとして解析不能な文字列を生成する。
- `max_output_length` (UInt64) - 生成または変動したJSON文字列の許容される最大長。
- `probability` (Float64) - JSONフィールドキー-値ペア)をファズ化する確率。範囲は[0, 1]。
- `max_nesting_level` (UInt64) - JSONデータ内で許可されるネスト構造の最大深さ。
- `max_array_size` (UInt64) - JSON配列の許可される最大サイズ。
- `max_object_size` (UInt64) - JSONオブジェクトの単一レベルでの許容されるフィールドの最大数。
- `max_string_value_length` (UInt64) - String型の値の最大長。
- `min_key_length` (UInt64) - キーの最小長。少なくとも1であるべき。
- `max_key_length` (UInt64) - キーの最大長。指定されている場合、`min_key_length`以上であるべき。
**戻り値**
変動したJSON文字列を含む単一カラムのテーブルオブジェクト。
## 使用例
``` sql
CREATE NAMED COLLECTION json_fuzzer AS json_str='{}';
SELECT * FROM fuzzJSON(json_fuzzer) LIMIT 3;
```
``` text
{"52Xz2Zd4vKNcuP2":true}
{"UPbOhOQAdPKIg91":3405264103600403024}
{"X0QUWu8yT":[]}
```
``` sql
SELECT * FROM fuzzJSON(json_fuzzer, json_str='{"name" : "value"}', random_seed=1234) LIMIT 3;
```
``` text
{"key":"value", "mxPG0h1R5":"L-YQLv@9hcZbOIGrAn10%GA"}
{"BRE3":true}
{"key":"value", "SWzJdEJZ04nrpSfy":[{"3Q23y":[]}]}
```
``` sql
SELECT * FROM fuzzJSON(json_fuzzer, json_str='{"students" : ["Alice", "Bob"]}', reuse_output=true) LIMIT 3;
```
``` text
{"students":["Alice", "Bob"], "nwALnRMc4pyKD9Krv":[]}
{"students":["1rNY5ZNs0wU&82t_P", "Bob"], "wLNRGzwDiMKdw":[{}]}
{"xeEk":["1rNY5ZNs0wU&82t_P", "Bob"], "wLNRGzwDiMKdw":[{}, {}]}
```
``` sql
SELECT * FROM fuzzJSON(json_fuzzer, json_str='{"students" : ["Alice", "Bob"]}', max_output_length=512) LIMIT 3;
```
``` text
{"students":["Alice", "Bob"], "BREhhXj5":true}
{"NyEsSWzJdeJZ04s":["Alice", 5737924650575683711, 5346334167565345826], "BjVO2X9L":true}
{"NyEsSWzJdeJZ04s":["Alice", 5737924650575683711, 5346334167565345826], "BjVO2X9L":true, "k1SXzbSIz":[{}]}
```
``` sql
SELECT * FROM fuzzJSON('{"id":1}', 1234) LIMIT 3;
```
``` text
{"id":1, "mxPG0h1R5":"L-YQLv@9hcZbOIGrAn10%GA"}
{"BRjE":16137826149911306846}
{"XjKE":15076727133550123563}
```
``` sql
SELECT * FROM fuzzJSON(json_nc, json_str='{"name" : "FuzzJSON"}', random_seed=1337, malform_output=true) LIMIT 3;
```
``` text
U"name":"FuzzJSON*"SpByjZKtr2VAyHCO"falseh
{"name"keFuzzJSON, "g6vVO7TCIk":jTt^
{"DBhz":YFuzzJSON5}
```