쿼리 API 엔드포인트
대화형 데이터 기반 애플리케이션을 구축하려면 빠른 데이터베이스, 잘 구조화된 데이터, 최적화된 쿼리뿐만 아니라, 프론트엔드와 마이크로서비스가 해당 쿼리가 반환하는 데이터를 손쉽게 활용할 수 있는 방법, 가급적이면 잘 구조화된 API를 통한 접근 방식을 제공해야 합니다.
Query API Endpoints 기능을 사용하면 ClickHouse Cloud 콘솔에서 저장된 SQL 쿼리로부터 직접 API 엔드포인트를 생성할 수 있습니다. 이를 통해 네이티브 드라이버로 ClickHouse Cloud 서비스에 연결할 필요 없이, HTTP를 통해 API 엔드포인트에 액세스하여 저장된 쿼리를 실행할 수 있습니다.
IP Access Control
Query API endpoint는 API 키 수준의 IP 허용 목록(whitelist)을 준수합니다. SQL Console과 마찬가지로 Query API endpoint는 ClickHouse 인프라 내부에서 요청을 프록시하므로, 서비스 수준의 IP 허용 목록 설정은 적용되지 않습니다.
Query API endpoint를 호출할 수 있는 클라이언트를 제한하려면 다음 단계를 수행합니다:
API 키 설정 열기
- ClickHouse Cloud Console → Organization → API Keys로 이동합니다.
- Query API endpoint에 사용되는 API 키 옆의 Edit를 클릭합니다.
허용할 IP 주소 추가
- Allow access to this API Key 섹션에서 Specific locations를 선택합니다.
- IP 주소 또는 CIDR 범위를 입력합니다(예:
203.0.113.1또는203.0.113.0/24). - 필요에 따라 여러 항목을 추가합니다.
Query API endpoint를 생성하려면 Admin Console Role과 적절한 권한이 부여된 API 키가 필요합니다.
Guide
몇 단계만으로 Query API endpoint를 설정하는 방법은 Query API endpoints guide를 참고하십시오.
