JDBC 드라이버 연결 매개 변수 참조¶

계정 이름에 밑줄을 허용할지 여부를 지정합니다. JDBC Driver는 계정 이름을 포함하는 URL에서 밑줄을 지원하지 않으므로, JDBC Driver는 밑줄을 하이픈으로 자동으로 변환합니다. 기본값은 false 입니다.

사용자 로그인 자격 증명을 확인하기 위해 사용할 인증자를 지정합니다. 인증자는 다음 값 중 1개로 설정할 수 있습니다.

• 내부 Snowflake 인증자를 사용하기 위한 snowflake.

• Okta, ADFS 또는 계정에 정의된 기타 SAML 2.0 규격 ID 공급자(IdP)를 인증하기 위해 웹 브라우저를 사용하기 위한 externalbrowser.

• 기본 Okta (IdP가 Okta인 경우에만 지원됨)를 통해 인증하기 위한 https://<okta_계정_이름>.okta.com (즉, Okta 계정의 URL 엔드포인트).

• OAuth를 사용하여 인증하려면 oauth. OAuth가 인증자로 지정되면 token 매개 변수도 설정하여 OAuth 토큰을 지정해야 합니다(아래 참조).

• 키 페어 인증을 사용하여 인증하려면 snowflake_jwt. 키 페어 인증에 대한 자세한 정보는 키 페어 인증 및 키 순환 사용하기 를 참조하십시오.

• MFA 토큰 캐싱을 사용하여 인증하려면 username_password_mfa. 자세한 내용은 다단계 인증 사용하기 섹션을 참조하십시오.

연결 문자열이 키 페어로 지정된 경우에는 authenticator 매개 변수가 설정되지 않거나 ‘Snowflake’로 설정되어 있어도 키 페어 인증이 사용됩니다.

인증에 대한 자세한 내용은 페더레이션 인증 관리하기/사용하기 및 클라이언트, 드라이버 및 커넥터 를 참조하십시오.

다단계 인증에서 사용할 암호를 지정합니다.

다단계 인증에 대한 자세한 내용은 다단계 인증(MFA) 을 참조하십시오.

지정된 사용자에 대한 비밀번호를 지정합니다.

비밀번호는 다음과 같은 두 가지 방법으로 지정할 수 있습니다.

• 첫 번째 방법은 다음과 같이 사용자 ID 및 비밀번호를 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

• 두 번째 방법은 다음과 같이 Properties 오브젝트를 생성하고 비밀번호를 사용하여 오브젝트를 업데이트한 후 오브젝트를 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

인증에 사용할 OAuth 토큰을 지정합니다. 여기서 <문자열> 은 토큰입니다. 이 매개 변수는 아래에 언급된 경우를 제외하면 authenticator 매개 변수를 oauth 로 설정하는 경우에만 필요합니다.

예를 들어, token 구성 매개 변수를 설정하는 대신에 다음과 유사하게 getConnection() 메서드 속성에서 토큰을 비밀번호로 전달할 수 있습니다.

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);

연결된 이후에 사용할 기본 데이터베이스를 지정하거나 빈 문자열을 지정합니다. 지정된 데이터베이스는 지정된 기본 역할에 권한이 있는 기존 데이터베이스여야 합니다.

연결 후 다른 데이터베이스를 사용해야 하는 경우에는 USE DATABASE 명령을 실행합니다.

드라이버가 시작한 Snowflake 세션에서 사용할 기본 액세스 제어 역할을 지정합니다. 지정된 역할은 드라이버에 지정된 사용자에게 이미 할당된 기존 역할이어야 합니다. 지정된 역할이 사용자에게 아직 할당되지 않은 경우에는 드라이버가 세션을 시작할 때 역할이 사용되지 않습니다.

연결 후 다른 역할을 사용해야 하는 경우에는 USE ROLE 명령을 실행합니다.

역할 및 액세스 제어에 대한 자세한 내용은 액세스 제어의 개요 를 참조하십시오.

연결된 이후에 지정된 데이터베이스에서 사용할 기본 스키마를 지정하거나 빈 문자열을 지정합니다. 지정된 스키마는 지정된 기본 역할에 권한이 있는 기존 스키마여야 합니다.

연결 후 다른 스키마를 사용해야 하는 경우에는 USE SCHEMA 명령을 실행합니다.

연결된 이후에 사용할 기본 웨어하우스를 지정하거나 빈 문자열을 지정합니다. 지정된 웨어하우스는 지정된 기본 역할에 권한이 있는 기존 웨어하우스여야 합니다.

연결된 이후에 다른 웨어하우스를 사용해야 하는 경우에는 USE WAREHOUSE 명령을 실행하여 세션에 대해 다른 웨어하우스를 설정할 수 있습니다.

드라이버가 Java 시스템 옵션에 지정된 SOCKS 프록시 구성을 무시해야 하는지 여부를 지정합니다.

• on (또는 true)으로 설정되면 프록시를 무시합니다.

• off (또는 false) 또는 기타 모든 값으로 설정되면 프록시를 사용합니다.

드라이버에서 프록시를 사용해야 하는지 여부를 지정합니다.

• on (또는 true) 은 드라이버가 프록시를 사용하도록 지정합니다.

• off (또는 false) 또는 기타 모든 값은 드라이버가 프록시를 사용하지 않도록 지정합니다.

자세한 내용은 JDBC 연결 문자열에 프록시 서버 지정 섹션을 참조하십시오.