Narwhal が公式データを最新に保つ方法

リクエストは保存済みデータを読み取ります

CPI、GDP、労働、貿易データをリクエストすると、Narwhal はデータベースから最新の受け入れ済み公開データを読み取ります。リクエストの待機中に公式発行元を呼び出すことはありません。

これにより、顧客へのレスポンス時間と新しいリリースの取得・確認作業を分離します。ソースのウェブサイトが遅くても、すべての顧客リクエストがそのサイトを待たされることはありません。

リリースは全体としてチェックに合格する必要があります。

新しいデータは、完全なリリースが検証を通過した後にのみ公開されます。更新手順は意図的にシンプルです：

• スケジュールされたワーカーが公式ソースを確認します。
• Narwhal はリリースを取得し、その識別情報、期間、必須フィールド、完全性を確認します。
• 正規化された観測値とソースの根拠をまとめて保存します。
• 完全なリリースは、必要な確認をすべて通過した後にのみ、顧客向けの現在のバージョンになります。

失敗したチェックによって、正しいデータが消えることはありません。

公式サイトがタイムアウトすることがあります。ファイルが不完全な状態で届くこともあります。形式も変わります。候補リリースが検証に失敗した場合、Narwhal は最後に受け入れた公開データを利用可能なまま維持します。値をゼロに置き換えたり、失敗したリリースの一部を以前のリリースと結合したりしません。

Narwhalが安全に提供できる公開内容を持たない場合、APIは結果を捏造せず、文書化された503エラーを返します。

日付を文字どおり読む

period フィールドは、観測値が対象とする月、四半期、年を示します。released_on フィールドは、そのリリースについて提供された公式公開日です。

パブリックベータでは Narwhal の取り込みタイムスタンプを公開せず、ソース公開から API 公開までの固定遅延も約束しません。これらの日付は経済観測値と公式公開を示すもので、API 呼び出しの速度を示すものではありません。

改訂は以前の値を置き換えます

経済機関は公開済みの数値を定期的に改訂します。改訂された公式リリースが同じチェックに合格すると、その期間に以前保存された値を置き換える場合があります。アプリケーションは公式経済データを、改訂され得る公開データとして扱うべきであり、変更できないイベントログとして扱うべきではありません。