다음을 통해 공유

Azure Database for PostgreSQL - 유연한 서버와 Azure Cognitive Services 통합

  • 아티클

Azure AI 확장은 데이터베이스 내에서 감정 분석과 같은 Azure AI 언어 서비스를 바로 호출하는 기능을 제공합니다.

필수 조건

  1. azure_ai 확장을 사용하도록 설정하고 구성합니다.
  2. Azure Portal에서 언어 리소스를 만들어 키와 엔드포인트를 가져옵니다.
  3. 배포 후 리소스로 이동을 선택합니다.

참고 항목

확장을 API에 연결하려면 만든 리소스의 키, 엔드포인트 및 지역이 필요합니다.

Azure Cognitive Services를 사용하여 azure_ai 확장 구성

언어 리소스의 리소스 관리>키 및 엔드포인트에서 언어 리소스의 엔드포인트, 키 및 위치/지역을 찾을 수 있습니다. 모델 배포를 호출하려면 엔드포인트와 키 중 하나를 사용하여 azure_ai 확장을 사용하도록 설정합니다. 위치/지역 설정은 번역 함수에만 필요합니다.

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

감정 분석

감정 분석은 모델에 전달된 텍스트에 대한 감정 레이블(negative,positive,neutral) 및 신뢰도 점수를 제공합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

batch_size

integer DEFAULT 10한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패할 경우 감정 분석을 위해 확장이 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패할 경우 감정 분석을 위해 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.sentiment_analysis_result 또는 TABLE(result azure_cognitive.sentiment_analysis_result) 입력 텍스트의 감정 예측과 함께 사용된 함수의 오버로드에 따라 단일 요소 또는 단일 열 테이블입니다. 여기에 포함되는 감정은 positive, negative, neutral, mixed 등이며, 텍스트에서 발견되는 양수, 중립, 음수에 대한 점수는 0과 1 사이의 실수로 표시됩니다. 예를 들어 (neutral,0.26,0.64,0.09)에서 감정은positive과 neutral이고 0.26에서 점수, 0.64에서 중립, 0.09에서 음수입니다.

언어 감지

Azure AI의 언어 감지는 문서의 언어를 자동으로 검색합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

batch_size

integer DEFAULT 1000한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패할 경우 확장이 언어 감지를 위해 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패할 경우 언어 감지를 위해 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.language_detection_result 또는 TABLE(result azure_cognitive.language_detection_result) 사용된 함수의 오버로드에 따라 검색된 언어 이름, 두 문자로 된 ISO 639-1 표현 및 검색에 대한 신뢰도 점수가 포함된 단일 요소 또는 단일 열 테이블입니다. 예를 들어 (Portuguese,pt,0.97)언어는 Portuguese이며 감지 신뢰도는 0.97입니다.

핵심 구 추출

Azure AI의 핵심 구 추출은 텍스트의 주요 개념을 추출합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

batch_size

integer DEFAULT 10한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패할 경우 확장이 핵심 구 추출을 위해 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패할 경우 핵심 구 추출을 위해 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

text[] 또는 TABLE(key_phrases text[]) 텍스트에 식별된 핵심 구가 포함된 단일 요소 또는 단일 열 테이블입니다. 예를 들어 'For more information, see Cognitive Services Compliance and Privacy notes.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, {"Cognitive Services Compliance","Privacy notes",information}를 반환할 수 있습니다.

엔터티 연결

Azure AI의 엔터티 연결은 잘 알려진 기술 자료에 연결되는 텍스트에서 찾은 엔터티의 ID를 식별하고 모호성을 제거합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

batch_size

integer DEFAULT 5한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.linked_entity[] 또는 TABLE(entities azure_cognitive.linked_entity[]) 텍스트에서 식별된 핵심 구, 연결된 엔터티 컬렉션이 있는 배열 또는 단일 열 테이블입니다. 여기서 각각은 이름, 데이터 원본 엔터티 식별자, 언어, 데이터 원본, URL, azure_cognitive.linked_entity_match 컬렉션(텍스트 및 신뢰도 점수 정의) 및 마지막으로 Bing 엔터티 검색 API 식별자를 정의합니다. 예를 들어 'For more information, see Cognitive Services Compliance and Privacy notes.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, {"(\"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

