Partager via

Intégrer Azure Database pour PostgreSQL – Serveur flexible à Azure Cognitive Services

  • Article

L’extension Azure AI permet d’appeler les Services d’Azure AI Language tels que l’analyse des sentiments directement à partir de la base de données.

Prérequis

  1. Activez et configurez l’extension azure_ai.
  2. Créez une ressource de langue dans le portail Azure pour obtenir votre clé et votre point de terminaison.
  3. À la fin du déploiement, sélectionnez Accéder à la ressource.

Remarque

Vous aurez besoin de la clé, du point de terminaison et de la région de la ressource que vous créez pour connecter l'extension à l'API.

Configurer l’extension azure_ai avec Azure Cognitive Services

Dans la ressource Langue, sous Gestion des ressources>Clés et points de terminaison, vous pouvez trouver le point de terminaison, les clés et l'emplacement/la région de votre ressource linguistique. Utilisez le point de terminaison et la clé pour activer l’extension azure_ai afin d’appeler le modèle de déploiement. Le paramètre Emplacement/Région n’est requis que pour la fonction de traduction.

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

analyse de sentiments

L’analyse des sentiments fournit des étiquettes de sentiments (negative,positive,neutral) et des scores de confiance pour le texte passé au modèle.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

batch_size

integer DEFAULT 10 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour l’analyse des sentiments en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour l’analyse des sentiments, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.sentiment_analysis_result ou TABLE(result azure_cognitive.sentiment_analysis_result) Élément unique ou table à colonne unique, selon la surcharge de la fonction utilisée, avec les prédictions de sentiments du texte d’entrée. Il contient le sentiment, qui peut être positive, negative, neutral et mixed, et le score positif, neutre et négatif trouvé dans le texte représenté sous la forme d’un nombre réel compris entre 0 et 1. Par exemple, dans (neutral,0.26,0.64,0.09), le sentiment est neutral avec un score positive à 0.26, neutre à 0.64 et négatif à 0.09.

Détection de langue

La détection de langue dans Azure AI détecte automatique la langue d’un document.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

batch_size

integer DEFAULT 1000 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour la détection de la langue, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour la détection de la langue, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.language_detection_result ou TABLE(result azure_cognitive.language_detection_result) Élément unique ou table à colonne unique, en fonction de la surcharge de la fonction utilisée, avec le nom de la langue détectée, sa représentation ISO 639-1 à deux lettres et le score de confiance pour la détection. Par exemple, dans (Portuguese,pt,0.97), la langue est Portuguese avec une confiance de détection de 0.97.

Extraction de phrases clés

L’extraction de phrases clés dans Azure AI extrait les principaux concepts d’un texte.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres des langues dans lesquelles l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

batch_size

integer DEFAULT 10 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour l’extraction d’expressions clés, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour l’extraction d’expressions clés, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

text[] ou TABLE(key_phrases text[]) Élément unique ou table à colonne unique, avec les expressions clés identifiées dans le texte. Par exemple, si vous l’appelez avec text défini sur 'For more information, see Cognitive Services Compliance and Privacy notes.' et language défini sur 'en', vous pouvez obtenir en retour {"Cognitive Services Compliance","Privacy notes",information}.

Liaison d’entités

La liaison d’entités dans Azure AI identifie et clarifie l’identité des entités trouvées dans un texte en les reliant à une base de connaissances bien connue.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

batch_size

