Skip to content

render

Render SQL files and just spit out the result.

PATH is the path to a sql file. This should be either a single file file (path/to/file.sql) or a single (-) character to indicate reading from stdin.

Usage

bash
sqlfluff render [OPTIONS] path

Arguments

ArgumentDescription
path

Options

OptionTypeDefaultDescription
-n, --nocolorBooleanNo color - output will be without ANSI color codes.
-v, --verboseIntegerVerbosity, how detailed should the output be. This is stackable, so -vv is more verbose than -v. For the most verbose option try -vvvv or -vvvvv.
--versionBooleanfalseShow the version and exit.
--stdin-filenamePathWhen using stdin as an input, load the configuration as if the contents of stdin was in a file in the listed location. This is useful for some editors that pass file contents from the editor that might not match the content on disk.
--library-pathStringOverride the library_path value from the [sqlfluff:templater:jinja] configuration value. Set this to none to disable entirely. This overrides any values set by users in configuration files or inline directives.
--disable-noqa-exceptStringIgnore all but the listed rules inline noqa comments.
--disable-noqaBooleanSet this flag to ignore inline noqa comments.
--loggerChoice (6 options)Sentinel.UNSETChoose to limit the logging to one of the loggers.
--benchBooleanfalseSet this flag to engage the benchmarking tool output.
-i, --ignoreStringIgnore particular families of errors so that they dont cause a failed run. For example --ignore parsing would mean that any parsing errors are ignored and dont influence the success or fail of a run. --ignore behaves somewhat like noqa comments, except it applies globally. Multiple options are possible if comma separated: e.g. --ignore parsing,templating.
--encodingStringSpecify encoding to use when reading and writing files. Defaults to autodetect.
--ignore-local-configBooleanfalseIgnore config files in default search path locations. This option allows the user to lint with the default config or can be used in conjunction with --config to only reference the custom config file.
--configPathInclude additional config file. By default the config is generated from the standard configuration files described in the documentation. This argument allows you to specify an additional configuration file that overrides the standard configuration files. N.B. cfg format is required.
-e, --exclude-rulesStringExclude specific rules. For example specifying --exclude-rules LT01 will remove rule LT01 (Unnecessary trailing whitespace) from the set of considered rules. This could either be the allowlist, or the general set if there is no specific allowlist. Multiple rules can be specified with commas e.g. --exclude-rules LT01,LT02 will exclude violations of rule LT01 and rule LT02.
-r, --rulesStringNarrow the search to only specific rules. For example specifying --rules LT01 will only search for rule LT01 (Unnecessary trailing whitespace). Multiple rules can be specified with commas e.g. --rules LT01,LT02 will specify only looking for violations of rule LT01 and rule LT02.
-t, --templaterChoice: raw, jinja, python, placeholderThe templater to use (default=jinja)
-d, --dialectStringThe dialect of SQL to lint

Released under the MIT License.