sql_table_name (para o Explores)

Esta página se refere ao parâmetro sql_table_name que faz parte de um Explorar.

sql_table_name também pode ser usado como parte de uma visualização, descrita na página de documentação de parâmetro sql_table_name (para visualizações).

O sql_table_name também pode ser usado como parte de uma mesclagem, descrita na página de documentação do parâmetro sql_table_name (para mesclagens).

Uso

explore: explore_name {
sql_table_name: table_name ;;
}
Hierarquia
sql_table_name
Valor padrão
A tabela do banco de dados em que a visualização do Explore está baseada

Aceita
O nome de uma tabela de banco de dados

Regras especiais
  • sql_table_name só deve ser usado quando a mesma visualização pode descrever várias tabelas
  • Qualquer tabela referenciada por sql_table_name precisa ser acessível na conexão de banco de dados do modelo

Definição

sql_table_name define a tabela no banco de dados que será consultada pelo Explorar. Normalmente, a visualização que recebe o nome de "Explorar" define a tabela que vai ser consultada. No entanto, nos casos em que várias tabelas têm a mesma estrutura, a mesma visualização pode ser usada para descrever todas elas. sql_table_name permite especificar quais dessas tabelas serão usadas.

Se você precisar referenciar uma tabela de um banco de dados/esquema diferente, use database_or_schema_name.table_name. Se você não gravar explicitamente um banco de dados/esquema, o Looker usará o padrão definido. O padrão é configurado na seção "Administrador" do Looker em Conexões.

Examples

Faça com que customers explore depender da tabela customer_1 do banco de dados/esquema padrão:

explore: customers {
  sql_table_name: customer_1 ;;
}

Faça o customers analisar a tabela customer_1 do banco de dados/esquema analytics:

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

Desafios comuns

As tabelas referenciadas por sql_table_name precisam ser acessíveis pela conexão atual

sql_table_name faz parte de um recurso Explorar, que, por sua vez, faz parte de um modelo. O modelo terá uma conexão de banco de dados definida. Qualquer tabela referenciada em sql_table_name precisa ser acessível nessa conexão de banco de dados.

Informações úteis

Para nomear uma view de maneira diferente da tabela, aplique sql_table_name no nível da view.

Usar sql_table_name no nível do explore, como descrito nesta página, não é muito comum. Ele só deve ser usado quando o mesmo view pode descrever várias tabelas.

O método mais comum é usar sql_table_name no nível do view quando você quiser nomear uma visualização de maneira diferente do nome da tabela.

Em outras palavras, em vez disso:

Arquivo de modelo

explore: customers {
  sql_table_name: customer_1 ;;
}

Faça o seguinte:

Arquivo de modelo

explore: customers { ... }

Ver arquivo

view: customers {
  sql_table_name: customer_1 ;;
}