翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

OpenSearch 用 AWS AppSync JavaScript リゾルバー関数リファレンス

Amazon OpenSearch Service 用 AWS AppSync リゾルバーにより、GraphQL を使用してアカウントの既存の OpenSearch Service ドメインに対してデータを保存または取得することが可能になります。リゾルバーにより、受信した GraphQL リクエストを OpenSearch Service リクエストにマッピングし、その後 OpenSearch Service のレスポンスを GraphQL にマッピングすることができます。このセクションでは、サポートされている OpenSearch Service オペレーションの関数リクエストハンドラーとレスポンスハンドラーについて説明します。

リクエスト

ほとんどの OpenSearch Service リクエストオブジェクトは構造が共通しており、変更されるのはほんのわずかです。次の例では、OpenSearch Service ドメインに対して検索を実行します。ここでは、ドキュメントは post タイプで id にインデックスが作成されます。検索パラメータは body セクションで定義され、query フィールドで定義されている多くの一般的なクエリの句を使用します。この例では "Nadia"、または "Bailey"、あるいはその両方を、ドキュメントの author フィールドに含むドキュメントを検索します。

export function request(ctx) {
  return {
    operation: 'GET',
    path: '/id/post/_search',
    params: {
      headers: {},
      queryString: {},
      body: {
        from: 0,
        size: 50,
        query: {
          bool: {
            should: [
              { match: { author: 'Nadia' } },
              { match: { author: 'Bailey' } },
            ],
          },
        },
      },
    },
  };
}

レスポンス

他のデータソースと同様に、OpenSearch Service はレスポンスを、AWS AppSync に送信します。これは GraphQL タイプに変換する必要があります。

ほとんどの GraphQL クエリは OpenSearch Service レスポンスから _source フィールドを探しています。個別のドキュメントまたはドキュメントのリストを返す検索を行うことができるので、OpenSearch Service で使用される、2 つの共通レスポンスマッピングテンプレートがあります。

結果のリスト

export function response(ctx) {
  const entries = [];
  for (const entry of ctx.result.hits.hits) {
    entries.push(entry['_source']);
  }
  return entries;
}

個別項目

export function response(ctx) {
  return ctx.result['_source']
}

operation フィールド

HTTP メソッドまたは動作 (GET、POST、PUT、HEAD または DELETE) で AWS AppSync が OpenSearch Service ドメインに送信します。キーと値の両方が文字列である必要があります。

"operation" : "PUT"

path フィールド

AWS AppSync からの OpenSearch Service リクエストの検索パス。これはオペレーションの HTTP 動作に対する URL を作成します。キーと値の両方が文字列である必要があります。

"path" : "/indexname/type"

"path" : "/indexname/type/_search"

マッピングテンプレートが評価されると、このパスは、OpenSearch Service ドメインが含まれる HTTP リクエストの一部として送信されます。たとえば、前の例では次のように変換される可能性があります。

GET https://opensearch-domain-name.REGION.es.amazonaws.com/indexname/type/_search

params フィールド

検索実行時のアクションを指定するために使用され、一般に、query 値を body 内に設定します。ただし、レスポンスのフォーマットなど、他のいくつかの機能を設定できます。

例 1

都市が「seattle」に一致するすべてのドキュメントを返します。

export function request(ctx) {
  return {
    operation: 'GET',
    path: '/id/post/_search',
    params: {
      headers: {},
      queryString: {},
      body: { from: 0, size: 50, query: { match: { city: 'seattle' } } },
    },
  };
}

例 2

都市または州が「washington」に一致するすべてのドキュメントを返します。

export function request(ctx) {
  return {
    operation: 'GET',
    path: '/id/post/_search',
    params: {
      headers: {},
      queryString: {},
      body: {
        from: 0,
        size: 50,
        query: {
          multi_match: { query: 'washington', fields: ['city', 'state'] },
        },
      },
    },
  };
}

渡す変数

リクエストハンドラーの評価の一部として変数を渡すこともできます。たとえば、次のような GraphQL クエリがあるとします。

query {
    searchForState(state: "washington"){
        ...
    }
}

関数リクエストハンドラーは次のようになります。

export function request(ctx) {
  return {
    operation: 'GET',
    path: '/id/post/_search',
    params: {
      headers: {},
      queryString: {},
      body: {
        from: 0,
        size: 50,
        query: {
          multi_match: { query: ctx.args.state, fields: ['city', 'state'] },
        },
      },
    },
  };
}