Centro de suporte da Workiva

Com o conector Snowflake® JDBC, você pode usar os comandos em uma cadeia para executar operações de linguagem de consulta estruturada (SQL) em bancos de dados Snowflake. Por exemplo, com esse conector, você pode:

• Executar comandos SQL, incluindo uma instrução CREATE ou UPDATE ou uma consulta SELECT
• Recuperar detalhes sobre uma tabela no Snowflake
• Inserir registros em um banco de dados do Snowflake

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para habilitar a conexão com o Snowflake, o administrador de segurança da organização deve primeiro habilitá-lo from Configuration.

O próprio conector usa a conectividade de banco de dados Java (JDBC), protegida com autenticação básica ou de par de chaves. Para configurar o conector, você precisará de:

• Um usuário de integração designado criado no Snowflake para o conector, além do nome de usuário e da senha do usuário de integração.
  

  Observação: A autenticação básica não terá mais suporte a partir de novembro de 2025. Em vez disso, recomendamos que você use a autenticação de par de chaves. Saiba mais​.

• (Opcional) Um arquivo de chave privada para habilitar a autenticação de par de chaves .
• O URL da conexão JDBC, como jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Para se conectar a um banco de dados Snowflake local, um GroundRunner para a conexão. (Para se conectar a uma instância de nuvem do Snowflake, use o CloudRunner padrão).

Configure o conector Snowflake

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Connector Connection, selecione Snowflake JDBC e o executor a ser usado com a conexão.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
4. (Opcional) Em Resources, carregue seu arquivo de chave privada. Você precisará digitar esse nome exato de arquivo no campo "Private key file" (Arquivo de chave privada) na próxima etapa.
5. Em Propriedades, insira os detalhes do conector:
   
   

   Propriedade	Detalhes
   Nome de usuário	Digite o nome de usuário com o qual você deseja se autenticar. Se um arquivo de chave privada for fornecido abaixo, você será autenticado automaticamente com esse nome de usuário.
   Senha	Digite a senha da propriedade Nome de usuário. Se um arquivo de chave privada for fornecido abaixo, digite a senha aqui. Observação: Deixe em branco para arquivos de chave não criptografados.
   URL de conexão	Digite o URL da conexão JDBC, como jdbc:snowflake://[accountName].snowflakecomputing.com/. Para incluir propriedades opcionais para a conexão, acrescente-as como uma cadeia de caracteres de consulta. Por exemplo, para que um login tenha um tempo limite automático se não conseguir se conectar em um minuto, acrescente ?loginTimeout=60.
   Arquivo de chave privada	(Opcional) Usado para autenticação com a chave pública do servidor. O nome de usuário e a senha devem ser inseridos nos campos acima. Saiba mais: Autenticação de pares de chaves e rotação de pares de chaves Observação: O nome do arquivo deve corresponder a um arquivo carregado como recurso de conexão.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256. Para fins de segurança, evite incluir credenciais de usuário como propriedades opcionais na propriedade URL de conexão.

6. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
7. Para testar a conexão, crie e execute uma cadeia com o comando Get Table Definition do conector e verifique se ele retorna uma saída válida.

Solução de problemas

• Se a conexão com o Snowflake falhar:
  • Verifique as credenciais de autenticação.
  • Se você estiver usando a autenticação de par de chaves, verifique se o nome do arquivo carregado em Resources corresponde ao nome do arquivo inserido no campo Private Key File.
  • Verifique o URL da conexão JDBC, incluindo o nome da conta.
  • Se você estiver se conectando a um banco de dados local, verifique o GroundRunner selecionado para o conector.
• Se a conexão não conseguir executar um comando, verifique se as entradas, como a sintaxe ou a tabela SQL, são válidas.
• Se um comando do Snowflake falhar com a mensagem de erro Incoming request with IP/Token XX.XX.XX.XX não tem permissão para acessar o Snowflake, faça referência a este artigo do Snowflake para obter orientação sobre como adicionar o endereço IP necessário ( CloudRunner ou GroundRunner) à lista de IPs permitidos na sua instância do Snowflake.