1. Structure
  2. Life Sciences
  3. Population Genomics
  4. Foundation
  5. Key Concepts
  6. The N+1 Problem
  • Home
  • What is TileDB?
  • Get Started
  • Explore Content
  • Accounts
    • Individual Accounts
      • Apply for the Free Tier
      • Profile
        • Overview
        • Cloud Credentials
        • Storage Paths
        • REST API Tokens
        • Credits
    • Organization Admins
      • Create an Organization
      • Profile
        • Overview
        • Members
        • Cloud Credentials
        • Storage Paths
        • Billing
      • API Tokens
    • Organization Members
      • Organization Invitations
      • Profile
        • Overview
        • Members
        • Cloud Credentials
        • Storage Paths
        • Billing
      • API Tokens
  • Catalog
    • Introduction
    • Data
      • Arrays
      • Tables
      • Single-Cell (SOMA)
      • Genomics (VCF)
      • Biomedical Imaging
      • Vector Search
      • Files
    • Code
      • Notebooks
      • Dashboards
      • User-Defined Functions
      • Task Graphs
      • ML Models
    • Groups
    • Marketplace
    • Search
  • Collaborate
    • Introduction
    • Organizations
    • Access Control
      • Introduction
      • Share Assets
      • Asset Permissions
      • Public Assets
    • Logging
    • Marketplace
  • Analyze
    • Introduction
    • Slice Data
    • Multi-Region Redirection
    • Notebooks
      • Launch a Notebook
      • Usage
      • Widgets
      • Notebook Image Dependencies
    • Dashboards
      • Dashboards
      • Streamlit
    • Preview
    • User-Defined Functions
    • Task Graphs
    • Serverless SQL
    • Monitor
      • Task Log
      • Task Graph Log
  • Scale
    • Introduction
    • Task Graphs
    • API Usage
  • Structure
    • Why Structure Is Important
    • Arrays
      • Introduction
      • Quickstart
      • Foundation
        • Array Data Model
        • Key Concepts
          • Storage
            • Arrays
            • Dimensions
            • Attributes
            • Cells
            • Domain
            • Tiles
            • Data Layout
            • Compression
            • Encryption
            • Tile Filters
            • Array Schema
            • Schema Evolution
            • Fragments
            • Fragment Metadata
            • Commits
            • Indexing
            • Array Metadata
            • Datetimes
            • Groups
            • Object Stores
          • Compute
            • Writes
            • Deletions
            • Consolidation
            • Vacuuming
            • Time Traveling
            • Reads
            • Query Conditions
            • Aggregates
            • User-Defined Functions
            • Distributed Compute
            • Concurrency
            • Parallelism
        • Storage Format Spec
      • Tutorials
        • Basics
          • Basic Dense Array
          • Basic Sparse Array
          • Array Metadata
          • Compression
          • Encryption
          • Data Layout
          • Tile Filters
          • Datetimes
          • Multiple Attributes
          • Variable-Length Attributes
          • String Dimensions
          • Nullable Attributes
          • Multi-Range Reads
          • Query Conditions
          • Aggregates
          • Deletions
          • Catching Errors
          • Configuration
          • Basic S3 Example
          • Basic TileDB Cloud
          • fromDataFrame
          • Palmer Penguins
        • Advanced
          • Schema Evolution
          • Advanced Writes
            • Write at a Timestamp
            • Get Fragment Info
            • Consolidation
              • Fragments
              • Fragment List
              • Consolidation Plan
              • Commits
              • Fragment Metadata
              • Array Metadata
            • Vacuuming
              • Fragments
              • Commits
              • Fragment Metadata
              • Array Metadata
          • Advanced Reads
            • Get Fragment Info
            • Time Traveling
              • Introduction
              • Fragments
              • Array Metadata
              • Schema Evolution
          • Array Upgrade
          • Backends
            • Amazon S3
            • Azure Blob Storage
            • Google Cloud Storage
            • MinIO
            • Lustre
          • Virtual Filesystem
          • User-Defined Functions
          • Distributed Compute
          • Result Estimation
          • Incomplete Queries
        • Management
          • Array Schema
          • Groups
          • Object Management
        • Performance
          • Summary of Factors
          • Dense vs. Sparse
          • Dimensions vs. Attributes
          • Compression
          • Tiling and Data Layout
          • Tuning Writes
          • Tuning Reads
      • API Reference
    • Tables
      • Introduction
      • Quickstart
      • Foundation
        • Data Model
        • Key Concepts
          • Indexes
          • Columnar Storage
          • Compression
          • Data Manipulation
          • Optimize Tables
          • ACID
          • Serverless SQL
          • SQL Connectors
          • Dataframes
          • CSV Ingestion
      • Tutorials
        • Basics
          • Ingestion with SQL
          • CSV Ingestion
          • Basic S3 Example
          • Running Locally
        • Advanced
          • Scalable Ingestion
          • Scalable Queries
      • API Reference
    • AI & ML
      • Vector Search
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • Vector Search
            • Vector Databases
            • Algorithms
            • Distance Metrics
            • Updates
            • Deployment Methods
            • Architecture
            • Distributed Compute
          • Storage Format Spec
        • Tutorials
          • Basics
            • Ingestion & Querying
            • Updates
            • Deletions
            • Basic S3 Example
            • Running Locally
          • Advanced
            • Versioning
            • Time Traveling
            • Consolidation
            • Distributed Compute
            • RAG LLM
            • LLM Memory
            • File Search
            • Image Search
            • Protein Search
          • Performance
        • API Reference
      • ML Models
        • Introduction
        • Quickstart
        • Foundation
          • Basics
          • Storage
          • Cloud Execution
          • Why TileDB for Machine Learning
        • Tutorials
          • Ingestion
            • Data Ingestion
              • Dense Datasets
              • Sparse Datasets
            • ML Model Ingestion
          • Management
            • Array Schema
            • Machine Learning: Groups
            • Time Traveling
    • Life Sciences
      • Single-cell
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • Data Structures
            • Use of Apache Arrow
            • Join IDs
            • State Management
            • TileDB Cloud URIs
          • SOMA API Specification
        • Tutorials
          • Data Ingestion
          • Bulk Ingestion Tutorial
          • Data Access
          • Distributed Compute
          • Basic S3 Example
          • Multi-Experiment Queries
          • Appending Data to a SOMA Experiment
          • Add New Measurements
          • SQL Queries
          • Running Locally
          • Shapes in TileDB-SOMA
          • Drug Discovery App
        • Spatial
          • Introduction
          • Foundation
            • Spatial Data Model
            • Data Structures
          • Tutorials
            • Spatial Data Ingestion
            • Access Spatial Data
            • Manage Coordinate Spaces
        • API Reference
      • Population Genomics
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • The N+1 Problem
            • Architecture
            • Arrays
            • Ingestion
            • Reads
            • Variant Statistics
            • Annotations
            • User-Defined Functions
            • Tables and SQL
            • Distributed Compute
          • Storage Format Spec
        • Tutorials
          • Basics
            • Basic Ingestion
            • Basic Queries
            • Export to VCF
            • Add New Samples
            • Deleting Samples
            • Basic S3 Example
            • Basic TileDB Cloud
          • Advanced
            • Scalable Ingestion
            • Scalable Queries
            • Query Transforms
            • Handling Large Queries
            • Annotations
              • Finding Annotations
              • Embedded Annotations
              • External Annotations
              • Annotation VCFs
              • Ingesting Annotations
            • Variant Statistics
            • Tables and SQL
            • User-Defined Functions
            • Sample Metadata
            • Split VCF
          • Performance
        • API Reference
          • Command Line Interface
          • Python API
          • Cloud API
      • Biomedical Imaging
        • Introduction
        • Foundation
          • Data Model
          • Key Concepts
            • Arrays
            • Ingestion
            • Reads
            • User Defined Functions
          • Storage Format Spec
        • Quickstart
        • Tutorials
          • Basics
            • Ingestion
            • Read
              • OpenSlide
              • TileDB-Py
          • Advanced
            • Batched Ingestion
            • Chunked Ingestion
            • Machine Learning
              • PyTorch
            • Napari
    • Files
  • API Reference
  • Self-Hosting
    • Installation
    • Upgrades
    • Administrative Tasks
    • Image Customization
      • Customize User-Defined Function Images
      • AWS ECR Container Registry
      • Customize Jupyter Notebook Images
    • Single Sign-On
      • Configure Single Sign-On
      • OpenID Connect
      • Okta SCIM
      • Microsoft Entra
  • Glossary

