Introduction

Data Connect is a standard for discovery and search of biomedical data, developed by the Discovery Work Stream of the Global Alliance for Genomics & Health.

The standard provides a mechanism for:

  • Describing data and its data model.
    • Data Connect’s Table API component provides a way to organize data into “Tables” and describe their data model, leveraging the JSON Schema standard.
  • Searching the data with the given data model.
    • Data Connect’s Search API component provides a way to query “Tables” of data, leveraging the SQL standard.

It is not in the scope of the standard to:

  • Define said data models.
    • Data Connect relies on other efforts in GA4GH (e.g. GA4GH SchemaBlocks), as well as outside implementers.

Background

GA4GH has previously developed two standards for discovery. Beacon is a standard for discovery of genomic variants, while Matchmaker is a standard for discovery of subjects with certain genomic and phenotypic features. Implementations of these standards have been linked into federated networks (e.g. Beacon Network and Matchmaker Exchange).

Both standards (and the corresponding networks) have been successful in their own right, but had a lot in common. It was acknowledged that it would be broadly useful to develop standards that abstract common infrastructure for building searchable, federated networks for a variety of applications in genomics and health.

Data Connect, formerly known as GA4GH Search, is this general-purpose middleware for building federated, search-based applications. The name of the API reflects its purpose of:

  • Giving data providers a mechanism to enable others to connect to their data via the described data models.
  • Allowing data consumers to make connections within the data through a flexible query language.

Benefits

  • Interoperable. Simple, interoperable, uniform mechanism to publish, discover, and search biomedical data.
  • Flexible. Works with any data that can be serialized as an array of JSON objects. Recommends the use of GA4GH SchemaBlocks data models, but allows custodians to specify their own data models to make their data available without extensive ETL transformations.
  • Supports federation. Serves as a general-purpose framework for building federatable search-based applications across multiple implementations. Federations reference common schemas and properties.
  • Minimal by design. The API is purposely kept minimal so that the barriers to publishing existing data are as small as possible.
  • Backend agnostic. It is possible to implement the API across a large variety of backend datastores.
  • General purpose. Admits use cases that have not yet been thought of.

Use cases

Data Connect is an intentionally general-purpose middleware meant to enable the development of a diverse ecosystem of applications.

The community has built versions of the following applications on top of Data Connect:

  • Data Explorers
  • Beacons
  • Patient matchmaking
  • Jupyter notebooks
  • R data frames
  • Command line query tools
  • Data and metadata indexers
  • Data federations
  • Concept cross-references

We’re looking forward to seeing things we haven’t yet imagined!

The community has also connected data through the following data sources:

  • FHIR
  • Relational databases
  • CSV/TSV files with data dictionaries
  • VCF+TBI files
  • Phenopackets
  • Google BigQuery
  • Google Sheets
  • and more!

Examples of queries on the data that can be answered via Data Connect include:

Full summary of use cases can be found in USECASES.md.