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