$util.transform の変換ヘルパー

$util.transform には、Amazon DynamoDB フィルター処理などの、データソースに対する複雑なオペレーションの実行を容易にするヘルパーメソッドが含まれています。

変換ヘルパー

変換ヘルパーユーティリティリスト

$util.transform.toDynamoDBFilterExpression(Map) : Map

入力文字列を DynamoDB で使用するフィルター式に変換します。

Input:

$util.transform.toDynamoDBFilterExpression({
    "title":{
      "contains":"Hello World"
    }
  })

Output:

{
    "expression" : "contains(#title, :title_contains)"
    "expressionNames" : {
        "#title" : "title",
    },
    "expressionValues" : {
        ":title_contains" : { "S" : "Hello World" }
    },
}

$util.transform.toElasticsearchQueryDSL(Map) : Map

指定された入力を同等の OpenSearch クエリ DSL 式に変換し、JSON 文字列として返します。

Input:

$util.transform.toElasticsearchQueryDSL({
    "upvotes":{
        "ne":15,
        "range":[
            10,
            20
        ]
    },
    "title":{
        "eq":"hihihi",
        "wildcard":"h*i"
    }
  })

Output:
{
    "bool":{
      "must":[
          {
            "bool":{
              "must":[
                  {
                    "bool":{
                      "must_not":{
                        "term":{
                          "upvotes":15
                        }
                      }
                    }
                  },
                  {
                    "range":{
                      "upvotes":{
                        "gte":10,
                        "lte":20
                      }
                    }
                  }
              ]
            }
          },
          {
            "bool":{
              "must":[
                  {
                    "term":{
                      "title":"hihihi"
                    }
                  },
                  {
                  "wildcard":{
                      "title":"h*i"
                    }
                  }
              ]
            }
          }
      ]
    }
}

デフォルトの演算子は AND と仮定されます。

変換ヘルパー、サブスクリプションフィルター

変換ヘルパー、サブスクリプションフィルター、ユーティリティリスト

$util.transform.toSubscriptionFilter(Map) : Map

MapSubscriptionFilter入力オブジェクトをエクスプレッションオブジェクトに変換します。$util.transform.toSubscriptionFilter$extensions.setSubscriptionFilter()このメソッドはエクステンションへの入力として使用されます。詳細については、「拡張機能」を参照してください。

$util.transform.toSubscriptionFilter(Map, List) : Map

MapSubscriptionFilter入力オブジェクトをエクスプレッションオブジェクトに変換します。$util.transform.toSubscriptionFilter$extensions.setSubscriptionFilter()このメソッドはエクステンションへの入力として使用されます。詳細については、「拡張機能」を参照してください。

最初の引数は、MapSubscriptionFilterエクスプレッションオブジェクトに変換される入力オブジェクトです。2List 番目の引数は、SubscriptionFilterエクスプレッションオブジェクトを作成するときに 1Map 番目の入力オブジェクトでは無視されるフィールド名です。

$util.transform.toSubscriptionFilter(Map, List, Map) : Map

MapSubscriptionFilter入力オブジェクトをエクスプレッションオブジェクトに変換します。$util.transform.toSubscriptionFilter$extensions.setSubscriptionFilter()このメソッドはエクステンションへの入力として使用されます。詳細については、「拡張機能」を参照してください。

MapSubscriptionFilter最初の引数はエクスプレッションオブジェクトに変換される入力オブジェクト、2Map 番目の引数は最初の入力オブジェクトでは無視されるフィールド名、3Map 番目の引数は厳密なルールの入力オブジェクトです。ListSubscriptionFilterエクスプレッションオブジェクトを構築します。これらの厳格なルールは、少なくとも 1SubscriptionFilter つのルールが満たされてサブスクリプションフィルタを通過するようにエクスプレッションオブジェクトに含まれています。

サブスクリプションフィルター引数

次の表は、以下のユーティリティの引数の定義方法を説明しています。

• $util.transform.toSubscriptionFilter(Map) : Map

• $util.transform.toSubscriptionFilter(Map, List) : Map

• $util.transform.toSubscriptionFilter(Map, List, Map) : Map

Argument 1: Map

引数 1 は、Map次のキー値を持つオブジェクトです。

• フィールド名

• 「と」

• 「または」

フィールド名をキーとして使用する場合、"operator" : "value"これらのフィールドのエントリの条件はという形式になります。

次の例では、エントリをに追加する方法を示しますMap。

"field_name" : {
                    "operator1" : value             
               }

## We can have multiple conditions for the same field_name: 

"field_name" : {
                    "operator1" : value             
                    "operator2" : value
                    .
                    .
                    .                  
               }

フィールドに 2 つ以上の条件が設定されている場合、これらの条件はすべて OR 操作を使用したものと見なされます。

入力にはキーとして「and」と「or」Map を使用することもできます。つまり、これらの中のすべてのエントリは、キーに応じて AND または OR ロジックを使用して結合する必要があります。キー値「and」と「or」には条件の配列が必要です。

"and" : [
            
            {
                "field_name1" : {
                    "operator1" : value             
                }
             },
             
             {
                "field_name2" : {
                    "operator1" : value             
                }
             },
             .
             .
        ].

「and」と「or」はネストできることに注意してください。つまり、別の「and」/「or」ブロック内に「and」/「or」をネストすることができます。ただし、これは単純なフィールドでは機能しません。

