tiledb/tiledb-mariadb-server

MariaDB-MyTile Docker镜像文档

镜像概述和主要用途

本Docker镜像集成了MariaDB数据库和MyTile存储引擎，旨在提供一个便捷的环境，使用户能够通过标准SQL接口直接查询TileDB数组。通过将MariaDB的SQL功能与MyTile的TileDB数据访问能力相结合，简化了从TileDB数组中提取和分析数据的流程，无需额外的数据导出或转换步骤。

核心功能和特性

• MariaDB基础功能：包含完整的MariaDB数据库服务，支持标准SQL语法、事务处理、用户管理等核心数据库功能。
• MyTile存储引擎集成：内置MyTile存储引擎，实现MariaDB与TileDB数据格式的原生对接。
• SQL查询TileDB数组：支持通过SQL语句（如SELECT、JOIN等）直接查询TileDB数组数据，降低数据访问门槛。
• 简化数据访问流程：无需手动转换TileDB数据格式，直接通过数据库接口进行数据查询和分析。
• 轻量级部署：基于Docker容器化部署，环境一致性高，可快速在开发、测试和生产环境中部署使用。

使用场景和适用范围

• 数据分析场景：适用于需要通过SQL工具（如MySQL客户端、BI工具）分析TileDB数组数据的场景。
• 数据库与TileDB集成：作为中间层实现传统数据库与TileDB数据仓库的联动，支持复杂数据查询。
• 开发与测试环境：提供快速搭建的MariaDB-MyTile开发环境，加速相关应用的开发和测试流程。
• 科研数据处理：方便科研人员使用熟悉的SQL语法查询存储在TileDB中的科学数据（如多维数组、时空数据等）。

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 已安装Docker Compose（可选，用于多容器部署）

基本使用步骤

1. 拉取镜像

从镜像仓库拉取最新版本（具体镜像名称需根据实际仓库调整）：

bash
docker pull [镜像仓库地址]/mariadb-mytile:latest

2. 运行容器

基础运行命令（默认配置）：

bash
docker run -d \
  --name mariadb-mytile \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  [镜像仓库地址]/mariadb-mytile:latest

挂载TileDB数据目录（指定TileDB数组存储路径）：

bash
docker run -d \
  --name mariadb-mytile \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -v /path/to/local/tiledb_data:/var/lib/mariadb/tiledb \
  [镜像仓库地址]/mariadb-mytile:latest

3. 连接数据库并查询TileDB数组

使用MariaDB客户端连接容器内数据库：

bash
mysql -h localhost -P 3306 -u root -p

输入密码后，通过MyTile引擎查询TileDB数组（示例）：

sql
-- 创建指向TileDB数组的表
CREATE TABLE tiledb_array (
  id INT,
  value FLOAT
) ENGINE=MyTile 
  TILEDB_URI='/var/lib/mariadb/tiledb/my_array' 
  TILEDB_ROW_DIM='id';

-- 查询TileDB数组数据
SELECT id, value FROM tiledb_array WHERE value > 10.0;

Docker部署示例

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mariadb-mytile:
    image: [镜像仓库地址]/mariadb-mytile:latest
    container_name: mariadb-mytile
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: tiledb_db  # 初始化数据库名称
      MYSQL_USER: tiledb_user    # 创建专用用户
      MYSQL_PASSWORD: tiledb_pass # 用户密码
    volumes:
      - ./tiledb_data:/var/lib/mariadb/tiledb  # 挂载TileDB数据目录
      - ./mariadb_data:/var/lib/mysql          # 持久化数据库数据
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

数据卷挂载

注意事项

• 确保TileDB数组目录权限正确，容器内MariaDB进程（通常为mysql用户）需有读取权限。
• MyTile存储引擎对TileDB数组的元数据有特定要求，创建表时需正确指定TILEDB_URI和维度参数（参考MariaDB MyTile官方文档）。
• 生产环境中建议通过环境变量或配置文件设置数据库安全参数（如skip-networking、SSL配置等）。