Freigeben über

Integrieren von Azure DB for PostgreSQL – Flexibler Server in Azure Cognitive Services

  • Artikel

Die Azure KI-Erweiterung bietet die Möglichkeit, die Azure KI Language-Dienste (etwa die Stimmungsanalyse) direkt in der Datenbank aufzurufen.

Voraussetzungen

  1. Aktivieren und Konfigurieren der azure_ai Erweiterung.
  2. Erstellen einer Sprachressource im Azure-Portal, um Ihren Schlüssel und Endpunkt abzurufen.
  3. Wählen Sie nach Abschluss der Bereitstellung Zu Ressource wechseln aus.

Hinweis

Sie benötigen den Schlüssel, den Endpunkt und die Region der von Ihnen erstellten Ressource, um eine Verbindung der Erweiterung mit der API herstellen zu können.

Konfigurieren der azure_ai-Erweiterung mit Azure Cognitive Services

In der Sprachressource unter Ressourcenverwaltung>Schlüssel und Endpunkt finden Sie den Endpunkt, die Schlüssel, und den Standort/die Region für Ihre Sprachressource. Verwenden Sie den Endpunkt und den Schlüssel, um der Erweiterung azure_ai das Aufrufen der Modellimplementierung zu ermöglichen. Die Einstellung „Standort/Region“ ist nur für die Übersetzungsfunktion erforderlich.

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>');

Standpunktanalyse

Stimmungsanalyse bietet Stimmungsbezeichnungen (negative,positive,neutral) und Zuverlässigkeitsbewertungen für den Text, der an das Modell übergeben wird.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

batch_size

integer DEFAULT 10: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für die Stimmungsanalyse erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für die Stimmungsanalyse erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.sentiment_analysis_result oder TABLE(result azure_cognitive.sentiment_analysis_result), also ein einzelnes Element oder eine einspaltige Tabelle (abhängig von der verwendeten Überladung der Funktion) mit den Stimmungsvorhersagen des Eingabetexts. Er enthält die Stimmung (positive, negative, neutral und mixed) und den Score für positive, neutrale und negative Stimmung im Text, dargestellt als reale Zahl zwischen 0 und 1. In (neutral,0.26,0.64,0.09) ist die Stimmung beispielsweise neutral mit dem Score positive bei 0.26, neutral bei 0.64 und negativ bei 0.09.

Sprachenerkennung

Die Spracherkennung in Azure KI erkennt die Sprache eines Dokuments automatisch.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

batch_size

integer DEFAULT 1000: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für die Spracherkennung erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für die Spracherkennung erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.language_detection_result oder TABLE(result azure_cognitive.language_detection_result), also ein einzelnes Element oder eine einspaltige Tabelle (abhängig von der verwendeten Überladung der Funktion) mit dem erkannten Sprachnamen, der zweistelligen ISO 639-1-Darstellung und der Konfidenzbewertung für die Erkennung. In (Portuguese,pt,0.97) ist die Sprache beispielsweise Portuguese, und die Erkennungssicherheit ist 0.97.

Schlüsselbegriffserkennung

Mit der Schlüsselbegriffserkennung in Azure KI werden die wichtigsten Konzepte in einem Text extrahiert.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprachen der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

batch_size

integer DEFAULT 10: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für die Schlüsselbegriffserkennung erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für die Schlüsselbegriffserkennung erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

text[] oder TABLE(key_phrases text[]), also ein einzelnes Element oder eine einspaltige Tabelle mit den im Text identifizierten Schlüsselbegriffen. Wenn text auf 'For more information, see Cognitive Services Compliance and Privacy notes.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise {"Cognitive Services Compliance","Privacy notes",information} zurückgegeben werden.

Entitätsverknüpfung

Durch die Entitätsverknüpfung wird die Identität von Entitäten im Text erkannt und eindeutig bestimmt, und die Entitäten werden mit einer bekannten Wissensdatenbank verknüpft.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

batch_size

integer DEFAULT 5: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.linked_entity[] oder TABLE(entities azure_cognitive.linked_entity[]), also ein Array oder eine einzelspaltige Tabelle mit den im Text identifizierten Schlüsselbegriffen, einer Auflistung verknüpfter Entitäten, wobei jede den Namen, den Entitätsbezeichner der Datenquelle, die Sprache, die Datenquelle, die URL, die Auflistung von azure_cognitive.linked_entity_match (die den Text und die Konfidenzbewertung definiert) und schließlich einen Bezeichner für die Bing-Entitätssuche-API definiert. Wenn text auf 'For more information, see Cognitive Services Compliance and Privacy notes.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise {"(\"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)"} zurückgegeben werden.