On this page

  • Limitations of VCF files
  • How TileDB-VCF solves the N+1 problem
  1. Structure
  2. Life Sciences
  3. Population Genomics
  4. Foundation
  5. Key Concepts
  6. The N+1 Problem

The N+1 Problem

life sciences
genomics (vcf)
foundation
The N+1 problem in population genomics and how TileDB-VCF solves it.

The N+1 problem in genomics refers to the inefficiency of interrogating existing samples for read coverage when a new sample introduces novel variants into a cohort. The gVCF format addresses this problem by introducing ranges that distinguish reference from no-calls. However, the gVCF format alone does not solve the broader performance problem when adding new samples, which has parallels to a similar problem in databases: adding a new row with a field that doesn’t exist as a column in the database. That would require adding a new column for that field, and filling null values for all existing rows.

More specifically, from a data management perspective, the N+1 problem is introducing the following severe performance issues in existing solutions:

  • The new sample needs to alter the entire existing dataset, typically stored in a CombinedVCF file (similar to adding a column in the above database example). This impacts storage size and write performance.
  • Or, the new sample must be stored separately, implying that all samples are stored as single-sample (g)VCF files. This impacts read performance.

The next subsection sheds a bit more light on how VCF-based solutions create the N+1 problem from a data management perspective, and the last subsection explains how TileDB solves this problem with a more principled, database-oriented approach, while providing first-class support for the gVCF standard.

