ODBC 구성 및 연결 매개 변수¶

필수 연결 매개 변수¶

<이름> (데이터 소스)

DSN의 이름을 지정합니다.

port (포트)

드라이버가 Snowflake 통신을 대기하는 포트를 지정합니다.

참고

기본 Port 값인 443 을 변경할 필요가 없습니다.

pwd (비밀번호)

Snowflake에 연결하려면 비밀번호가 필요하지만, 보안 및 인증을 위해 Snowflake는 DSN 정의에 비밀번호 자격 증명을 직접 저장하지 않는 것을 강력하게 권장합니다.

일반적으로 자격 증명은 Snowflake에 연결하려고 시도하는 클라이언트 애플리케이션에 의해 프로그래밍 방식으로 드라이버로 전달됩니다.

참고

Windows에서 ODBC 드라이버는 Data Source Administration 도구에 Password 필드를 표시하지만, 드라이버는 이 필드에 입력된 값을 저장하지 않습니다. 대신, 연결 시 로그인 자격 증명을 드라이버에 제공해야 합니다.

server (서버)

계정의 호스트 이름 을 다음 형식으로 지정합니다.

account_identifier.snowflakecomputing.com

계정 식별자에 대한 자세한 내용은 계정 식별자 를 참조하십시오.

uid (사용자)

인증할 Snowflake 사용자의 로그인 이름을 지정합니다.

선택적 연결 매개 변수¶

BROWSER_RESPONSE_TIMEOUT

외부 브라우저에서 인증 응답을 기다리는 시간(초)을 지정합니다.

기본값은 120입니다.

CLIENT_OUT_OF_BAND_TELEMETRY_ENABLED=<부울>

대역 외 원격 분석을 활성화할지 여부를 지정합니다.

기본값은 true 입니다.

CLIENT_SESSION_KEEP_ALIVE=<부울>

비활성 기간이 경과한 이후 현재 세션을 활성 상태로 유지할지 아니면 사용자가 다시 로그인하도록 할지를 지정합니다. 값이 true 이면 Snowflake는 사용자가 비활성 상태인 경우에도 세션을 무기한 활성 상태로 유지합니다. 값이 false 이면 4시간 동안 사용자의 활동이 없으면 사용자가 다시 로그인해야 합니다.

기본값은 false 입니다.

database (데이터베이스)

드라이버에서 시작된 세션에서 사용할 기본 데이터베이스를 지정합니다.

maxHttpRetries (데이터베이스)

오류를 반환하기 전에 실패한 HTTP 요청이 있는 쿼리에 대한 최대 HTTP 재시도 횟수를 지정합니다. maxHttpRetries=0 으로 설정하면 재시도 횟수 제한이 제거되지만, 그러면 드라이버가 실패한 HTTP 호출을 무한히 재시도할 위험이 발생합니다.

기본값은 7입니다.

role (역할)

드라이버에서 시작된 세션에서 사용할 기본 역할을 지정합니다. 지정된 역할은 드라이버에 지정된 사용자에게 할당된 역할이어야 합니다. 지정된 역할이 사용자에게 할당된 역할과 일치하지 않으면, 드라이버에서 시작된 세션에는 처음에 역할이 없지만, 역할은 항상 세션 내에서부터 지정되어야 합니다.

schema (스키마)

드라이버에서 시작된 세션에서 사용할 기본 스키마를 지정합니다.

기본값은 public 입니다.

SecondaryRoles (역할)

드라이버에서 시작된 세션에서 사용할 보조 역할을 지정합니다. 드라이버의 지정된 사용자에게 역할이 이미 부여된 상태여야 합니다. 보조 역할은 USE SECONDARY ROLES 명령을 사용하여 사용자 세션 내에서 활성화할 수도 있습니다.

가능한 값은 다음과 같습니다.

• 모두: 사용자에게 부여된 모든 역할.

• 없음: 허용되는 역할이 없음(보조 역할을 비활성화함).

tracing (추적)

드라이버 추적 파일에 기록될 세부 정보 수준:

• 0= 추적 비활성화

• 1 = 심각한 오류만 추적

• 2 = 오류 추적

• 3 = 경고 추적

• 4 = 정보 추적

• 5 = 디버그 추적

• 6 = 세부 추적

warehouse (웨어하우스)

드라이버에서 시작된 세션에서 사용할 기본 웨어하우스를 지정합니다.

추가 연결 매개 변수¶

allowEmptyProxy

다음 섹션에 설명된 대로 proxy 및 no_proxy 연결 매개 변수에 빈 값을 허용할지 여부를 지정합니다.

• 연결 매개 변수 사용하기

• 구성 매개 변수 사용하기

• 환경 변수 사용하기

이 값을 설정하면 다음과 같은 효과가 나타납니다.

