Ajuda para criação na Web e Tableau Desktop

Este artigo descreve como conectar o Tableau aos dados do Google BigQuery e como configurar a fonte de dados.

Observação: alguns dos recursos e personalizações listados neste artigo não são compatíveis com o Tableau Prep Builder. Para obter mais informações sobre a conexão aos dados no Prep Builder, consulte Conectar aos dados(O link abre em nova janela).

Antes de começar

Antes de começar, colete estas informações de conexão:

• E-mail ou telefone e senha do Google BigQuery

Recomendação

Configurar um cliente OAuth personalizado para usar as políticas de TI da sua empresa

Você pode controlar totalmente sua configuração OAuth de acordo com suas próprias políticas de TI com um cliente OAuth personalizado. A opção de usar seu próprio cliente OAuth faz com que você não fique preso aos ciclos de lançamento do Tableau e à agenda de rotação do cliente OAuth do Tableau. Para obter informações sobre como configurar seu próprio cliente OAuth, consulte Configurar OAuth personalizado para um site.

Fazer a conexão e configurar a fonte de dados

Observação: para usar credenciais de conta de serviço para uma nova fonte de dados do Google BigQuery, a conexão deve ser criada no Tableau Desktop.

1. Inicie o Tableau e em Conectar, selecione Google BigQuery.

   Conclua uma das seguintes duas opções para continuar.

    

   Opção 1:

   1. Em Autenticação, selecione Entrar usando OAuth.
   2. Clique em Fazer logon.
   3. Digite sua senha para continuar.
   4. Selecione Aceitar para permitir que o Tableau possa acessar os dados do Google BigQuery. Você será solicitado a fechar o navegador.

   

    

    

   Opção 2:

   Dica: se estiver usando o Tableau Server ou o Tableau Cloud para publicação, você deve começar fazendo login no produto que está usando e, em seguida, adicionar suas credenciais salvas do Google BigQuery nas configurações da conta. Isso evita um "erro de credenciais inválidas".

   1. Em Autenticação, selecione Entrar usando o arquivo de conta de serviço (JSON).
   2. Digite o caminho do arquivo ou use o botão Procurar para procurá-lo.
   3. Clique em Fazer logon.
   4. Digite sua senha para continuar.
   5. Selecione Aceitar para permitir que o Tableau possa acessar os dados do Google BigQuery. Você será solicitado a fechar o navegador.



 

2. Na página da fonte de dados, faça o seguinte:

   1. (Opcional) Selecione o nome da fonte de dados padrão na parte superior da página e, em seguida, insira um nome de fonte de dados exclusivo para uso no Tableau. Por exemplo, use uma convenção de nomeação de fonte de dados que ajude os outros usuários da fonte de dados a deduzir a qual fonte de dados devem se conectar.

   2. (Opcional) Na lista suspensa Projeto de faturamento, selecione um projeto de faturamento. Se você não selecionar um projeto de faturamento, EmptyProject aparecerá no campo logo após a seleção dos campos restantes.

   3. Na lista suspensa Projeto, selecione um projeto. Como alternativa, selecione publicdata para conectar aos dados de amostra no BigQuery.

   4. Na lista suspensa Conjunto de dados, selecione um conjunto de dados.

   5. Em Tabela, selecione uma tabela.

      Use SQL personalizado para se conectar a uma consulta específica em vez de à fonte de dados inteira. Para obter mais informações, consulte Conectar a uma consulta de SQL personalizado.

Observações:
- Google BigQuery alterou o suporte do SQL (BQL) antigo do BigQuery para o SQL padrão. As suas pastas de trabalho serão atualizadas para o suporte do SQL padrão ao abri-las no Tableau.
- Devido ao grande volume de dados no BigQuery, o Tableau recomenda a conexão dinâmica.
- A função Radians() não é aceita no Google BigQuery.

Usar atributos de personalização para melhorar o desempenho da consulta

Observação: os atributos de personalização não são suportados no momento no Tableau Prep Builder.

Os atributos de personalizaçãopodem ser usados para melhorar o desempenho de grandes conjuntos de resultados retornados do BigQuery ao Tableau Cloud, Tableau Server e no Tableau Desktop.

