Como usar o Snowflake Connector for Google Looker Studio¶

Métodos de autenticação¶

O Snowflake Connector for Google Looker Studio oferece suporte aos seguintes métodos de autenticação para conexão ao Snowflake:

• Nome de usuário e senha

• Autenticação de pares de chaves

Com o método de autenticação de nome de usuário e senha, os usuários podem autenticar a conexão fornecendo suas credenciais do Snowflake. O método de par de chaves permite uma conexão mais segura usando uma chave privada para autenticação em vez de uma senha. Para saber mais sobre como configurar a autenticação de pares de chaves em um banco de dados Snowflake, consulte Autenticação de par de chaves e rotação de par de chaves.

Ao configurar a chave pública para um usuário no banco de dados Snowflake, certifique-se de atender aos seguintes requisitos:

• A chave não inclui as cadeias de caracteres -----BEGIN PUBLIC KEY----- e -----END PUBLIC KEY-----.

• Todos os caracteres de nova linha são removidos da chave pública. Isso é necessário para autenticação adequada.

Conexão de sua conta Snowflake ao Google Looker Studio¶

1. Entre no Google Looker Studio.

2. Clique em + e selecione Data Source.

3. Na seção Partner Connectors, selecione o conector Snowflake (o conector com o logotipo Snowflake).

4. Se necessário, autorize o Google Looker Studio a usar este conector da comunidade.

5. Digite as seguintes credenciais de usuário do Snowflake para se conectar ao Snowflake:

   • Nome de usuário

   • Senha ou chave privada

6. Clique em Submit.

7. Forneça os seguintes parâmetros necessários para se conectar à sua conta Snowflake:

   • URL da conta

   • Função

   • Warehouse

   • Banco de dados

   • Esquema

   • Consulta SQL

   Nota

   A consulta SQL não pode terminar com um ponto e vírgula.

8. Clique em Connect.

   Uma página contendo campos de fonte de dados é exibida.

9. Clique em Create Report ou Explore para visualizar seus dados.

Mapeamento dos tipos de dados Snowflake para os tipos de dados do Looker Studio¶

O conector mapeia seus tipos de dados do banco de dados Snowflake para um conjunto unificado de tipos de dados como a seguir:

Consulte Tipos de dados para obter mais informações sobre os tipos de dados Snowflake.

Acesso à política de redes¶

As conexões do Google Looker Studio ao Snowflake vêm de servidores efêmeros do Google sem endereços IP fixos. Se sua rede utilizar políticas de rede, talvez seja necessário abrir a política para o usuário do Looker Studio para permitir todos os endereços IP (0.0.0.0/0) ou usar este script shell para obter uma lista de possíveis endereços IP do Google Cloud com sub-redes.

Identificação de consultas de conectores em seu histórico de consultas¶

O Snowflake Connector for Google Looker Studio usa instruções SQL fornecidas pelo usuário como uma instrução SELECT interna para cada consulta gerada em um banco de dados. Portanto, seu histórico de consultas pode conter consultas otimizadas que diferem das consultas inseridas ao configurar uma fonte de dados.

Em seu histórico de consultas, as consultas do conector incluirão esta instrução interna SELECT.

Consultas SQL com suporte¶

Somente as instruções SELECT, SHOW e DESCRIBE SQL são suportadas. O conector oferece suporte apenas à especificação de uma única instrução SQL como consulta; ele não oferece suporte à seleção de tabelas e exibições de uma lista.

Limitações¶

• O conector não oferece suporte ao uso de chaves privadas criptografadas para autenticação de par de chaves.

• Devido ao seu design para comunicação de sistema para sistema, o conector não é compatível com métodos de autenticação interativos, como o MFA com Duo Push.

• O fluxo de login atual oferece suporte apenas a um único login (nome de usuário e senha ou chave privada), que só funciona para contas diferentes se todas as contas usarem o mesmo nome de usuário e senha ou chave privada. O conector não é compatível com o uso de vários logins na mesma conta Snowflake ou em contas diferentes.

• O Google limita o conjunto de dados devolvidos a 1 milhão de linhas e 50 MB de dados. Podem ocorrer erros inesperados ao tentar retornar mais dados.

• Os cabeçalhos das colunas (nomes de campo) devem usar somente caracteres ASCII; caracteres não ASCII não são suportados.

• Relatórios contendo os operadores REGEXP_PARTIAL_MATCH e REGEXP_EXACT_MATCH não são otimizados por filtros pushdown porque o Snowflake e o Google Looker Studio oferecem suporte a diferentes tipos de regexp.

• Filtros pushdown não são suportados para as instruções SHOW e DESCRIBE e para as colunas DATE, TIME e TIMESTAMP.