Conexão ao Google BigQuery
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
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
- No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
- 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.
- 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:
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. | |
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.
|
|
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.