"and" : [
            
            {
                "field_name1" : {
                    "operator" : value             
                }
             },
             
             {
                "or" : [
                            {
                                "field_name2" : {
                                    "operator" : value             
                                }
                            },
                            
                            {
                                "field_name3" : {
                                    "operator" : value             
                                }
                            }
              
                        ].

次の例は、を使用して引数 1 の入力を示しています$util.transform.toSubscriptionFilter(Map) : Map。

インプット

引数 1: マップ:

{
  "percentageUp": {
    "lte": 50,
    "gte": 20
  },
  "and": [
    {
      "title": {
        "ne": "Book1"
      }
    },
    {
      "downvotes": {
        "gt": 2000
      }
    }
  ],
  "or": [
    {
      "author": {
        "eq": "Admin"
      }
    },
    {
      "isPublished": {
        "eq": false
      }
    }
  ]
}

出力

Map結果はオブジェクトです。

{
  "filterGroup": [
    {
      "filters": [
        {
          "fieldName": "percentageUp",
          "operator": "lte",
          "value": 50
        },
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 2000
        },
        {
          "fieldName": "author",
          "operator": "eq",
          "value": "Admin"
        }
      ]
    },
    {
      "filters": [
        {
          "fieldName": "percentageUp",
          "operator": "lte",
          "value": 50
        },
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 2000
        },
        {
          "fieldName": "isPublished",
          "operator": "eq",
          "value": false
        }
      ]
    },
    {
      "filters": [
        {
          "fieldName": "percentageUp",
          "operator": "gte",
          "value": 20
        },
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 2000
        },
        {
          "fieldName": "author",
          "operator": "eq",
          "value": "Admin"
        }
      ]
    },
    {
      "filters": [
        {
          "fieldName": "percentageUp",
          "operator": "gte",
          "value": 20
        },
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 2000
        },
        {
          "fieldName": "isPublished",
          "operator": "eq",
          "value": false
        }
      ]
    }
  ]
}

Argument 2: List

引数 2 にはList、SubscriptionFilter式オブジェクトを作成するときに入力Map (引数 1) に含めるべきではないフィールド名が含まれています。Listは空でもかまいません。

次の例は、を使用して引数 1 と引数 2 の入力を示しています$util.transform.toSubscriptionFilter(Map, List) : Map。

インプット

引数 1: マップ:

{
  "percentageUp": {
    "lte": 50,
    "gte": 20
  },
  "and": [
    {
      "title": {
        "ne": "Book1"
      }
    },
    {
      "downvotes": {
        "gt": 20
      }
    }
  ],
  "or": [
    {
      "author": {
        "eq": "Admin"
      }
    },
    {
      "isPublished": {
        "eq": false
      }
    }
  ]
}

引数 2: リスト:

["percentageUp", "author"]

出力

Map結果はオブジェクトです。

{
  "filterGroup": [
    {
      "filters": [
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 20
        },
        {
          "fieldName": "isPublished",
          "operator": "eq",
          "value": false
        }
      ]
    }
  ]
}

Argument 3: Map

引数 3 は、Mapフィールド名をキー値とするオブジェクトです (「and」や「or」は使用できません)。フィールド名をキーとして使用する場合、"operator" : "value"これらのフィールドの条件はという形式のエントリです。引数 1 とは異なり、引数 3 は同じキーに複数の条件を含めることはできません。さらに、引数 3 には「and」または「or」句がないため、ネストも必要ありません。

引数 3 は厳密な規則のリストを表し、これらの条件の少なくとも 1SubscriptionFilter つが満たされてフィルタを通過するように条件式オブジェクトに追加されます。

{
  "fieldname1": {
    "operator": value
  },
  "fieldname2": {
    "operator": value
  }
}
.
.
.

次の例は、を使用して引数 1、引数 2、および引数 3 の入力を示しています$util.transform.toSubscriptionFilter(Map, List, Map) : Map。

インプット

引数 1: マップ:

{
  "percentageUp": {
    "lte": 50,
    "gte": 20
  },
  "and": [
    {
      "title": {
        "ne": "Book1"
      }
    },
    {
      "downvotes": {
        "lt": 20
      }
    }
  ],
  "or": [
    {
      "author": {
        "eq": "Admin"
      }
    },
    {
      "isPublished": {
        "eq": false
      }
    }
  ]
}

引数 2: リスト:

["percentageUp", "author"]

引数 3: マップ:

{
  "upvotes": {
    "gte": 250
  },
  "author": {
    "eq": "Person1"
  }
}

出力

Map結果はオブジェクトです。

{
  "filterGroup": [
    {
      "filters": [
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 20
        },
        {
          "fieldName": "isPublished",
          "operator": "eq",
          "value": false
        },
        {
          "fieldName": "upvotes",
          "operator": "gte",
          "value": 250
        }
      ]
    },
    {
      "filters": [
        {
          "fieldName": "title",
          "operator": "ne",
          "value": "Book1"
        },
        {
          "fieldName": "downvotes",
          "operator": "gt",
          "value": 20
        },
        {
          "fieldName": "isPublished",
          "operator": "eq",
          "value": false
        },
        {
          "fieldName": "author",
          "operator": "eq",
          "value": "Person1"
        }
      ]
    }
  ]
}