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
O parâmetro sql_table_name especifica a tabela no banco de dados que será consultada pela Análise. 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, é possível usar o parâmetro sql_table_name no parâmetro explore para substituir a tabela de base especificada no arquivo de visualização. Dessa forma, você pode usar as dimensões e métricas definidas no arquivo de visualização e aplicá-las a tabelas de banco de dados diferentes da especificada no arquivo de visualização.
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 do 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, use 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 fazer referência a 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 com 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
Neste exemplo, a análise detalhada customers depende 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 do modelo.
O banco de dados e o esquema padrão (ou, para o 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 ;;
}