Udostępnij za pośrednictwem

Integrowanie usługi Azure Database for PostgreSQL — serwer elastyczny z usługami Azure Cognitive Services

  • Artykuł

Rozszerzenie azure AI umożliwia wywoływanie usług azure AI Language Services , takich jak analiza tonacji bezpośrednio z poziomu bazy danych.

Wymagania wstępne

  1. Włącz i skonfiguruj azure_ai rozszerzenie.
  2. Utwórz zasób języka w witrynie Azure Portal, aby uzyskać klucz i punkt końcowy.
  3. Po wdrożeniu wybierz pozycję Przejdź do zasobu.

Uwaga

Będziesz potrzebować klucza, punktu końcowego i regionu z utworzonego zasobu, aby połączyć rozszerzenie z interfejsem API.

Konfigurowanie rozszerzenia azure_ai za pomocą usług Azure Cognitive Services

W zasobie Język w obszarze Klucze zarządzania>zasobami i punkt końcowy można znaleźć punkt końcowy, klucze i lokalizację/region dla zasobu językowego. Użyj punktu końcowego i klucza, aby włączyć azure_ai rozszerzenie w celu wywołania wdrożenia modelu. Ustawienie Lokalizacja/region jest wymagane tylko dla funkcji tłumaczenia.

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

Analiza opinii

Analiza tonacji udostępnia etykiety tonacji (negative,positiveneutral) i oceny ufności tekstu przekazanego do modelu.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

batch_size

integer DEFAULT 10 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure na potrzeby analizy tonacji, jeśli wystąpi błąd z możliwością ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas (w milisekundach) oczekiwania rozszerzenia przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure na potrzeby analizy tonacji, gdy wystąpi błąd z możliwością ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.sentiment_analysis_result lub pojedynczy element lub TABLE(result azure_cognitive.sentiment_analysis_result) jednokolumna tabela w zależności od przeciążenia używanej funkcji z przewidywaniami tonacji tekstu wejściowego. Zawiera tonację, która może być positivewartością , negative, neutrali mixed; oraz wynikiem dla dodatnich, neutralnych i ujemnych znalezionych w tekście reprezentowanym jako liczba rzeczywista z zakresu od 0 do 1. Na przykład w (neutral,0.26,0.64,0.09)pliku tonacja jest neutral z positive wynikiem na 0.26, neutralne na 0.64 i ujemne na 0.09.

Wykrywanie języka

Wykrywanie języka w usłudze Azure AI automatycznie wykrywa język dokumentu.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

batch_size

integer DEFAULT 1000 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure w celu wykrycia języka, jeśli zakończy się niepowodzeniem z powodu błędu możliwego do ponowienia próby.

retry_delay_ms

integer DEFAULT 1000 czas (w milisekundach) oczekiwania rozszerzenia przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure na potrzeby wykrywania języka, gdy wystąpi błąd z możliwością ponowienia próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.language_detection_result lub pojedynczy element lub TABLE(result azure_cognitive.language_detection_result) jednokolumna tabela, w zależności od przeciążenia używanej funkcji, z wykrytą nazwą języka, jego dwuliterową reprezentacją ISO 639-1 i współczynnik ufności wykrywania. Na przykład w systemie (Portuguese,pt,0.97)język to Portuguese, a pewność wykrywania to 0.97.

Wyodrębnianie kluczowych fraz

Wyodrębnianie kluczowych fraz w usłudze Azure AI wyodrębnia główne pojęcia w tekście.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języków, w których zapisano dane wejściowe w formacie ISO 639-1. Sprawdź obsługę języka pod kątem dozwolonych wartości.

batch_size

integer DEFAULT 10 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure w celu wyodrębnienia kluczowych fraz, jeśli wystąpi błąd z możliwością ponowienia próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure na potrzeby wyodrębniania kluczowych fraz, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

text[] lub pojedynczy element lub TABLE(key_phrases text[]) jednokolumna tabela z kluczowymi frazami określonymi w tekście. Jeśli na przykład wywołano element z zestawem text na 'For more information, see Cognitive Services Compliance and Privacy notes.', i language ustawiono wartość 'en', może zwrócić wartość {"Cognitive Services Compliance","Privacy notes",information}.

Łączenie jednostek

Łączenie jednostek w usłudze Azure AI identyfikuje i deambiguje tożsamość jednostek znalezionych w tekście łączącym je z dobrze znanym baza wiedzy.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

