クエリ API エンドポイント
インタラクティブなデータ駆動型アプリケーションを構築するには、高速なデータベース、適切に構造化されたデータ、最適化されたクエリだけでは不十分です。 フロントエンドやマイクロサービスもまた、クエリから返されるデータを、できれば適切に構造化された API を介して、簡単に利用できる必要があります。
Query API Endpoints 機能を使用すると、ClickHouse Cloud コンソールで保存した任意の SQL クエリから、直接 API エンドポイントを作成できます。 これにより、ネイティブ ドライバーを使って ClickHouse Cloud サービスに接続することなく、HTTP 経由で API エンドポイントにアクセスして保存済みクエリを実行できます。
IP アクセス制御
Query API エンドポイントは、API キー単位の IP ホワイトリスト設定に従います。SQL Console と同様に、Query API エンドポイントは ClickHouse のインフラストラクチャ内部からリクエストをプロキシするため、サービスレベルの IP ホワイトリスト設定は適用されません。
どのクライアントが Query API エンドポイントを呼び出せるかを制限するには、次の手順に従います。
API キー設定を開く
- ClickHouse Cloud Console で Organization → API Keys に移動します
- Query API エンドポイントに使用している API キーの横にある Edit をクリックします
許可する IP アドレスを追加する
- Allow access to this API Key セクションで、Specific locations を選択します
- IP アドレスまたは CIDR 範囲（例:
203.0.113.1や203.0.113.0/24）を入力します - 必要に応じて複数のエントリを追加します
Query API エンドポイントを作成するには、Admin Console ロールと、適切な権限を持つ API キーが必要です。
Guide
いくつかの簡単なステップで Query API エンドポイントをセットアップする手順については、Query API endpoints guide を参照してください。
