Partilhar via

Integrar o Banco de Dados do Azure para PostgreSQL - Servidor Flexível com os Serviços Cognitivos do Azure

  • Artigo

A extensão de IA do Azure oferece a capacidade de invocar os Serviços de Linguagem de IA do Azure, como análise de sentimento, diretamente do banco de dados.

Pré-requisitos

  1. Habilite e configure a azure_ai extensão.
  2. Crie um recurso de idioma no portal do Azure para obter sua chave e ponto de extremidade.
  3. Depois de implantar, selecione Ir para recurso.

Nota

Você precisará da chave, do ponto de extremidade e da região do recurso criado para conectar a extensão à API.

Configurar azure_ai extensão com os Serviços Cognitivos do Azure

No recurso Idioma, em Chaves de Gerenciamento de Recursos e Ponto de Extremidade, você pode encontrar o ponto de>extremidade, as chaves e o Local/Região do seu recurso de idioma. Use o ponto de extremidade e a chave para habilitar azure_ai a extensão para invocar a implantação do modelo. A configuração Local/Região só é necessária para a função de tradução.

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álise de sentimentos

A análise de sentimento fornece rótulos de sentimento (negative,positive,neutral) e pontuações de confiança para o texto passado para o 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

batch_size

integer DEFAULT 10 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta chamar novamente o ponto de extremidade do Serviço de Idiomas do Azure para análise de sentimento se ele falhar com qualquer erro que possa ser repetido.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para análise de sentimento, quando ele falha com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.sentiment_analysis_result ou TABLE(result azure_cognitive.sentiment_analysis_result) um único elemento ou uma tabela de coluna única, dependendo da sobrecarga da função usada, com as previsões de sentimento do texto de entrada. Ele contém o sentimento, que pode ser positive, negative, neutral, e mixed; e a pontuação para positivo, neutro e negativo encontrado no texto representado como um número real entre 0 e 1. Por exemplo, em (neutral,0.26,0.64,0.09), o sentimento é neutral com positive pontuação em 0.26, neutro em 0.64 e negativo em 0.09.

Deteção de idioma

A deteção de idioma na IA do Azure deteta automaticamente o idioma de um 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

batch_size

integer DEFAULT 1000 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta chamar novamente o ponto de extremidade do Serviço de Idiomas do Azure para deteção de idioma se ele falhar com qualquer erro que possa ser repetido.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Serviço de Idiomas do Azure para deteção de idioma, quando ele falha com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.language_detection_result ou TABLE(result azure_cognitive.language_detection_result) um único elemento ou uma tabela de coluna única, dependendo da sobrecarga da função usada, com o nome do idioma detetado, sua representação ISO 639-1 de duas letras e o índice de confiança para a deteção. Por exemplo, em (Portuguese,pt,0.97), o idioma é Portuguese, e a confiança de deteção é 0.97.

Extração de expressões-chave

A extração de frases-chave na IA do Azure extrai os principais conceitos de um 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras dos idiomas em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

batch_size

integer DEFAULT 10 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Linguagem do Azure para extração de frase-chave se ele falhar com qualquer erro retentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para extração de frase-chave, quando ele falhar com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

text[] ou TABLE(key_phrases text[]) um único elemento ou uma tabela de coluna única, com as frases-chave identificadas no texto. Por exemplo, se invocado com um text conjunto como 'For more information, see Cognitive Services Compliance and Privacy notes.', e language definido como 'en', ele pode retornar {"Cognitive Services Compliance","Privacy notes",information}.

Associação de entidades

A vinculação de entidades na IA do Azure identifica e desambigua a identidade de entidades encontradas no texto vinculando-as a uma base de dados de conhecimento conhecida.

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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

batch_size

