SnowflakeSearchTool
الوصف
صُممتSnowflakeSearchTool للاتصال بمستودعات بيانات Snowflake وتنفيذ استعلامات SQL مع ميزات متقدمة مثل تجميع الاتصالات ومنطق إعادة المحاولة والتنفيذ غير المتزامن. تتيح هذه الأداة لوكلاء CrewAI التفاعل مع قواعد بيانات Snowflake، مما يجعلها مثالية لمهام تحليل البيانات وإعداد التقارير وذكاء الأعمال التي تتطلب الوصول إلى بيانات المؤسسة المخزنة في Snowflake.
التثبيت
لاستخدام هذه الأداة، تحتاج إلى تثبيت التبعيات المطلوبة:خطوات البدء
لاستخدامSnowflakeSearchTool بفعالية، اتبع هذه الخطوات:
- تثبيت التبعيات: قم بتثبيت الحزم المطلوبة باستخدام أحد الأوامر أعلاه.
- تكوين اتصال Snowflake: أنشئ كائن
SnowflakeConfigببيانات اعتماد Snowflake الخاصة بك. - تهيئة الأداة: أنشئ نسخة من الأداة بالتكوين اللازم.
- تنفيذ الاستعلامات: استخدم الأداة لتشغيل استعلامات SQL على قاعدة بيانات Snowflake الخاصة بك.
مثال
يوضح المثال التالي كيفية استخدامSnowflakeSearchTool للاستعلام عن البيانات من قاعدة بيانات Snowflake:
Code
Code
المعاملات
معاملات SnowflakeConfig
يقبل صنفSnowflakeConfig المعاملات التالية:
- account: مطلوب. معرّف حساب Snowflake.
- user: مطلوب. اسم مستخدم Snowflake.
- password: اختياري*. كلمة مرور Snowflake.
- private_key_path: اختياري*. مسار ملف المفتاح الخاص (بديل لكلمة المرور).
- warehouse: مطلوب. اسم مستودع Snowflake.
- database: مطلوب. قاعدة البيانات الافتراضية.
- snowflake_schema: مطلوب. المخطط الافتراضي.
- role: اختياري. دور Snowflake.
- session_parameters: اختياري. معاملات جلسة مخصصة كقاموس.
password أو private_key_path.
معاملات SnowflakeSearchTool
تقبلSnowflakeSearchTool المعاملات التالية أثناء التهيئة:
- config: مطلوب. كائن
SnowflakeConfigيحتوي على تفاصيل الاتصال. - pool_size: اختياري. عدد الاتصالات في المجمع. الافتراضي هو 5.
- max_retries: اختياري. الحد الأقصى لمحاولات إعادة المحاولة للاستعلامات الفاشلة. الافتراضي هو 3.
- retry_delay: اختياري. التأخير بين المحاولات بالثواني. الافتراضي هو 1.0.
- enable_caching: اختياري. ما إذا كان سيتم تفعيل التخزين المؤقت لنتائج الاستعلامات. الافتراضي هو True.
الاستخدام
عند استخدامSnowflakeSearchTool، تحتاج إلى توفير المعاملات التالية:
- query: مطلوب. استعلام SQL المراد تنفيذه.
- database: اختياري. تجاوز قاعدة البيانات الافتراضية المحددة في التكوين.
- snowflake_schema: اختياري. تجاوز المخطط الافتراضي المحدد في التكوين.
- timeout: اختياري. مهلة الاستعلام بالثواني. الافتراضي هو 300.
Code
الميزات المتقدمة
تجميع الاتصالات
تُطبّقSnowflakeSearchTool تجميع الاتصالات لتحسين الأداء من خلال إعادة استخدام اتصالات قاعدة البيانات. يمكنك التحكم في حجم المجمع بمعامل pool_size.
إعادة المحاولة التلقائية
تُعيد الأداة تلقائياً محاولة الاستعلامات الفاشلة مع تراجع أسي. يمكنك تكوين سلوك إعادة المحاولة بمعاملاتmax_retries و retry_delay.
التخزين المؤقت لنتائج الاستعلامات
لتحسين أداء الاستعلامات المتكررة، يمكن للأداة تخزين نتائج الاستعلامات مؤقتاً. هذه الميزة مفعّلة افتراضياً ولكن يمكن تعطيلها بتعيينenable_caching=False.
مصادقة زوج المفاتيح
بالإضافة إلى مصادقة كلمة المرور، تدعم الأداة مصادقة زوج المفاتيح لتعزيز الأمان:Code
معالجة الأخطاء
تتضمنSnowflakeSearchTool معالجة شاملة للأخطاء لمشكلات Snowflake الشائعة:
- فشل الاتصال
- انتهاء مهلة الاستعلام
- أخطاء المصادقة
- أخطاء قاعدة البيانات والمخطط
الخلاصة
توفرSnowflakeSearchTool طريقة قوية لدمج مستودعات بيانات Snowflake مع وكلاء CrewAI. مع ميزات مثل تجميع الاتصالات وإعادة المحاولة التلقائية والتخزين المؤقت للاستعلامات، تتيح وصولاً فعالاً وموثوقاً لبيانات المؤسسة. هذه الأداة مفيدة بشكل خاص لمهام تحليل البيانات وإعداد التقارير وذكاء الأعمال التي تتطلب الوصول إلى بيانات منظمة مخزنة في Snowflake.