整合適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器與 Azure 認知服務 (部分機器翻譯)

您可使用 Azure AI 延伸模組直接從資料庫內叫用 Azure AI 語言服務，例如情感分析。

必要條件

1. 啟用和設定 azure_ai 延伸模組。
2. 在 Azure 入口網站中建立語言資源，以取得金鑰和端點。
3. 在其部署後，選取 [前往資源]。

注意

您將需要來自所建立資源中的金鑰、端點和區域，將延伸模組連線至該 API。

使用 Azure 認知服務設定 azure_ai 延伸模組

在 [語言資源] 的 [資源管理]>[金鑰和端點] 下，您可以找到語言資源的端點、金鑰和位置/區域。 使用端點和金鑰來啟用 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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行情感分析的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行情感分析之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 AI 準則。

傳回類型

azure_cognitive.sentiment_analysis_result 或 TABLE(result azure_cognitive.sentiment_analysis_result) 單一元素或單一資料行表格具體取決於函式的多載，以及輸入文字的情感預測。 其中包含情緒，可以是 positive、negative、neutral 和 mixed；以及文字中發現的積極、中立及消極的分數表示為介於 0 到 1 之間的實數。 例如，在 (neutral,0.26,0.64,0.09) 中，情緒為 neutral、positive 分數為 0.26，中立分數為 0.64 且消極分數為 0.09。

語言偵測

Azure AI 中的語言偵測會自動偵測文件的語言。

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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行語言偵測的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行語言偵測之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 AI 準則。

傳回類型

azure_cognitive.language_detection_result 或 TABLE(result azure_cognitive.language_detection_result) 單一元素或單一資料行表格，具體取決於函式的多載、偵測到的語言名稱、其雙字母 ISO 639-1 表示法，以及偵測的信賴分數。 例如，在 (Portuguese,pt,0.97) 中，語言為 Portuguese，且偵測信賴度為 0.97。

關鍵片語擷取

Azure AI 中的關鍵片語擷取會擷取文字中的主要概念。

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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行關鍵片語擷取的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行關鍵片語擷取之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 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 AI 中的實體連結識別並釐清在文字中找到的實體身分識別，並將其連結至已知的知識庫。

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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

disable_service_logs

boolean DEFAULT false 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 AI 準則。

傳回類型

azure_cognitive.linked_entity[] 或 TABLE(entities azure_cognitive.linked_entity[]) 陣列或單一資料行表格，包含文字中識別關鍵片語、連結實體的集合，其中每個都會定義名稱、資料來源實體識別碼、語言、資料來源、URL、azure_cognitive.linked_entity_match 的集合 (定義文字和信賴分數)，最後是 Bing 實體搜尋 API 識別碼。 例如，如果在呼叫時將 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

Azure AI 中的具名實體辨識 (NER) 功能可在非結構化文字中識別和分類實體。

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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 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 語言服務會將您的輸入文字記錄 48 小時，僅用於疑難排解問題。 將此屬性設定為 true 後，輸入記錄會停用，並可能會限制我們調查所發生問題的能力。

timeout_ms

作業停止之前的 integer DEFAULT 3600000 逾時 (以毫秒為單位)。

throw_on_error

boolean DEFAULT true 如果發生錯誤，函式會擲回例外狀況導致換行交易復原。

max_attempts

integer DEFAULT 1 延伸模組會重試呼叫 Azure 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

如需詳細資訊，請參閱 https://aka.ms/cs-compliance 的認知服務合規性和隱私權注意事項，以及 https://www.microsoft.com/ai/responsible-ai 的 Microsoft 負責任 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 AI 文字翻譯支援即時快速且精確地進行目標語言翻譯。

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)

注意

翻譯僅在 azure_ai 延伸模組 0.2.0 版中可用。 若要檢查版本，請檢查 pg_available_extensions 目錄檢視。

select * from pg_available_extensions where name = 'azure_ai';

引數

如需參數的詳細資訊，請參閱翻譯工具 API。

text

text 或 text[] 單一文字或文字陣列，具體取決於所使用函式的多載，以及要處理的輸入。

target_language

text 或 text[] 單一值或值陣列，具體取決於所使用函式的多載，以及寫入輸入所用語言的雙字母 ISO 639-1 表示法。 檢查語言支援，以了解允許的值。

source_language

text DEFAULT NULL寫入輸入文字所用語言的雙字母 ISO 639-1 表示法。 檢查語言支援，以了解允許的值。 如果未指定，則會套用自動語言偵測來判斷來源語言。

text_type

boolean DEFAULT 'plain' 定義要翻譯的文字類型。 有效值為「plain」或「html」。 任何 HTML 都必須格式正確。

profanity_action

boolean DEFAULT 'NoAction' 指定在翻譯時如何處理不雅內容。 有效值為「NoAction」、「Marked」或「Deleted」。 「NoAction」是預設行為，而且不雅內容會從來源傳遞至目標。 「Deleted」表示不取代的情況下刪除不雅字詞。 「Marked」用 profanity_marker 參數取代輸出中的標記字詞。

profanity_marker

boolean DEFAULT 'Asterisk' 指定在翻譯時如何標記不雅內容。 可能的值為「Asterisk」或「Tag」，前者表示用 *** 取代不雅字詞，後者表示用「<profanity></profanity>」標記取代不雅字詞。

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 語言服務端點以進行連結身分識別的次數 (如果其失敗並出現任何可重試的錯誤)。

retry_delay_ms

integer DEFAULT 1000 擴充功能再次呼叫 Azure 語言服務端點以進行連結身分識別之前等待的時間 (毫秒)(如果其失敗並出現任何可重試的錯誤)。

傳回類型

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

相關內容

• 深入了解 Azure OpenAI 服務整合
• 深入了解 Azure Machine Learning 整合
• 在 適用於 PostgreSQL 的 Azure 資料庫 中產生向量內嵌 - 具有本機部署 LLM 的彈性伺服器 （預覽版） 。
• 整合 適用於 PostgreSQL 的 Azure 資料庫 與 Azure 機器學習 服務。
• 在 適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器中使用 Azure OpenAI 產生向量內嵌。
• 適用於 PostgreSQL 的 Azure 資料庫 中的 Azure AI 擴充功能 - 彈性伺服器。
• 具有 適用於 PostgreSQL 的 Azure 資料庫 的 Generative AI - 彈性伺服器。
• 具有 適用於 PostgreSQL 的 Azure 資料庫 的建議系統 - 彈性伺服器和 Azure OpenAI。
• 具有 適用於 PostgreSQL 的 Azure 資料庫 的語意搜尋 - 彈性伺服器和 Azure OpenAI。
• 在 適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器中啟用及使用 pgvector。