El conector Snowflake .NET admite las siguientes versiones de bibliotecas y marcos .NET:
Descargo de responsabilidad: si bien el conector apunta a netstandard2.0 y puede funcionar con versiones en su matriz de soporte, el conector solo admite y prueba las versiones enumeradas anteriormente.
Consulte la sección Aviso a continuación para obtener información sobre el uso seguro del controlador .NET.
Si desea contribuir a este proyecto, conozca las convenciones de codificación que nos gustaría seguir: Convenciones de codificación.
Puede crear aplicaciones de conector Snowflake .NET para sistemas operativos Windows, Macintosh y Linux. Para obtener información sobre las versiones de sistemas operativos compatibles, consulte la Política de soporte y versiones del cliente.
Este proyecto se desarrolla en Visual Studio 2017. No se admiten versiones anteriores de Visual Studio.
Requisitos previos: instalar dotnet, git, nuget y mono (solo en 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
El ID del paquete para Snowflake Connector para .Net es Snowflake.Data.
Los paquetes se pueden descargar directamente desde nuget.org.
También se puede descargar usando la interfaz de usuario de Visual Studio (Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución y buscar "Snowflake.Data")
Alternativamente, los paquetes también se pueden descargar usando la Consola del Administrador de paquetes:
PM> Install-Package Snowflake.Data
A partir de la versión v4.2.0, el paquete del controlador está firmado con una firma que permite verificar su autenticidad e integridad. Pasos para verificar la firma:
cosign
.nupkg
) de nuget, por ejemplo: https://www.nuget.org/packages/Snowflake.Data/4.2.0cosign 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
Ejecución de pruebas
Cobertura de código
Para crear una conexión, familiarícese con: Métodos de conexión y autenticación
Descripción del grupo de conexiones: varios grupos de conexiones.
Se describe la agrupación anterior a v4.0.0: Grupo de conexiones únicas: deprecated
Los tipos de datos de Snowflake y sus tipos .NET se tratan en: Tipos de datos y formatos de datos
Cómo ejecutar una consulta, utilizar enlaces de consulta, ejecutar consultas de forma sincrónica y asincrónica: ejecutar consultas y leer resultados
Usar tipos estructurados: tipos estructurados
Usando tipo de vector: tipo de vector
Uso de archivos de escenario dentro de los comandos PUT/GET: archivos PUT y GET hacia/desde el escenario
Descripción y configuración del registro: Registro y Registro fácil
El método de validación de los certificados de conexión en el controlador .NET difiere del resto de controladores Snowflake. Lea más en los documentos de validación de certificados.
CVE-2019-0820: este CVE se ha informado en Systems.text.regularexpressions.dll que utilizan los paquetes de expresiones regulares: Systems.text.regularexpressions.4.3.1.nupkg. Esta vulnerabilidad se manifiesta SÓLO cuando se utilizan los siguientes entornos de ejecución .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.
Registro: Snowflake identificó un problema el 20 de febrero de 2020 con nuestro código de registro para los controladores .NET en el que escribimos tokens maestros y de sesión sin cifrar en los registros de depuración. Los registros de depuración se recopilan localmente en la unidad donde se ejecutan sus programas. Este problema afecta sólo a aquellas instancias en las que los programas se ejecutan con los indicadores de depuración habilitados, es decir, configurar el valor del nivel de registro = "Depurar" o "Todos" en la configuración de log4Net.
En condiciones normales, los tokens Master y Session capturados en los archivos de registro tienen una vida corta, aproximadamente 4 y 1 hora, respectivamente. Caducarán después del período de 4 horas a menos que se actualicen explícitamente, en cuyo caso podrían actualizarse indefinidamente.
Si está utilizando el controlador .NET, realice la siguiente acción:
Configuración de conexión HTTP global: Snowflake ha identificado un problema en el que el controlador aplica globalmente TLS 1.2 y verificaciones de revocación de certificados con el controlador .NET v1.2.1 y versiones anteriores. A partir de v2.0.0, el controlador los configurará localmente.
Lista de revocación de certificados no realizada cuando insecureMode estaba deshabilitado: Snowflake ha identificado una vulnerabilidad en la que no se realizaron verificaciones de la Lista de revocación de certificados (CRL) cuando el indicador insecureMode estaba establecido en falso, que es la configuración predeterminada. A partir de la versión v2.1.5, CRL vuelve a funcionar según lo previsto.
Actualmente, este controlador no admite puntos finales regionales de GCP. Asegúrese de que cualquier carga de trabajo que utilice este controlador no requiera compatibilidad con puntos finales regionales en GCP. Si tiene preguntas sobre esto, comuníquese con el soporte de Snowflake.
Tenga en cuenta que el controlador ahora tiene como objetivo .NET Standard 2.0. Al actualizar, es posible que también necesite ejecutar “Update-Package -reinstall” para actualizar las dependencias.
Ver más: