This page refers to the
case_sensitiveparameter that is part of a dimension or filter.
case_sensitivecan also be used as part of a model, described on thecase_sensitive(for models) parameter documentation page.
case_sensitivecan 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
}
}
|
Hierarchy
case_sensitive |
Possible Field Types
Dimension, Filter
Accepts
A Boolean (yes or 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 |
| 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 | 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 2+ | Yes |
| SingleStore | No |
| SingleStore 7+ | No |
| Snowflake | Yes |
| Teradata | Yes |
| Trino | Yes |
| Vector | Yes |
| Vertica | Yes |