snowflake connector net
4.2.0
Соединитель Snowflake .NET поддерживает следующие версии платформы .NET и библиотек:
Отказ от ответственности: хотя соединитель предназначен для netstandard2.0 и может работать с версиями в своей матрице поддержки, только перечисленные выше версии поддерживаются и тестируются соединителем.
Пожалуйста, обратитесь к разделу «Уведомление» ниже для получения информации о безопасном использовании драйвера .NET.
Если вы хотите внести свой вклад в этот проект, ознакомьтесь с соглашениями по кодированию, которым мы хотели бы следовать: Соглашения по кодированию.
Вы можете создавать приложения-коннекторы Snowflake .NET для операционных систем Window, Macintosh и Linux. Информацию о поддерживаемых версиях операционной системы см. в Политике клиентских версий и поддержки.
Этот проект разработан в Visual Studio 2017. Более ранние версии Visual Studio не поддерживаются.
Предварительные требования: установите dotnet, git, nuget и mono (только на Mac).
git clone [email protected]:snowflakedb/snowflake-connector-net snowflake-connector-net
cd snowflake-connector-net
nuget restore
cd Snowflake.Data
dotnet build --configuration Release
Add a parameters.json file to Snowflake.Data.Tests
dotnet build
Идентификатор пакета для соединителя Snowflake для .Net — Snowflake.Data.
Пакеты можно загрузить напрямую с сайта nuget.org.
Его также можно загрузить с помощью пользовательского интерфейса Visual Studio (Инструменты > Диспетчер пакетов NuGet > Управление пакетами NuGet для решения и выполнить поиск по запросу "Snowflake.Data").
Кроме того, пакеты также можно загрузить с помощью консоли диспетчера пакетов:
PM> Install-Package Snowflake.Data
Начиная с версии v4.2.0 пакет драйверов подписывается подписью, позволяющей проверить его подлинность и целостность. Действия по проверке подписи:
cosign.nupkg ) с сайта nuget, например: https://www.nuget.org/packages/Snowflake.Data/4.2.0.cosign verify-blob snowflake.data.4.2.0.nupkg
--key snowflake-connector-net-v4.2.0.pub
--signature Snowflake.Data.4.2.0.nupkg.sig
Verified OKЗапуск тестов
Покрытие кода
Чтобы создать соединение, ознакомьтесь с: Методами подключения и аутентификации.
Описание пула соединений: Несколько пулов соединений.
Описано объединение в пулы до версии 4.0.0: Пул с одним соединением — deprecated
Типы данных Snowflake и их типы .NET рассматриваются в разделе Типы данных и форматы данных.
Как выполнить запрос, использовать привязки запроса, выполнять запросы синхронно и асинхронно: выполнение запросов и чтение результатов
Использование структурированных типов: Структурированные типы
Использование векторного типа: Векторный тип
Использование файлов сцены в командах PUT/GET: PUT и GET файлы в/из сцены.
Описание и конфигурация ведения журнала: Ведение журнала и простое ведение журнала
Метод проверки сертификатов подключения в драйвере .NET отличается от остальных драйверов Snowflake. Подробнее читайте в документации по проверке сертификатов.
CVE-2019-0820 — об этой CVE сообщается в файле system.text.regularexpressions.dll, который используется пакетами регулярных выражений — system.text.regularexpressions.4.3.1.nupkg. Эта уязвимость проявляется ТОЛЬКО при использовании следующих сред выполнения .NET:
* v1.0 branch: 1.0 - 1.0.16 (exclusive)
* v1.1 branch: 1.1 - 1.1.13 (exclusive)
* v2.1 branch: 2.1 - 2.1.11 (exclusive)
* v2.2 branch: 2.2 - 2.2.5 (exclusive)
In order to mitigate this vulnerability, we recommend to update to higher Runtime versions. If you're already running on a .NET Runtime version higher than the ones listed above, you're not going to be affected by this vulnerability.
Ведение журнала. 20 февраля 2020 г. компания Snowflake обнаружила проблему с нашим кодом ведения журнала для драйверов .NET, в котором мы записываем основные токены и токены сеанса в открытые журналы отладки. Журналы отладки собираются локально на диске, на котором запущены ваши программы. Эта проблема затрагивает только те случаи, когда программы запускаются с включенными флагами отладки, то есть с установкой значения уровня журнала = «Отладка» или «Все» в конфигурации log4Net.
В нормальных условиях токены Master и Session, зафиксированные в файлах журналов, недолговечны и составляют около 4 и 1 часа соответственно. Срок их действия истечет через 4 часа, если они не будут явно обновлены, и в этом случае они могут обновляться бесконечно.
Если вы используете драйвер .NET, выполните следующие действия:
Глобальные настройки HTTP-соединения. Snowflake обнаружила проблему, при которой драйвер глобально применяет TLS 1.2 и проверяет отзыв сертификатов с помощью .NET Driver v1.2.1 и более ранних версий. Начиная с версии 2.0.0, драйвер будет устанавливать их локально.
Список отзыва сертификатов не выполняется, если insecureMode отключен. Snowflake обнаружила уязвимость, из-за которой проверки списка отзыва сертификатов (CRL) не выполнялись, когда для флага insecureMode было установлено значение false, что является настройкой по умолчанию. Начиная с версии v2.1.5 CRL работает как положено.
В настоящее время этот драйвер не поддерживает региональные конечные точки GCP. Убедитесь, что любые рабочие нагрузки, использующие этот драйвер, не требуют поддержки региональных конечных точек в GCP. Если у вас есть вопросы по этому поводу, обратитесь в службу поддержки Snowflake.
Обратите внимание, что драйвер теперь ориентирован на .NET Standard 2.0. При обновлении вам также может потребоваться запустить «Update-Package -reinstall», чтобы обновить зависимости.
Смотрите больше:
