Publish GitHub Pages

Author: Azure Pipelines

articles/extensions/sql-server-extensions.html

@@ -99,6 +99,21 @@ <h3 id="create-a-unique-constraint-with-a-clustered-index">Create a unique const
 <pre><code class="lang-cs">Create.UniqueConstraint(&quot;UQ&quot;).OnTable(&quot;TestTable&quot;).Column(&quot;Name&quot;).Clustered();
 </code></pre>
 <p>Note: You have to create the primary key index or unique constraint separately from the Create.Table expression to be able to specify them as clustered or non-clustered.</p>
+<h3 id="create-a-unique-constraint-on-nullable-columns-using-null-value-filter">Create a unique constraint on nullable columns using null value filter</h3>
+<p>Note: SQL Server has a different approach to creating unique constraints on nullable columns than ANSI standard.</p>
+<pre><code class="lang-cs">Create.Index(&quot;UQ_NullFilter&quot;)
+    .OnTable(&quot;TestTable&quot;).InSchema(&quot;dbo&quot;)
+    .OnColumn(&quot;Name&quot;).Ascending()
+    .WithOptions().Unique()
+    .WithOptions().Filter(&quot;[Name] IS NOT NULL&quot;);
+</code></pre>
+<p>This will generate the following T-SQL DDL statement:</p>
+<pre><code class="lang-sql">CREATE UNIQUE NONCLUSTERED INDEX [UQ_NullFilter] ON [dbo].[TestTable]
+(
+	[Name] ASC
+)
+WHERE ([Name] IS NOT NULL)
+</code></pre>
 <h2 id="create-a-column-of-sql-data-type-nvarcharmax--varcharmax">Create a column of SQL data type <code>nvarchar(MAX)</code> / <code>varchar(MAX)</code></h2>
 <p>Use <code>int.MaxValue</code> to represent infinite length strings.</p>
 <pre><code class="lang-cs">Create.Column(&quot;Name&quot;).OnTable(&quot;TestTable&quot;).AsString(int.MaxValue);

articles/guides/upgrades/guide-2.0-to-3.0.html

@@ -136,7 +136,7 @@ <h2 id="custom-migration-expression-validation">Custom migration expression vali
 <p>This feature allows - for example - forbidding data deletions in a production environment.</p>
 <h2 id="using-systemcomponentmodeldataannotations-for-validation">Using <code>System.ComponentModel.DataAnnotations</code> for validation</h2>
 <h1 id="breaking-changes">Breaking Changes</h1>
-<p>Version 3.0 dropped support for all .NET Framework versions below 4.6.1 and the timeout values are now stored as <a class="xref" href="https://docs.microsoft.com/dotnet/api/system.timespan">TimeSpan</a> rather than an <code>int</code> (of seconds).</p>
+<p>Version 3.0 dropped support for all .NET Framework versions below 4.6.1 and the timeout values are now stored as <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.timespan">TimeSpan</a> rather than an <code>int</code> (of seconds).</p>
 <h2 id="minimum-net-framework-461">Minimum: .NET Framework 4.6.1</h2>
 <p>Dropping the support for all .NET Framework versions below 4.6.1 was required, because the package now relies on the following libraries:</p>
 <ul>
@@ -145,7 +145,7 @@ <h2 id="minimum-net-framework-461">Minimum: .NET Framework 4.6.1</h2>
 <li><a href="https://github.com/aspnet/Logging/">Microsoft.Extensions.Logging</a></li>
 <li><a href="https://github.com/aspnet/Configuration/">Microsoft.Extensions.Configuration</a></li>
 </ul>
-<h2 id="processoroptionstimeout-is-now-a-timespan"><code>ProcessorOptions.Timeout</code> is now a <a class="xref" href="https://docs.microsoft.com/dotnet/api/system.timespan">TimeSpan</a></h2>
+<h2 id="processoroptionstimeout-is-now-a-timespan"><code>ProcessorOptions.Timeout</code> is now a <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.timespan">TimeSpan</a></h2>
 <p>This change is part of the ongoing effort to make the API easier to understand, because it might not be clear if an <code>int timeout</code> is the timeout in milliseconds, seconds, et cetera. Previously the <code>int</code> value corresponded to seconds.</p>
 <h2 id="icanbevalidated-not-used-anymore"><code>ICanBeValidated</code> not used anymore</h2>
 <p>The library now uses <code>System.ComponentModel.DataAnnotations</code> for validation - for example the <code>[Required]</code> attribute for expression fields that are - one might've guessed it - required.</p>
