This page refers to the
case_sensitive
parameter that is part of a dimension or filter .
case_sensitive
can also be used as part of a model, described on thecase_sensitive
(for models) parameter documentation page.
case_sensitive
can also be used as part of an Explore, described on thecase_sensitive
(for Explores) parameter documentation page.
Usage
view: view_name { dimension: field_name { case_sensitive : no } }
Definition
When a dimension
or filter
field is used as a filter, you can change its case-sensitivity by using the case_sensitive
parameter. The case_sensitive
parameter works with most dialects, although some dialects do not have the necessary SQL functions.
By default, case_sensitivity
is on and filters are case-sensitive. However, some dialects do not support this parameter, as described in the case_sensitive
is not supported by some SQL dialects
section on this page.
Examples
Stop filters on the name
dimension from being case-sensitive:
dimension: name {
sql: ${TABLE}.name ;;
case_sensitive: no
}
Common challenges
case_sensitive
is not supported by some SQL dialects
By default, case_sensitivity
is on and filters are case-sensitive. If your SQL dialect doesn't support the case_sensitive
parameter, case sensitivity will vary according to your database setup, which will usually
not be case-sensitive.
For Looker to support case_sensitive
in your Looker project, your database dialect must also support it. The following table shows which dialects support case_sensitive
in the latest release of Looker:
Dialect | Supported? |
---|---|
Actian Avalanche | Yes
|
Amazon Athena | Yes
|
Amazon Aurora MySQL | No
|
Amazon Redshift | Yes
|
Amazon Redshift 2.1+ | Yes
|
Amazon Redshift Serverless 2.1+ | Yes
|
Apache Druid | Yes
|
Apache Druid 0.13+ | Yes
|
Apache Druid 0.18+ | Yes
|
Apache Hive 2.3+ | Yes
|
Apache Hive 3.1.2+ | Yes
|
Apache Spark 3+ | Yes
|
ClickHouse | Yes
|
Cloudera Impala 3.1+ | Yes
|
Cloudera Impala 3.1+ with Native Driver | Yes
|
Cloudera Impala with Native Driver | Yes
|
DataVirtuality | Yes
|
Databricks | Yes
|
Denodo 7 | Yes
|
Denodo 8 & 9 | Yes
|
Dremio | Yes
|
Dremio 11+ | Yes
|
Exasol | Yes
|
Firebolt | Yes
|
Google BigQuery Legacy SQL | Yes
|
Google BigQuery Standard SQL | Yes
|
Google Cloud PostgreSQL | Yes
|
Google Cloud SQL | No
|
Google Spanner | Yes
|
Greenplum | Yes
|
HyperSQL | No
|
IBM Netezza | Yes
|
MariaDB | No
|
Microsoft Azure PostgreSQL | Yes
|
Microsoft Azure SQL Database | No
|
Microsoft Azure Synapse Analytics | No
|
Microsoft SQL Server 2008+ | No
|
Microsoft SQL Server 2012+ | No
|
Microsoft SQL Server 2016 | No
|
Microsoft SQL Server 2017+ | No
|
MongoBI | Yes
|
MySQL | No
|
MySQL 8.0.12+ | No
|
Oracle | Yes
|
Oracle ADWC | Yes
|
PostgreSQL 9.5+ | Yes
|
PostgreSQL pre-9.5 | Yes
|
PrestoDB | Yes
|
PrestoSQL | Yes
|
SAP HANA | Yes
|
SAP HANA 2+ | Yes
|
SingleStore | No
|
SingleStore 7+ | No
|
Snowflake | Yes
|
Teradata | Yes
|
Trino | Yes
|
Vector | Yes
|
Vertica | Yes
|