Snowflake

Aplica-se a: Tableau Cloud, Tableau Desktop, Tableau Prep, Tableau Server

Este artigo descreve como conectar o Tableau a um data warehouse do Snowflake e configurar a fonte de dados.

Antes de começar

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

  • Nome do servidor ao qual deseja se conectar
  • Método de autenticação:
    • OAuth: use este método se quiser habilitar a federação de um IDP.
    • SAML IDP: use este método se quiser incorporar as credenciais do IDP na conexão.
    • Nome de usuário e senha: use este método se quiser armazenar credenciais de usuário no Snowflake.
  • As credenciais de logon dependem do método de autenticação escolhido
  • (Opcional) Instrução SQL inicial para ser executada sempre que o Tableau se conecta

Driver necessário

Este conector exige um driver para se comunicar com o banco de dados. Você talvez já tenha esse driver instalado no computador. Se o driver não estiver instalado no computador, o Tableau exibirá uma mensagem na caixa de diálogo de conexão com um link para a página Download do driver(O link abre em nova janela), na qual é possível encontrar links para o driver e instruções de instalação.

Observação: para aceitar o uso do OAuth com Snowflake, você deve instalar um driver de ODBC do Snowflake com versão 2.25.4 ou posterior.

Fazer a conexão e configurar a fonte de dados

Depois de selecionar Snowflake como conexão, um menu POPUP é exibido com 3 guias. Use a guia Geral para autenticação. Selecione SQL inicial se quiser executar um comando de SQL no início de cada conexão. Para obter mais informações, consulte Executar o SQL inicial. Você pode usar a guia Avançado para adicionar conexões de clientes com parâmetros.

Conectar o Tableau a seus dados

  1. Inicie o Tableau e, em Conectar, selecione Snowflake.
  2. Insira o nome do servidor ao qual você deseja se conectar.
  3. Selecione o método de Autenticação: Nome de usuário e senha, Nome de usuário e senha do Okta ou Entrar usando o OAuth.
  4. Selecione um dos métodos de autenticação e conclua as etapas de login.
    Nome de usuário e senha do Okta:
    1. Insira o Nome de usuário e Senha,
    2. No campo Okta, insira a URL do servidor de servidor Okta.
    Entrar usando OAuth
    1. (Opcional) Selecione SQL inicial se quiser executar um comando de SQL no início de cada conexão. Para obter mais informações, consulte Executar o SQL inicial.
    2. Selecione Fazer logon.
    3. Na página da Web que é aberta, entre no Snowflake inserindo seu Nome de usuário e Senha e selecione Logon. Ou selecione Logon único [SSO] se o Snowflake estiver configurado para suportar o SSO.
    4. Clique em OK para confirmar a autorização para acessar seus dados do Snowflake.
    5. Feche a janela do navegador e o Tableau.
    6. Vá para a próxima seção "Configurar a fonte de dados".
  5. Selecione Fazer logon.

    6. Se o Tableau não conseguir fazer a conexão, verifique se as suas credenciais estão corretas. Se ainda assim não conseguir se conectar, seu computador está enfrentando problemas para localizar o servidor. Entre em contato com o administrador de banco de dados ou de rede.

Personalizar a conexão usando parâmetros de driver

Você pode querer modificar a conexão feita com o conector Snowflake. Você pode fazer isso ao acrescentar parâmetros de driver à cadeia de caracteres da conexão na guia Avançado:

Observação: não é possível alterar os parâmetros do driver gerados pelo Tableau; você pode anexar somente parâmetros.

Por exemplo, esta sintaxe especifica um servidor proxy a ser usado quando os valores no_proxy não são atendidos e quais nomes de host têm permissão para ignorar o servidor proxy:

Proxy=http://proxyserver.company:80;no_proxy=.trustedserver.com;

Para outro exemplo de parâmetros personalizados do driver, consulte Usar um proxy para o Snowflake.

 

Observação: se desejar personalização sem incorporá-lo na fonte de dados, você pode configurar parâmetros no registro do Windows (apenas os parâmetros marcados como "Parâmetros de configuração" estão disponíveis). Para obter detalhes sobre os parâmetros de driver, consulte Parâmetros de configuração e conexão do ODBC no site da Snowflake.

