Compartilhar via

Integrar o Banco de Dados do Azure para PostgreSQL aos Serviços Cognitivos do Azure

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

Pré-requisitos

  1. Habilitar e configurar a extensão azure_ai.
  2. Criar um Recurso de linguagem no portal do Azure para obter a chave e o ponto de extremidade.
  3. Após a implantação, selecione Ir para o recurso.

Observação

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

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

No recurso Idioma, em Gerenciamento de Recursos>Chaves e Ponto de Extremidade, você pode encontrar o ponto de extremidade, as chaves e a localização/região do recurso de idioma. Use o ponto de extremidade e a chave para habilitar extensão azure_ai para invocar a implantação do modelo. A configuração Local/Região é necessária apenas 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 sentimento

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

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

batch_size

integer DEFAULT 10 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para a análise de sentimento se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguardará, antes de chamar novamente o ponto de extremidade do Azure Language Service para análise de sentimento, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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. Contém o sentimento, que pode ser positive, negative, neutral e mixed; e a pontuação para positivo, neutro e negativo encontrada no texto, representada 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.

Detecção de Idioma

A Detecção de Idioma na IA do Azure detecta 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[] único texto ou matriz de textos, dependendo da sobrecarga da função usada, com a entrada a ser processada.

batch_size

integer DEFAULT 1000 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para detecção de idioma se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para detecção de idioma, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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 detectado, sua representação ISO 639-1 de duas letras e a pontuação de confiança para a detecção. Por exemplo, em (Portuguese,pt,0.97), o idioma é Portuguese e a confiança de detecção é 0.97.

Extração de Frases-chave

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

language

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

batch_size

integer DEFAULT 10 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para extração de frases-chave se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda, antes de chamar novamente o ponto de extremidade do Azure Language Service para extração de frases-chave, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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 definido como 'For more information, see Cognitive Services Compliance and Privacy notes.' e language definido como 'en', ele poderá retornar {"Cognitive Services Compliance","Privacy notes",information}.

Vinculação de entidade

Vinculação de entidade na IA do Azure identifica e desambigua a identidade das entidades encontradas no texto que as vincula 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[] único texto ou matriz de textos, dependendo da sobrecarga da função usada, com a entrada a ser processada.

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

batch_size

integer DEFAULT 5 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das transações de encapsulamento.

disable_service_logs

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

max_attempts

integer DEFAULT 1 número de vezes que a extensão tenta chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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, em que cada uma define o nome, o identificador de entidade de fonte de dados, a linguagem, a fonte de dados, a URL, a coleção de azure_cognitive.linked_entity_match (definindo a pontuação de texto e confiança) e, por fim, um identificador de API de pesquisa de entidade do Bing. Por exemplo, se invocado com um text definido como 'For more information, see Cognitive Services Compliance and Privacy notes.' e language definido como 'en', ele poderá 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 do NER (Reconhecimento de Entidade Nomeada) na IA do Azure, pode identificar e categorizar as 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[] único texto ou matriz de textos, dependendo da sobrecarga da função usada, com a entrada a ser processada.

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

batch_size

integer DEFAULT 5 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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, em que cada um 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 definido como 'For more information, see Cognitive Services Compliance and Privacy notes.' e language definido como 'en', ele poderá retornar {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Detecção dos dados de identificação pessoal (PII)

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

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

domain

text DEFAULT 'none'::text, o domínio de dados pessoais usado para o Reconhecimento de Entidade de dados pessoais. Os valores válidos são none para nenhum domínio especificado e phi para as Informações de Integridade Pessoal.

batch_size

integer DEFAULT 5 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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 redigido 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 definido 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 poderá 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)""}").

Sumarização 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

A Sumarização abstrativa do documento produz um resumo que talvez não use as mesmas palavras do documento, mas que ainda assim capta 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[] único texto ou matriz de textos, dependendo da sobrecarga da função usada, com a entrada a ser processada.

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

sentence_count

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

batch_size

integer DEFAULT 25 número de registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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 tabela de coluna única de sumário com cada um não excedendo o sentence_count estabelecido. Por exemplo, se invocado com um text definido 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 poderá 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

A Sumarização extrativa do documento produz um resumo extraindo frases-chave 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[] único texto ou matriz de textos, dependendo da sobrecarga da função usada, com a entrada a ser processada.

language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

sentence_count

integer DEFAULT 3, número máximo de sentenças a serem extraídas.

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 registros a serem processados por vez (disponível apenas 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 idioma registra o texto de entrada por 48 horas apenas para permitir a solução de problemas. Definir essa propriedade como true desabilita o registro em log de entrada e pode limitar nossa capacidade de investigar os 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

Para obter mais informações, consulte as notas de Conformidade e Privacidade dos Serviços Cognitivos em https://aka.ms/cs-compliance e os 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 junto com sua pontuação de classificação.
Por exemplo, se invocado com um text definido 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 poderá 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 de idioma

A Tradução de Texto de IA do Azure permite traduções rápidas e precisas para 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)

Observação

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 exibição do catálogo pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Argumentos

Para obter mais informações sobre parâmetros, veja API do Tradutor.

text

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

target_language

text ou text[] único valor 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 é gravada. Verifique o suporte ao idioma para os valores permitidos.

source_language

text DEFAULT NULL representação ISO 639-1 de duas letras do idioma, em que o texto de entrada é escrito. Verifique o suporte ao idioma para os valores permitidos. Se não for especificado, a detecçã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". Um HTML precisa ser bem formado.

profanity_action

boolean DEFAULT 'NoAction' Especifica como os conteúdos ofensivos devem ser tratados nas traduções. Os valores válidos são “NoAction”, “Marked” ou “Deleted”. "NoAction" é o comportamento padrão e o conteúdo ofensivo passa de origem para destino. 'Deleted' indica que palavras ofensivas são removidas sem substituição. "Marked" substitui a palavra marcada na saída pelo parâmetro profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' Especifica como os conteúdos ofensivos devem ser marcados nas traduções. Os valores possíveis são "Asterisk", que substitui palavras ofensivas por ***, ou "Tag", que substitui palavras ofensivas pelas marcas "<profanity></profanity>".

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 Especifica o script do texto de entrada.

target_script

text DEFAULT NULL Especifica o script do texto de entrada.

batch_size

integer DEFAULT 1000 número de registros a serem processados por vez (disponível apenas 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 caso de erro, a função gera uma exceção resultando em uma reversão das 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 Azure Language Service para identidades vinculadas se falhar com qualquer erro passível de nova tentativa.

retry_delay_ms

integer DEFAULT 1000 quantidade de tempo (milissegundos) que a extensão aguarda antes de chamar novamente o ponto de extremidade do Azure Language Service para identidades vinculadas, quando falhar com qualquer erro passível de nova tentativa.

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 resumo

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 detecçã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údo relacionado

  • Last updated on