• true: 드라이버는 빈 프록시 값을 유효한 프록시 설정으로 처리하고 기존 설정이나 환경 변수를 재정의합니다.

• false: 드라이버는 빈 프록시 값을 무시하고 지정된 구성 매개 변수 또는 환경 변수를 사용합니다.

기본값은 true 입니다.

application

Snowflake 파트너 전용: ODBC를 통해 연결할 파트너 애플리케이션의 이름을 지정합니다.

This parameter can also be set by calling the SQLSetConnectAttr() function. 자세한 내용은 SQLSetConnectAttr 함수의 Snowflake 고유 동작 을 참조하십시오.

authenticator

Specifies the인증자to use for verifying사용자 로그인로그인 자격 증명:

• 내부 Snowflake 인증자를 사용하려면 snowflake (기본값).

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

  참고

  Snowflake ODBC 드라이버는 MacOS에서 Microsoft Excel을 사용하는 externalbrowser 인증을 지원하지 않습니다.

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

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

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

기본값은 snowflake 입니다.

On Windows, you can use the ODBC Data Source Administration Tool to set this parameter.

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

default_binary_size, . default_varchar_size

결정되지 않은 크기의 BINARY 또는 VARCHAR 열에서 값을 검색 및 변환할 때 드라이버가 사용할 기본 크기(바이트 단위)를 지정합니다. 이러한 타입의 열에서 값을 검색할 때 이 매개 변수를 설정합니다.

기본적으로, 드라이버는 결정되지 않은 열의 값을 검색하기 위해 메모리를 할당할 때 8388608 (BINARY 열) 및 16777216 (VARCHAR 열)을 기본 크기로 사용합니다.

이러한 값에 할당되는 메모리의 크기를 줄이려면 default_binary_size 및 default_varchar_size 를 이러한 타입의 열에 대한 최대 값 크기로 설정할 수 있습니다.

참고

이들 값을 설정하면 IRD(구현 행 설명자)의 SQL_DESC_LENGTH 필드와 SQLDescribeCol/SQLColAttribute/SQLColAttributes 에서 반환된 해당 값만 변경됩니다. 드라이버는 길이가 설정을 초과하더라도 여전히 전체 데이터를 반환합니다.

반면에 애플리케이션은 버퍼에 공간이 충분하지 않아 데이터가 잘릴 수 있는 이러한 매개 변수에 지정된 길이를 기반으로 데이터 버퍼를 할당할 수 있습니다. 모범 사례로, Snowflake는 기본 크기를 일반 데이터의 최대 크기(예: 4,000 또는 8,000바이트)보다 크게 설정하여 원래 기본값인 16,777,216/8,388,608바이트에서 메모리 사용량을 크게 줄이고 데이터 잘림 가능성을 최소화하는 것이 좋습니다.

이러한 설정을 사용하여 Snowflake 데이터베이스와 함께 Microsoft OLE DB 공급자(MSDASQL)를 사용할 때 발생할 수 있는 다음과 같은 오류를 방지할 수 있습니다.

Requested conversion is not supported
Cannot get the current row value of column

Copy

이러한 매개 변수를 연결 구성 매개 변수 (예: macOS 및 Linux 의 simba.snowflake.ini)로 지정할 수 있습니다. 이 매개 변수가 연결 매개 변수 및 구성 매개 변수 모두로 설정된 경우, DSN(또는 연결 문자열)의 연결 매개 변수가 우선 적용됩니다.

이러한 매개 변수는 ODBC 드라이버 버전 2.23.2에 도입되었습니다.

get_size_threshold

GET 명령으로 파일을 다운로드할 때 파일을 더 작은 부분으로 나누기 위한 최소 파일 크기(MB)를 지정합니다. 이 임계값보다 크기가 작은 파일은 다중 파트 다운로드를 사용하지 않습니다.

기본값은 5 (MB)입니다.

참고

이 값을 연결 매개 변수로 설정하면 해당 크기_임계값_가져오기 구성 매개 변수의 값이 재정의됩니다.

login_timeout

Snowflake 서비스에 연결할 때 로그인 실패 오류를 반환하기 전에 응답을 대기하는 시간(초)을 지정합니다.

기본값은 300 (초)입니다.

network_timeout

오류를 반환하기 전 Snowflake 서비스와 상호 작용할 때 응답을 대기하는 시간(초)을 지정합니다. 영(0)은 네트워크 시간 제한이 설정되지 않음을 나타냅니다.

기본값은 0 (초)입니다.

retryTimeout

실패한 HTTP 요청이 있는 쿼리에서 HTTP 재시도에 대해 오류를 반환하기 전에 기다려야 하는 시간(초)을 지정합니다. 영(0)은 재시도 시간 제한이 설정되지 않음을 나타냅니다.

