case_sensitive (para análises)

Esta página se refere ao parâmetro case_sensitive, que faz parte de uma análise detalhada.

case_sensitive também pode ser usado como parte de um modelo, descrito na página de documentação do parâmetro case_sensitive (para modelos).

case_sensitive também pode ser usado como parte de uma dimensão, conforme descrito na página de documentação do parâmetro case_sensitive (para campos).

Uso

explore: explore_name {
  case_sensitive: yes
}
Hierarquia
case_sensitive
Valor padrão
yes, se o dialeto do banco de dados for compatível com o parâmetro

Aceita
Um booleano (yes ou no)

Definição

case_sensitive determina se os filtros vão diferenciar maiúsculas e minúsculas em uma determinada Análise. Todos os filtros relacionados à análise detalhada são afetados, incluindo aqueles adicionados na interface da análise detalhada, na interface do painel e no parâmetro filters.

Por padrão, a opção case_sensitivity fica ativada e os filtros diferenciam maiúsculas de minúsculas. No entanto, alguns dialetos não oferecem suporte a esse parâmetro, conforme descrito na seção case_sensitive não é compatível com alguns dialetos SQL desta página.

O case_sensitive funciona ajustando a cláusula WHERE do SQL gerado pelo Looker. Quando case_sensitive está ativado, os filtros são expressos com = ou LIKE, como:

WHERE name = 'bob'
WHERE name LIKE '%bob%'

Quando case_sensitive está desativado, os filtros são expressos com ILIKE (ou equivalente), como:

WHERE name ILIKE 'bob'

Exemplos

Deixe todos os filtros sensíveis a maiúsculas e minúsculas na análise detalhada de Produto:

explore: product {
  case_sensitive: yes
}

Faça com que todos os filtros não diferenciem maiúsculas de minúsculas na Análise Cliente:

explore: customer {
  case_sensitive: no
}

Desafios comuns

case_sensitive não é compatível com alguns dialetos SQL

Por padrão, a opção case_sensitivity fica ativada e os filtros diferenciam maiúsculas de minúsculas. Se o dialeto SQL não for compatível com o parâmetro case_sensitive, a sensibilidade a maiúsculas e minúsculas vai variar de acordo com a configuração do banco de dados, que geralmente não é sensível a maiúsculas e minúsculas.

Para que o Looker ofereça suporte a case_sensitive no seu projeto, o dialeto do banco de dados também precisa oferecer. A tabela a seguir mostra quais dialetos são compatíveis com o case_sensitive na versão mais recente do Looker:

Dialeto Compatível?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13+
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

Informações importantes

É possível criar uma pesquisa com diferenciação de maiúsculas e minúsculas no MySQL

É possível criar uma pesquisa sensível a maiúsculas e minúsculas no MySQL, mesmo que ele não seja compatível com o parâmetro case_sensitive. No MySQL, alguns tipos de dados, chamados de strings binárias, armazenam texto como uma série de números. O uso de maiúsculas e minúsculas no texto faz diferença nos números usados. Portanto, se você converter o texto em uma string binária, poderá fazer pesquisas sensíveis a maiúsculas e minúsculas. Exemplo:

dimension: will_NOT_be_case_sensitive {
  sql: ${TABLE}.something ;;
}

dimension: will_be_case_sensitive {
  sql: CAST(${TABLE}.something AS BINARY) ;;
}