azure_cognitive.recognize_entities

Das NER-Feature (Named Entity Recognition, Erkennung benannter Entitäten) in Azure KI kann Entitäten in unstrukturiertem Text ermitteln und kategorisieren.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

batch_size

integer DEFAULT 5: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.entity[] oder TABLE(entities azure_cognitive.entity[]), also ein Array oder eine einspaltige Tabelle mit Entitäten, wobei jede den Text definiert, der die Entität, die Kategorie der Entität und die Konfidenzbewertung der Übereinstimmung definiert. Wenn text auf 'For more information, see Cognitive Services Compliance and Privacy notes.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise {"(\"Cognitive Services\",Skill,\"\",0.94)"} zurückgegeben werden.

Schutz personenbezogener Daten (PII)

Identifiziert im Eingabetext gefundene personenbezogene Daten und kategorisiert diese Entitäten in Typen.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

domain

text DEFAULT 'none'::text: Die Domäne für personenbezogene Daten, die für die Entitätserkennung personenbezogener Daten verwendet wird. Gültige Werte sind none, wenn keine Domäne angegeben wird, und phi für persönliche Gesundheitsdaten.

batch_size

integer DEFAULT 5: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT true: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.pii_entity_recognition_result oder TABLE(result azure_cognitive.pii_entity_recognition_result), also ein einzelner Wert oder eine einspaltige Tabelle mit dem bearbeiteten Text und Entitäten wie azure_cognitive.entity[]. Jede Entität enthält den nicht bearbeiteten Text, die Kategorie personenbezogener Daten, eine Unterkategorie und eine Bewertung, die die Konfidenz angibt, dass die Entität ordnungsgemäß mit der ermittelten Teilzeichenfolge übereinstimmt. Wenn text auf 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}") zurückgegeben werden.

Dokumentzusammenfassung

Die Dokumentzusammenfassung verwendet Techniken zur Verarbeitung natürlicher Sprache, um eine Zusammenfassung für Dokumente zu erstellen.

azure_cognitive.summarize_abstractive

Die abstrakte Dokumentzusammenfassung generiert eine Zusammenfassung, die möglicherweise nicht dieselben Wörter wie im Dokument verwendet, aber dennoch die Kernaussage erfasst.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

sentence_count

integer DEFAULT 3: Maximale Anzahl von Sätzen, die die Zusammenfassung enthalten soll.

batch_size

integer DEFAULT 25: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

text[] oder TABLE(summaries text[]), also ein Array oder eine einspaltige Tabelle mit Zusammenfassungen, die jeweils den definierten sentence_count nicht übersteigen. Wenn text auf '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.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise {"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."} zurückgegeben werden.

azure_cognitive.summarize_extractive

Die extraktive Dokumentzusammenfassung erstellt eine Zusammenfassung durch Extrahieren von Schlüsselsätzen aus dem Dokument.

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)

Argumente

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

sentence_count

integer DEFAULT 3: Maximale Anzahl der zu extrahierenden Sätze.

sort_by

text DEFAULT ``offset``::text: Reihenfolge der extrahierten Sätze. Gültige Werte sind rank und offset.

batch_size

integer DEFAULT 25: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren input-Parameter den Typ text[] hat).

disable_service_logs

boolean DEFAULT false: Der Sprachdienst protokolliert Ihren Eingabetext nur für 48 Stunden, um die Problembehandlung zu ermöglichen. Wenn Sie diese Eigenschaft auf true festlegen, wird die Protokollierung der Eingaben deaktiviert. Unsere Möglichkeiten, auftretende Probleme zu untersuchen, werden dadurch möglicherweise eingeschränkt.

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Weitere Informationen finden Sie in den Compliance- und Datenschutzhinweisen zu Cognitive Services unter https://aka.ms/cs-compliance und in den Microsoft-Prinzipien für verantwortungsvolle KI unter https://www.microsoft.com/ai/responsible-ai.

Rückgabetyp

