Referência dos parâmetros de conexão do driver JDBC¶

Especifica se devem ser permitidos sublinhados nos nomes das contas. O driver JDBC não oferece suporte a sublinhados em URLs, que incluem o nome da conta, portanto o driver JDBC converte automaticamente os sublinhados em hífens. O valor padrão é false.

Especifica o autenticador a ser usado para verificar as credenciais de login de usuário. Você pode definir isto para um dos seguintes valores:

• snowflake para usar o autenticador interno do Snowflake.

• externalbrowser para usar seu navegador para autenticar com Okta, AD FS ou qualquer outro provedor de identidade compatível com SAML 2.0 (IdP) que tenha sido definido para sua conta.

• https://<nome_da_conta_okta>.okta.com (ou seja, o ponto de extremidade da URL para sua conta Okta) para autenticar através de Okta nativo (com suporte apenas se seu IdP for Okta).

• oauth para autenticar usando OAuth. Quando OAuth é especificado como o autenticador, você também deve definir o parâmetro token para especificar o token OAuth (consulte abaixo).

• snowflake_jwt para autenticar usando autenticação de pares de chaves. Para obter mais detalhes sobre autenticação de par de chaves, consulte Uso da autenticação de par de chaves e rotação de chaves.

• username_password_mfa para autenticar com o armazenamento em cache de tokens MFA. Para obter mais detalhes, consulte Uso da autenticação multifator

Se a cadeia de conexão especificar um par de chaves, então a autenticação do par de chaves será usada mesmo que o parâmetro authenticator seja removido ou esteja definido como “snowflake”.

Para obter mais informações sobre autenticação, consulte Gerenciamento/uso da autenticação federada e Clientes, drivers e conectores.

Especifica a senha a ser usada para autenticação multifator.

Para obter mais informações sobre autenticação multifator, consulte Autenticação multifator (MFA).

Especifica a senha para o usuário especificado.

Há duas maneiras de especificar a senha:

• A primeira maneira é passar a ID de usuário e a senha diretamente para o método getConnection:

  String user = "<user>";          // replace "<user>" with your user name
  String password = "<password>";  // replace "<password>" with your password
  Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", user, password);
  

  Copy

• A segunda maneira é criar um objeto Properties, atualizar o objeto com a senha e passar o objeto para o método getConnection:

  String user = "<user>";          // replace "<user>" with your user name
  String password = "<password>";  // replace "<password>" with your password
  Properties props = new Properties();
  props.put("user", user);
  props.put("password", password);
  Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", props);
  

  Copy

Especifica o token OAuth a ser usado para autenticação, onde <string> é o token. Este parâmetro só é necessário quando se define o parâmetro authenticator como oauth, exceto conforme observado abaixo.

Por exemplo, em vez de definir o parâmetro de configuração de token, você pode passar o token como senha nas propriedades do método getConnection(), semelhante ao seguinte:

Properties props = new Properties();
props.put("user", "myusername");
props.put("authenticator", "oauth");
props.put("role", "myrole");
props.put("password", "xxxxxxxxxxxxx"); // where xxxxxxxxxxxxx is the token string
Connection myconnection = DriverManager.getConnection(url, props);

Especifica o banco de dados padrão a ser usado uma vez conectado, ou especifica uma cadeia de caracteres vazia. O banco de dados especificado deve ser um banco de dados existente para o qual a função padrão especificada tem privilégios.

Se você precisar usar um banco de dados diferente após a conexão, execute o comando USE DATABASE.

Especifica a função de controle de acesso padrão a ser usada na sessão Snowflake iniciada pelo driver. A função especificada deve ser uma função existente que já tenha sido atribuída ao usuário especificado para o driver. Se a função especificada ainda não tiver sido atribuída ao usuário, a função não é utilizada quando a sessão é iniciada pelo driver.

Se você precisar usar uma função diferente após a conexão, execute o comando USE ROLE.

Para obter mais informações sobre funções e controle de acesso, consulte Visão geral do controle de acesso.

Especifica o esquema padrão a ser usado para o banco de dados especificado, uma vez conectado, ou especifica uma cadeia de caracteres vazia. O esquema especificado deve ser um esquema existente para o qual a função padrão especificada tem privilégios.

Se você precisar usar um esquema diferente após a conexão, execute o comando USE SCHEMA.

Especifica o warehouse virtual a ser utilizado uma vez conectado, ou especifica uma cadeia de caracteres vazia. O warehouse especificado deve ser um warehouse existente para o qual a função padrão especificada tem privilégios.

Se você precisar usar um warehouse diferente após a conexão, execute o comando USE WAREHOUSE pode ser executado para definir um warehouse diferente para a sessão.

Especifica se o driver deve ignorar a configuração de proxy SOCKS especificada nas opções do sistema Java:

• on (ou true) especifica para ignorar o proxy.

• off (ou false) ou qualquer outro valor especifica para usar o proxy.

Especifica se o driver deve usar um proxy:

• on (ou true) especifica que o driver deve usar um proxy.

• off (ou false) ou qualquer outro valor especifica que o driver não deve usar um proxy.

Consulte Especificação de um servidor proxy na cadeia de conexão JDBC para obter mais detalhes.