GraphQL CLI Data Loading plugin
npm install graphql-cli-loadData import plugin for graphql-cli.
```
npm i -g graphql-cli graphql-cli-load
Configure the plugin via the .graphqlconfig or command line.
The schema will be obtained from the schemaPath key, you can fetch it via graphql get-schema
All other options such as csv, json, mutation or mapping _can_ be placed in the extensions.load key
or provided via commandline.
Here is an example:
.graphqlconfig`json`
{
"schemaPath": "schema.graphql",
"includes": [
"src/*/.graphql",
"src/*/.gql",
],
"extensions": {
"load": { // this section is optional
"csv" : "reviews.txt",
"mutation": "createReview",
"mapping": { "text" : "review", "rating" : "stars"}
}
}
}
You can now run:
``
graphql load
or
`
graphql load --csv reviews.txt --mutation createReview2 --mapping '{ "text" : "commentary", "rating" : "stars"}'
Using endpoint starwars: http://localhost:7474/graphql/
Using mutation "createReview2".
Done parsing CSV-file /Users/mh/d/js/graphql-cli-load/example/reviews.txt rows: 3
meta: {"delimiter":"\t","linebreak":"\n","aborted":false,"truncated":false,"cursor":566,"fields":["episode","text","rating"]}
Using mapping: {"text":"commentary","rating":"stars"}
Sending query:
mutation {
_0 : createReview2 ( episode: NEWHOPE,commentary: "A legendarily expansive and ambitious start to the sci-fi saga, George Lucas opened our eyes to the possibilities of blockbuster filmmaki...
ā Call succeeded:
{"_0":"Nodes created: 1\nProperties set: 3\nLabels added: 1\n","_1":"Nodes created: 1\nProperties set: 3\nLabels added: 1\n","_2":"Nodes created: 1\nProperties set: 3\nLabels added: 1\n"}...
`
`
/usr/local/bin/graphql load [--json] [--csv] [--endpoint] [--mutation] [--mapping] [--delim]
Optionen:
--help Hilfe anzeigen [boolean]
--mapping, -p name mapping of input to mutation (json)
--mutation, -m mutation to call
--endpoint, -e endpoint name to use
--json, -j json file to load
--csv, -c csv file to load
--delim, -d delimiter for arrays
`
Which will take each line of the _csv_ or _json_ file and call the _mutation_ on the _endpoint_ with the data (optionally _mapping_ columns).
Non-absolute files are resolved relative to the directory containing .graphqlconfig.
To test this with the neo4j-graphql extension:
1. npm install -g neo4j-graphql-cligit clone https://github.com/neo4j-graphql/graphql-cli-load && cd example
2. neo4j-graphql example-schema.graphql
2. (remember the auth header)npm install -g graphql-cli graphql-cli-load
4. graphql
5. Run to install the endpoint, and manually add the auth-header to .graphqlconfig, like here:``
"endpoints": {
"starwars": {"url":"http://localhost:7474/graphql/","headers":{"Authorization": "Basic bmVvNGo6dGVzdA=="}}
},graphql load --csv reviews.txt
6. Run or graphql load --csv reviews.json`