Condividi tramite

Integrare Database di Azure per PostgreSQL - Server flessibile con Servizi cognitivi di Azure

  • Articolo

L'estensione Azure per intelligenza artificiale offre la possibilità di richiamare i Servizi di Lingua di Azure AI, ad esempio l'analisi del sentiment, direttamente dal database.

Prerequisiti

  1. Abilitare e configurare l'azure_aiestensione.
  2. Creare una risorsa di Linguaggio nel portale di Azure per ottenere la chiave e l'endpoint.
  3. Al termine della distribuzione, fare clic su Vai alla risorsa.

Nota

Saranno necessari la chiave, l'endpoint e l'area dalla risorsa creata per connettere l'estensione all'API.

Configurare l'estensione azure_ai con Servizi cognitivi di Azure

Nella risorsa Lingua, in Gestione risorse>Chiavi ed endpoint è possibile trovare l'endpoint, le chiavi e la posizione/area per la risorsa della lingua. Usare l'endpoint e la chiave per abilitare l'estensione azure_ai per richiamare la distribuzione del modello. L'impostazione Posiz/Area è necessaria solo per la funzione di conversione.

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

Analisi valutazione

L'analisi del sentiment fornisce etichette di sentiment (negative,positive,neutral) e punteggi di attendibilità per il testo passato al modello.

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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

batch_size

integer DEFAULT 10 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per l'analisi del sentiment in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare di nuovo l'endpoint del servizio di linguaggio di Azure per l'analisi del sentiment, quando ha esito negativo con qualsiasi errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.sentiment_analysis_result o TABLE(result azure_cognitive.sentiment_analysis_result) un singolo elemento o una tabella a colonna singola, a seconda dell'overload della funzione usata, con le stime del sentiment del testo di input. Contiene il sentiment, che può essere positive, negative, neutral e mixed e il punteggio per positivo, neutro e negativo trovato nel testo rappresentato come numero reale compreso tra 0 e 1. Ad esempio, in (neutral,0.26,0.64,0.09), il sentiment è neutral con punteggio positive su 0.26, neutro su 0.64 e negativo su 0.09.

Rilevamento lingua

Il Rilevamento della lingua in Azure per intelligenza artificiale rileva automaticamente la lingua di 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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

batch_size

integer DEFAULT 1000 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per il rilevamento della lingua in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare di nuovo l'endpoint del servizio di linguaggio di Azure per il rilevamento della lingua, quando ha esito negativo con qualsiasi errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.language_detection_result o TABLE(result azure_cognitive.language_detection_result) un singolo elemento o una tabella a colonna singola, a seconda dell'overload della funzione usata, con il nome della lingua rilevata, la relativa rappresentazione ISO 639-1 a due lettere e il punteggio di attendibilità per il rilevamento. Ad esempio, in (Portuguese,pt,0.97), la lingua è Portuguese e l'attendibilità del rilevamento è 0.97.

Estrazione frasi chiave

Estrazione di frasi chiave in Azure per intelligenza artificiale estrae i concetti principali in un testo.

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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere delle lingue in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

batch_size

integer DEFAULT 10 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per l'estrazione di frasi chiave in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare di nuovo l'endpoint del servizio di linguaggio di Azure per l'estrazione di frasi chiave, quando ha esito negativo con qualsiasi errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

text[] o TABLE(key_phrases text[]) un singolo elemento o una tabella a colonna singola, con le frasi chiave identificate nel testo. Ad esempio, se richiamato con text impostato su 'For more information, see Cognitive Services Compliance and Privacy notes.' e language impostato su 'en', potrebbe restituire {"Cognitive Services Compliance","Privacy notes",information}.

Collegamento di entità

Collegamento di entità in Azure per intelligenza artificiale identifica e disambigua l'identità delle entità trovate nel testo che le collega a una knowledge base nota.

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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

batch_size