기본값은 300 (초)입니다.

no_proxy

프록시 서버를 우회하도록 허용해야 하는 호스트 이름의 끝을 지정합니다(예: no_proxy=.amazonaws.com 은 Amazon S3 액세스가 프록시를 통과할 필요가 없음을 의미).

이 매개 변수는 와일드카드를 지원하지 않습니다. 지정된 각 값은 다음 중 하나여야 합니다.

• 호스트 이름의 끝(또는 전체 호스트 이름), 예:

  • .amazonaws.com

  • myorganization-myaccount.snowflakecomputing.com

• IP 주소, 예:

  • 192.196.1.15

2개 이상의 값이 지정된 경우, 값은 쉼표로 구분되어야 합니다. 예:

no_proxy=localhost,.my_company.com,myorganization-myaccount.snowflakecomputing.com,192.168.1.15,192.168.1.16

Copy

참고

이 매개 변수는 프로세스에 적용됩니다. 다른 연결에서 동일한 프로세스를 공유하는 경우 프록시 설정이 반드시 동일해야 합니다. 그렇지 않으면 동작을 예상할 수 없습니다.

odbc_use_standard_timestamp_columnsize

이 부울 매개 변수는 SQL_TYPE_TIMESTAMP에 대해 반환된 열 크기(문자)에 영향을 줍니다. 이 매개 변수가 true로 설정되면 드라이버는 ODBC 표준에 따라 29를 반환합니다. 이 매개 변수가 false 로 설정되면, 드라이버는 35를 반환하여 표준 시간대 오프셋(예: “-08:00”)을 위한 공간을 허용합니다.

이 값은 odbc.ini 파일(Linux 또는 macOS) 또는 Microsoft Windows 레지스트리뿐만 아니라 연결 문자열을 통해서도 설정할 수 있습니다.

기본값은 false 입니다.

passcode

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

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

passcodeInPassword

다단계 인증에 사용할 암호를 비밀번호에 추가할지 여부를 지정합니다.

• on (또는 true)은 암호를 추가하도록 지정합니다.

• off (또는 false) 또는 기타 모든 값은 암호가 추가되지 않도록 지정합니다.

기본값은 off 입니다.

proxy

프록시 서버 URL을 http://<호스트 이름>:<포트>/ 또는 <호스트 이름>:<포트_번호> 의 형식으로 지정하여 ODBC로부터의 모든 통신에서 프록시 서버를 사용하도록 합니다.

참고

이 매개 변수는 프로세스에 적용됩니다. 다른 연결에서 동일한 프로세스를 공유하는 경우 프록시 설정이 반드시 동일해야 합니다. 그렇지 않으면 동작을 예상할 수 없습니다.

put_compresslv

PUT 명령으로 데이터를 전송할 때 ODBC 드라이버가 사용하는 압축률을 지정합니다. 이 매개 변수는 기본 gzip 압축 수준을 재정의합니다. put_compresslv 를 지정하지 않으면 ODBC 드라이버는 기본 압축 수준을 사용합니다.

유효한 값은 -1 ~ 9 입니다. 기본값은 -1 이며 기본 Z_DEFAULT_COMPRESSION 을 지정합니다.

0 ~ 9 의 값은 사용자 지정 압축률을 지정합니다. 0 의 경우 ODBC 드라이버에서 더 낮은 압축률이 사용되며 9 의 경우 더 높은 압축률이 사용됩니다. 더 높은 압축률을 사용하면 데이터 전송 속도가 느려집니다.

이 매개 변수를 구성 매개 변수 (예: macOS 및 Linux 의 simba.snowflake.ini)로 지정할 수도 있습니다. 이 매개 변수가 연결 매개 변수 및 구성 매개 변수 모두로 설정된 경우, DSN(또는 연결 문자열)의 연결 매개 변수가 우선 적용됩니다.

이 매개 변수는 ODBC 드라이버 버전 2.23.3에 도입되었습니다.

put_fastfail

PUT 명령에서 와일드카드 문자를 사용하여 한 번에 여러 파일을 업로드하고 오류 발생 시 드라이버가 파일 업로드를 중지하도록 하려면, 이 매개 변수를 true 로 설정합니다.

기본값은 false 이며, 즉 한 파일에서 오류가 발생하면 드라이버는 나머지 파일의 업로드를 계속 진행합니다.

이 매개 변수는 ODBC 드라이버 버전 2.22.3에 도입되었습니다.

ODBC 드라이버 2.22.5 버전부터는 이 매개 변수를 구성 매개 변수 (예: macOS 및 Linux 의 simba.snowflake.ini)로 지정할 수도 있습니다. 이 매개 변수가 연결 매개 변수 및 구성 매개 변수 모두로 설정된 경우, DSN(또는 연결 문자열)의 연결 매개 변수가 우선 적용됩니다.

