يدعم موصل Snowflake .NET إصدارات .NET Framework والمكتبات التالية:
إخلاء المسؤولية: على الرغم من أن الموصل يستهدف 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 UI (الأدوات > NuGet Package Manager > إدارة حزم NuGet للحل والبحث عن "Snowflake.Data")
وبدلاً من ذلك، يمكن أيضًا تنزيل الحزم باستخدام وحدة تحكم إدارة الحزم:
PM> Install-Package Snowflake.Data
بدءًا من الإصدار v4.2.0، يتم توقيع حزمة برنامج التشغيل بتوقيع يسمح بالتحقق من صحتها ونزاهتها. خطوات التحقق من التوقيع:
cosign
.nupkg
) من nuget، على سبيل المثال: 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
تشغيل الاختبارات
تغطية الكود
لإنشاء اتصال، تعرف على: طرق الاتصال والمصادقة
وصف تجمع الاتصال: تجمعات اتصال متعددة.
تم وصف التجميع قبل الإصدار 4.0.0: تجمع اتصال واحد - deprecated
تتم تغطية أنواع بيانات Snowflake وأنواع .NET الخاصة بها في: أنواع البيانات وتنسيقات البيانات
كيفية تنفيذ استعلام، واستخدام روابط الاستعلام، وتشغيل الاستعلامات بشكل متزامن وغير متزامن: تشغيل الاستعلامات ونتائج القراءة
استخدام الأنواع المنظمة: الأنواع المنظمة
استخدام نوع المتجه: نوع المتجه
استخدام ملفات المرحلة ضمن أوامر PUT/GET: PUT وGET Files من/إلى Stage
وصف التسجيل وتكوينه: التسجيل والتسجيل السهل
تختلف طريقة التحقق من صحة شهادات الاتصال في برنامج تشغيل .NET عن بقية برامج تشغيل Snowflake. اقرأ المزيد في مستندات التحقق من صحة الشهادة.
CVE-2019-0820 - تم الإبلاغ عن CVE هذا في Systems.text.regularexpressions.dll الذي تستخدمه حزم التعبيرات العادية - Systems.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.
التسجيل - اكتشف Snowflake مشكلة في 20 فبراير 2020، تتعلق برمز التسجيل الخاص بنا لبرامج تشغيل .NET التي نكتب فيها الرموز المميزة الرئيسية والجلسة بشكل واضح لسجلات تصحيح الأخطاء. يتم جمع سجلات التصحيح محليًا على محرك الأقراص الذي يتم تشغيل برامجك عليه. تؤثر هذه المشكلة فقط على تلك الحالات التي يتم فيها تشغيل البرامج مع تمكين علامات التصحيح، أي تعيين قيمة مستوى السجل = "Debug" أو "All" في تكوين log4Net
في ظل الظروف العادية، تكون الرموز المميزة للجلسة والرئيسية التي تم التقاطها في ملفات السجل قصيرة العمر لمدة 4 وساعة واحدة تقريبًا، على التوالي. وستنتهي صلاحيتها بعد فترة 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. يُرجى التأكد من أن أي أحمال عمل يتم استخدامها من خلال برنامج التشغيل هذا لا تتطلب دعمًا لنقاط النهاية الإقليمية على Google Cloud Platform. إذا كانت لديك أسئلة حول هذا الأمر، فيرجى الاتصال بدعم Snowflake.
لاحظ أن برنامج التشغيل يستهدف الآن .NET Standard 2.0. عند الترقية، قد تحتاج أيضًا إلى تشغيل "Update-Package -reinstall" لتحديث التبعيات.
شاهد المزيد: