mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-14 02:12:21 +00:00
99 lines
2.7 KiB
Markdown
99 lines
2.7 KiB
Markdown
---
|
|
slug: /ja/sql-reference/table-functions/format
|
|
sidebar_position: 65
|
|
sidebar_label: format
|
|
---
|
|
|
|
# format
|
|
|
|
指定された入力フォーマットに従って、引数からデータを解析します。もし構造引数が指定されていない場合、データから抽出されます。
|
|
|
|
**構文**
|
|
|
|
``` sql
|
|
format(format_name, [structure], data)
|
|
```
|
|
|
|
**パラメータ**
|
|
|
|
- `format_name` — データの[フォーマット](../../interfaces/formats.md#formats)。
|
|
- `structure` - テーブルの構造。オプション。形式は 'column1_name column1_type, column2_name column2_type, ...'。
|
|
- `data` — 指定されたフォーマットでデータを含む文字列を返す文字列リテラルまたは定数式
|
|
|
|
**返される値**
|
|
|
|
指定されたフォーマットと指定または抽出された構造に従って`data`引数から解析されたデータを含むテーブル。
|
|
|
|
**例**
|
|
|
|
`structure`引数なし:
|
|
|
|
**クエリ:**
|
|
``` sql
|
|
SELECT * FROM format(JSONEachRow,
|
|
$$
|
|
{"a": "Hello", "b": 111}
|
|
{"a": "World", "b": 123}
|
|
{"a": "Hello", "b": 112}
|
|
{"a": "World", "b": 124}
|
|
$$)
|
|
```
|
|
|
|
**結果:**
|
|
|
|
```response
|
|
┌───b─┬─a─────┐
|
|
│ 111 │ Hello │
|
|
│ 123 │ World │
|
|
│ 112 │ Hello │
|
|
│ 124 │ World │
|
|
└─────┴───────┘
|
|
```
|
|
|
|
**クエリ:**
|
|
```sql
|
|
DESC format(JSONEachRow,
|
|
$$
|
|
{"a": "Hello", "b": 111}
|
|
{"a": "World", "b": 123}
|
|
{"a": "Hello", "b": 112}
|
|
{"a": "World", "b": 124}
|
|
$$)
|
|
```
|
|
|
|
**結果:**
|
|
|
|
```response
|
|
┌─name─┬─type──────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
|
|
│ b │ Nullable(Float64) │ │ │ │ │ │
|
|
│ a │ Nullable(String) │ │ │ │ │ │
|
|
└──────┴───────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
|
|
```
|
|
|
|
`structure`引数あり:
|
|
|
|
**クエリ:**
|
|
```sql
|
|
SELECT * FROM format(JSONEachRow, 'a String, b UInt32',
|
|
$$
|
|
{"a": "Hello", "b": 111}
|
|
{"a": "World", "b": 123}
|
|
{"a": "Hello", "b": 112}
|
|
{"a": "World", "b": 124}
|
|
$$)
|
|
```
|
|
|
|
**結果:**
|
|
```response
|
|
┌─a─────┬───b─┐
|
|
│ Hello │ 111 │
|
|
│ World │ 123 │
|
|
│ Hello │ 112 │
|
|
│ World │ 124 │
|
|
└───────┴─────┘
|
|
```
|
|
|
|
**関連項目**
|
|
|
|
- [フォーマット](../../interfaces/formats.md)
|