Author: Johannes Rainer

# Using a MySQL server backend

# Introduction

`ensembldb` uses by default, similar to other annotation packages in Bioconductor, a SQLite database backend, i.e. annotations are retrieved from file-based SQLite databases that are provided via packages, such as the `EnsDb.Hsapiens.v86` package. In addition, `ensembldb` allows to switch the backend from SQLite to MariaDB/MySQL and thus to retrieve annotations from a MySQL server instead. Such a setup might be useful for a lab running a well-configured MySQL server that would require installation of EnsDb databases only on the database server and not on the individual clients.

Note the code in this document is not executed during vignette generation as this would require access to a MySQL server.

# Using `ensembldb` with a MySQL server

Installation of `EnsDb` databases in a MySQL server is straight forward - given that the user has write access to the server:

    library(ensembldb)
    ## Load the EnsDb package that should be installed on the MySQL server
    library(EnsDb.Hsapiens.v86)

    ## Call the useMySQL method providing the required credentials to create
    ## databases and inserting data on the MySQL server
    edb_mysql <- useMySQL(EnsDb.Hsapiens.v86, host = "localhost",
                          user = "userwrite", pass = "userpass")

    ## Use this EnsDb object
    genes(edb_mysql)

To use an `EnsDb` in a MySQL server without the need to install the corresponding R-package, the connection to the database can be passed to the `EnsDb` constructor function. With the resulting `EnsDb` object annotations can be retrieved from the MySQL database.

    library(ensembldb)
    library(RMariaDB)

    ## Connect to the MySQL database to list the databases.
    dbcon <- dbConnect(MariaDB(), host = "localhost", user = "readonly",
                       pass = "readonly")

    ## List the available databases
    listEnsDbs(dbcon)

    ## Connect to one of the databases and use that one.
    dbcon <- dbConnect(MariaDB(), host = "localhost", user = "readonly",
                       pass = "readonly", dbname = "ensdb_hsapiens_v75")
    edb <- EnsDb(dbcon)
    edb