put_maxretries

PUT 명령이 실패하는 경우 드라이버가 명령을 다시 시도하는 횟수를 지정합니다.

기본값은 5 입니다.

이 매개 변수의 유효한 값 범위는 0 ~ 100 입니다. 이 범위를 초과하여 값을 지정하면 드라이버는 기본값인 5 를 사용합니다.

이 매개 변수는 ODBC 드라이버 버전 2.22.3에 도입되었습니다.

ODBC 드라이버 2.22.5 버전부터는 이 매개 변수를 구성 매개 변수 (예: macOS 및 Linux 의 simba.snowflake.ini)로 지정할 수도 있습니다. 이 매개 변수가 연결 매개 변수 및 구성 매개 변수 모두로 설정된 경우, DSN(또는 연결 문자열)의 연결 매개 변수가 우선 적용됩니다.

put_tempdir

PUT 명령 요청에서 사용할 임시 디렉터리를 지정합니다. 드라이버는 이 임시 디렉터리를 사용하여 Snowflake에 파일을 업로드하기 전 임시 압축 파일을 만듭니다.

이 매개 변수가 설정되지 않은 경우, 드라이버는 임시 디렉터리 /tmp/snowflakeTmp_username 을 생성하고 사용합니다. 여기서 username 은 운영 체제에 있는 현재 사용자의 사용자 이름입니다.

이 매개 변수를 구성 매개 변수 (예: macOS 및 Linux 의 simba.snowflake.ini)로 지정할 수도 있습니다. 이 매개 변수가 연결 매개 변수 및 구성 매개 변수 모두로 설정된 경우, DSN(또는 연결 문자열)의 연결 매개 변수가 우선 적용됩니다.

이 매개 변수는 ODBC 드라이버 버전 2.23.1에 도입되었습니다.

query_timeout

오류를 반환하기 전 쿼리의 완료를 대기하는 시간(초)을 지정합니다. 영(0)은 무한대로 대기를 나타냅니다.

기본값은 0 (초)입니다.

token=<문자열>

인증에 사용할 OAuth 토큰을 지정합니다. 여기서 <문자열> 은 토큰입니다. This parameter is required only when the authenticator=oauth parameter is set.

기본값은 없음입니다.

validateSessionParam

다음 중 유효하지 않은 세션 연결 매개 변수 가 있을 때 어떻게 응답할지 지정합니다.

• database
• schema
• warehouse

가능한 값은 다음과 같습니다.

• false (기본값): 성공적으로 연결되지만 database 및 schema 매개 변수 값을 빈 문자열로 설정하고 warehouse 매개 변수를 기본값으로 설정합니다. 웨어하우스에 대한 자세한 내용은 세션에서 웨어하우스 사용 섹션을 참조하십시오.

• true: 연결을 거부하고 오류를 발생시킵니다.

연결 매개 변수 사용하기¶

프록시 서버를 통해 연결하려면, 다음 연결 매개 변수를 DSN에 추가합니다.

• proxy

• no_proxy

예:

[connection]
Description = SnowflakeDB
Driver      = SnowflakeDSIIDriver
Locale      = en-US
server      = myorganization-myaccount.snowflakecomputing.com
proxy       = http://proxyserver.company:80
no_proxy    = .amazonaws.com

Copy

매개 변수 설명은 연결 매개 변수 를 참조하십시오.

구성 매개 변수 사용하기¶

프록시 서버를 통해 연결하려면, 다음 구성 매개 변수를 추가합니다.

• Proxy

• NoProxy

매개 변수 설명은 구성 매개 변수 를 참조하십시오.

환경 변수 사용하기¶

프록시 서버를 통해 연결하려면 다음 환경 변수를 구성합니다.

• http_proxy

• https_proxy

• no_proxy

예:

• Linux 또는 macOS:

  export http_proxy=http://proxyserver.company.com:80
  export https_proxy=http://proxyserver.company.com:80
  

  Copy

  프록시 서버에 사용자 이름 및 비밀번호가 필요한 경우 자격 증명을 포함합니다. 예:

  export https_proxy=http://username:password@proxyserver.company.com:80
  

  Copy

• Windows:

  set http_proxy=http://proxyserver.company.com:80
  set https_proxy=http://proxyserver.company.com:80
  

  Copy

  프록시 서버에 사용자 이름 및 비밀번호가 필요한 경우 자격 증명을 포함합니다. 예:

  set https_proxy=http://username:password@proxyserver.company.com:80
  

  Copy

선택 사항으로, no_proxy 를 설정하여 특정 통신(예: Amazon S3 액세스를 우회하기 위한 no_proxy=.amazonaws.com)에서 프록시를 우회하도록 할 수 있습니다.