2024년 .NET Driver 릴리스 정보

이 문서에는 .NET Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.

  • 동작 변경 사항

  • 새로운 기능

  • 고객이 직면한 버그 수정

Snowflake는 .NET Driver 업데이트에 의미 체계 버전 관리를 사용합니다.

버전 3.0.0(2024년 2월 29일)

BCR(동작 변경 릴리스) 변경 사항

  • 보안을 강화하기 위해 드라이버는 더 이상 쉬운 로깅 구성을 위해 임시 디렉터리를 검색하지 않습니다. 또한 이제 드라이버에는 파일 소유자만 파일을 수정할 수 있도록 파일 권한을 제한하기 위해 Unix 스타일 시스템의 로깅 구성 파일이 필요합니다(예: chmod 0600, chmod 0644).

  • 이제 드라이버는 PUT/GET 실패에 대해 QueryID 와 함께 SnowflakeDbException 을 발생시킵니다. 이전에는 드라이버가 FileNotFoundDirectoryNotFound 와 같은 다양한 유형의 예외를 반환했습니다. 애플리케이션에서 이러한 예외 중 하나라도 확인한 경우 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 고객에게 영향을 미칩니다. 이 상황에서는 allowUnderscoresInHosttrue 로 설정하여 기본값을 재정의해야 합니다. ConnectionString 에서 allowUnderscoresInHost=true 를 설정하여 이 동작을 재정의할 수 있습니다.

    이 변경은 계정 이름에 밑줄이 있는 Snowflake 계정과 공개 링크를 통해 연결할 때 발생하는 DNS 해결 오류를 수정하기 위해 이루어졌습니다.

새로운 기능과 업데이트

  • 향상된 Arrow 성능.

  • 계정 이름을 기반으로 호스트 이름을 구성할 때 계정 이름의 밑줄(_)을 하이픈(-)으로 자동으로 바꿉니다.

  • 구성된 호스트 이름에서 계정 이름의 밑줄(_)을 유지할 수 있도록 허용하는 allowUnderscoresInHost 구성 매개 변수를 추가했습니다. 이 매개 변수를 사용하면 이 릴리스와 관련된 동작 변경 사항을 재정의할 수 있습니다.

버그 수정 사항

  • 연결 시간 초과 문제를 수정하기 위해 이제 드라이버는 연결 시 만료된 세션을 비동기적으로 닫습니다.