batch_size

integer DEFAULT 5 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas (w milisekundach) oczekiwania rozszerzenia przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.linked_entity[] lub tablica lub TABLE(entities azure_cognitive.linked_entity[]) jednokolumna tabela z frazami kluczowymi zidentyfikowanymi w tekście, kolekcją połączonych jednostek, w której każda definiuje nazwę, identyfikator jednostki źródła danych, język, źródło danych, adres URL, kolekcję azure_cognitive.linked_entity_match (definiując tekst i wskaźnik ufności), a na koniec identyfikator interfejsu API wyszukiwania jednostek Bing. Jeśli na przykład wywołano element z zestawem text na 'For more information, see Cognitive Services Compliance and Privacy notes.', i language ustawiono wartość 'en', może zwrócić wartość {"(\"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

Funkcja rozpoznawania jednostek nazwanych (NER) w usłudze Azure AI umożliwia identyfikowanie i kategoryzowanie jednostek w tekście bez struktury.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

batch_size

integer DEFAULT 5 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.entity[] lub tablica lub TABLE(entities azure_cognitive.entity[]) jednokolumna tabela z jednostkami, w których każdy definiuje tekst identyfikujący jednostkę, kategorię jednostki i współczynnik ufności dopasowania. Jeśli na przykład wywołano element z zestawem text na 'For more information, see Cognitive Services Compliance and Privacy notes.', i language ustawiono wartość 'en', może zwrócić wartość {"(\"Cognitive Services\",Skill,\"\",0.94)"}.

Wykrywanie danych osobowych

Identyfikuje dane osobowe znalezione w tekście wejściowym i kategoryzuje te jednostki w typach.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

domain

text DEFAULT 'none'::text, domena danych osobowych używana do rozpoznawania jednostek danych osobowych. Prawidłowe wartości nie są none określone w domenie i phi dla informacji o kondycji osobistej.

batch_size

integer DEFAULT 5 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT true Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.pii_entity_recognition_result lub pojedyncza wartość lub TABLE(result azure_cognitive.pii_entity_recognition_result) jednokolumna tabela zawierająca zredagowany tekst i jednostki jako azure_cognitive.entity[]. Każda jednostka zawiera nieredagowany tekst, kategorię danych osobowych, podkategorię i wynik wskazujący pewność, że jednostka prawidłowo pasuje do zidentyfikowanego podciągu. Jeśli na przykład wywołano element z zestawem text na 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.', i language ustawiono wartość 'en', może zwrócić wartość ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}").

Podsumowanie dokumentów

Podsumowanie dokumentów używa technik przetwarzania języka naturalnego do generowania podsumowania dokumentów.

azure_cognitive.summarize_abstractive

Podsumowanie abstrakcyjne dokumentu tworzy podsumowanie, które może nie używać tych samych słów w dokumencie, ale jeszcze przechwytuje główną ideę.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

sentence_count

integer DEFAULT 3, maksymalna liczba zdań, które powinny zawierać podsumowania.

batch_size

integer DEFAULT 25 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

text[] lub tablica lub TABLE(summaries text[]) jednokolumna tabela podsumowań, z których każda nie przekracza zdefiniowanego sentence_countelementu . Jeśli na przykład wywołano element z zestawem text na '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.', i language ustawiono wartość 'en', może zwrócić wartość {"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

Podsumowanie wyodrębniające dokumentu tworzy podsumowanie wyodrębniania kluczowych zdań w dokumencie.

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)

Argumenty

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

sentence_count

integer DEFAULT 3, maksymalna liczba zdań do wyodrębnienia.

sort_by

text DEFAULT ``offset``::text, kolejność wyodrębnionych zdań. Prawidłowe wartości to rank i offset.

batch_size

integer DEFAULT 25 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr input jest typu text[]).

disable_service_logs

boolean DEFAULT false Usługa językowa rejestruje tekst wejściowy przez 48 godzin wyłącznie w celu umożliwienia rozwiązywania problemów. Ustawienie tej właściwości w celu true wyłączenia rejestrowania danych wejściowych i może ograniczyć możliwość badania występujących problemów.

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Aby uzyskać więcej informacji, zobacz Cognitive Services Compliance and Privacy notes at , and Microsoft Responsible AI principles at https://aka.ms/cs-compliancehttps://www.microsoft.com/ai/responsible-ai.

Typ zwracany