integer DEFAULT 5 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.linked_entity[] o TABLE(entities azure_cognitive.linked_entity[]) una matrice o una tabella a colonna singola, con le frasi chiave identificate nel testo, una raccolta di entità collegate, in cui ognuno definisce il nome, l'identificatore dell'entità origine dati, la lingua, l'origine dati, l'URL, la raccolta di azure_cognitive.linked_entity_match (che definisce il testo e il punteggio di attendibilità) e infine un identificatore dell'API ricerca entità Bing. Ad esempio, se richiamato con text impostato su 'For more information, see Cognitive Services Compliance and Privacy notes.' e language impostato su 'en', potrebbe restituire {"(\"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 funzionalità di Riconoscimento entità denominata in Azure per intelligenza artificiale può identificare e classificare le entità in testo non strutturato.

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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

batch_size

integer DEFAULT 5 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.entity[] o TABLE(entities azure_cognitive.entity[]) una matrice o una tabella a colonna singola con entità, ognuna delle quali definisce il testo che identifica l'entità, la categoria dell'entità e il punteggio di attendibilità della corrispondenza. Ad esempio, se richiamato con text impostato su 'For more information, see Cognitive Services Compliance and Privacy notes.' e language impostato su 'en', potrebbe restituire {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Rilevamento di informazioni personali

Identifica le informazioni personali trovate nel testo di input e classifica tali entità in tipi.

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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

domain

text DEFAULT 'none'::text, il dominio delle informazioni personali usato per il riconoscimento delle entità dati personali. I valori validi sono none per nessun dominio specificato e phi per informazioni sull'integrità personali.

batch_size

integer DEFAULT 5 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT true il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.pii_entity_recognition_result o TABLE(result azure_cognitive.pii_entity_recognition_result) un singolo valore o una tabella a colonna singola contenente il testo scritto ed entità come azure_cognitive.entity[]. Ogni entità contiene il testo non crittografato, la categoria di dati personali, la sottocategoria e un punteggio che indica la certezza che l'entità corrisponda correttamente alla substring identificata. Ad esempio, se richiamato con text impostato su 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.' e language impostato su 'en', potrebbe restituire ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

Riepilogo del documento

Il riepilogo dei documenti usa tecniche di elaborazione del linguaggio naturale per generare un riepilogo per i documenti.

azure_cognitive.summarize_abstractive

Il riepilogo astrattivo del documento produce un riepilogo che potrebbe non usare le stesse parole nel documento, ma acquisisce l'idea principale.

azure_cognitive.summarize_abstractive(text text, language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_abstractive(text text[], language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
azure_cognitive.summarize_abstractive(text text[], language text[] DEFAULT NULL::text[], sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

sentence_count

integer DEFAULT 3, numero massimo di frasi che il riepilogo deve contenere.

batch_size

integer DEFAULT 25 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

text[] o TABLE(summaries text[]) una matrice o una tabella a colonna singola di riepiloghi senza superare il valore sentence_countdefinito. Ad esempio, se richiamato con text impostato su '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 impostato su 'en', potrebbe restituire {"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

Il riepilogo estrattivo del documento genera un riepilogo estraendo le frasi salienti all'interno di un 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)

Argomenti

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

sentence_count

integer DEFAULT 3, numero massimo di frasi da estrarre.

sort_by

text DEFAULT ``offset``::text, ordine delle frasi estratte. I valori validi sono rank e offset.

batch_size

integer DEFAULT 25 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro input è di tipo text[]).

disable_service_logs

boolean DEFAULT false il servizio di linguaggio registra il testo di input solo per 48 ore per consentire la risoluzione dei problemi. L'impostazione di questa proprietà su true disabilita la registrazione dell'input e potrebbe limitare la possibilità di analizzare i problemi che si verificano.

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Per altre informazioni, vedere le note sulla conformità e sulla privacy di Servizi cognitivi all'indirizzo https://aka.ms/cs-compliance, nonché i principi di intelligenza artificiale responsabile di Microsoft all'indirizzo https://www.microsoft.com/ai/responsible-ai.

Tipo restituito

azure_cognitive.sentence[] o TABLE(sentences azure_cognitive.sentence[]) una matrice o una tabella a colonna singola di frasi estratte assieme al relativo punteggio di classificazione.
Ad esempio, se richiamato con text impostato su '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 impostato su 'en', potrebbe restituire {"(\"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)"}.

Traduzione linguistica

La traduzione testuale di Azure per intelligenza artificiale consente una traduzione rapida e accurata nelle lingue di destinazione in tempo reale.

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 traduzione è disponibile solo nella versione 0.2.0 dell'estensione azure_ai. Per controllare la versione, esaminare la vista del catalogo pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Argomenti

Per altre informazioni sui parametri, vedere API Traduttore.

text

text o text[] singolo testo o matrice di testi, a seconda dell'overload della funzione usata, con l'input da elaborare.

target_language

text o text[] singolo valore o matrice di valori, a seconda dell'overload della funzione usata, con la rappresentazione ISO 639-1 a due lettere della lingua in cui è scritto l'input. Controllare il supporto lingua per i valori consentiti.

source_language

text DEFAULT NULL rappresentazione ISO 639-1 di due lettere della lingua in cui è scritto il testo di input. Controllare il supporto lingua per i valori consentiti. Se non specificato, viene applicato il rilevamento automatico della lingua per determinare la lingua di origine.

text_type

boolean DEFAULT 'plain' Definisce il tipo di testo da tradurre. I valori validi sono "plain" o "html". Qualsiasi codice HTML deve essere ben formato.

profanity_action

boolean DEFAULT 'NoAction' specifica come deve essere trattato il contenuto volgare nelle traduzioni. I valori validi sono "NoAction", "Marked" o "Deleted". "NoAction" è il comportamento predefinito e il contenuto volgare passa dall'origine alla destinazione. "Deleted" indica che le parole volgari vengono rimosse senza sostituzione. "Marked" sostituisce la parola contrassegnata nell'output con il parametro profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' specifica come deve essere contrassegnato il contenuto volgare nelle traduzioni. I valori possibili sono "Asterisk" che sostituisce le parole volgari con (*) o "Tag" che sostituisce le parole volgari con tag "<volgarity></profanity>".

suggested_source_language

text DEFAULT NULL specifica una lingua di fallback se non è possibile identificare la lingua del testo di input.

source_script

text DEFAULT NULL specifica l'alfabeto del testo di input.

target_script

text DEFAULT NULL specifica l'alfabeto del testo di input.

batch_size

integer DEFAULT 1000 numero di record da elaborare alla volta (disponibile solo per l'overload della funzione per cui il parametro text è di tipo text[]).

timeout_ms

integer DEFAULT 3600000 timeout in millisecondi dopo il quale l'operazione viene arrestata.

throw_on_error

boolean DEFAULT true in caso di errore, la funzione genera un'eccezione che genera un rollback delle transazioni di wrapping.

max_attempts

integer DEFAULT 1 numero di tentativi dell'estensione che chiamano l'endpoint del servizio di linguaggio di Azure per le identità collegate in caso di errore reversibile.

retry_delay_ms

integer DEFAULT 1000 periodo di tempo (in millisecondi) di attesa dell'estensione prima di chiamare nuovamente l'endpoint del servizio di linguaggio di Azure per le identità collegate, quando ha esito negativo con errore reversibile.

Tipo restituito

azure_cognitive.translated_text_result o TABLE(result azure_cognitive.translated_text_result) una matrice o una tabella a colonna singola di testi tradotti. I dettagli del corpo della risposta sono disponibili nel corpo della risposta.

Esempi

Esempi di analisi del sentiment

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

Esempi di riepilogo

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

Esempi di traduzione

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

Esempi di rilevamento dei dati personali

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

Contenuto correlato