integer DEFAULT 5 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falha com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.linked_entity[] ou TABLE(entities azure_cognitive.linked_entity[]) uma matriz ou uma tabela de coluna única, com as frases-chave identificadas no texto, uma coleção de entidades vinculadas, onde cada uma define o nome, identificador de entidade da fonte de dados, idioma, fonte de dados, URL, coleção de (definindo o texto e a pontuação de confiança) e, finalmente, um identificador de API de pesquisa de azure_cognitive.linked_entity_match entidade do Bing. Por exemplo, se invocado com um text conjunto como 'For more information, see Cognitive Services Compliance and Privacy notes.', e language definido como 'en', ele pode retornar {"(\"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

O recurso de Reconhecimento de Entidade Nomeada (NER) na IA do Azure pode identificar e categorizar entidades em texto não estruturado.

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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

batch_size

integer DEFAULT 5 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falhar com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.entity[] ou TABLE(entities azure_cognitive.entity[]) uma matriz ou uma tabela de coluna única com entidades, onde cada uma define o texto que identifica a entidade, a categoria da entidade e a pontuação de confiança da correspondência. Por exemplo, se invocado com um text conjunto como 'For more information, see Cognitive Services Compliance and Privacy notes.', e language definido como 'en', ele pode retornar {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Deteção de dados pessoalmente identificáveis (PII)

Identifica os dados de PII encontrados no texto de entrada e categoriza essas entidades em 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

domain

text DEFAULT 'none'::text, o domínio de dados pessoais utilizado para o Reconhecimento de Entidades de dados pessoais. Os valores válidos são none para nenhum domínio especificado e phi para Informações Pessoais de Saúde.

batch_size

integer DEFAULT 5 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT true o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falhar com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.pii_entity_recognition_result ou TABLE(result azure_cognitive.pii_entity_recognition_result) um único valor ou uma tabela de coluna única contendo o texto editado e entidades como azure_cognitive.entity[]. Cada entidade contém o texto não redigido, a categoria de dados pessoais, a subcategoria e uma pontuação que indica a confiança de que a entidade corresponde corretamente à subcadeia de caracteres identificada. Por exemplo, se invocado com um text conjunto como 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.', e language definido como 'en', ele pode retornar ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

Resumo de documentos

A sumarização de documentos usa técnicas de processamento de linguagem natural para gerar um resumo para documentos.

azure_cognitive.summarize_abstractive

O resumo abstrato do documento produz um resumo que pode não usar as mesmas palavras no documento, mas ainda captura a ideia 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

sentence_count

integer DEFAULT 3, número máximo de frases que o resumo deve conter.

batch_size

integer DEFAULT 25 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falhar com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

text[] ou TABLE(summaries text[]) uma matriz ou um quadro de resumos de coluna única com cada um deles não excedendo o definido sentence_count. Por exemplo, se invocado com um text conjunto como '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.', e language definido como 'en', ele pode retornar {"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

O resumo extrativo de documentos produz um resumo extraindo frases-chave dentro do 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 ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

sentence_count

integer DEFAULT 3, número máximo de frases a extrair.

sort_by

text DEFAULT ``offset``::text, ordem das sentenças extraídas. Os valores válidos são rank e offset.

batch_size

integer DEFAULT 25 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro input é do tipo text[]).

disable_service_logs

boolean DEFAULT false o Serviço de idiomas registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade para true desativar o log de entrada e pode limitar nossa capacidade de investigar problemas que ocorrem.

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falhar com qualquer erro tentável.

Para obter mais informações, consulte Notas de conformidade e privacidade dos serviços cognitivos em https://aka.ms/cs-compliance, e Princípios de IA responsável da Microsoft em https://www.microsoft.com/ai/responsible-ai.

Tipo de retorno

azure_cognitive.sentence[] ou TABLE(sentences azure_cognitive.sentence[]) uma matriz ou uma tabela de coluna única de frases extraídas juntamente com sua pontuação de classificação.
Por exemplo, se invocado com um text conjunto como '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.', e language definido como 'en', ele pode retornar {"(\"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)"}.

Tradução linguística

A Tradução de Texto do Azure AI permite uma tradução rápida e precisa para os idiomas de destino em tempo 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

A tradução só está disponível na versão 0.2.0 da extensão azure_ai. Para verificar a versão, verifique a pg_available_extensions visualização do catálogo.

select * from pg_available_extensions where name = 'azure_ai';

Argumentos

Para obter mais informações sobre parâmetros, consulte API do tradutor.

text

text ou text[] texto único ou matriz de textos, dependendo da sobrecarga da função utilizada, com a entrada a ser processada.

target_language

text ou text[] valor único ou matriz de valores, dependendo da sobrecarga da função usada, com a representação ISO 639-1 de duas letras da linguagem em que a entrada está escrita. Verifique o suporte ao idioma para valores permitidos.

source_language

text DEFAULT NULL Representação ISO 639-1 de duas letras da língua em que o texto de entrada está escrito. Verifique o suporte ao idioma para valores permitidos. Se não for especificado, a deteção automática de idioma será aplicada para determinar o idioma de origem.

text_type

boolean DEFAULT 'plain' Define o tipo de texto que está sendo traduzido. Os valores válidos são 'plain' ou 'html'. Qualquer HTML precisa ser bem formado.

profanity_action

boolean DEFAULT 'NoAction' Especifica como os palavrões são tratados nas traduções. Os valores válidos são 'NoAction', 'Marked' ou 'Deleted'. 'NoAction' é o comportamento padrão e os palavrões passam da fonte para o alvo. «Suprimido» indica que as palavras profanas são removidas sem substituição. 'Marcado' substitui a palavra marcada na saída pelo parâmetro profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' Especifica como os palavrões são marcados nas traduções. Os valores possíveis são 'Asterisk' que substitui palavras profanas por *** ou 'Tag' que substitui palavras profanas por tags '<profanidade></palavrões>'.

suggested_source_language

text DEFAULT NULL Especifica o idioma de fallback se o idioma do texto de entrada não puder ser identificado.

source_script

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

target_script

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

batch_size

integer DEFAULT 1000 número de registos a processar de cada vez (apenas disponível para a sobrecarga da função para a qual o parâmetro text é do tipo text[]).

timeout_ms

integer DEFAULT 3600000 tempo limite em milissegundos após o qual a operação é interrompida.

throw_on_error

boolean DEFAULT true em erro, se a função lançar uma exceção, resultando em uma reversão de transações de encapsulamento.

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta novamente chamar o ponto de extremidade do Serviço de Idiomas do Azure para identidades vinculadas se ele falhar com qualquer erro tentável.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Serviço de Linguagem do Azure para identidades vinculadas, quando ele falhar com qualquer erro tentável.

Tipo de retorno

azure_cognitive.translated_text_result ou TABLE(result azure_cognitive.translated_text_result) uma matriz ou uma tabela de coluna única de textos traduzidos. Os detalhes do corpo da resposta podem ser encontrados no corpo da resposta.

Exemplos

Exemplos de análise de sentimento

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

Exemplos de sumarização

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

Exemplos de tradução

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

Exemplos de deteção de dados pessoais

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

Conteúdos relacionados