構造化データのクエリを生成する

構造化データストアをナレッジベースに接続すると、ナレッジベースは、クエリ対象のデータソースの構造に基づいて、ユーザーから提供された自然言語クエリを SQLクエリに変換することで、そのストアをクエリできます。を使用する場合 Retrieve、レスポンスはSQLクエリ実行の結果を返します。を使用する場合 RetrieveAndGenerate、生成されたレスポンスはSQLクエリ実行の結果に基づいています。

Amazon Bedrock ナレッジベースでは、 GenerateQueryAPIオペレーションを使用してクエリを に変換することで、クエリの変換を取得プロセスから切り離すこともできますSQL。レスポンスは、後続の Retrieveまたは RetrieveAndGenerateアクションで使用するか、他のワークフローに挿入することができます。 GenerateQueryでは、ナレッジベースのデータソースの構造を考慮してクエリを効率的にSQLクエリに変換できます。

重要

生成されたSQLクエリの精度は、コンテキスト、テーブルスキーマ、およびユーザークエリのインテントによって異なります。生成されたクエリを評価して、ワークロードで使用する前にユースケースに適していることを確認します。

自然言語クエリをSQLクエリに変換するには、Agents for Amazon Bedrock ランタイムエンドポイントを使用してGenerateQueryリクエストを送信します。GenerateQuery リクエストには、次のフィールドが含まれます。

• queryGenerationInput – TEXTとして を指定typeし、 text フィールドにクエリを含めます。

  注記

  クエリは英語で記述する必要があります。

• transformationConfiguration – TEXT_TO_SQLとして を指定しますmode。textToSqlConfiguration フィールドで、 を KNOWLEDGE_BASEとして指定しますtype。次に、ナレッジベースの ARN を指定します。

注記

には、1 秒あたり 2 リクエストのクォータGenerateQueryAPIがあります。

レスポンスは、 queriesフィールドにGeneratedQueryオブジェクトを含む配列を返します。オブジェクトには、 sqlフィールドのSQLクエリの クエリが含まれています。