É possível incluir os atributos de personalização na sua pasta de trabalho ou fonte de dados publicada, desde que especifique-os antes de publicar a pasta de trabalho ou a fonte de dados no Tableau Cloud ou Tableau Server.

Usar os atributos de personalização do Google BigQuery

Os atributos de personalização aceitam valores integrados e afetam as consultas em tempo real e atualizações de extração para a conexão especificada.

Os atributos a seguir ajudam a maioria a aumentar o desempenho de grandes conjuntos de resultados:

Os atributos a seguir também estão disponíveis e são usados para pequenas consultas:

Esta configuração de recursos aceita os valores sim ou não e pode ser útil ao testar:

Como o Tableau retorna as linhas do Google BigQuery

O Tableau usa duas abordagens para retornar as linhas do BigQuery: a abordagem não spool padrão ou a de tabela temporária (spool):

• Na primeira tentativa, as consultas são executadas usando a consulta padrão, sem spool, que usa a configuração bq-fetch-rows.

• Se o conjunto de resultados for muito grande, a API do BigQuery retorna um erro e o conector do BigQuery do Tableau tenta novamente a consulta ao salvar os resultados em uma tabela temporária do BigQuery. Em seguida, o conector do BigQuery lê a tabela temporária, que é um trabalho de spool usando a configuração bq-large-fetch-rows.

Como especificar os atributos

Há duas formas de especificar atributos: em um arquivo de personalização de fonte de dados do Tableau .tdc ou no XML das pastas de trabalho ou das fontes de dados.

Como especificar atributos de um arquivo .tdc

Para especificar os atributos de personalização durante uma operação de publicação de pasta de trabalho ou de fonte de dados do Tableau Desktop, siga essas etapas:

1. Crie um arquivo XML que contenha os atributos de personalização.

2. Salve o arquivo com uma extensão ..tdc ; por exemplo, BigQueryCustomization.tdc.

3. Salve o arquivo na pasta My Tableau Repository\Datasources.

Os atributos de personalização dos arquivos .tdc são lidos e incluídos pelo Tableau Desktop quando a fonte de dados ou a pasta de trabalho for publicada no Tableau Cloud ou no Tableau Server.

Importante: os arquivos TDC podem ser utilizados para personalizar a funcionalidade de uma conexão ou para diagnosticar e resolver problemas relacionados à conexão com seus dados. O Tableau não consegue testar exaustivamente todas as possíveis modificações que você pode fazer com esses arquivos. Criar e usar arquivos TDC requer edição manual e é crucial testá-los completamente antes de implantá-los em um ambiente de produção.

Exemplo de um arquivo .tdc com configurações recomendadas para grandes extrações

<connection-customization class='bigquery' enabled='true' version='8.0' >

  <vendor name='bigquery' />

  <driver name='bigquery' />

  <customizations>

    <customization name='bq-fetch-tasks' value='10' />

    <customization name='bq-large-fetch-rows' value='10000' />

  </customizations>

</connection-customization>

Inserção manual de atributos no arquivo XML da pasta de trabalho ou da fonte de dados

Os atributos de personalização podem ser inseridos manualmente dentro da marca "connection" do arquivo workbook.twb da pasta de trabalho ou do arquivo .tds da fonte de dados. Os atributos de personalização do BigQuery estão em negrito no exemplo a seguir, para facilitar a visualização.

Exemplo de atributos manualmente inseridos

<connection CATALOG='publicdata' EXECCATALOG='some-project-123' REDIRECT_URI='some-url:2.0:oob' SCOPE='https://www.googleapis.com/auth/bigquery https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email' authentication='yes' bq-fetch-tasks='10' bq-large-fetch-rows='10000'bq_schema='samples' class='bigquery' connection-dialect='google-bql' connection-protocol='native-api' login_title='Sign in to Google BigQuery' odbc-connect-string-extras='' project='publicdata' schema='samples' server='googleapis.com/bigquery' server-oauth='' table='wikipedia' username=''>

Verificar se a pasta de trabalho usa SQL padrão ou SQL legado

