What-If 分析

What-If 分析を作成するには、次のステップを実行します。

CreateWhatIfAnalysis オペレーションを使用して、WhatIfAnalysisName に一意の名前を指定し、ForecastArn のベースライン予想の予想 ARN を指定します。次の例は、「item_id」と「store_location」のディメンションの組み合わせを使用した時系列のスキーマを示しています。詳細については、「時系列の指定」を参照してください。

{
  "ForecastArn": "arn:aws:forecast:region:acctNumber:forecast/baselineForecast",
  "WhatIfAnalysisName": "unique_name",
  "TimeSeriesSelector": {
    "TimeSeriesIdentifiers": {
      "DataSource": {
        "S3Config": {
          "Path": "s3://bucket/example-path",
          "RoleArn": "arn:aws:iam::000000000000:role/ExampleRole"
        }
      },
      "Schema": {
        "Attributes": [
          {
            "AttributeName": "item_id",
            "AttributeType": "string"
          }
          { 
            "AttributeName": "store_location",
            "AttributeType": "string"
          }
        ]
      }
    }
  }
}

What-If 予想を作成するには、次のステップを実行します。

CreateWhatIfForecast オペレーションを使用して、WhatIfAnalysisName に一意の名前を指定し、ForecastArn の予想 ARN を指定します。以下の例は、「store_location」が「tacoma」でない場合に「price」に変換するスキーマを示しています。

{
  "WhatIfAnalysisArn": "arn:aws:forecast:us-west-2:666488130463:what-if-analysis/jan2020forecast/PromotionAnalysis_01G8MB3PZM89J9V1VEXCC0BS63",
  "WhatIfForecastName": "unique_name",
  "TimeSeriesTransformations": [
    {
      "Action": {
        "AttributeName": "price",
        "Operation": "MULTIPLY",
        "Value": 0.85
      },
      "TimeSeriesConditions": [
        {
          "AttributeName": "store_location",
          "AttributeValue": "tacoma",
          "Condition": "NOT_EQUALS"
        }
      ]
    }
  ]
}

この例では、jan2020forecast はベースライン予想で、PromotionAnalysis_01G8MB3PZM89J9V1VEXCC0BS63 は What-If 分析の名前です。

TimeSeriesReplacementsDataSource オペレーションでは代替データセットを指定することもできます。

CreateWhatIfForecast オペレーションを使用して、WhatIfAnalysisName に一意の名前を指定し、ForecastArn の予想 ARN を指定します。次の例は、代替データソースのスキーマを示しています。

{
  "WhatIfAnalysisArn": "arn:aws:forecast:us-west-2:666488130463:what-if-analysis/jan2020forecast/PromotionAnalysis_01G8MB3PZM89J9V1VEXCC0BS63",
  "WhatIfForecastName": "unique_name",
  "TimeSeriesReplacementsDataSource": {
    "S3config": {
      "Path" : "s3://bucket-name/replacementDatasource.csv",
      "RoleArn": "arn:aws:iam::acct-id:role/Role"
    },
    "Schema": {
      Attributes" : [
        {
          "AttributeName": "item_id",
          "AttributeType": "string"
        },
        {
          "AttributeName": "timestamp",
          "AttributeType": "timestamp"
        },
        {
          "AttributeName": "price",
          "AttributeType": "float"
        },
        {
          "AttributeName": "stock_count",
          "AttributeType": "integer"
        },
      ]
    }
  }
}

TimeSeriesTransformation オペレーションで関連する時系列への変更を指定することもできます。

What-If 予想をエクスポートするには、次のステップを実行します。

CreateWhatIfForecastExport オペレーションを使用して、エクスポートを格納する Amazon S3 バケットを指すように「宛先」を設定します。どの What-If 予想をエクスポートするかを指定し、エクスポートに固有の名前を指定します。

{
  "WhatIfForecastArns": [ "arn:aws:forecast:region:acctNumber:what-if-forecast/id1" , "arn:aws:forecast:region:acctNumber:what-if-forecast/id2" ],
  "WhatIfForecastExportName": "unique_export_name",
  "Destination": {
    "S3Config": {
      "Path": "s3://bucket/example-path",
      "RoleArn": "arn:aws:iam::000000000000:role/ExampleRole"
    }
  },
}