Conexão ao Google BigQuery

Esta versão do conector de dados do Google BigQuery será descontinuada após o Analytics 17.x.
Faça o teste e mude para a nova versão do conector agora para manter a conexão ao Google BigQuery no Analytics 18. (Lançamento provisório no segundo semestre de 2024)
Ver Mudança para uma nova versão do conector do ACL

Concept Information

Comando ACCESSDATA

O Google BigQuery é um serviço de dados na nuvem. Você pode usar o conector de dados do Google BigQuery para importar dados da sua organização residentes no BigQuery.

Nota

O Analytics oferece o Google BigQuery como um conector opcional. Se esse conector não estiver disponível na janela Acesso a dados, é provável que o coletor não tenha sido selecionado durante a instalação. Para obter mais informações, consulte Instale opcionalmente os conectores de dados do Analytics e o mecanismo do Python.

Antes de começar

Para conectar-se ao Google BigQuery, você deve obter:

  • detalhes de autenticação
  • catálogo

Para obter ajuda na coleta dos pré-requisitos de conexão, entre em contato com o administrador do Google BigQuery na sua organização. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte da Google BigQuery.

Criar uma conexão ao BigQuery

  1. No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
  2. Na guia novas conexões, na seção Conectores do ACL, selecione Google BigQuery.

    Dica

    Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.

  3. No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.

    Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.

A conexão do Google BigQuery é salva na guia Conexões existentes. No futuro, você poderá reconectar o Google BigQuery usando a conexão salva.

Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do Google BigQuery, consulte Trabalho com a Janela de Acesso a Dados.

Configurações de conexão

Configurações básicas

Configuração Descrição Exemplo
Mecanismo de OAuth

Especifica o mecanismo de autenticação para autenticar o driver:

  • Autenticação do usuário - O driver se autentica como um usuário por meio da conta de usuário do Google.
  • Autenticação do serviço - O driver se autentica como um serviço por meio da conta de serviço do Google.

Ao usar Autenticação do usuário, clique em Login para acessar a página de login do Google.

Autenticação do usuário
Código de confirmação O código obtido do Google para gerar um token de atualização.  
Token de atualização O token de atualização obtido do Google para autorizar o acesso ao BigQuery. O token de atualização é gerado automaticamente depois que você informa o código de confirmação.  
E-mail Ao usar a Autenticação do serviço, informe o ID de e-mail da conta de serviço.  
Caminho do arquivo de chave Ao configurar a Autenticação do serviço, defina esta opção como o caminho completo para o arquivo de chave .p12 ou .json usado para autenticar o endereço de e-mail da conta de serviço.  
Catálogo (projeto) O nome do seu projeto do Google BigQuery.  

Configurações avançadas

Configuração Descrição Exemplo
Host do proxy O nome do host ou o endereço IP de um proxy pelo qual o tráfego HTTP será roteado. O driver pode usar os tipos de autenticação HTTP, Windows (NTLM) ou Kerberos para autenticar em um proxy HTTP.  
Porta do proxy

A porta TCP onde o servidor de proxy é executado.

O valor padrão é 80.

80
Nome do usuário do proxy

Um nome de usuário usado para autenticação no servidor proxy.

 
Senha do proxy Uma senha usada para autenticação no servidor proxy.  
Máximo de solicitações por segundo (0=ilimitado)

Informe o número máximo de solicitações que podem ser feitas por segundo.

Para permitir um número ilimitado de solicitações por segundo, sem controle de fluxo, digite 0.

0
Linhas por bloco O número máximo de linhas que o driver deve recuperar para cada solicitação de dados. 16384
Comprimento padrão da coluna de cadeia O número máximo de caracteres que pode estar contido em colunas STRING. 65536
Nome do conjunto de dados para conjuntos de resultados grandes

O ID do conjunto de dados do BigQuery a ser usado para armazenar tabelas temporárias de grandes conjuntos de resultados.

Somente especifique um valor para esta opção se quiser habilitar o suporte para grandes conjuntos de resultados.

Este campo somente será habilitado se você selecionar a opção Permitir conjuntos de resultados grandes.

_odbc_temp_tables
Expiração da tabela temporária (ms) Tempo (em segundos) até que a tabela temporária expire. Para que uma tabela temporária nunca expire, especifique o valor 0. 3600000
Dialeto do idioma

Especifica se o driver executa consultas usando a sintaxe SQL padrão ou a sintaxe BigQuery SQL legada.

  • Habilitado - Sintaxe SQL padrão
  • Desabilitado - Sintaxe BigQuery SQL legada
 
Ativar metadados de SQLPrepare com Legacy SQL (mais lento) Especifica se o dialeto SQL legado do BigQuery deve ser usado nesta consulta.  
Permitir conjuntos de resultados grandes Especifica se resultados maiores que 128 MB devem ser consultados ao usar o SQL legado.  

Atualizações de conector de dados

Quando atualiza o Analytics ou o Agente do Robôs, você deve testar todos os scripts que importam dados usando um dos conectores de dados do Analytics (comando ACCESSDATA).

É possível que alterações feitas por fornecedores externos de fontes de dados ou drivers ODBC exigiram atualizações em um ou mais conectores de dados. Pode ser necessário atualizar as conexões de dados com script para que continuem a funcionar corretamente.

  • Execute novamente a importação A maneira mais fácil de atualizar uma conexão é executar manualmente uma importação usando a janela Acesso a Dados na versão atualizada do Analytics. Copie o comando ACCESSDATA do log e use-o para atualizar o script.

    Nota

    Antes de se conectar a uma fonte de dados e executar novamente a importação, limpe o cache do conector para remover o conjunto existente de nomes de tabelas.

    Na guia Conexões existentes na janela Acesso a Dados, ao lado do nome do conector, selecione > Limpar cache.

  • Atualize as especificações de campos Também pode ser necessário atualizar as especificações de campos no corpo do script para compatibilizá-lo com as alterações do esquema da tabela na fonte de dados ou no driver ODBC. As possíveis alterações incluem nomes de campos, tipos de dados de campos e comprimentos de campos e registro.
  • Verifique os resultados de todas as filtragens Você também deve verificar os resultados de qualquer filtragem aplicada durante a importação de dados. Confirme se a filtragem de importação está incluindo e excluindo corretamente os registros.