diff -r d7ae02390fac -r fce3d6290c40 relpipe-data/examples-hello-world.xml --- a/relpipe-data/examples-hello-world.xml Fri Sep 25 14:38:24 2020 +0200 +++ b/relpipe-data/examples-hello-world.xml Thu Oct 22 01:51:32 2020 +0200 @@ -12,25 +12,27 @@ Let's start with an obligatory Hello World example.

- +

This command generates relational data. In order to see them, we need to convert them to some other format. - For now, we will use the "tabular" format and pipe relational data to the relpipe-out-tabular. + For now, we will use the „tabular“ format and pipe relational data to the relpipe-out-tabular.

-

Output:

@@ -46,8 +48,8 @@ ]]>

- The syntax is simple as we see above. We specify the name of the relation, number of attributes, - and then their definitions (names and types), + The syntax is simple as we see above. We specify the name of the relation + and the names and types of attributes followed by the data.

@@ -55,8 +57,8 @@ A single stream may contain multiple relations:

-

@@ -77,6 +79,38 @@ │ world │ ╰────────────╯ Record count: 1]]> + +

+ In the example above, we call relpipe-in-cli twice and let the shell combine their outputs. + This approach is useful when we want to combine relational data from various sources: different relpipe-in-* tools, files etc. + But when we work with relpipe-in-cli only, we can ask it to create several relations during one run: +

+ + + +

+ The result will be the same. + We can also use the --records option instead of the --record option – then the rest of the CLI arguments is treated as data of given relation. + Obviously this option can be used only once for the last relation. +

+ + + +

+ It will generate the same relation_from_cli table as above. + If we have more data (especially from external sources), we can use the --records-on-stdin option and pass them through the STDIN. +