Azure AI의 NER(명명된 엔터티 인식) 기능은 구조화되지 않은 텍스트로 엔터티를 식별하고 분류할 수 있습니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

batch_size

integer DEFAULT 5한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.entity[] 또는 TABLE(entities azure_cognitive.entity[]) 엔터티가 포함된 배열 또는 단일 열 테이블. 각 엔터티는 엔터티를 식별하는 텍스트, 엔터티 범주 및 일치 신뢰도 점수를 정의합니다. 예를 들어 'For more information, see Cognitive Services Compliance and Privacy notes.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, {"(\"Cognitive Services\",Skill,\"\",0.94)"}를 반환할 수 있습니다.

PII(개인 식별 데이터) 검색

입력 텍스트에서 발견된 PII 데이터를 식별하고 해당 항목을 형식으로 분류합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

domain

text DEFAULT 'none'::text은 개인 데이터 엔터티 인식에 사용되는 개인 데이터 도메인입니다. 유효한 값은 도메인이 지정되지 않은 경우none과 개인 건강 정보에 대한 phi입니다.

batch_size

integer DEFAULT 5한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT true 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.pii_entity_recognition_result 또는 TABLE(result azure_cognitive.pii_entity_recognition_result) 수정된 텍스트와 azure_cognitive.entity[]와 같은 항목을 포함하는 단일 값 또는 단일 열 테이블입니다. 각 엔터티에는 비연속 텍스트, 개인 데이터 범주, 하위 범주, 엔터티가 식별된 부분 문자열과 올바르게 일치한다는 신뢰도를 나타내는 점수가 포함됩니다. 예를 들어 'My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, ("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}")를 반환할 수 있습니다.

문서 요약

문서 요약은 자연어 처리 기술을 사용하여 문서 요약을 생성합니다.

azure_cognitive.summarize_abstractive

문서 추상 요약은 문서에서 동일한 단어를 사용하지 않더라도 주요 아이디어를 캡처하는 요약을 생성합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

sentence_count

integer DEFAULT 3요약에 포함해야 하는 최대 문장 수입니다.

batch_size

integer DEFAULT 25한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

text[] 또는 TABLE(summaries text[]) 각각 정의된 sentence_count를 초과하지 않는 배열 또는 단일 열 요약 테이블입니다. 예를 들어 '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.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, {"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

문서 추출 요약은 문서 내의 핵심 문장을 추출하여 요약을 생성합니다.

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)

인수

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

sentence_count

integer DEFAULT 3, 추출할 최대 문장 수입니다.

sort_by

text DEFAULT ``offset``::text, 추출된 문장의 순서입니다. 유효한 값은 rank 및 offset입니다.

batch_size

integer DEFAULT 25한 번에 처리할 레코드 수(매개 변수 input 형식이 text[]인 함수의 오버로드에만 사용 가능).

disable_service_logs

boolean DEFAULT false 언어 서비스는 문제 해결을 위해 입력 텍스트를 48시간 동안만 기록합니다. 입력 로깅을 사용하지 않도록 true로 설정하면 발생하는 문제를 조사하는 기능이 제한될 수 있습니다.

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

자세한 내용은 Cognitive Services 규정 준수 및 개인 정보 취급 방침 참고 사항 및 https://aka.ms/cs-complianceMicrosoft 책임 AI 원칙https://www.microsoft.com/ai/responsible-ai을 참조하세요.

반환 형식

azure_cognitive.sentence[] 또는 TABLE(sentences azure_cognitive.sentence[]) 순위 점수와 함께 추출된 문장의 배열 또는 단일 열 테이블입니다.
예를 들어 '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.'로 설정된 text을 호출하고 'en'로 설정된 language을 호출하는 경우, {"(\"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)"}를 반환할 수 있습니다.

언어 번역

Azure AI 텍스트 번역을 사용하면 실시간으로 대상 언어로 빠르고 정확하게 번역할 수 있습니다.

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)

참고 항목

번역은 azure_ai 확장 버전 0.2.0에서만 사용할 수 있습니다. 버전을 확인하려면 pg_available_extensions 카탈로그 뷰를 확인합니다.

select * from pg_available_extensions where name = 'azure_ai';

인수

매개 변수에 대한 자세한 내용은 Translator API를 참조하세요.

text

text 또는 text[] 처리할 입력과 함께 사용된 함수의 오버로드에 따라 단일 텍스트 또는 텍스트 배열입니다.

target_language

text 또는 text[] 단일 값 또는 값 배열(사용된 함수의 오버로드에 따라) 입력이 작성된 언어를 나타내는 두 문자 ISO 639-1 표현이 포함됩니다. 허용되는 값은 언어 지원을 확인하세요.

source_language

text DEFAULT NULL 입력 텍스트가 작성된 언어의 두 글자 ISO 639-1 표현입니다. 허용되는 값에 대한 언어 지원을 확인합니다. 지정하지 않으면 자동 언어 감지가 적용되어 소스 언어를 결정합니다.

text_type

boolean DEFAULT 'plain' 번역되는 텍스트 형식을 정의합니다. 유효한 값은 'plain' 또는 'html'입니다. 모든 HTML은 올바른 형식으로 작성되어야 합니다.

profanity_action

boolean DEFAULT 'NoAction' 번역에서 욕설을 처리하는 방법을 지정합니다. 유효한 값은 'NoAction', 'Marked' 또는 'Deleted'입니다. 'NoAction'은 기본 작업이며 욕설은 원본에서 대상으로 전달됩니다. 'Deleted'은 욕설이 바뀌지 않고 제거되었음을 나타냅니다. 'Marked'는 출력에서 표시된 단어를 profanity_marker 매개 변수로 바꿉니다.

profanity_marker

boolean DEFAULT 'Asterisk' 번역에서 욕설을 표시하는 방법을 지정합니다. 이 값에는 비속어를 ***로 바꾸는 'Asterisk' 또는 비속어를 '<profanity></profanity>' 태그로 바꾸는 'Tag'가 가능합니다.

suggested_source_language

text DEFAULT NULL 입력 텍스트의 언어를 식별할 수 없는 경우 대체 언어를 지정합니다.

source_script

text DEFAULT NULL 입력 텍스트의 특정 스크립트입니다.

target_script

text DEFAULT NULL 입력 텍스트의 특정 스크립트입니다.

batch_size

integer DEFAULT 1000한 번에 처리할 레코드 수(매개 변수 text 형식이 text[]인 함수의 오버로드에만 사용 가능).

timeout_ms

integer DEFAULT 3600000 작업이 중지된 후의 시간 제한(밀리초)입니다.

throw_on_error

boolean DEFAULT true 오류가 발생하면 함수가 예외를 발생시켜 래핑 트랜잭션이 롤백됩니다.

max_attempts

integer DEFAULT 1 다시 시도 가능한 오류로 인해 실패하는 경우 확장이 연결된 ID에 대한 Azure 언어 서비스 엔드포인트 호출을 다시 시도하는 횟수입니다.

retry_delay_ms

integer DEFAULT 1000 다시 시도 가능한 오류로 인해 실패하는 경우 연결된 ID에 대한 Azure 언어 서비스 엔드포인트를 다시 호출하기 전에 확장이 기다리는 시간(밀리초)입니다.

반환 형식

azure_cognitive.translated_text_result 또는 TABLE(result azure_cognitive.translated_text_result) 번역된 텍스트의 배열 또는 단일 열 테이블입니다. 응답 본문에 대한 세부 정보는 응답 본문에서 확인할 수 있습니다.

예제

감정 분석 예

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

요약 예

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

번역 예

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

개인 데이터 검색 예

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

관련 콘텐츠