"
```
データのインポート先となるテーブルを作成しましょう。
```sql theme={null}
CREATE TABLE error_log
(
`time` DateTime,
`ip` String,
`host` String,
`request` String
)
ENGINE = MergeTree
ORDER BY (host, request, time)
```
指定したTemplateを使ってデータをインポートするには、テンプレート文字列をファイルに保存する必要があります (この例では [row.template](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/row.template)) :
```response theme={null}
${time:Escaped} [error] client: ${ip:CSV}, server: ${host:CSV} ${request:JSON}
```
`${name:escaping}` フォーマットで、カラム名とエスケープ規則を指定します。ここでは CSV、JSON、Escaped、Quoted など複数のオプションを利用でき、それぞれ [対応するエスケープ規則](/docs/ja/reference/formats/Template/Template) に従います。
これで、データのインポート時に、指定したファイルを `format_template_row` 設定オプションの引数として使用できます (*なお、template ファイルと data ファイルの末尾に余分な `\n` 記号を **付けてはいけません***) :
```sql theme={null}
INSERT INTO error_log FROM INFILE 'error.log'
SETTINGS format_template_row = 'row.template'
FORMAT Template
```
データがテーブルに読み込まれたことを確認できます。
```sql theme={null}
SELECT
request,
count(*)
FROM error_log
GROUP BY request
```
```response theme={null}
┌─request──────────────────────────────────────────┬─count()─┐
│ GET /img/close.png HTTP/1.1 │ 176 │
│ GET /h5/static/cert/icon_yanzhengma.png HTTP/1.1 │ 172 │
│ GET /phone/images/icon_01.png HTTP/1.1 │ 139 │
│ GET /apple-touch-icon-precomposed.png HTTP/1.1 │ 161 │
│ GET /apple-touch-icon.png HTTP/1.1 │ 162 │
│ GET /apple-touch-icon-120x120.png HTTP/1.1 │ 190 │
└──────────────────────────────────────────────────┴─────────┘
```
### 空白文字のスキップ
テンプレート内で区切り文字の間にある空白文字をスキップできる [TemplateIgnoreSpaces](/docs/ja/reference/formats/Template/TemplateIgnoreSpaces) の使用を検討してください：
```text theme={null}
Template: --> "p1: ${p1:CSV}, p2: ${p2:CSV}"
TemplateIgnoreSpaces --> "p1:${p1:CSV}, p2:${p2:CSV}"
```
## Templateを使用したデータのエクスポート
Templateを使って、任意のテキスト形式にデータをエクスポートすることもできます。この場合は、2 つのファイルを作成する必要があります。
[結果セットテンプレート](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/output.results)：結果セット全体のレイアウトを定義します。
```response theme={null}
== Top 10 IPs ==
${data}
--- ${rows_read:XML} rows read in ${time:XML} ---
```
ここで、`rows_read` と `time` は各リクエストで利用できるシステムメトリクスです。一方、`data` は生成された行を表します (このファイルでは `${data}` が常に最初のプレースホルダーである必要があります) 。これは、[**行テンプレートファイル**](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/output.rows) で定義されたテンプレートに基づくものです。
```response theme={null}
${ip:Escaped} generated ${total:Escaped} requests
```
それでは、これらのTemplateを使って次のクエリをエクスポートしてみましょう：
```sql theme={null}
SELECT
ip,
count() AS total
FROM error_log GROUP BY ip ORDER BY total DESC LIMIT 10
FORMAT Template SETTINGS format_template_resultset = 'output.results',
format_template_row = 'output.rows';
== Top 10 IPs ==
9.8.4.6 generated 3 requests
9.5.1.1 generated 3 requests
2.4.8.9 generated 3 requests
4.8.8.2 generated 3 requests
4.5.4.4 generated 3 requests
3.3.6.4 generated 2 requests
8.9.5.9 generated 2 requests
2.5.1.8 generated 2 requests
6.8.3.6 generated 2 requests
6.6.3.5 generated 2 requests
--- 1000 rows read in 0.001380604 ---
```
### HTMLファイルへのエクスポート
Template ベースの結果は、[`INTO OUTFILE`](/docs/ja/reference/statements/select/into-outfile) 句を使ってファイルにエクスポートすることもできます。指定された[結果セット](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/html.results)および[行](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/html.row)フォーマットに基づいて、HTML ファイルを生成してみましょう。
```sql theme={null}
SELECT
ip,
count() AS total
FROM error_log GROUP BY ip ORDER BY total DESC LIMIT 10
INTO OUTFILE 'out.html'
FORMAT Template
SETTINGS format_template_resultset = 'html.results',
format_template_row = 'html.row'
```
### XML へのエクスポート
Template フォーマットは、XML を含む、考え得るあらゆるテキスト形式のファイルを生成するために使用できます。適切なテンプレートを用意して、エクスポートするだけです。
メタデータを含む標準的な XML 出力を得るには、[XML](/docs/ja/reference/formats/XML) フォーマットを使用することも検討してください。
```sql theme={null}
SELECT *
FROM error_log
LIMIT 3
FORMAT XML
```
```xml theme={null}
time
DateTime
...
3.5.9.2
example.com
GET /apple-touch-icon-120x120.png HTTP/1.1
...
3
1000
0.000745001
1000
88184
```
## 正規表現を使ったデータのインポート
[Regexp](/docs/ja/reference/formats/Regexp) フォーマットは、入力データをより複雑な形で解析する必要がある、より高度なケースに対応しています。今回は [error.log](https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/error.log) のサンプルファイルを解析し、ファイル名とプロトコルも抽出して、それぞれ別のカラムに保存してみましょう。まず、そのための新しいテーブルを用意します。
```sql theme={null}
CREATE TABLE error_log
(
`time` DateTime,
`ip` String,
`host` String,
`file` String,
`protocol` String
)
ENGINE = MergeTree
ORDER BY (host, file, time)
```
これで、正規表現を基にデータをインポートできます。
```sql theme={null}
INSERT INTO error_log FROM INFILE 'error.log'
SETTINGS
format_regexp = '(.+?) \\[error\\] client: (.+), server: (.+?) "GET .+?([^/]+\\.[^ ]+) (.+?)"'
FORMAT Regexp
```
ClickHouse は、各キャプチャグループのデータを、順序に応じて対応するカラムに挿入します。データを確認してみましょう。
```sql theme={null}
SELECT * FROM error_log LIMIT 5
```
```response theme={null}
┌────────────────time─┬─ip──────┬─host────────┬─file─────────────────────────┬─protocol─┐
│ 2023-01-15 13:00:01 │ 3.5.9.2 │ example.com │ apple-touch-icon-120x120.png │ HTTP/1.1 │
│ 2023-01-15 13:01:40 │ 3.7.2.5 │ example.com │ apple-touch-icon-120x120.png │ HTTP/1.1 │
│ 2023-01-15 13:16:49 │ 9.2.9.2 │ example.com │ apple-touch-icon-120x120.png │ HTTP/1.1 │
│ 2023-01-15 13:21:38 │ 8.8.5.3 │ example.com │ apple-touch-icon-120x120.png │ HTTP/1.1 │
│ 2023-01-15 13:31:27 │ 9.5.8.4 │ example.com │ apple-touch-icon-120x120.png │ HTTP/1.1 │
└─────────────────────┴─────────┴─────────────┴──────────────────────────────┴──────────┘
```
デフォルトでは、一致しない行があると ClickHouse はエラーを返します。代わりに一致しない行をスキップするには、[format\_regexp\_skip\_unmatched](/docs/ja/reference/settings/formats#format_regexp_skip_unmatched) オプションを有効にしてください。
```sql theme={null}
SET format_regexp_skip_unmatched = 1;
```
## その他のフォーマット
ClickHouse は、さまざまなユースケースやプラットフォームに対応するため、テキスト形式とバイナリ形式の両方を含む多数のフォーマットをサポートしています。さらに多くのフォーマットとその扱い方については、以下の記事を参照してください。
* [CSV と TSV フォーマット](/docs/ja/guides/clickhouse/data-formats/csv-tsv)
* [Parquet](/docs/ja/guides/clickhouse/data-formats/parquet)
* [JSON フォーマット](/docs/ja/guides/clickhouse/data-formats/json/intro)
* **Regex とTemplate**
* [Native とバイナリ形式](/docs/ja/guides/clickhouse/data-formats/binary)
* [SQL フォーマット](/docs/ja/guides/clickhouse/data-formats/sql)
また、[clickhouse-local](https://clickhouse.com/blog/extracting-converting-querying-local-files-with-sql-clickhouse-local) もご覧ください。これは、ClickHouse server を必要とせずにローカル/リモートファイルを扱える、ポータブルでフル機能のツールです。