This commit is contained in:
@@ -76,6 +76,30 @@ dataxl -i examples/people.yaml -o people.tsv
|
||||
dataxl -from tsv -to yaml < people.tsv
|
||||
```
|
||||
|
||||
## データのマージ
|
||||
|
||||
主入力の各レコードを保持したまま、同じキーを持つ第2入力のフィールドを追加できます。
|
||||
次の例は `people.csv` の `id` と `details.json` の `id` を照合し、JSON側の
|
||||
フィールドを追加してYAMLへ出力します。
|
||||
|
||||
```sh
|
||||
dataxl -i people.csv -merge details.json -on id -to yaml
|
||||
```
|
||||
|
||||
マージはleft joinです。主入力にだけ存在するレコードはそのまま残り、第2入力にだけ
|
||||
存在するレコードは出力しません。`-on` には `user.id` や
|
||||
`items[0].sku` のような列パスも指定できます。
|
||||
|
||||
データを暗黙に上書きしないため、次の場合はエラーになります。
|
||||
|
||||
- いずれかのレコードにマージキーがない、またはキーがscalarでない
|
||||
- 第2入力に同じキーが複数ある
|
||||
- 同名フィールドの値が異なる
|
||||
|
||||
入力形式は各ファイル名から推定します。第2入力がstdinや拡張子なしの場合は
|
||||
`-merge-from` を指定してください。主入力と第2入力を同時にstdinから読むことは
|
||||
できません。
|
||||
|
||||
## Excelとの連携
|
||||
|
||||
Excelへ貼り付ける場合はTSVが便利です。
|
||||
@@ -174,6 +198,9 @@ CSV、TSV、XLSXから構造化形式へ戻す際は、セル文字列を次の
|
||||
- `-to`: 出力形式。`json`, `yaml`, `toml`, `csv`, `tsv`, `xlsx`, `markdown`。
|
||||
- `-sheet`: XLSXの読み書きに使うシート名。既定値は `Sheet1`。
|
||||
- `-pretty`: JSONなどの構造化出力を整形するか。既定値は `true`。
|
||||
- `-merge`: 主入力へフィールドを追加する第2入力ファイル。
|
||||
- `-merge-from`: 第2入力の形式。通常は `-merge` の拡張子から推定。
|
||||
- `-on`: マージ時に両入力を照合する列パス。
|
||||
- `-version`: バージョンを表示して終了します。
|
||||
|
||||
## 現在の制約
|
||||
|
||||
Reference in New Issue
Block a user