Compartir a través de

Integración del servidor flexible de Azure Database for PostgreSQL con Azure Cognitive Services

  • Artículo

La extensión de Azure AI ofrece la capacidad de invocar los servicios de Lenguaje de Azure AI, como el análisis de sentimiento directamente desde la base de datos.

Requisitos previos

  1. Habilitar y configurar la extensión azure_ai.
  2. Cree un recurso de idioma en Azure Portal para obtener la clave y el punto de conexión.
  3. Tras su implementación, seleccione Ir al recurso.

Nota:

Necesitará la clave, el punto de conexión y la región del recurso que cree para conectar la extensión a la API.

Configurar la extensión azure_ai con Azure Cognitive Services

En el recurso Idioma, en Administración de recursos>Claves y punto de conexión puede encontrar el punto de conexión, las claves y la ubicación/región del recurso de idioma. Use el punto de conexión y la clave para habilitar la extensión azure_ai para invocar la implementación de modelo. La configuración de ubicación/región solo es necesaria para la función de traducción.

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

Análisis de opiniones

El análisis de sentimiento proporciona etiquetas de opinión (negative,positive,neutral) y puntuaciones de confianza para el texto que se pasa al modelo.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

batch_size

integer DEFAULT 10 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintentará la llamada al punto de conexión de Azure Language Service para el análisis de sentimiento si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión antes de llamar de nuevo al punto de conexión de Azure Language Service para el análisis de sentimiento, cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.sentiment_analysis_result o TABLE(result azure_cognitive.sentiment_analysis_result) un único elemento o una tabla de una sola columna, según la sobrecarga de la función utilizada, con las predicciones de opinión del texto de entrada. Contiene la opinión, que puede ser positive, negative, neutral, y mixed; y la puntuación para positivos, neutros y negativos encontrados en el texto representado como un número real entre 0 y 1. Por ejemplo, en (neutral,0.26,0.64,0.09), la opinión es neutral con positive puntuación en 0.26, neutral en 0.64 y negativa en 0.09.

Detección de idioma

La detección de idioma en Azure AI detecta automáticamente el idioma en el que se encuentra un documento.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

batch_size

integer DEFAULT 1000 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para la detección de idioma si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión antes de llamar de nuevo al punto de conexión de Azure Language Service para la detección de idioma, cuando se produce un error de reintento.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.language_detection_result o TABLE(result azure_cognitive.language_detection_result) un único elemento o una tabla de una sola columna, según la sobrecarga de la función utilizada, con el nombre del idioma detectado, su representación ISO 639-1 de dos letras y la puntuación de confianza para la detección. Por ejemplo, en (Portuguese,pt,0.97), el idioma es Portuguese y la confianza de detección es 0.97.

Extracción de frases clave

La extracción de frases clave en Azure AI extrae los conceptos principales de un texto.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

batch_size

integer DEFAULT 10 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para la extracción de frases clave si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para la extracción de frases clave, cuando se produce un error que de reintento.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

text[] o TABLE(key_phrases text[]) un único elemento o una tabla de una sola columna, con las frases clave identificadas en el texto. Por ejemplo, si se invoca con text establecido en 'For more information, see Cognitive Services Compliance and Privacy notes.' y language establecido en 'en', podría devolver {"Cognitive Services Compliance","Privacy notes",information}.

Vinculación de entidad

La vinculación de entidades en Azure AI identifica y desambigua la identidad de las entidades encontradas en un texto vinculándolas a una base de conocimientos conocida.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

batch_size

