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

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

• Retrieve: レスポンスは SQL クエリ実行の結果を返します。

• RetrieveAndGenerate: 生成されたレスポンスは、SQL クエリ実行の結果に基づいています。

• GenerateQuery: Amazon Bedrock ナレッジベースは、クエリの変換を取得プロセスから切り離します。この API オペレーションを使用して、クエリを SQL に変換できます。

重要

構造化データ取り出しでは、クロスリージョン推論を使用して、推論リクエストを処理する最適な を地域 AWS リージョン 内で選択します。これにより追加料金は発生せず、利用可能なリソースとモデルの可用性を最大化することでカスタマーエクスペリエンスが向上します。

クロス推論リクエストは、データが最初に存在する地域の一部 AWS リージョン である 内に保持されます。データはソースリージョン内に保存されますが、入力プロンプトと出力結果がこのリージョン外に移動する可能性があります。すべてのデータは Amazon の安全なネットワーク経由で暗号化されて送信されます。

詳細については、「クロスリージョン推論によるスループットの向上」を参照してください。

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

重要

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

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

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

  注記

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

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

注記

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

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