From 96898f6d9046928d5671c51f05936f613a4b0fb8 Mon Sep 17 00:00:00 2001 From: Drew Skwiers-Koballa Date: Thu, 25 Jul 2024 15:27:36 -0700 Subject: [PATCH] docs and templates option add for 162.3 (#457) --- README.md | 4 ++-- .../sqlproject/.template.config/template.json | 4 ++++ src/Microsoft.Build.Sql/docs/Converting-Existing.md | 8 ++++++-- src/Microsoft.Build.Sql/docs/Functionality.md | 5 ++++- 4 files changed, 16 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 71297a2..be0027c 100644 --- a/README.md +++ b/README.md @@ -3,12 +3,12 @@ |Component|Links|Summary| |:--|:--|:--| |SqlPackage|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlPackage)
[📗 Docs](https://aka.ms/sqlpackage-ref)|Microsoft.SqlPackage is a cross-platform command-line utility for creating and deploying .dacpac and .bacpac packages. SqlPackage can be installed as a *dotnet tool*.| -|DacFx|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.DacFx)|The Microsoft SQL Server Data-Tier Application Framework (Microsoft.SqlServer.DacFx) is a .NET library which provides application lifecycle services for database development and management for Microsoft SQL Server and Microsoft Azure SQL Databases. Preview versions of DacFx are frequently released to NuGet.| +|DacFx|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.DacFx)
[📘 API Docs](https://learn.microsoft.com/dotnet/api/microsoft.sqlserver.dac)|The Microsoft SQL Server Data-Tier Application Framework (Microsoft.SqlServer.DacFx) is a .NET library which provides application lifecycle services for database development and management for Microsoft SQL Server and Microsoft Azure SQL Databases. Preview versions of DacFx are frequently released to NuGet.| |Dacpacs.(Master,Msdb)|[📦 Master](https://www.nuget.org/packages/Microsoft.SqlServer.Dacpacs.Master)
[📦 Msdb](https://www.nuget.org/packages/Microsoft.SqlServer.Dacpacs.Msdb)|Microsoft.SqlServer.Dacpacs.Master and Microsoft.SqlServer.Dacpacs.Msdb is a set of NuGet packages containing .dacpac files for Microsoft SQL Server system databases (master, msdb) with versions across SQL Server 2008 (100) through SQL Server 2022 (160).| |Dacpacs.Azure.Master|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.Dacpacs.Azure.Master)|Microsoft.SqlServer.Dacpacs.Azure.Master is a NuGet package containing a .dacpac file for the Azure SQL Database master database.| |Dacpacs.Synapse.Master|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.Dacpacs.Synapse.Master)|Microsoft.SqlServer.Dacpacs.Synapse.Master is a NuGet package containing a .dacpac file for the Azure Synapse Analytics master database.| |Dacpacs.SynapseServerless.Master|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.Dacpacs.SynapseServerless.Master)|Microsoft.SqlServer.Dacpacs.SynapseServerless.Master is a NuGet package containing a .dacpac file for the Azure Synapse Analytics serverless SQL pools master database.| -|ScriptDom|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.TransactSql.ScriptDom)
[🛠️ Code](https://github.com/microsoft/SqlScriptDOM)|Microsoft.SqlServer.TransactSql.ScriptDom is a NuGet package containing the Transact-SQL parser [ScriptDOM](https://learn.microsoft.com/dotnet/api/microsoft.sqlserver.transactsql.scriptdom). The [source code](https://github.com/microsoft/SqlScriptDOM) is licensed MIT.| +|ScriptDom|[📦 NuGet](https://www.nuget.org/packages/Microsoft.SqlServer.TransactSql.ScriptDom)
[🛠️ Code](https://github.com/microsoft/SqlScriptDOM)
[📘 API Docs](https://learn.microsoft.com/dotnet/api/microsoft.sqlserver.transactsql.scriptdom)|Microsoft.SqlServer.TransactSql.ScriptDom is a NuGet package containing the Transact-SQL parser [ScriptDOM](https://learn.microsoft.com/dotnet/api/microsoft.sqlserver.transactsql.scriptdom). The [source code](https://github.com/microsoft/SqlScriptDOM) is licensed MIT.| |Microsoft.Build.Sql|[📦 NuGet](https://www.nuget.org/packages/Microsoft.Build.Sql)
[🛠️ Code](/src/Microsoft.Build.Sql/)|Microsoft.Build.Sql (preview) is a [.NET project SDK](https://docs.microsoft.com/dotnet/core/project-sdk/overview) for SQL projects, compiling T-SQL code to a data-tier application package (dacpac). In preview, [source code](/src/Microsoft.Build.Sql/) in this repository.| |Project Templates|[📦 NuGet](https://www.nuget.org/packages/Microsoft.Build.Sql.Templates)
[🛠️ Code](/src/Microsoft.Build.Sql.Templates/)|Microsoft.Build.Sql.Templates (preview) is a set of [.NET project templates](https://learn.microsoft.com/dotnet/core/tools/custom-templates) for SQL projects. In preview, [source code](/src/Microsoft.Build.Sql.Templates/) in this repository.| diff --git a/src/Microsoft.Build.Sql.Templates/sqlproject/.template.config/template.json b/src/Microsoft.Build.Sql.Templates/sqlproject/.template.config/template.json index a30b151..d5a7ce5 100644 --- a/src/Microsoft.Build.Sql.Templates/sqlproject/.template.config/template.json +++ b/src/Microsoft.Build.Sql.Templates/sqlproject/.template.config/template.json @@ -61,6 +61,10 @@ "choice": "SqlAzureV12", "description": "Azure SQL Database" }, + { + "choice": "SqlDbFabric", + "description": "Fabric mirrored SQL database (preview)" + }, { "choice": "SqlDw", "description": "Azure Synapse SQL" diff --git a/src/Microsoft.Build.Sql/docs/Converting-Existing.md b/src/Microsoft.Build.Sql/docs/Converting-Existing.md index 8360fd8..ee00898 100644 --- a/src/Microsoft.Build.Sql/docs/Converting-Existing.md +++ b/src/Microsoft.Build.Sql/docs/Converting-Existing.md @@ -2,10 +2,14 @@ This page provides guidance in converting existing SQL projects from Visual Studio SQL Server Data Tools (SSDT) or Azure Data Studio (ADS) to use the Microsoft.Build.Sql SDK. +> [!WARNING] +> Visual Studio does not yet support Microsoft.Build.Sql SDK-style SQL projects. Converting existing projects to use Microsoft.Build.Sql will require you to make further edits through VS Code or Azure Data Studio. + + ## Changes to .sqlproj file To convert a database project into SDK-style, edit the .sqlproj file by adding ```xml - + ``` inside the `` tag. @@ -13,7 +17,7 @@ inside the `` tag. ```xml - + ... ``` diff --git a/src/Microsoft.Build.Sql/docs/Functionality.md b/src/Microsoft.Build.Sql/docs/Functionality.md index 0de4ff7..a4eb936 100644 --- a/src/Microsoft.Build.Sql/docs/Functionality.md +++ b/src/Microsoft.Build.Sql/docs/Functionality.md @@ -36,9 +36,12 @@ Valid settings for the target platform are: - `Microsoft.Data.Tools.Schema.Sql.Sql130DatabaseSchemaProvider` - `Microsoft.Data.Tools.Schema.Sql.Sql140DatabaseSchemaProvider` - `Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider` -- `Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider` +- `Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider` (161.6374.0 and higher) - `Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider` +- `Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider` (162.3 and higher) - `Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider` +- `Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider` (161.8089.0 and higher) +- `Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider` (162.1 and higher) ## Database references The database model validation at build time can be extended past the contents of the SQL project through database references. Database references specified in the `.sqlproj` file can reference another SQL project or a `.dacpac` file, representing either another database or more components of the same database.