azure_cognitive.sentence[] lub tablica lub TABLE(sentences azure_cognitive.sentence[]) jednokolumna tabela wyodrębnionych zdań wraz z ich oceną rangi.
Jeśli na przykład wywołano element z zestawem text na '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.', i language ustawiono wartość 'en', może zwrócić wartość {"(\"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)"}.

Tłumaczenie języka

Tłumaczenie tekstu w usłudze Azure AI umożliwia szybkie i dokładne tłumaczenie na języki docelowe w czasie rzeczywistym.

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)

Uwaga

Tłumaczenie jest dostępne tylko w wersji 0.2.0 rozszerzenia azure_ai. Aby sprawdzić wersję, sprawdź widok wykazu pg_available_extensions.

select * from pg_available_extensions where name = 'azure_ai';

Argumenty

Aby uzyskać więcej informacji na temat parametrów, zobacz Interfejs API tłumaczenia w usłudze Translator.

text

text lub text[] pojedynczy tekst lub tablica tekstów, w zależności od przeciążenia używanej funkcji, z danymi wejściowymi do przetworzenia.

target_language

text lub text[] pojedyncza wartość lub tablica wartości, w zależności od przeciążenia używanej funkcji, z dwuliterową reprezentacją języka ISO 639-1, w jakim są zapisywane dane wejściowe. Sprawdź obsługę języka pod kątem dozwolonych wartości.

source_language

text DEFAULT NULL dwuliterowa reprezentacja języka ISO 639-1, w jakim jest zapisywany tekst wejściowy. Sprawdź obsługę języka pod kątem dozwolonych wartości. Jeśli nie zostanie określony, automatyczne wykrywanie języka jest stosowane w celu określenia języka źródłowego.

text_type

boolean DEFAULT 'plain' Definiuje typ przetłumaczonego tekstu. Prawidłowe wartości to "zwykły" lub "html". Każdy kod HTML musi być dobrze sformułowany.

profanity_action

boolean DEFAULT 'NoAction' Określa sposób traktowania wulgaryzmów w tłumaczeniach. Prawidłowe wartości to "NoAction", "Oznaczone" lub "Usunięte". "NoAction" jest zachowaniem domyślnym, a wulgaryzm przechodzi od źródła do celu. Polecenie "Usunięte" wskazuje, że wulgarne słowa są usuwane bez zastępowania. Element "Oznaczone" zastępuje oznaczone słowo w danych wyjściowych parametrem profanity_marker.

profanity_marker

boolean DEFAULT 'Asterisk' Określa sposób oznaczania wulgaryzmów w tłumaczeniach. Możliwe wartości to "Gwiazdka", która zastępuje wulgarne słowa *** lub "Tag", który zastępuje wulgarne słowa tagami "<wulgaryzm></wulgaryzm>".

suggested_source_language

text DEFAULT NULL Określa język rezerwowy, jeśli nie można zidentyfikować języka tekstu wejściowego.

source_script

text DEFAULT NULL Określony skrypt tekstu wejściowego.

target_script

text DEFAULT NULL Określony skrypt tekstu wejściowego.

batch_size

integer DEFAULT 1000 liczba rekordów do przetworzenia w danym momencie (dostępna tylko dla przeciążenia funkcji, dla której parametr text jest typu text[]).

timeout_ms

integer DEFAULT 3600000 limit czasu w milisekundach, po którym operacja jest zatrzymana.

throw_on_error

boolean DEFAULT true w przypadku błędu funkcja powinna zgłosić wyjątek powodujący wycofanie transakcji zawijania.

max_attempts

integer DEFAULT 1 ile razy rozszerzenie ponawia próbę wywołania punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, jeśli wystąpi błąd ponawiania próby.

retry_delay_ms

integer DEFAULT 1000 czas oczekiwania rozszerzenia (w milisekundach) przed ponownym wywołaniem punktu końcowego usługi językowej platformy Azure dla połączonych tożsamości, gdy wystąpi błąd ponawiania próby.

Typ zwracany

azure_cognitive.translated_text_result lub tablica lub TABLE(result azure_cognitive.translated_text_result) jednokolumna tabela przetłumaczonych tekstów. Szczegóły treści odpowiedzi można znaleźć w treści odpowiedzi.

Przykłady

Przykłady analizy tonacji

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

Przykłady podsumowań

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

Przykłady tłumaczenia

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

Przykłady wykrywania danych osobowych

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

Powiązana zawartość