Contoso-Data-Generator 项目下载及安装教程

1. 项目介绍

Contoso-Data-Generator 是一个用于生成自定义 Contoso 示例数据库的开源项目。该项目提供了两种运行方式：通过克隆仓库并使用 Visual Studio 编译项目，或者直接使用预编译的工具生成新的数据库。生成的数据库可以用于 SQL Server 的开发和测试。

2. 项目下载位置

要下载 Contoso-Data-Generator 项目，请访问项目的 GitHub 仓库。你可以通过以下步骤下载项目：

1. 打开命令行工具（如 Git Bash 或 PowerShell）。

2. 使用以下命令克隆仓库：

   git clone https://github.com/sql-bi/Contoso-Data-Generator.git
   

   这将把项目文件下载到你的本地计算机。

3. 项目安装环境配置

在安装和运行 Contoso-Data-Generator 之前，你需要确保系统满足以下环境要求：

• 7-Zip: 用于压缩和解压缩文件。你可以从 7-Zip 官网 下载并安装。
• Microsoft SQL Server: 必须安装在同一台计算机上，并且可以通过别名 Demo 访问。你可以从 Microsoft SQL Server 官网 下载并安装 SQL Server Developer 版本（免费版，适用于非生产环境的开发和测试）。
• .NET Core 3.1: 项目依赖于 .NET Core 3.1。你可以从 .NET Core 官网 下载并安装。

环境配置示例

以下是配置环境的一些示例步骤：

1. 安装 7-Zip:

   • 下载并安装 7-Zip。
   • 确保 7-Zip 已添加到系统的 PATH 环境变量中。

2. 安装 Microsoft SQL Server:

   • 下载并安装 SQL Server Developer 版本。
   • 配置 SQL Server 别名 Demo，以便通过该别名访问 SQL Server。

3. 安装 .NET Core 3.1:

   • 下载并安装 .NET Core 3.1 SDK。
   • 确保 .NET Core 3.1 已正确安装并可以在命令行中运行。

4. 项目安装方式

Contoso-Data-Generator 提供了两种安装方式：

方式一：通过克隆仓库并编译项目

1. 克隆项目仓库到本地：

   git clone https://github.com/sql-bi/Contoso-Data-Generator.git
   

2. 打开 Visual Studio，加载项目解决方案文件 DatabaseGenerator.sln。

3. 编译项目，生成可执行文件。

方式二：使用预编译工具

1. 从项目的 GitHub 仓库的 release 文件夹中下载预编译的 ZIP 文件。
2. 解压缩 ZIP 文件到本地目录。
3. 运行 QuickRun.ps1 脚本以生成新的 Contoso 数据库。

5. 项目处理脚本

Contoso-Data-Generator 包含多个 PowerShell 脚本，用于生成和处理数据库。以下是一些关键脚本的介绍：

• QuickRun.ps1: 快速运行脚本，生成新的 Contoso 数据库。
• GenerateDatabases.ps1: 生成数据库的脚本，包含详细的配置选项。
• ImportData.ps1: 导入生成的数据到新的数据库中。

示例脚本运行

以下是运行 QuickRun.ps1 脚本的示例：

.\QuickRun.ps1 -SqlDataFilesFolder "C:\TEMP" -SqlServerInstance "Demo"

该命令将在 C:\TEMP 目录下生成数据库文件，并将其导入到名为 Demo 的 SQL Server 实例中。

通过以上步骤，你可以成功下载、安装并运行 Contoso-Data-Generator 项目，生成自定义的 Contoso 示例数据库。