2024년 .NET Driver 릴리스 정보¶
이 문서에는 .NET Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.
동작 변경 사항
새로운 기능
고객이 직면한 버그 수정
Snowflake는 .NET Driver 업데이트에 의미 체계 버전 관리를 사용합니다.
버전 3.0.0(2024년 2월 29일)¶
BCR(동작 변경 릴리스) 변경 사항¶
보안을 강화하기 위해 드라이버는 더 이상 쉬운 로깅 구성을 위해 임시 디렉터리를 검색하지 않습니다. 또한 이제 드라이버에는 파일 소유자만 파일을 수정할 수 있도록 파일 권한을 제한하기 위해 Unix 스타일 시스템의 로깅 구성 파일이 필요합니다(예:
chmod 0600
,chmod 0644
).이제 드라이버는 PUT/GET 실패에 대해
QueryID
와 함께SnowflakeDbException
을 발생시킵니다. 이전에는 드라이버가FileNotFound
및DirectoryNotFound
와 같은 다양한 유형의 예외를 반환했습니다. 애플리케이션에서 이러한 예외 중 하나라도 확인한 경우 PUT/GET 실패에 대해SnowflakeDbException
만 처리하도록 코드를 업데이트해야 합니다.드라이버는 청크 파서/다운로더의 V1 및 V2와 같은 이전 버전을 더 이상 지원하지 않습니다. 버전 V3으로 업그레이드하는 과정의 일부로, 드라이버는 더 이상
SFConfiguration.UseV2JsonParser
또는SFConfiguration.UseV2ChunkDownloader
구성 옵션을 지원하지 않습니다. 다음과 유사한 명령을 사용한 경우 해당 명령을 제거해야 합니다.SFConfiguration.Instance().ChunkParserVersion = 1;
또는SFConfiguration.Instance().ChunkParserVersion = 2;
SFConfiguration.Instance().ChunkDownloaderVersion = 1;
또는SFConfiguration.Instance().ChunkDownloaderVersion = 2;
SFConfiguration.Instance().UseV2JsonParser
SFConfiguration.Instance().UseV2ChunkDownloader
새로운 기능 및 개선 사항¶
여러 SAML 통합에 대한 지원을 추가했습니다.
버그 수정 사항¶
다음을 포함하여 간편한 로깅 기능의 보안을 개선했습니다.
클라이언트 구성 파일을 검색할 때 사용할 드라이버 디렉터리를 결정하는 보다 안정적인 방법 사용.
더 이상 구성 검색에 임시 디렉터리를 사용하지 않음.
보안 강화를 위해 Unix에서 추가 파일 권한 검사 적용.
더 자세한 로깅 추가.
SSO/SAML 엔드포인트에 대한 Okta 재시도 문제를 수정했습니다.
텍스트 실행이 없는 명령에 대한 빠른 실패를 추가했습니다.
가능한 경우
QueryId
를 포함하도록 PUT/GET 실행 실패로 인해 발생한 예외를 수정했습니다.Portable.BouncyCastle
라이브러리를BouncyCastle.Cryptography
로 바꾸었습니다.
버전 2.2.0(2024년 1월 17일)¶
BCR(동작 변경 릴리스) 변경 사항¶
버전 2.2.0부터 .NET 드라이버는 계정 이름을 기반으로 호스트 이름을 구성할 때 계정 이름의 밑줄(
_
)을 하이픈(-
)으로 자동으로 바꿉니다. 이 변경 사항은 계정 이름에 밑줄이 포함된 PrivateLink 고객에게 영향을 미칩니다. 이 상황에서는allowUnderscoresInHost
를true
로 설정하여 기본값을 재정의해야 합니다.ConnectionString
에서allowUnderscoresInHost=true
를 설정하여 이 동작을 재정의할 수 있습니다.이 변경은 계정 이름에 밑줄이 있는 Snowflake 계정과 공개 링크를 통해 연결할 때 발생하는 DNS 해결 오류를 수정하기 위해 이루어졌습니다.
새로운 기능과 업데이트¶
향상된 Arrow 성능.
계정 이름을 기반으로 호스트 이름을 구성할 때 계정 이름의 밑줄(
_
)을 하이픈(-
)으로 자동으로 바꿉니다.구성된 호스트 이름에서 계정 이름의 밑줄(_)을 유지할 수 있도록 허용하는
allowUnderscoresInHost
구성 매개 변수를 추가했습니다. 이 매개 변수를 사용하면 이 릴리스와 관련된 동작 변경 사항을 재정의할 수 있습니다.
버그 수정 사항¶
연결 시간 초과 문제를 수정하기 위해 이제 드라이버는 연결 시 만료된 세션을 비동기적으로 닫습니다.