Configurar a fontes de dados

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. Na lista suspensa Armazém, selecione um armazém ou use a caixa de texto para pesquisá-lo pelo nome.

    Observação: se você deixar isso em branco e não selecionar um warehouse, o Tableau usará o warehouse virtual padrão do Snowflake.

    Para obter mais informações, consulte Warehouses virtuais padrão no Snowflake.

  3. Na lista suspensa Banco de dados, selecione um banco de dados ou use a caixa de texto para pesquisá-lo pelo nome.
  4. Na lista suspensa Esquema, selecione um esquema ou use a caixa de texto para procurar um pelo nome.
  5. Em Tabela, selecione uma tabela ou use a caixa de texto para procurar uma tabela pelo nome.

  6. Arraste uma tabela para a tela e selecione a guia da planilha para iniciar sua análise.

Fazer logon em um Mac

Se você usa o Tableau Desktop em um Mac, quando inserir o nome de servidor com o qual se conectar, use um nome de domínio totalmente qualificado, como mydb.test.example.lan, em vez de um nome de domínio relativo, como mydb ou mydb.test.

Como alternativa, é possível adicionar o domínio à lista de Domínios de Pesquisa no computador Mac para que, quando você se conectar, seja necessário fornecer apenas um nome de servidor. Para atualizar a lista de Domínios de Pesquisa, vá para Preferências do Sistema > Rede > Avançado e depois abra a guia DNS.

Warehouses virtuais padrão no Snowflake

Quando você cria uma fonte de dados do Snowflake, cria um warehouse Snowflake (para recursos computacionais) e os bancos de dados Snowflake (para recursos de dados). Tanto warehouses quanto bancos de dados exigem permissões para acessá-los. Você pode usar diferentes warehouses para acessar o mesmo banco de dados, dependendo do poder de computação que você precisa, assumindo que você tem permissões para cada warehouse e banco de dados.

Quando você cria uma fonte de dados, tem a opção de escolher um warehouse em uma lista de drop-down. Se você deixar isso em branco e não selecionar um warehouse, o Tableau usará o warehouse virtual padrão do Snowflake. Se você publicar posteriormente essa fonte de dados ou livro de trabalho, quando um usuário se conectar, o Tableau usará o warehouse virtual padrão do Snowflake dessa pessoa.

Cada usuário deve receber um warehouse padrão para que o Tableau possa usar esse como padrão para abrir uma pasta de trabalho em uma fonte de dados do Snowflake.

Configurar suporte do servidor Snowflake para OAuth

Para obter informações sobre como configurar o OAuth para conexões entre o Tableau e o Snowflake, consulte Configurar OAuth para conexões do Snowflake(O link abre em nova janela).

Usar um proxy para o Snowflake

Conecte-se a partir do Tableau por meio de um proxy ao Snowflake. Se estiver usando a versão 2019.4 ou posterior, poderá configurá-lo com a caixa de diálogo do conector digitando os parâmetros necessários na guia Avançado.

Por exemplo:

proxy=http://proxyserver.company:80

Para obter informações sobre os parâmetros que você deve usar, consulte a documentação do Snowflake(O link abre em nova janela).

Observação: o Tableau não usa um DSN para se conectar ao Snowflake, então você pode ignorar as instruções na documentação do Snowflake sobre o uso de um DSN.

Se estiver usando a versão do Tableau anterior à 2019.4, poderá configurá-lo ao inserir os parâmetros em um arquivo TDC usando odbc-extras.

Por exemplo:

<connection-customization class='snowflake' enabled='true' version='19.1'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='odbc-connect-string-extras' value='proxy=http://proxyserver.company:80' />
</customizations>
</connection-customization>

Para obter mais informações, consulte Personalizar a cadeia de caracteres de conexão de um Conector nativo(O link abre em nova janela).

Perguntas frequentes

A seguir estão alguns problemas e soluções comuns.

Eu tenho um erro "Este campo XXX não existe" o que eu faço?

Este erro aparece quando você está estiver criando um campo de cálculo, adicionando-o à planilha e substituindo a fonte de dados pelos dados do Snowflake (CustomSQL).

Use a função Substituir referências de campo para resolver o erro. Para obter informações adicionais sobre a substituição de referências de campo, consulte Substituir referências de campo.

 

Consulte também

Voltar para o topo
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!