@@ -255,7 +255,7 @@ <h4 id="obsolete-api-1">Obsolete API</h4>
 <li>Re-inventing the wheel</li>
 </ul>
 <h2 id="iannouncer"><code>IAnnouncer</code></h2>
-<p>The <a href="xref:FluentMigrator.Runner.IAnnouncer">IAnnouncer</a> interface (and its implementations) were replaced by <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> and its implementations.</p>
+<p>The <a href="xref:FluentMigrator.Runner.IAnnouncer">IAnnouncer</a> interface (and its implementations) were replaced by <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> and its implementations.</p>
 <h3 id="logger-registration">Logger registration</h3>
 <p>You can comfortably register the default <a href="xref:FluentMigrator.Runner.Logging.FluentMigratorConsoleLogger">FluentMigratorConsoleLogger</a>:</p>
 <pre><code class="lang-cs">var serviceProvider = new ServiceCollection()
@@ -289,7 +289,7 @@ <h5>Important</h5>
     .BuildServiceProvider();
 </code></pre>
 <h3 id="logger-usage">Logger usage</h3>
-<p>You don't use the loggers directly any more. Instead, you just create a constructor parameter with a type of <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> or <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger-1">ILogger</a>.</p>
+<p>You don't use the loggers directly any more. Instead, you just create a constructor parameter with a type of <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> or <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger-1">ILogger</a>.</p>
 <pre><code class="lang-cs">public class MyMigration : ForwardOnlyMigration {
     private readonly ILogger&lt;MyMigration&gt; _logger;
 
@@ -306,7 +306,7 @@ <h3 id="other-loggers">Other loggers</h3>
 <p>There are several other loggers, like:</p>
 <ul>
 <li><a href="xref:FluentMigrator.Runner.Logging.LogFileFluentMigratorLoggerProvider">LogFileFluentMigratorLoggerProvider</a> for logging SQL statements into a file</li>
-<li><a href="xref:FluentMigrator.Runner.Logging.SqlScriptFluentMigratorLoggerProvider">SqlScriptFluentMigratorLoggerProvider</a> for logging SQL statements into a <a class="xref" href="https://docs.microsoft.com/dotnet/api/system.io.textwriter">TextWriter</a></li>
+<li><a href="xref:FluentMigrator.Runner.Logging.SqlScriptFluentMigratorLoggerProvider">SqlScriptFluentMigratorLoggerProvider</a> for logging SQL statements into a <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.io.textwriter">TextWriter</a></li>
 </ul>
 <h4 id="registration-of-logfilefluentmigratorloggerprovider">Registration of <a href="xref:FluentMigrator.Runner.Logging.LogFileFluentMigratorLoggerProvider">LogFileFluentMigratorLoggerProvider</a></h4>
 <pre><code class="lang-cs">var serviceProvider = new ServiceCollection()
@@ -357,8 +357,8 @@ <h3 id="properties-moved-into-appconfigconnectionstringaccessoroptions">Properti
 <div class="WARNING">
 <h5>Warning</h5>
 <p>This class only works under the full .NET Framework and is marked as obsolete!
-Provide access to an <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration">IConfiguration</a> service.
-The FluentMigrator library will use it to call the <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.configuration.configurationextensions.getconnectionstring#microsoft-extensions-configuration-configurationextensions-getconnectionstring(microsoft-extensions-configuration-iconfiguration-system-string)">GetConnectionString</a> extension method.</p>
+Provide access to an <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration">IConfiguration</a> service.
+The FluentMigrator library will use it to call the <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.configurationextensions.getconnectionstring#microsoft-extensions-configuration-configurationextensions-getconnectionstring(microsoft-extensions-configuration-iconfiguration-system-string)">GetConnectionString</a> extension method.</p>
 </div>
 <ul>
 <li><a href="xref:FluentMigrator.Runner.Initialization.NetFramework.AppConfigConnectionStringAccessorOptions.ConnectionStringConfigPath">ConnectionStringPath ➔ ConnectionStringConfigPath</a></li>
@@ -373,7 +373,7 @@ <h3 id="properties-moved-into-assemblysourceoptions">Properties moved into <a hr
 </ul>
 <h3 id="properties-with-no-direct-replacement">Properties with no direct replacement</h3>
 <ul>
-<li><code>Announcer</code>: Get your <a class="xref" href="https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> with dependency injection instead</li>
+<li><code>Announcer</code>: Get your <a class="xref" href="https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger">ILogger</a> with dependency injection instead</li>
 <li><code>StopWatch</code>: Get your <a href="xref:FluentMigrator.Runner.IStopWatch">IStopWatch</a> with dependency injection instead</li>
 </ul>
 <h3 id="workingdirectory">WorkingDirectory</h3>