SQLFluff is configured using a configuration file.

Flyway ships with a default configuration file in the conf/ folder of the Flyway installation called sqlfluff.cfg. In order to turn this into a project policy we recommend putting a copy of this file under version control for your project and directing Flyway where to find this using the rulesConfig parameter

Enabling and Disabling Rules

There are a number of ways to enable and disable rules in the SQLFluff configuration file SQLFluff Rules configuration

The default configuration shipped with Flyway enables only a subset of SQLFluff rules, primarily those that help make your SQL statements clearer, safer, and more consistently styled. It also enables a set of custom rules provided by Redgate by default.

Note that these custom rules are available only in the Redgate-packaged version of SQLFluff.

Redgate also recommends explicitly specifying the rules to enable (using rules) rather than relying on exclude_rules to disable unwanted ones. This approach is safer and helps prevent potential issues if new Redgate custom rules are added in future releases.

[sqlfluff]
rules = ambiguous,convention,structure,RG01,RG02,RG03...

Configuring Rules

Severity

By default, rules are enabled and violations are regarded as errors.

Whether Flyway will fail or not if there is an error is governed by the check.code.failOnError setting

Parameters

Many rules have configurable options that allow you to customize their behavior. For the standard SQLFluff rules you will see these defined in each rule in a section labelled "Configuration"

For the Redgate SQLFluff rules Library you will also find a "Configuration" section for rules where this is applicable.

In order to configure these rules you would edit the SQLFluff configuration file

As an example, if we take the rule: CV09 - Block a list of configurable words from being used. This offers the following configuration parameters blocked_regex, blocked_words and match_source

We could configure the rule to trigger a violation on the use of TODO in the SQL by configuring the it in sqlfluff.cfg like this

[sqlfluff:rules:convention.blocked_words]
blocked_words = TODO

Local violation of policy

Having configured your code analysis policy there may be occasions when you want to override the policy temporarily. There are a number of mechanisms available with varying degrees of granularity.

Pipeline level

This involves adding a manual approval step to your pipeline so if Flyway's check -code operation returns violations then it will require a review and approval step to proceed.

• Run flyway check -code -> If successful, deploy changes
  • else stop for manual review -> if approved, deploy changes
    • else fail pipeline

File level

This involves adding In-File Configuration Directives to the top of your file. For example, if I want to suspend rule AM01 for this file I would add a comment to my SQL like this:

-- noqa: disable=AM01

Which will prevent this rule being checked on the remainder of the file

Section level

This is a more localized change of policy just ignoring a range of lines in the SQL

-- noqa: disable = AL02
SELECT col_a a FROM foo
-- noqa: enable = AL02

line level

This is the most granular change and just ignores violation on an individual line

-- Ignore rule CP02 & rule CP03
SeLeCt  1 from tBl ;    -- noqa: CP02,CP03

Reporting --noqa Tag Usage

{% include enterprise.html %}

Using --noqa tags to suppress SQLFluff code analysis rules introduces risks, as those statements will bypass linting checks.

To help mitigate this, Flyway generates a warning-level violation whenever a --noqa tag is detected.

In the command-line output, you will see something similar to the following:

+--------------------+-----------+------------------+----------+
| Engine             | Rule Code | Violations Count | Severity |
+--------------------+-----------+------------------+----------+
| SQLFluff (Redgate) | RG01      | 1                | Error    |
| SQLFluff (Redgate) | RG02      | 1                | Error    |
| Policy Overrides   | noqa      | 4                | Warning  |
+--------------------+-----------+------------------+----------+