integer DEFAULT 5 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.linked_entity[] o TABLE(entities azure_cognitive.linked_entity[]) una matriz o una tabla de una sola columna, con las frases clave identificadas en el texto, una colección de entidades vinculadas, donde cada una define el nombre, el identificador de entidad de origen de datos, el idioma, el origen de datos, la dirección URL, la colección de azure_cognitive.linked_entity_match (definición del texto y la puntuación de confianza) y, por último, un identificador de api de búsqueda de entidades de Bing. Por ejemplo, si se invoca con text establecido en 'For more information, see Cognitive Services Compliance and Privacy notes.' y language establecido en 'en', podría devolver {"(\"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 característica Reconocimiento de entidades con nombre (NER) en Azure AI puede identificar y clasificar entidades en texto no estructurado.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

batch_size

integer DEFAULT 5 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas, cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.entity[] o TABLE(entities azure_cognitive.entity[]) una matriz o una tabla de una sola columna con entidades, donde cada una define el texto que identifica la entidad, la categoría de la entidad y la puntuación de confianza de la coincidencia. Por ejemplo, si se invoca con text establecido en 'For more information, see Cognitive Services Compliance and Privacy notes.' y language establecido en 'en', podría devolver {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Detección de datos de identificación personal (PII)

Identifica los datos PII que se encuentran en el texto de entrada y clasifica esas entidades en tipos.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

domain

text DEFAULT 'none'::text, el dominio de datos personales que se usa para el reconocimiento de entidades de datos personales. Los valores válidos son none para ningún dominio especificado y phi para información de salud personal.

batch_size

integer DEFAULT 5 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT true el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas, cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.pii_entity_recognition_result o TABLE(result azure_cognitive.pii_entity_recognition_result) un valor único o una tabla de una sola columna que contiene el texto redactado y las entidades como azure_cognitive.entity[]. Cada entidad contiene el texto no aprobado, la categoría de datos personales, la subcategoría y una puntuación que indica la confianza de que la entidad coincide correctamente con la subcadena identificada. Por ejemplo, si se invoca con text establecido en 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.' y language establecido en 'en', podría devolver ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

Resumen de documento

El resumen de documentos usa técnicas de procesamiento de lenguaje natural para generar un resumen de los documentos.

azure_cognitive.summarize_abstractive

El resumen abstracto de documentos produce un resumen que puede no usar las mismas palabras del documento pero que, sin embargo, capta la idea principal.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

sentence_count

integer DEFAULT 3, número máximo de oraciones que debe contener el resumen.

batch_size

integer DEFAULT 25 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas, cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

text[] o TABLE(summaries text[]) una matriz o una tabla de una sola columna de resúmenes con cada uno que no supere el sentence_countdefinido. Por ejemplo, si se invoca con text establecido en '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.' y language establecido en 'en', podría devolver {"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

Resumen mediante extracción de documentos genera un resumen que extrae oraciones destacadas en el documento.

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)

Argumentos

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

sentence_count

integer DEFAULT 3, número máximo de oraciones que se van a extraer.

sort_by

text DEFAULT ``offset``::text, orden de oraciones extraídas. Los valores válidos son rank y offset.

batch_size

integer DEFAULT 25 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro input es de tipo text[]).

disable_service_logs

boolean DEFAULT false el servicio de idioma registra el texto de entrada durante 48 horas únicamente para permitir la solución de problemas. Establecer esta propiedad en true deshabilita el registro de entrada y podría limitar nuestra capacidad de investigar los problemas que se producen.

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas, cuando se produce un error que se pueda reintentar.

Para más información, consulte las notas sobre el Cumplimiento y la Privacidad de Cognitive Services en https://aka.ms/cs-compliance, y los principios de la IA responsable de Microsoft en https://www.microsoft.com/ai/responsible-ai.

Tipo de valor devuelto

azure_cognitive.sentence[] o TABLE(sentences azure_cognitive.sentence[]) una matriz o una tabla de una sola columna de oraciones extraídas junto con su puntuación de clasificación.
Por ejemplo, si se invoca con text establecido en '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.' y language establecido en 'en', podría devolver {"(\"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)"}.

Traducción de idiomas

La traducción de texto de Azure AI permite una traducción rápida y precisa a idiomas de destino en tiempo real.

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)

Nota:

La traducción solo está disponible en la versión 0.2.0 de la extensión azure_ai. Para comprobar la versión, compruebe la vista de catálogo de pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Argumentos

Para obtener más información sobre los parámetros, consulte API Translator.

text

text o text[] texto único o matriz de textos, en función de la sobrecarga de la función utilizada, con la entrada que se va a procesar.

target_language

text o text[] valor único o matriz de valores, según la sobrecarga de la función utilizada, con la representación ISO 639-1 de dos letras de los idiomas en los que se escribe la entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos.

source_language

text DEFAULT NULL representación ISO 639-1 de dos letras del idioma en el que se escribe el texto de entrada. Compruebe la compatibilidad con idiomas para ver los valores permitidos. Si no se ha especificado, se aplica la detección de idioma automática para determinar el idioma de origen.

text_type

boolean DEFAULT 'plain' Define el tipo de texto que se va a traducir. Los valores válidos son "plain" o "html". Cualquier HTML debe tener un formato correcto.

profanity_action

boolean DEFAULT 'NoAction' Especifica cómo se tratan las palabras soeces en las traducciones. Los valores válidos son "NoAction", "Marked" o "Deleted". "NoAction" es el comportamiento predeterminado y las palabras soeces pasan de origen a destino. "Deleted" indica que las palabras soeces se quitan sin reemplazarse. "Marked" reemplaza la palabra marcada en la salida por el parámetro profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' Especifica cómo se marcan las palabras soeces en las traducciones. Los valores posibles son "Asterisk" que reemplaza palabras profanas por *** o "Tag" que reemplazan palabras profanas por etiquetas "<profanity></profanity>".

suggested_source_language

text DEFAULT NULL Especifica el idioma de reserva si no se puede identificar el idioma del texto de entrada.

source_script

text DEFAULT NULL Script específico del texto de entrada.

target_script

text DEFAULT NULL Script específico del texto de entrada.

batch_size

integer DEFAULT 1000 número de registros que se van a procesar a la vez (solo está disponible para la sobrecarga de la función para la que el parámetro text es de tipo text[]).

timeout_ms

integer DEFAULT 3600000 tiempo de espera en milisegundos después del cual se detiene la operación.

throw_on_error

boolean DEFAULT true en caso de error, la función debe producir una excepción, lo que da lugar a una reversión de las transacciones de ajuste.

max_attempts

integer DEFAULT 1 número de veces que la extensión reintenta la llamada al punto de conexión de Azure Language Service para identidades vinculadas si se produce un error de reintento.

retry_delay_ms

integer DEFAULT 1000 cantidad de tiempo (milisegundos) que espera la extensión, antes de llamar de nuevo al punto de conexión de Azure Language Service para identidades vinculadas, cuando se produce un error que se pueda reintentar.

Tipo de valor devuelto

azure_cognitive.translated_text_result o TABLE(result azure_cognitive.translated_text_result) una matriz o una tabla de una sola columna de textos traducidos. Los detalles del cuerpo de la respuesta se pueden encontrar en el cuerpo de la respuesta.

Ejemplos

Ejemplos de análisis de sentimiento

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

Ejemplos de resumen

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

Ejemplos de traducción

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

Ejemplos de detección de datos personales

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

Contenido relacionado