Merge pull request #32943 from dzsquared/sqlprojects/q1_2025

Sqlprojects and sqlpackage docs changes

Author: prmerger-automator[bot]

docs/tools/sql-database-projects/sql-database-projects.md

@@ -87,7 +87,9 @@ New development work should consider using the SDK-style project format, as it's
 - NuGet [package references](concepts/package-references.md) for database references
 - Default globbing pattern for .sql files in the project
 
-SDK-style projects have a superset of functionality from original SQL projects and existing SQL projects can be converted to SDK-style projects through [modification of the project file](howto/convert-original-sql-project.md). The exception to the functionality coverage is support for SQLCLR objects, which require .NET Framework and aren't supported in SDK-style projects.
+SDK-style projects have a superset of functionality from original SQL projects and existing SQL projects can be converted to SDK-style projects through [modification of the project file](howto/convert-original-sql-project.md).
+
+The exception to the functionality coverage is support for SQLCLR objects, which require .NET Framework. A project that contains SQLCLR objects can be converted to an SDK-style project, but the project requires .NET Framework and must be built in Visual Studio on Windows. Once the project with the SQLCLR object is built, the `.dacpac` can be deployed with SqlPackage on .NET and .NET Framework and can be used as a `.dacpac` reference in a project (both same database or same server different database).
 
 ## Related content
 

docs/tools/sqlpackage/sqlpackage-download.md

@@ -99,7 +99,7 @@ A list of preview releases is available on the [dotnet tool feed for SqlPackage]
 
 ## Installation, file download (alternative)
 
-SqlPackage is also prepared as a self-contained download for Windows, macOS, and Linux. No .NET install is required, however, the dependencies included in this .zip download are updated more frequently in the [dotnet tool option for SqlPackage](#installation-cross-platform). The following links are for the latest version of SqlPackage:
+SqlPackage is also prepared as a self-contained download for Windows, macOS, and Linux. No .NET install is required, however, the [operating system requirements](#supported-operating-systems) are the same as the [dotnet tool install](#installation-cross-platform). The dependencies included in this .zip download are updated more frequently in the [dotnet tool option for SqlPackage](#installation-cross-platform). The following links are for the latest version of SqlPackage:
 
 | Platform | Download |
 | :--- | :--- |

docs/tools/sqlpackage/sqlpackage-with-data-in-parquet-files.md

@@ -87,8 +87,47 @@ Ledger tables are enabled for extract and publish operations with Parquet files.
 
 Data stored with Always Encrypted isn't supported for extract and publish operations with Parquet files.
 
+Checking the database for unsupported types is done prior to extract to Parquet by SqlPackage, but you can examine your database quickly with T-SQL. The following sample query returns a result set of types and tables with types not supported for writing to Parquet files.
+
+```sql
+SELECT DISTINCT C.DATA_TYPE, C.TABLE_SCHEMA, C.TABLE_NAME 
+FROM INFORMATION_SCHEMA.TABLES T
+INNER JOIN INFORMATION_SCHEMA.COLUMNS C
+    ON T.TABLE_SCHEMA = C.TABLE_SCHEMA 
+    AND T.TABLE_NAME = C.TABLE_NAME
+    AND T.TABLE_TYPE = 'BASE TABLE'
+WHERE C.DATA_TYPE NOT IN (
+    'binary',
+    'varbinary',
+    'char',
+    'varchar',
+    'nchar',
+    'nvarchar',
+    'smalldate',
+    'smalldatetime',
+    'date',
+    'datetime',
+    'datetime2',
+    'datetimeoffset',
+    'time',
+    'decimal',
+    'numeric',
+    'float',
+    'real',
+    'bigint',
+    'tinyint',
+    'smallint',
+    'int',
+    'bigint',
+    'bit',
+    'money',
+    'smallmoney',
+    'uniqueidentifier'
+)
+```
 
 ## Next Steps
+
 - Learn more about [Extract](sqlpackage-extract.md)
 - Learn more about [Publish](sqlpackage-publish.md)
 - Learn more about [Azure Blob Storage](/azure/storage/blobs/storage-blobs-introduction)

docs/tools/sqlpackage/troubleshooting-issues-and-performance-with-sqlpackage.md

@@ -44,6 +44,10 @@ For Export, an example command is:
 
 Alternative to username and password, [multifactor authentication](/azure/azure-sql/database/authentication-mfa-ssms-overview) can be used to authenticate via Microsoft Entra authentication (formerly Azure Active Directory) with multifactor authentication. Substitute the username and password parameters for `/ua:true` and `/tid:"yourdomain.onmicrosoft.com"`.
 
+### Diagnostic package
+
+In SqlPackage [162.5](release-notes-sqlpackage.md#162557-sqlpackage) and later, a diagnostic package can be generated to assist in troubleshooting. The diagnostic package contains the SqlPackage version, the command executed, and the output of the command. To generate a diagnostic package, use the `/DiagnosticsFile:<filename>` parameter.
+
 ## Common issues
 
 ### Timeout errors