Konektor Snowflake .NET mendukung versi .NET framework dan pustaka berikut:
Penafian: Meskipun konektor menargetkan netstandard2.0 dan dapat bekerja dengan versi dalam matriks dukungannya, hanya versi yang tercantum di atas yang didukung dan diuji oleh konektor
Silakan merujuk ke bagian Pemberitahuan di bawah untuk informasi tentang penggunaan Driver .NET yang aman
Jika Anda ingin berkontribusi pada proyek ini, silakan mengenal konvensi pengkodean yang ingin kami ikuti: Konvensi pengkodean.
Anda dapat membuat aplikasi konektor Snowflake .NET untuk sistem operasi Window, Macintosh, dan Linux. Untuk informasi tentang versi sistem operasi yang didukung, lihat Versi Klien dan Kebijakan Dukungan.
Proyek ini dikembangkan di bawah Visual Studio 2017. Versi Visual Studio sebelumnya tidak didukung.
Prasyarat: Instal dotnet, git, nuget, dan mono (Hanya di 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
ID paket untuk Konektor Snowflake untuk .Net adalah Snowflake.Data.
Paket dapat langsung diunduh dari nuget.org.
Itu juga dapat diunduh menggunakan Visual Studio UI (Alat > Manajer Paket NuGet > Kelola Paket NuGet untuk Solusi dan cari "Snowflake.Data")
Alternatifnya, paket juga dapat diunduh menggunakan Package Manager Console:
PM> Install-Package Snowflake.Data
Mulai dari versi v4.2.0 paket driver ditandatangani dengan tanda tangan yang memungkinkan untuk memverifikasi keaslian dan integritasnya. Langkah-langkah untuk memverifikasi tanda tangan:
cosign
.nupkg
) dari nuget, misal: 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
Menjalankan tes
Cakupan kode
Untuk membuat koneksi, kenali: Metode Koneksi dan Otentikasi
Deskripsi kumpulan koneksi: Beberapa Kumpulan Koneksi.
Pengumpulan sebelum v4.0.0 dijelaskan: Kumpulan Koneksi Tunggal - deprecated
Tipe data kepingan salju dan tipe .NET-nya tercakup dalam: Tipe Data dan Format Data
Cara menjalankan kueri, menggunakan pengikatan kueri, menjalankan kueri secara sinkron dan asinkron: Menjalankan Kueri dan Hasil Membaca
Menggunakan tipe terstruktur: Tipe terstruktur
Menggunakan tipe vektor: Tipe vektor
Menggunakan file tahapan dalam perintah PUT/GET: PUT dan GET File ke/dari Tahap
Deskripsi dan konfigurasi logging: Logging dan Logging Mudah
Metode memvalidasi sertifikat koneksi di driver .NET berbeda dari driver Snowflake lainnya. Baca selengkapnya di dokumen validasi sertifikat.
CVE-2019-0820 - CVE ini telah dilaporkan di system.text.regularexpressions.dll yang digunakan oleh paket ekspresi reguler - system.text.regularexpressions.4.3.1.nupkg. Kerentanan ini HANYA muncul ketika lingkungan runtime .NET berikut ini digunakan:
* 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 telah mengidentifikasi masalah pada 20 Februari 2020, dengan kode logging kami untuk driver .NET tempat kami menulis token Master dan Sesi di log debug. Log debug dikumpulkan secara lokal di drive tempat program Anda berjalan. Masalah ini hanya berdampak pada kejadian di mana program dijalankan dengan tanda debug diaktifkan, yaitu menyetel tingkat log value= "Debug" atau "Semua" di konfigurasi log4Net
Dalam kondisi normal, token Master dan Sesi yang ditangkap dalam file log hanya berumur pendek masing-masing sekitar 4 dan 1 jam. Informasi tersebut akan kedaluwarsa setelah jangka waktu 4 jam kecuali jika disegarkan secara eksplisit, dalam hal ini informasi tersebut dapat disegarkan tanpa batas waktu.
Jika Anda menggunakan driver .NET, silakan lakukan tindakan berikut:
Pengaturan koneksi HTTP global - Snowflake telah mengidentifikasi masalah ketika driver menerapkan TLS 1.2 secara global dan pemeriksaan pencabutan sertifikat dengan .NET Driver v1.2.1 dan versi yang lebih lama. Dimulai dengan v2.0.0, driver akan mengaturnya secara lokal.
Daftar Pencabutan Sertifikat tidak dilakukan ketika insecureMode dinonaktifkan - Snowflake telah mengidentifikasi kerentanan ketika pemeriksaan terhadap Daftar Pencabutan Sertifikat (CRL) tidak dilakukan ketika tanda insecureMode disetel ke false, yang merupakan pengaturan default. Dari versi v2.1.5 CRL berfungsi kembali sebagaimana mestinya.
Driver ini saat ini tidak mendukung endpoint regional GCP. Harap pastikan bahwa beban kerja apa pun yang digunakan melalui driver ini tidak memerlukan dukungan untuk endpoint regional di GCP. Jika Anda memiliki pertanyaan tentang ini, silakan hubungi Dukungan Snowflake.
Perhatikan bahwa driver sekarang menargetkan .NET Standard 2.0. Saat memutakhirkan, Anda mungkin juga perlu menjalankan “Update-Package -reinstall” untuk memperbarui dependensi.
Lihat lebih lanjut: