مشاركة عبر

دمج قاعدة بيانات Azure ل PostgreSQL مع خدمات Azure المعرفية

يمنح ملحق Azure الذكاء الاصطناعي القدرة على استدعاء Azure الذكاء الاصطناعي Language Services مثل تحليل التوجه مباشرة من داخل قاعدة البيانات.

المتطلبات الأساسية

  1. تمكين الملحق وتكوينهazure_ai.
  2. إنشاء مورد Language في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية.
  3. بعد انتشاره، حدد "Go to resource".

إشعار

ستحتاج إلى المفتاح ونقطة النهاية والمنطقة من المورد الذي تقوم بإنشائه لتوصيل الملحق بواجهة برمجة التطبيقات.

تكوين ملحق azure_ai باستخدام Azure Cognitive Services

في مورد اللغة، ضمن مفاتيح إدارة>الموارد ونقطة النهاية، يمكنك العثور على نقطة النهاية والمفاتيح والموقع/المنطقة لمورد اللغة. استخدم نقطة النهاية والمفتاح لتمكين azure_ai الملحق لاستدعاء نشر النموذج. إعداد الموقع/المنطقة مطلوب فقط لدالة الترجمة.

select azure_ai.set_setting('azure_cognitive.endpoint','https://<endpoint>.cognitiveservices.azure.com');
select azure_ai.set_setting('azure_cognitive.subscription_key', '<API Key>');
-- the region setting is only required for the translate function
select azure_ai.set_setting('azure_cognitive.region', '<Region>');

تحليل التوجه

يوفر تحليل المشاعر تسميات المشاعر (negative،positive،neutral ودرجات الثقة للنص الذي تم تمريره إلى النموذج.

azure_cognitive.analyze_sentiment

azure_cognitive.analyze_sentiment(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.analyze_sentiment(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.analyze_sentiment(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

batch_size

integer DEFAULT 10 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service لتحليل التوجه إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى لتحليل التوجه، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.sentiment_analysis_result أو TABLE(result azure_cognitive.sentiment_analysis_result) عنصر واحد أو جدول من عمود واحد، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تنبؤات التوجه لنص الإدخال. يحتوي على التوجه، والذي يمكن أن يكون positiveو negativeneutralو و mixedو ودرجة إيجابية ومحايدة وسلبية موجودة في النص الممثل كعدد حقيقي بين 0 و1. على سبيل المثال في (neutral,0.26,0.64,0.09)، يكون neutral التوجه مع positive درجة في 0.26، محايدة في 0.64 وسلبية في 0.09.

اكتشاف اللغة

الكشف عن اللغة في Azure الذكاء الاصطناعي يكشف تلقائيا عن اللغة التي يحتويها المستند.

azure_cognitive.detect_language

azure_cognitive.detect_language(text text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.detect_language(text text[], batch_size integer DEFAULT 1000, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

batch_size

integer DEFAULT 1000 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للكشف عن اللغة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للكشف عن اللغة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.language_detection_result أو TABLE(result azure_cognitive.language_detection_result) عنصر واحد أو جدول من عمود واحد، اعتمادا على التحميل الزائد للدالة المستخدمة، مع اسم اللغة المكتشفة، وتمثيل ISO 639-1 المكون من حرفين، ودرجة الثقة للكشف. على سبيل المثال في (Portuguese,pt,0.97)، اللغة هي Portuguese، والثقة في الكشف هي 0.97.

استخراج العبارة الرئيسية

استخراج العبارة الرئيسية في Azure الذكاء الاصطناعي يستخرج المفاهيم الرئيسية في نص.

azure_cognitive.extract_key_phrases

azure_cognitive.extract_key_phrases(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.extract_key_phrases(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.extract_key_phrases(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغات التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

batch_size

integer DEFAULT 10 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service لاستخراج العبارة الرئيسية إذا فشلت مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى لاستخراج العبارة الرئيسية، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

text[] أو TABLE(key_phrases text[]) عنصر واحد أو جدول من عمود واحد، مع العبارات الرئيسية المحددة في النص. على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'For more information, see Cognitive Services Compliance and Privacy notes.'، وتعيين language إلى 'en'، فقد يرجع {"Cognitive Services Compliance","Privacy notes",information}.

• ربط الكيانات

يحدد ربط الكيان في Azure الذكاء الاصطناعي هوية الكيانات الموجودة في النص ويفصلها عن قاعدة المعارف (KB) معروف.

azure_cognitive.linked_entities

azure_cognitive.linked_entities(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.linked_entities(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.linked_entities(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

batch_size

integer DEFAULT 5 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.linked_entity[] أو TABLE(entities azure_cognitive.linked_entity[]) صفيف أو جدول من عمود واحد، مع العبارات الرئيسية المحددة في النص، ومجموعة من الكيانات المرتبطة، حيث يعرف كل منها الاسم ومعرف كيان مصدر البيانات واللغة ومصدر البيانات وعنوان URL ومجموعة azure_cognitive.linked_entity_match (تحديد النص ودرجة الثقة) وأخيرا معرف واجهة برمجة تطبيقات بحث كيان Bing. على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'For more information, see Cognitive Services Compliance and Privacy notes.'، وتعيين language إلى 'en'، فقد يرجع {"(\"Cognitive computing\",\"Cognitive computing\",en,Wikipedia,https://en.wikipedia.org/wiki/Cognitive_computing,\"{\"\"(\\\\\"\"Cognitive Services\\\\\"\",0.78)\ "\"}\",d73f7d5f-fddb-0908-27b0-74c7db81cd8d)","(\"Regulatory compliance\",\"Regulatory compliance\",en,Wikipedia,https://en.wikipedia.org/wiki/Regulatory_compliance ,\"{\"\"(Compliance,0.28)\"\"}\",89fefaf8-e730-23c4-b519-048f3c73cdbd)","(\"Information privacy\",\"Information privacy\",en,Wikipedia,https://en.wikipedia.org/wiki /Information_privacy,\"{\"\"(Privacy,0)\"\"}\",3d0f2e25-5829-4b93-4057-4a805f0b1043)"}.

azure_cognitive.recognize_entities

يمكن لميزة التعرف على الكيانات المسماة (NER) في Azure الذكاء الاصطناعي تحديد الكيانات وتصنيفها في نص غير منظم.

azure_cognitive.recognize_entities(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.recognize_entities(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.recognize_entities(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

batch_size

integer DEFAULT 5 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.entity[] أو TABLE(entities azure_cognitive.entity[]) صفيف أو جدول من عمود واحد مع كيانات، حيث يحدد كل منها النص الذي يحدد الكيان وفئة الكيان ودرجة الثقة للمطابقة. على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'For more information, see Cognitive Services Compliance and Privacy notes.'، وتعيين language إلى 'en'، فقد يرجع {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

الكشف عن البيانات الشخصية (PII)

تعريف بيانات PII الموجودة في نص الإدخال وتصنيف هذه الكيانات إلى أنواع.

azure_cognitive.recognize_pii_entities

azure_cognitive.recognize_pii_entities(text text, language text DEFAULT NULL::text, domain text DEFAULT 'none'::text, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.recognize_pii_entities(text text[], language text DEFAULT NULL::text, domain text DEFAULT 'none'::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.recognize_pii_entities(text text[], language text[] DEFAULT NULL::text[], domain text DEFAULT 'none'::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

domain

text DEFAULT 'none'::text، مجال البيانات الشخصية المستخدم للتعرف على كيان البيانات الشخصية. القيم الصالحة هي none لأي مجال محدد ولمعلومات phi الصحة الشخصية.

batch_size

integer DEFAULT 5 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT true تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.pii_entity_recognition_result أو TABLE(result azure_cognitive.pii_entity_recognition_result) قيمة واحدة أو جدول من عمود واحد يحتوي على النص المنقح والكيانات ك azure_cognitive.entity[]. يحتوي كل كيان على النص غير النشط، وفئة البيانات الشخصية، والفئة الفرعية، ودرجة تشير إلى الثقة في أن الكيان يطابق السلسلة الفرعية المحددة بشكل صحيح. على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.'، وتعيين language إلى 'en'، فقد يرجع ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

تلخيص المستند

يستخدم تلخيص المستندات تقنيات معالجة اللغة الطبيعية لإنشاء ملخص للمستندات.

azure_cognitive.summarize_abstractive

ينتج عن التلخيص التجريدي للمستند ملخص قد لا يستخدم نفس الكلمات في المستند ولكنه يلتقط الفكرة الرئيسية.

azure_cognitive.summarize_abstractive(text text, language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_abstractive(text text[], language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_abstractive(text text[], language text[] DEFAULT NULL::text[], sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

sentence_count

integer DEFAULT 3، الحد الأقصى لعدد الجمل التي يجب أن يحتوي عليها التلخيص.

batch_size

integer DEFAULT 25 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

text[] أو TABLE(summaries text[]) صفيف أو جدول من عمود واحد من الملخصات مع كل واحد لا يتجاوز المعرف sentence_count. على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'PostgreSQL features transactions with atomicity, consistency, isolation, durability (ACID) properties, automatically updatable views, materialized views, triggers, foreign keys, and stored procedures. It is designed to handle a range of workloads, from single machines to data warehouses or web services with many concurrent users. It was the default database for macOS Server and is also available for Linux, FreeBSD, OpenBSD, and Windows.'، وتعيين language إلى 'en'، فقد يرجع {"PostgreSQL is a database system with advanced features such as atomicity, consistency, isolation, and durability (ACID) properties. It is designed to handle a range of workloads, from single machines to data warehouses or web services with many concurrent users. PostgreSQL was the default database for macOS Server and is available for Linux, BSD, OpenBSD, and Windows."}.

azure_cognitive.summarize_extractive

ينتج عن التلخيص الاستخراجي للمستند ملخص لاستخراج الجمل الرئيسية داخل المستند.

azure_cognitive.summarize_extractive(text text, language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_extractive(text text[], language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_extractive(text text[], language text[] DEFAULT NULL::text[], sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

الوسيطات

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

sentence_count

integer DEFAULT 3، الحد الأقصى لعدد الجمل المراد استخراجها.

sort_by

text DEFAULT ``offset``::text، ترتيب الجمل المستخرجة. القيم الصالحة هي rank و offset.

batch_size

integer DEFAULT 25 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة input من النوع text[]).

disable_service_logs

boolean DEFAULT false تسجل خدمة Language نص الإدخال لمدة 48 ساعة فقط للسماح باستكشاف الأخطاء وإصلاحها. يؤدي تعيين هذه الخاصية إلى true تعطيل تسجيل الإدخال وقد يحد من قدرتنا على التحقيق في المشكلات التي تحدث.

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

لمزيد من المعلومات، راجع ملاحظات التوافق والخصوصية للخدمات المعرفية في https://aka.ms/cs-compliance، ومبادئ الذكاء الاصطناعي المسؤولة من Microsoft على https://www.microsoft.com/ai/responsible-ai.

نوع الإرجاع

azure_cognitive.sentence[] أو TABLE(sentences azure_cognitive.sentence[]) صفيف أو جدول من عمود واحد من الجمل المستخرجة جنبا إلى جنب مع نقاط الرتبة الخاصة بهم.
على سبيل المثال، إذا تم استدعاؤه مع تعيين text إلى 'PostgreSQL features transactions with atomicity, consistency, isolation, durability (ACID) properties, automatically updatable views, materialized views, triggers, foreign keys, and stored procedures. It is designed to handle a range of workloads, from single machines to data warehouses or web services with many concurrent users. It was the default database for macOS Server and is also available for Linux, FreeBSD, OpenBSD, and Windows.'، وتعيين language إلى 'en'، فقد يرجع {"(\"PostgreSQL features transactions with atomicity, consistency, isolation, durability (ACID) properties, automatically updatable views, materialized views, triggers, foreign keys, and stored procedures.\",0.16)","(\"It is designed to handle a range of workloads, from single machines to data warehouses or web services with many concurrent users.\",0)","(\"It was the default database for macOS Server and is also available for Linux, FreeBSD, OpenBSD, and Windows.\",1)"}.

ترجمة اللغة

تتيح ترجمة نص Azure الذكاء الاصطناعي ترجمة سريعة ودقيقة لاستهداف اللغات في الوقت الفعلي.

azure_cognitive.translate

azure_cognitive.translate(text text, target_language text, source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text DEFAULT NULL::text, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.translate(text text, target_language text[], source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text[] DEFAULT NULL::text[], timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.translate(text text[], target_language text, source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text DEFAULT NULL::text, batch_size integer DEFAULT 1000, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.translate(text text[], target_language text[], source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text[] DEFAULT NULL::text[], batch_size integer DEFAULT 1000, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

إشعار

تتوفر الترجمة فقط في الإصدار 0.2.0 من ملحق azure_ai. للتحقق من الإصدار، تحقق من طريقة عرض الكتالوج pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

الوسيطات

لمزيد من المعلومات حول المعلمات، راجع واجهة برمجة تطبيقات المترجم.

text

text أو text[] نص واحد أو صفيف من النصوص، اعتمادا على التحميل الزائد للدالة المستخدمة، مع الإدخال الذي ستتم معالجته.

target_language

text أو text[] قيمة مفردة أو صفيف من القيم، اعتمادا على التحميل الزائد للدالة المستخدمة، مع تمثيل ISO 639-1 المكون من حرفين للغة التي تتم كتابة الإدخال فيها. تحقق من دعم اللغة للقيم المسموح بها.

source_language

text DEFAULT NULL تمثيل ISO 639-1 من حرفين للغة المكتوب بها نص الإدخال. تحقق من دعم اللغة للقيم المسموح بها. إذا لم يتم تحديده، يتم تطبيق الكشف التلقائي عن اللغة لتحديد لغة المصدر.

text_type

boolean DEFAULT 'plain' تعريف نوع النص الذي تتم ترجمته. القيم الصالحة هي "عادي" أو "html". يجب أن يكون أي HTML جيدا.

profanity_action

boolean DEFAULT 'NoAction' يحدد كيفية التعامل مع الألفاظ النابية في الترجمات. القيم الصالحة هي "NoAction" أو "Marked" أو "Deleted". "NoAction" هو السلوك الافتراضي ويمر الألفاظ النابية من المصدر إلى الهدف. يشير "المحذوف" إلى إزالة الكلمات النابية دون استبدالها. يستبدل "تم وضع علامة" الكلمة التي تم وضع علامة عليها في الإخراج بمعلمة profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' يحدد كيفية وضع علامة على الألفاظ النابية في الترجمات. القيم المحتملة هي "العلامة النجمية" التي تستبدل الكلمات النابية ب *** أو "العلامة" التي تستبدل الكلمات النابية بعلامات "<الألفاظ النابية></الألفاظ> النابية".

suggested_source_language

text DEFAULT NULL تحديد اللغة الاحتياطية إذا تعذر تحديد لغة نص الإدخال.

source_script

text DEFAULT NULL برنامج نصي محدد لنص الإدخال.

target_script

text DEFAULT NULL برنامج نصي محدد لنص الإدخال.

batch_size

integer DEFAULT 1000 عدد السجلات التي يجب معالجتها في كل مرة (متاح فقط للتحميل الزائد للدالة التي لها معلمة text من النوع text[]).

timeout_ms

integer DEFAULT 3600000 المهلة بالمللي ثانية التي يتم بعدها إيقاف العملية.

throw_on_error

boolean DEFAULT true عند الخطأ، يجب أن تطرح الدالة استثناء يؤدي إلى التراجع عن عمليات الالتفاف.

max_attempts

integer DEFAULT 1 عدد المرات التي يعيد فيها الملحق محاولة استدعاء نقطة نهاية Azure Language Service للهويات المرتبطة إذا فشل مع أي خطأ قابل لإعادة المحاولة.

retry_delay_ms

integer DEFAULT 1000 مقدار الوقت (بالمللي ثانية) الذي ينتظره الملحق، قبل استدعاء نقطة نهاية Azure Language Service مرة أخرى للهويات المرتبطة، عندما يفشل مع أي خطأ قابل لإعادة المحاولة.

نوع الإرجاع

azure_cognitive.translated_text_result أو TABLE(result azure_cognitive.translated_text_result) صفيف أو جدول من عمود واحد من النصوص المترجمة. يمكن العثور على تفاصيل نص الاستجابة في نص الاستجابة.

الأمثلة

أمثلة تحليل التوجه

select b.*
from azure_cognitive.analyze_sentiment('The book  was not great, It is mediocre at best','en') b

أمثلة التلخيص

SELECT
    bill_id,
    unnest(azure_cognitive.summarize_abstractive(bill_text, 'en')) abstractive_summary
FROM bill_summaries
WHERE bill_id = '114_hr2499';

أمثلة الترجمة

-- Translate into Portuguese
select  a.*
from azure_cognitive.translate('Language Translation in real time in multiple languages is quite cool', 'pt') a;

-- Translate to multiple languages
select  (unnest(a.translations)).*
from azure_cognitive.translate('Language Translation in real time in multiple languages is quite cool', array['es', 'pt', 'zh-Hans']) a;

أمثلة الكشف عن البيانات الشخصية

select
    'Contoso employee with email Contoso@outlook.com is using our awesome API' as InputColumn,
    pii_entities.*
    from azure_cognitive.recognize_pii_entities('Contoso employee with email Contoso@outlook.com is using our awesome API', 'en') as pii_entities

المحتوى ذو الصلة

  • Last updated on