integer DEFAULT 5 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.linked_entity[] ou TABLE(entities azure_cognitive.linked_entity[]) Tableau ou table à colonne unique, avec les expressions clés identifiées dans le texte, une collection d’entités liées, où chacune définit le nom, l’identificateur d’entité de la source de données, la langue, la source de données, l’URL, la collection de azure_cognitive.linked_entity_match (définissant le texte et le score de confiance) et enfin un identificateur d’API de recherche d’entités de Bing. Par exemple, si vous l’appelez avec text défini sur 'For more information, see Cognitive Services Compliance and Privacy notes.' et language défini sur 'en', vous pouvez obtenir en retour {"(\"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

La fonctionnalité Reconnaissance d’entité nommée (NER) dans Azure AI peut identifier et classer des entités dans du texte non structuré.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

batch_size

integer DEFAULT 5 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.entity[] ou TABLE(entities azure_cognitive.entity[]) Tableau ou table à colonne unique avec des entités, où chacune définit le texte identifiant l’entité, la catégorie de l’entité et le score de confiance de la correspondance. Par exemple, si vous l’appelez avec text défini sur 'For more information, see Cognitive Services Compliance and Privacy notes.' et language défini sur 'en', vous pouvez obtenir en retour {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Détection des données personnellement identifiables (PII)

Identifie les données d’informations d’identification personnelle trouvées dans le texte d’entrée et classe ces entités en types.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

domain

text DEFAULT 'none'::text, le domaine de données personnelles utilisé pour la reconnaissance d’entités de données personnelles. Les valeurs valides sont none pour aucun domaine spécifié et phi pour les informations d’intégrité personnelle.

batch_size

integer DEFAULT 5 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT true : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.pii_entity_recognition_result ou TABLE(result azure_cognitive.pii_entity_recognition_result) Valeur unique ou table à colonne unique contenant le texte rédigé et les entités en tant que azure_cognitive.entity[]. Chaque entité contient le texte non supprimé, la catégorie de données personnelles, la sous-catégorie, et un score indiquant le degré de confiance dans la correspondance de l’entité avec le substring identifié. Par exemple, si vous l’appelez avec text défini sur 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.' et language défini sur 'en', vous pouvez obtenir en retour ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

Résumé de document

Le résumé des documents utilise des techniques de traitement du langage naturel pour générer un résumé de documents.

azure_cognitive.summarize_abstractive

Le résumé abstractif du document produit un résumé qui n’utilise pas nécessairement les mêmes mots que le document, mais qui en reprend l’idée principale.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

sentence_count

integer DEFAULT 3, nombre maximal de phrases que le résumé doit contenir.

batch_size

integer DEFAULT 25 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

text[] ou TABLE(summaries text[]) Tableau ou table à colonne unique de résumés, chacun ne dépassant pas le sentence_count défini. Par exemple, si vous l’appelez avec text défini sur '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.' et language défini sur 'en', vous pouvez obtenir en retour {"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

Résumé extractif du document : produit un résumé en extrayant des phrases saillantes du document.

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)

Arguments

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

sentence_count

integer DEFAULT 3, nombre maximal de phrases à extraire.

sort_by

text DEFAULT ``offset``::text, ordre des phrases extraites. Les valeurs valides sont rank et offset.

batch_size

integer DEFAULT 25 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre input est de type text[]).

disable_service_logs

boolean DEFAULT false : le service Language consigne votre texte d’entrée pendant 48 heures uniquement pour permettre la résolution des problèmes. La définition de cette propriété sur true désactive la journalisation des entrées et peut limiter notre capacité à examiner les problèmes qui se produisent.

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Pour plus d’informations, consultez les notes de conformité et de confidentialité de Cognitive Services à https://aka.ms/cs-compliance et les principes d’IA responsable de Microsoft à https://www.microsoft.com/ai/responsible-ai.

Type renvoyé

azure_cognitive.sentence[] ou TABLE(sentences azure_cognitive.sentence[]) Tableau ou table à colonne unique de phrases extraites, ainsi que leur score de classement.
Par exemple, si vous l’appelez avec text défini sur '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.' et language défini sur 'en', vous pouvez obtenir en retour {"(\"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)"}.

Traduction linguistique

Azure AI Text Translation permet une traduction rapide et précise dans les langues cibles en temps réel.

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)

Remarque

La traduction n'est disponible que dans la version 0.2.0 de l'extension azure_ai. Pour vérifier la version, vérifiez l’affichage catalogue pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Arguments

Pour plus d’informations sur les paramètres, consultez l’API Translator.

text

text ou text[] Texte unique ou tableau de textes, en fonction de la surcharge de la fonction utilisée, avec l’entrée à traiter.

target_language

text ou text[] : valeur unique ou tableau de valeurs, en fonction de la surcharge de la fonction utilisée, avec la représentation ISO 639-1 à deux lettres de la langue dans laquelle l’entrée est écrite. Consultez prise en charge du langage pour connaître les valeurs autorisées.

source_language

text DEFAULT NULL représentation à deux lettres de la norme ISO 639-1 de la langue dans laquelle le texte d’entrée est écrit. Consultez prise en charge du langage pour connaître les valeurs autorisées. Si cela n'est pas spécifié, la détection automatique de la langue est appliquée pour déterminer la langue source.

text_type

boolean DEFAULT 'plain' Définit le type de texte en cours de traduction. Les valeurs valides sont « plain » ou « html ». Tout code HTML doit être bien formé.

profanity_action

boolean DEFAULT 'NoAction' Spécifie comment les grossièretés sont traitées dans les traductions. Les valeurs valides sont « NoAction », « Marquées » ou « Supprimées ». « NoAction » est le comportement par défaut et la profanité passe de la source à la cible. 'Supprimé' indique que les mots profanes sont supprimés sans remplacement. 'Marqué' remplace le mot marqué dans la sortie par le paramètre profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' Spécifie la façon dont les profanités sont marquées dans les traductions. Les valeurs possibles sont « Asterisk » qui remplace les mots grossiers par *** ou « Tag » qui remplace les mots grossiers par les balises « <blasphème></blasphème> ».

suggested_source_language

text DEFAULT NULL Spécifie la langue de secours si la langue du texte saisi ne peut pas être identifiée.

source_script

text DEFAULT NULL Script spécifique du texte saisi.

target_script

text DEFAULT NULL Script spécifique du texte saisi.

batch_size

integer DEFAULT 1000 Nombre d’enregistrements à traiter à la fois (disponible uniquement pour la surcharge de la fonction pour laquelle le paramètre text est de type text[]).

timeout_ms

Délai d’expiration de integer DEFAULT 3600000 en millisecondes après lequel l’opération est arrêtée.

throw_on_error

boolean DEFAULT true sur l’erreur si la fonction doit lever une exception entraînant une restauration des transactions d’enveloppement.

max_attempts

integer DEFAULT 1 : nombre de fois où l’extension réessaye d’appeler le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

retry_delay_ms

integer DEFAULT 1000 : durée (en millisecondes) pendant laquelle l’extension attend avant d’appeler à nouveau le point de terminaison Azure Language Service pour les identités liées, en cas d’échec causé par une erreur récupérable quelconque.

Type renvoyé

azure_cognitive.translated_text_result ou TABLE(result azure_cognitive.translated_text_result) Tableau ou table à colonne unique de textes traduits. Vous trouverez les détails du corps de la réponse dans le corps de la réponse.

Exemples

Exemples d’analyse des sentiments

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

Exemples de résumé

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

Exemples de traduction

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

Exemples de détection de données personnelles

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

Contenu connexe