Esta página se refere ao parâmetro
sql_table_name, que faz parte de uma análise detalhada.
sql_table_nametambém pode ser usado como parte de uma visualização, conforme descrito na página de documentação do parâmetrosql_table_name(para visualizações).
sql_table_nametambém pode ser usado como parte de uma junção, conforme descrito na página de documentação do parâmetrosql_table_name(para junções).
Uso
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
Valor padrão
A tabela de banco de dados em que a visualização da Análise própria se baseia.
Aceita
O nome de uma tabela de banco de dados
Regras especiais
|
Definição
sql_table_name define a tabela no banco de dados que será consultada pela Análise detalhada. Normalmente, a visualização para a qual uma análise detalhada é nomeada define a tabela que será consultada. No entanto, em 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 qual dessas tabelas deve ser usada.
Nomes de tabelas de escopo
Quando você faz referência a uma tabela usando apenas o nome dela, o Looker usa o caminho de pesquisa padrão (o banco de dados e o esquema) que o administrador do Looker configurou nas definições da conexão com o banco de dados. Consulte a seção O que considerar desta página para mais informações.
Se você precisar fazer referência a uma tabela em um banco de dados e esquema diferente que não esteja no caminho de pesquisa padrão do usuário do banco de dados, poderá definir o escopo do nome da tabela usando o formato <database_name>.<schema_name>.<table_name> para apontar para outro banco de dados ou esquema:
- Para referenciar uma tabela de um esquema diferente, use
<schema_name>.<table_name>, conforme mostrado no exemplo nesta página. - Para referenciar uma tabela de um banco de dados diferente, use o
<database_name>.<schema_name>.<table_name>completo.
Para uma conexão do Google BigQuery, você pode referenciar uma tabela em um projeto e conjunto de dados diferentes ao definir o escopo do nome da tabela usando o formato <project_name>.<dataset_name>.<table_name>. Consulte a página de documentação Conexão do Google BigQuery para mais informações.
Exemplos
Este exemplo faz com que a análise detalhada customers dependa da tabela customer_1 do banco de dados/esquema padrão:
explore: customers {
sql_table_name: customer_1 ;;
}
Este exemplo faz com que a análise detalhada customers dependa da tabela customer_1 do esquema analytics ao definir o escopo do nome da tabela para incluir o nome do esquema (usando o formato <schema_name>.<table_name>):
explore: customers {
sql_table_name: analytics.customer_1 ;;
}
Informações importantes
As tabelas referenciadas por sql_table_name precisam estar acessíveis na conexão atual.
Quando o parâmetro sql_table_name é usado em um objeto explore, esse objeto explore é incluído em um objeto model. A hierarquia nesta página mostra essa cadeia de relacionamento. O objeto do modelo tem um connection de banco de dados definido nele. Quando você faz referência a uma tabela de banco de dados no parâmetro sql_table_name, ela precisa estar acessível na conexão associada especificada no arquivo de modelo.
O banco de dados e o esquema padrão (ou, no caso do Google BigQuery, o projeto de faturamento e o conjunto de dados) são definidos pelo administrador do Looker ao criar a conexão do Looker com seu banco de dados.
Para nomear uma view de maneira diferente da tabela subjacente, aplique sql_table_name no nível da view.
Usar sql_table_name no nível explore, conforme 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 view quando você quer nomear uma visualização de forma diferente do nome da tabela subjacente.
Em outras palavras, em vez de:
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 ;;
}