SQLDataSource

by cvburgess

cvburgess / SQLDataSource

SQL DataSource for Apollo GraphQL projects

148 Stars 19 Forks Last release: 6 months ago (v1.3.0) MIT License 37 Commits 17 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

SQLDataSource

This package combines the power of Knex with the ease of use of Apollo DataSources.

BREAKING CHANGES IN v1.0.0

In v1.0.0 this lib has a new fluid interface that plays nicely with Knex and stays more true to the spirit of Apollo DataSources.

const query = this.knex.select("*").from("fruit").where({ id: 1 }).cache();

query.then(data => /* ... */ );

To use ( or not use ) the caching feature in v1, simply add

.cache()
to your Knex query.

Read more below about getting set up and customizing the cache controls.

Getting Started

Installation

To install SQLDataSource:

npm i datasource-sql

Usage

// MyDatabase.js

const { SQLDataSource } = require("datasource-sql");

const MINUTE = 60;

class MyDatabase extends SQLDataSource { getFruits() { return this.knex .select("*") .from("fruit") .where({ id: 1 }) .cache(MINUTE); } }

module.exports = MyDatabase;

And use it in your Apollo server configuration:

// index.js

const MyDatabase = require("./MyDatabase");

const knexConfig = { client: "pg", connection: { /* CONNECTION INFO */ } };

// you can also pass a knex instance instead of a configuration object const db = new MyDatabase(knexConfig);

const server = new ApolloServer({ typeDefs, resolvers, cache, context, dataSources: () => ({ db }) });

Caching ( .cache( ttl ) )

If you were to make the same query over the course of multiple requests to your server you could also be making needless requests to your server - especially for expensive queries.

SQLDataSource leverages Apollo's caching strategy to save results between requests and makes that available via

.cache()
.

This method accepts one OPTIONAL parameter,

ttl
that is the number of seconds to retain the data in the cache.

The default value for cache is

5 seconds
.

Unless configured, SQLDataSource uses an InMemoryLRUCache like the RESTDataSource.

SQLDataSource Properties

SQLDataSource is an ES6 Class that can be extended to make a new SQLDataSource and extends Apollo's base DataSource class under the hood.

( See the Usage section above for an example )

Like all DataSources, SQLDataSource has an initialize method that Apollo will call when a new request is routed.

If no cache is provided in your Apollo server configuration, SQLDataSource falls back to the same InMemoryLRUCache leveraged by RESTDataSource.

context

The context from your Apollo server is available as

this.context
.

knex

The knex instance is made available as

this.knex
or
this.db
.

Debug mode

To enable more enhanced logging via knex-tiny-logger, set

DEBUG
to a truthy value in your environment variables.

Contributing

All contributions are welcome!

Please open an issue or pull request.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.