snowflake connector net
4.2.0
O conector Snowflake .NET oferece suporte às seguintes versões de bibliotecas e estruturas .NET:
Isenção de responsabilidade: embora o conector seja direcionado ao netstandard2.0 e possa funcionar com versões em sua matriz de suporte, apenas as versões listadas acima são suportadas e testadas pelo conector
Consulte a seção Aviso abaixo para obter informações sobre o uso seguro do driver .NET
Se você gostaria de contribuir com este projeto, conheça as convenções de codificação que gostaríamos de seguir: Convenções de codificação.
Você pode construir aplicativos do conector Snowflake .NET para sistemas operacionais Windows, Macintosh e Linux. Para obter informações sobre versões de sistemas operacionais compatíveis, consulte Versões do cliente e política de suporte.
Este projeto foi desenvolvido no Visual Studio 2017. Versões anteriores do Visual Studio não são suportadas.
Pré-requisitos: Instale dotnet, git, nuget e mono (somente no 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
O ID do pacote do Snowflake Connector para .Net é Snowflake.Data.
Os pacotes podem ser baixados diretamente de nuget.org.
Ele também pode ser baixado usando a UI do Visual Studio (Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para Solução e pesquise "Snowflake.Data")
Alternativamente, os pacotes também podem ser baixados usando o Package Manager Console:
PM> Install-Package Snowflake.Data
A partir da versão v4.2.0 o pacote de drivers é assinado com uma assinatura que permite verificar sua autenticidade e integridade. Etapas para verificar a assinatura:
cosign.nupkg ) do nuget, por exemplo: 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 OKExecutando testes
Cobertura de código
Para criar uma conexão, familiarize-se com: Métodos de conexão e autenticação
Descrição do pool de conexões: Vários pools de conexões.
O pool anterior à v4.0.0 é descrito: Pool de conexão única - deprecated
Os tipos de dados Snowflake e seus tipos .NET são abordados em: Tipos de dados e formatos de dados
Como executar uma consulta, usar vinculações de consulta, executar consultas de forma síncrona e assíncrona: Executando consultas e lendo resultados
Usando tipos estruturados: tipos estruturados
Usando tipo de vetor: tipo de vetor
Usando arquivos de palco nos comandos PUT/GET: Arquivos PUT e GET de/para o Stage
Descrição e configuração do log: Logging e Easy Logging
O método de validação dos certificados de conexão no driver .NET difere do restante dos drivers Snowflake. Leia mais em documentos de validação de certificado.
CVE-2019-0820 - Este CVE foi relatado em Systems.text.regularexpressions.dll que é usado pelos pacotes de expressões regulares - Systems.text.regularexpressions.4.3.1.nupkg. Esta vulnerabilidade se manifesta SOMENTE quando os seguintes ambientes de execução .NET estão sendo usados:
* 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.
Logging - Snowflake identificou um problema em 20 de fevereiro de 2020, com nosso código de log para os drivers .NET nos quais escrevemos tokens Master e Session de forma transparente para os logs de depuração. Os logs de depuração são coletados localmente na unidade onde seus programas estão sendo executados. Este problema afeta apenas as instâncias em que os programas são executados com sinalizadores de depuração habilitados, ou seja, definindo o valor do nível de log = "Debug" ou "All" na configuração do log4Net
Em condições normais, os tokens Master e Session capturados nos arquivos de log têm vida curta, cerca de 4 e 1 hora, respectivamente. Eles expirarão após a janela de 4 horas, a menos que sejam atualizados explicitamente; nesse caso, poderão ser atualizados indefinidamente.
Se você estiver usando o driver .NET, execute a seguinte ação:
Configurações globais de conexão HTTP - Snowflake identificou um problema em que o driver está aplicando globalmente o TLS 1.2 e verificações de revogação de certificado com o driver .NET v1.2.1 e versões anteriores. A partir da v2.0.0, o driver irá configurá-los localmente.
Lista de revogação de certificados não executada onde insecureMode foi desativado - Snowflake identificou uma vulnerabilidade onde as verificações na lista de revogação de certificados (CRL) não foram executadas onde o sinalizador insecureMode foi definido como falso, que é a configuração padrão. A partir da versão v2.1.5, a CRL está funcionando conforme planejado.
Atualmente, este driver não oferece suporte a endpoints regionais do GCP. Certifique-se de que quaisquer cargas de trabalho usadas por meio deste driver não exijam suporte para endpoints regionais no GCP. Se você tiver dúvidas sobre isso, entre em contato com o suporte do Snowflake.
Observe que o driver agora está direcionado ao .NET Standard 2.0. Ao atualizar, você também pode precisar executar “Update-Package -reinstall” para atualizar as dependências.
Veja mais:
