Azure Database for PostgreSQL - 유연한 서버의 Azure AI 확장
적용 대상: 
Azure Database for PostgreSQL - 유연한 서버
Azure AI용 Azure Database for PostgreSQL 유연한 서버 확장을 사용하면 LLMS(대규모 언어 모델)를 사용하고 데이터베이스 내에 풍부한 생성 AI 애플리케이션을 빌드할 수 있습니다. Azure AI 확장을 사용하면 데이터베이스가 Azure OpenAI 및 Azure Cognitive Services를 비롯한 다양한 Azure AI 서비스를 호출해 개발 프로세스를 간소화하여 해당 서비스에 원활하게 통합할 수 있습니다.
azure_ai 확장 사용
Azure Database for PostgreSQL 유연한 서버 인스턴스에서 azure_ai를 사용하도록 설정하려면 먼저 PostgreSQL 확장 사용 방법에 설명된 대로 이를 허용 목록에 추가하고 SHOW azure.extensions;를 실행하여 올바르게 추가되었는지 확인해야 합니다.
팁
azure_ai와 함께 일반적으로 사용되는 pgvector 확장을 사용하도록 설정할 수도 있습니다.
그런 다음 대상 데이터베이스에 연결하고 CREATE EXTENSION 명령을 실행하여 확장을 설치할 수 있습니다. 확장 기능을 사용하려는 모든 데이터베이스에 대해 개별적으로 명령을 반복해야 합니다.
CREATE EXTENSION azure_ai;
참고 항목
현재 연결된 데이터베이스에서 확장을 제거하려면 DROP EXTENSION azure_ai;를 사용합니다.
azure_ai 확장을 설치하면 다음 세 가지 스키마가 만들어집니다.
azure_ai: 구성 테이블이 상주하고 상호 작용하는 주요 스키마입니다.azure_openai: OpenAI와 관련된 함수 및 복합 형식입니다.azure_cognitive: Cognitive Services와 관련된 함수 및 복합 형식입니다.
이 확장을 사용하면 Azure OpenAI 및 Azure Cognitive Services를 호출할 수도 있습니다.
azure_ai 확장 구성
확장을 구성하려면 Azure AI 서비스에 연결하기 위한 엔드포인트와 인증에 필요한 API 키를 제공해야 합니다. 서비스 설정은 다음 함수를 사용하여 저장됩니다.
사용 권한
Azure AI 액세스 키는 계정의 루트 암호와 유사합니다. 항상 액세스 키를 보호해야 합니다. Azure Key Vault를 사용하여 키를 안전하게 관리하고 회전합니다.
확장에서 사용하는 서비스 키를 관리하려면 사용자에게 부여된 azure_ai_settings_manager 역할이 필요합니다. 다음 함수에는 역할이 필요합니다.
- azure_ai.set_setting
- azure_ai.get_setting
azure_ai_settings_manager 역할은 기본적으로 azure_pg_admin 역할에 부여됩니다.
azure_ai.set_setting
구성 옵션을 설정하는 데 사용됩니다.
azure_ai.set_setting(key TEXT, value TEXT)
인수
key
구성 옵션의 이름입니다. key의 유효한 값은 다음과 같습니다.
azure_openai.endpoint: 지원되는 OpenAI 엔드포인트(예:https://example.openai.azure.com)입니다.azure_openai.subscription_key: OpenAI 리소스의 구독 키입니다.azure_cognitive.endpoint: 지원되는 Cognitive Services 엔드포인트(예:https://example.cognitiveservices.azure.com)입니다.azure_cognitive.subscription_key: Cognitive Services 리소스에 대한 구독 키입니다.
value
선택한 설정의 원하는 값을 나타내는 TEXT입니다.
azure_ai.get_setting
구성 옵션의 현재 값을 가져오는 데 사용됩니다.
azure_ai.get_setting(key TEXT)
인수
키
구성 옵션의 이름입니다. key의 유효한 값은 다음과 같습니다.
azure_openai.endpoint: 지원되는 OpenAI 엔드포인트(예:https://example.openai.azure.com)입니다.azure_openai.subscription_key: OpenAI 리소스의 구독 키입니다.azure_cognitive.endpoint: 지원되는 Cognitive Services 엔드포인트(예:https://example.cognitiveservices.azure.com)입니다.azure_cognitive.subscription_key: Cognitive Services 리소스에 대한 구독 키입니다.
반환 형식
TEXT는 선택한 설정의 현재 값을 나타냅니다.
azure_ai.version
azure_ai.version()
반환 형식
TEXT는 Azure AI 확장의 현재 버전을 나타냅니다.
예제
Azure OpenAI에 대한 엔드포인트 및 API 키 설정
select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com');
select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');
Azure OpenAI용 엔드포인트 및 API 키 가져오기
select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');
Azure AI 확장 버전 확인
select azure_ai.version();
사용 권한
azure_ai 확장은 확장과 관련된 설정을 읽고 쓸 수 있게 해주는 azure_ai_settings_manager라는 역할을 정의합니다. azure_ai_settings_manager 역할의 슈퍼 사용자와 멤버만 azure_ai.get_settings 및 azure_ai.set_settings 함수를 호출할 수 있습니다. Azure Database for PostgreSQL 유연한 서버에서는 모든 관리 사용자에게 azure_ai_settings_manager 역할이 할당되어 있습니다.
Azure AI 확장 업그레이드
최신 버전의 확장 프로그램에는 새로운 기능이 도입될 수 있으며 확장 프로그램의 현재 위치 업그레이드가 허용됩니다. SQL 명령을 사용하여 현재 설치된 버전을 허용되는 최신 버전과 비교할 수 있습니다.
SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'
설치된 확장을 Azure에서 지원하는 사용 가능한 최신 버전으로 업데이트하려면 다음 SQL 명령을 사용합니다.
ALTER EXTENSION azure_ai UPDATE;