# Session information

    sessionInfo()

    ## R version 4.6.0 (2026-04-24)
    ## Platform: x86_64-pc-linux-gnu
    ## Running under: Ubuntu 24.04.4 LTS
    ##
    ## Matrix products: default
    ## BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
    ## LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so;  LAPACK version 3.12.0
    ##
    ## locale:
    ##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C
    ##  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8
    ##  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8
    ##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C
    ##  [9] LC_ADDRESS=C               LC_TELEPHONE=C
    ## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
    ##
    ## time zone: Etc/UTC
    ## tzcode source: system (glibc)
    ##
    ## attached base packages:
    ## [1] grid      stats4    stats     graphics  grDevices utils     datasets
    ## [8] methods   base
    ##
    ## other attached packages:
    ##  [1] AnnotationHub_4.3.0
    ##  [2] BiocFileCache_3.3.0
    ##  [3] dbplyr_2.5.2
    ##  [4] BSgenome.Hsapiens.NCBI.GRCh38_1.3.1000
    ##  [5] BSgenome_1.81.0
    ##  [6] rtracklayer_1.73.0
    ##  [7] BiocIO_1.23.3
    ##  [8] Biostrings_2.81.3
    ##  [9] XVector_0.53.0
    ## [10] Gviz_1.57.0
    ## [11] EnsDb.Hsapiens.v86_2.99.0
    ## [12] ensembldb_2.37.3
    ## [13] AnnotationFilter_1.37.0
    ## [14] GenomicFeatures_1.65.0
    ## [15] AnnotationDbi_1.75.0
    ## [16] Biobase_2.73.1
    ## [17] GenomicRanges_1.65.0
    ## [18] Seqinfo_1.3.0
    ## [19] IRanges_2.47.2
    ## [20] S4Vectors_0.51.3
    ## [21] BiocGenerics_0.59.7
    ## [22] generics_0.1.4
    ## [23] BiocStyle_2.41.0
    ##
    ## loaded via a namespace (and not attached):
    ##   [1] RColorBrewer_1.1-3          sys_3.4.3
    ##   [3] rstudioapi_0.18.0           jsonlite_2.0.0
    ##   [5] magrittr_2.0.5              farver_2.1.2
    ##   [7] rmarkdown_2.31              vctrs_0.7.3
    ##   [9] memoise_2.0.1               Rsamtools_2.29.0
    ##  [11] RCurl_1.98-1.19             base64enc_0.1-6
    ##  [13] htmltools_0.5.9             S4Arrays_1.13.0
    ##  [15] BiocBaseUtils_1.15.1        progress_1.2.3
    ##  [17] curl_7.1.0                  SparseArray_1.13.2
    ##  [19] Formula_1.2-5               sass_0.4.10
    ##  [21] bslib_0.11.0                htmlwidgets_1.6.4
    ##  [23] httr2_1.2.2                 cachem_1.1.0
    ##  [25] buildtools_1.0.0            GenomicAlignments_1.49.0
    ##  [27] lifecycle_1.0.5             pkgconfig_2.0.3
    ##  [29] Matrix_1.7-5                R6_2.6.1
    ##  [31] fastmap_1.2.0               MatrixGenerics_1.25.0
    ##  [33] digest_0.6.39               colorspace_2.1-2
    ##  [35] Hmisc_5.2-5                 RSQLite_3.53.1
    ##  [37] filelock_1.0.3              httr_1.4.8
    ##  [39] abind_1.4-8                 compiler_4.6.0
    ##  [41] withr_3.0.2                 bit64_4.8.2
    ##  [43] htmlTable_2.5.0             S7_0.2.2
    ##  [45] backports_1.5.1             BiocParallel_1.47.0
    ##  [47] DBI_1.3.0                   biomaRt_2.69.0
    ##  [49] rappdirs_0.3.4              DelayedArray_0.39.3
    ##  [51] rjson_0.2.23                tools_4.6.0
    ##  [53] foreign_0.8-91              otel_0.2.0
    ##  [55] nnet_7.3-20                 glue_1.8.1
    ##  [57] restfulr_0.0.16             checkmate_2.3.4
    ##  [59] cluster_2.1.8.2             gtable_0.3.6
    ##  [61] data.table_1.18.4           hms_1.1.4
    ##  [63] BiocVersion_3.24.0          pillar_1.11.1
    ##  [65] stringr_1.6.0               dplyr_1.2.1
    ##  [67] lattice_0.22-9              bit_4.6.0
    ##  [69] deldir_2.0-4                biovizBase_1.61.0
    ##  [71] tidyselect_1.2.1            maketools_1.3.2
    ##  [73] knitr_1.51                  gridExtra_2.3
    ##  [75] ProtGenerics_1.45.0         SummarizedExperiment_1.43.0
    ##  [77] xfun_0.58                   matrixStats_1.5.0
    ##  [79] stringi_1.8.7               UCSC.utils_1.9.0
    ##  [81] lazyeval_0.2.3              yaml_2.3.12
    ##  [83] evaluate_1.0.5              codetools_0.2-20
    ##  [85] cigarillo_1.3.0             interp_1.1-6
    ##  [87] tibble_3.3.1                BiocManager_1.30.27
    ##  [89] cli_3.6.6                   rpart_4.1.27
    ##  [91] jquerylib_0.1.4             dichromat_2.0-0.1
    ##  [93] Rcpp_1.1.1-1.1              GenomeInfoDb_1.49.1
    ##  [95] png_0.1-9                   XML_3.99-0.23
    ##  [97] parallel_4.6.0              ggplot2_4.0.3
    ##  [99] blob_1.3.0                  prettyunits_1.2.0
    ## [101] latticeExtra_0.6-31         jpeg_0.1-11
    ## [103] bitops_1.0-9                VariantAnnotation_1.59.0
    ## [105] scales_1.4.0                purrr_1.2.2
    ## [107] crayon_1.5.3                rlang_1.2.0
    ## [109] KEGGREST_1.53.0