Em 2016, o Google atualizou os APIs do BigQuery para suportarem um SQL padrão e continuarem o suporte do SQL BigQuery (agora chamado de SQL legado). Começando pelo Tableau 10.1, o conector do Google BigQuery foi atualizado para suportar o SQL padrão e manter o suporte para o SQL legado. O SQL padrão permite que os usuários do conector BigQuery usem expressões de nível de detalhe, consigam uma validação de metadados mais rápida e selecionem um projeto de faturamento com a conexão.

Agora, por padrão, ao criar uma pasta de trabalho, o Tableau suporta o SQL padrão. O Tableau também suporta SQL legado com a opção Usar SQL legado no painel de Dados. Por exemplo, ao abrir uma pasta de trabalho criada com uma versão anterior do Tableau Desktop, e se sua pasta de trabalho usa o SQL legado, a opção Usar SQL legado estará selecionada.

Motivos para configurar a opção Usar SQL legado:

• Você tem uma pasta de trabalho existente que deseja atualizar para usar o SQL legado de forma a escrever expressões de nível de detalhe ou usufruir de outros aprimoramentos. Nesse caso, certifique-se de que a opção Usar SQL legado não está selecionada.

• Você está criando uma pasta de trabalho que precisa se conectar a uma exibição do SQL legado. Você não pode mesclar SQL legado com SQL padrão, então precisa selecionar a opção Usar SQL legado para que a pasta de trabalho funcione.

No Google BigQuery, as exibições são escritas em SQL padrão ou legado. Você pode juntar as exibições em SQL padrão a exibições em SQL legado, ou exibições em SQL legado a outras em SQL legado, e é possível unir as exibições escritas em ambas as versões do SQL à tabela. Entretanto, não é possível realizar a união de exibições escritas em SQL padrão e em SQL legado em uma pasta de trabalho. Ao unir as exibições,é preciso configurar a caixa de seleção Usar SQL legado para que corresponda ao tipo de SQL usado na exibição a qual estiver se conectando.

Observação: o Tableau Desktop oferece suporte limitado para dados aninhados ao usar SQL legado ou padrão. Por exemplo: se a tabela contiver dados aninhados e o SQL legado ou padrão estiver em uso, a opção Atualizar agora, na página da fonte de dados, não funcionará.

Para obter mais informações sobre a migração do SQL legado para o SQL padrão, consulte Migrating from legacy SQL(O link abre em nova janela) (em inglês) no site do Google Cloud Platform.

Use o BigQuery BI Engine para analisar dados

Você pode usar o BigQuery BI Engine para executar serviços de análise rápidos e de baixa latência e análises interativas com relatórios e painéis com suporte do BigQuery. Para obter mais informações, incluindo instruções sobre como integrar o BigQuery BI Engine ao Tableau, consulte Analisar dados do BigQuery usando o BI Engine e o Tableau na documentação do Google.

Solução de problemas do Google BigQuery

Conexão a várias contas

Ao usar a criação na Web ou publicar na Web, não é possível usar várias contas do Google BigQuery na mesma pasta de trabalho. Você pode ter várias conexões de contas do Google BigQuery no Desktop.

Ao publicar fluxos, as credenciais que você usa para se conectar ao Google BigQuery na etapa de Entrada devem corresponder às credenciais definidas na guia Configurações na página Minhas configurações de conta do Google BigQuery em Tableau Server ou Tableau Cloud. Se você selecionar credenciais diferentes ou nenhuma credencial em sua configuração de autenticação ao publicar o fluxo, ocorrerá um erro de autenticação no fluxo, até que você edite a conexão do fluxo no Tableau Server ou Tableau Cloud para corresponder às credenciais.

Criação na Web com o Internet Explorer 11 e o Edge

No Internet Explorer 11 e no Edge, não é possível acessar um servidor usando uma conexão não segura (http). Use uma conexão segura (https) ou altere para outro navegador.

Consulte também

• Configurar fontes de dados – Adicione mais dados a esta fonte de dados ou prepare os dados antes de analisá-los.
• Criar gráficos e analisar dados – Inicie a análise de dados.

• Configurar Oauth para Google(O link abre em nova janela) - Configure conexões Oauth para o Tableau Server.
• Conexões Oauth(O link abre em nova janela) - Configure conexões Oauth para o Tableau Cloud.
• Google BigQuery e Tableau: práticas recomendadas(O link abre em nova janela) - leia o white paper do Tableau (é necessário fazer o registro ou logon)