Limitations of VCF files

The figure below demonstrates the most basic case, where the user maintains all data as single-sample VCF files. A typical query is one or more genomic ranges across all samples (potentially subsetting on the VCF fields). Although the result for this query may have some locality within each file, a solution performing the query needs to perform N (or N+1) separate range searches across all files. The entire result then has almost no locality, as it is located in very diverse byte ranges in the storage medium. This leads to extremely poor perormance and does not scale well as the number of samples increases.

An illustration demonstrating how single-sample VCF files lead to read performance issues. An illustration demonstrating how single-sample VCF files lead to read performance issues.

The second case is to merge all initial N samples into a single file, called CombinedVCF, illustrated in the figure below. That file is optimized for fast genomic range reads across all samples, as this information appears relatively collocated in the same file. This leads to extremely high read performance.

An illustration demonstrating how adding a new VCF sample needs to regenerate the entire CombinedVCF file. An illustration demonstrating how adding a new VCF sample needs to regenerate the entire CombinedVCF file.

When you wish to add a new sample to a CombinedVCF file, two problems appear:

  1. The CombinedVCF file needs to be destroyed and completely regenerated. This is because the CombinedVCF file needs to collocate information from each sample in the same genomic range entry. Loosely speaking, this means that the bytes from the new sample file need to be injected in disparate places across the entire CombinedVCF file. For a large value for N, the CombinedVCF file reconstruction cost is prohibitive.
  2. If the new sample contains a variant that is not present in the CombinedVCF file, a new entry needs to be created, and information from all the N+1 samples needs to be stored in that entry. This leads to a non-linear explosion of the CombinedVCF file size in the number of samples it encompasses.

The above indicates that CombinedVCF-based solutions are not scalable and cannot work for biobank-scale datasets.

How TileDB-VCF solves the N+1 problem

TileDB-VCF adopts a more principled approach to solving this problem. It does so in the following manner:

  • It builds upon TileDB arrays, inheriting all the important built-in database functionality, such as efficient storage, indexing and querying, versioning, time traveling, consolidation, and more. TileDB-VCF, coupled with TileDB Cloud, adds further functionality, such as advanced authentication, access control, logging, catalogs, compliance, and more.
  • TileDB-VCF offers compressed storage, which scales linearly in the number of samples (eliminating the storage explosion of CombinedVCF). This is because of the way it stores the VCF entries, which is described in detail in the Data Model section.
  • TileDB-VCF employs a combination of batch insertions and consolidation to offer an excellent tradeoff between read and ingestion performance. Upon ingestion, the user can specify any number of samples to ingest, and TileDB-VCF can perform the format conversion and write very efficiently, collocating genomic range information across samples (similar to CombinedVCF, but without the storage explosion). When new samples or batches of samples arrive, TileDB-VCF can ingest them without touching the previously ingested samples at all. This further allows embarrassingly parallel ingestion, as TileDB doesn’t need to synchronize anything. Finally, the user can choose to perform an operation called consolidation in the background and without blocking any incoming reads. The consolidation process reorganizes the data, so that it increases the locality of genomic range entries across samples (again, similar to CombinedVCF but without the storage explosion).

TileDB-VCF offers excellent performance for both ingestion and reads, in addition to bringing more management rigor akin to advanced database solutions in other applications.

Key Concepts
Architecture