matheusr/mssql

matheusr/mssql镜像文档

镜像概述

matheusr/mssql是基于微软官方mcr.microsoft.com/mssql/server:2019-latest镜像构建的SQL Server 2019 Developer版容器镜像。该镜像通过自定义脚本实现了通过JSON配置文件和SQL脚本自动附加数据库文件的功能，简化了数据库实例的部署和配置流程。

核心功能与特性

• 自动数据库附加：通过JSON配置文件定义数据库信息，自动完成MDF和LDF文件的附加
• 环境变量配置：支持通过环境变量灵活配置数据库密码、工作目录、配置文件名等
• 持久化存储：支持挂载卷以持久化数据库文件和配置
• 简化部署流程：集成入口脚本，自动执行数据库附加逻辑，减少手动操作

使用场景

• 开发环境快速部署SQL Server实例并附加现有数据库文件
• 测试环境快速搭建包含特定数据库的SQL Server环境
• 需要频繁部署相同数据库配置的场景

使用方法

基本运行命令

bash
docker run -e "SA_PASSWORD=your_password" -e "WORKDIR=/vol" -e "JSONFILE=attach_db.json" -e "SQLSCRIPT=attach_db.sql" -p 1433:1433 -v "$(pwd):/vol" -d matheusr/mssql:latest

参数说明

环境变量（Environment Variables）

约束条件

• 挂载的卷路径（-v参数）必须与WORKDIR环境变量指定的路径相同

Docker Compose示例

yaml
version: '3'
services:
  mssql:
    image: matheusr/mssql:latest
    ports:
      - "1433:1433"
    environment:
      - SA_PASSWORD=your_strong_password
      - WORKDIR=/vol
      - JSONFILE=my_databases.json
      - SQLSCRIPT=attach_databases.sql
    volumes:
      - ./local_data:/vol
    restart: unless-stopped

配置文件说明

JSON配置文件（JSONFILE）

用于定义需要附加的数据库信息，格式示例：

json
[
    {"id": "RXIMS_60", 
        "files": {
            "mdf": "dbfiles/RXIMS_60.mdf", 
            "ldf": "dbfiles/RXIMS_60_1.LDF"
        }
    },
    {"id": "CXIMS_60", 
        "files": {
            "mdf": "dbfiles/CXIMS_60.mdf", 
            "ldf": "dbfiles/CXIMS_60_1.LDF"
        }
    }
]

• id：数据库名称
• files.mdf：MDF文件路径（相对于WORKDIR）
• files.ldf：LDF文件路径（相对于WORKDIR）

SQL脚本文件（SQLSCRIPT）

用于执行数据库附加逻辑，默认脚本功能包括：

1. 读取JSON配置文件
2. 验证JSON格式有效性
3. 循环处理每个数据库定义：
   • 如数据库已存在则先分离
   • 附加指定的MDF和LDF文件

默认脚本内容：

sql
DECLARE @JSON varchar(max)

SELECT @JSON = BulkColumn
FROM OPENROWSET (BULK N'$(workdir)/$(jsonfile)', SINGLE_CLOB) as j

IF (ISJSON(@JSON)=1) 
BEGIN 
	PRINT ' ---------------->>>>>> Valid JSON <<<<<<--------------------------'
	DECLARE @SQL VARCHAR(MAX);
	DECLARE @DATABASE NVARCHAR(30);
	DECLARE @MDF NVARCHAR(50);
	DECLARE @LDF NVARCHAR(50);
	DECLARE @ROWCOUNT INT = (SELECT count(*) FROM OPENJSON(@json))

	DECLARE @i INT = 0
	WHILE (@i < @ROWCOUNT) 
	BEGIN 
		SET @DATABASE = JSON_VALUE(@json,CONCAT('$[',@i,'].id'));
		SET @MDF = JSON_VALUE(@json,CONCAT('$[',@i,'].files.mdf'));
		SET @LDF = JSON_VALUE(@json,CONCAT('$[',@i,'].files.ldf'));

		SET @sql = 'IF EXISTS (SELECT 1 FROM SYS.DATABASES WHERE NAME = ''' + @DATABASE  + ''') BEGIN EXEC sp_detach_db [' + @DATABASE + '] END; '
		set @sql = @sql + 'CREATE DATABASE [' + @DATABASE + '] ON	(FILENAME = N''$(workdir)/' + @MDF + '''), (FILENAME = N''$(workdir)/' + @LDF + ''') FOR ATTACH;'

 		EXEC sp_sqlexec @Sql
		PRINT 'COMMAND EXECUTED: ' + @SQL

		SET @i = @i + 1;
	END
END ELSE 
BEGIN
	PRINT 'JSON File is invalid';
END

技术要求

• Docker Engine 1.8及以上版本
• 至少2GB内存（2017-CU2之前版本需要3.25GB）
• 如在Docker for Mac或Windows上运行，需确保为Docker VM分配足够内存