azure_cognitive.sentence[] oder TABLE(sentences azure_cognitive.sentence[]), also ein Array oder eine einspaltige Tabelle mit extrahierten Sätzen zusammen mit ihrem Bewertungsscore.
Wenn text auf '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.' und language auf 'en' festgelegt ist, kann bei einem Aufruf beispielsweise {"(\"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)"} zurückgegeben werden.

Sprachübersetzung

Azure KI Text Translation ermöglicht eine schnelle und genaue Übersetzung in Zielsprachen in Echtzeit.

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)

Hinweis

Die Übersetzung ist nur in Version 0.2.0 der Erweiterung „azure_ai“ verfügbar. Um die Version zu überprüfen, überprüfen Sie die Katalogansicht pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Argumente

Weitere Informationen zu Parametern finden Sie unter Übersetzer-API.

text

text oder text[], also einzelner Text oder ein Textarray (abhängig von der verwendeten Überladung der Funktion) mit der zu verarbeitenden Eingabe.

target_language

text oder text[], also ein einzelner Wert oder Wertearray (abhängig von der verwendeten Überladung der Funktion) mit der zweistelligen ISO 639-1-Darstellung der Sprache der Eingabe. Überprüfen Sie die Sprachunterstützung auf zulässige Werte.

source_language

Eine zweistellige ISO 639-1-Darstellung (text DEFAULT NULL) der Sprache, in der der Eingabetext geschrieben ist. Überprüfen Sie die Sprachunterstützung auf zulässige Werte. Wenn dieser Wert nicht angegeben ist, wird die automatische Sprachenerkennung zum Bestimmen der Ausgangssprache verwendet.

text_type

boolean DEFAULT 'plain' definiert den Typ des übersetzten Texts. Gültige Werte sind „plain“ oder „html“. Jeglicher HTML-Code muss wohlgeformt sein.

profanity_action

boolean DEFAULT 'NoAction' gibt an, wie Obszönitäten in Übersetzungen behandelt werden. Gültige Werte sind „NoAction“, „Marked“ oder „Deleted“. „NoAction“ ist das Standardverhalten, bei dem die Obszönität vom Ausgangs- in den Zieltext übernommen wird. „Deleted“ gibt an, dass obszöne Wörter ersatzlos entfernt werden. „Marked“ ersetzt das markierte Wort in der Ausgabe durch den Parameter „profanity_marker“.

profanity_marker

boolean DEFAULT 'Asterisk' gibt an, wie Obszönitäten in Übersetzungen markiert werden. Mögliche Werte sind „Asterisk“, wodurch obszöne Wörter durch *** ersetzt werden, oder „Tag“, wodurch obszöne Wörter durch die Tags <profanity></profanity> ersetzt werden.

suggested_source_language

text DEFAULT NULL gibt eine Fallbacksprache an, wenn die Sprache des Eingabetexts nicht identifiziert werden kann.

source_script

text DEFAULT NULL gibt das Skript des Eingabetexts an.

target_script

text DEFAULT NULL gibt das Skript des Eingabetexts an.

batch_size

integer DEFAULT 1000: Anzahl der Datensätze, die gleichzeitig verarbeitet werden sollen (nur für die Überladung der Funktion verfügbar, deren text-Parameter den Typ text[] hat).

timeout_ms

integer DEFAULT 3600000 Timeout in Millisekunden, nach dem der Vorgang beendet wird.

throw_on_error

boolean DEFAULT true Bei Fehler sollte die Funktion eine Ausnahme auslösen, die zu einem Rollback des Umbruchs von Transaktionen führt.

max_attempts

integer DEFAULT 1: Häufigkeit, mit der die Erweiterung den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

retry_delay_ms

integer DEFAULT 1000: Zeitdauer (Millisekunden), die die Erweiterung wartet, bevor sie den Azure Language Service-Endpunkt für verknüpfte Identitäten erneut aufruft, wenn ein wiederholbarer Fehler auftritt.

Rückgabetyp

azure_cognitive.translated_text_result oder TABLE(result azure_cognitive.translated_text_result), also ein Array oder eine einspaltige Tabelle mit übersetzten Texten. Details zum Antworttext finden Sie im Antworttext.

Beispiele

Beispiele für die Stimmungsanalyse

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

Beispiele für die Zusammenfassung

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

Beispiele für die Übersetzung

-- 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;

Beispiele für die Erkennung personenbezogener Daten

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

Zugehöriger Inhalt