> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# クラウド統合でデータの鮮度とキャッシングを設定する

## はじめに

この記事では、クラウド統合の\*\*［データの鮮度］\*\*タブを開き、スケジュール設定されたデータの鮮度チェックを設定し、カードのクエリ結果のデータキャッシングを設定する方法について説明します。

***

## 概要

クラウド統合DataSetは、次の2種類のメカニズムによって最新の状態を維持します。これは統合ごとに設定を行います。

* **データの鮮度チェック —** Domoはソースとなるクラウドウェアハウスをスケジュールに従ってポーリングし、基となるデータが変更されている場合に検出します。更新が検出されると、接続されているカード、アラート、DataFlowが、次回の読み込み時に新しいデータを反映します。Domoは、クエリが実行され、設定されたキャッシュ期間（TTL）が期限切れになっている場合にもオンデマンドの鮮度チェックを実行します。これにより、スケジュール設定されたポーリングだけに頼ることなく、より応答性の高いデータを提供します。
* **データキャッシング —** Domoは、カードのクエリ結果を一時的に保存します。ユーザーがカードを開くとき、キャッシュされた結果が存在する場合は、新しいクエリをウェアハウスに送信せずにキャッシュされた結果を返します。これにより、ウェアハウスのクエリ負荷が軽減されます。

それぞれの設定は統合レベルで設定され、その統合内のすべてのDataSetに適用されます。

## ［データの鮮度］タブを開く

既存の統合でデータの鮮度とキャッシングを設定するには、以下の手順を実行します。

1. **［Data Warehouse］**>**［データを接続］**>\*\*［Manage existing integrations］\*\*に移動します。

2. BigQueryなど、統合タイプのタイルを選択します。

   <Frame>
     <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-01.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=7644b1bcd70b7f581be00925cf35a435" alt="統合のリストでスパナメニューが開いています" width="1920" height="911" data-path="images/kb/data-freshness-01.png" />
   </Frame>

3. 設定する統合の上にカーソルを合わせ、表示されるレンチアイコンを選択して、\*\*［統合を編集］\*\*を選択します。

   <Frame>
     <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-02.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=c123be7bf7ec510813e7da871990a974" alt="統合の詳細に［設定］タブが表示されています" width="1920" height="911" data-path="images/kb/data-freshness-02.png" />
   </Frame>

4. \*\*［データの鮮度］\*\*タブを選択します

   デフォルトでは、データの鮮度のスケジュール設定とキャッシングの両方が無効になっています。

   <Frame>
     <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-03.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=341c2610f94aa0f7d872bd5ee9f8cb6d" alt="デフォルト状態の［データの鮮度］タブ、スケジュール設定とキャッシングの両方がオフになっています" width="1920" height="911" data-path="images/kb/data-freshness-03.png" />
   </Frame>

## データの鮮度チェックを設定する

1. \*\*［Schedule data freshness checks］\*\*トグルボタンを有効にします。

2. \*\*［基本］**または**［高度］\*\*タブを選択し、Domoが更新をチェックするタイミングを設定します。

### 基本

基本モードでは、ドロップダウンからプリセットの更新間隔を選択できます。\*\*［開始時間］**と**［タイムゾーン］**を設定することで、更新間隔内でチェックを開始するタイミングをコントロールできます。1日より短い間隔（15分ごと、30分ごと、1時間ごと）の場合、**［アクティブ時間］\*\*を有効にすることで、定義された時間帯にのみチェックを実行するように制限できます。

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-04.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=c541fe2e7b6b10e7bc0a19f77eea6cb7" alt="［基本］タブで更新間隔ドロップダウンが開いています" width="1920" height="911" data-path="images/kb/data-freshness-04.png" />
</Frame>

| 更新頻度 | 説明                                |
| ---- | --------------------------------- |
| 15分毎 | 終日または設定したアクティブ時間の間、15分ごとにチェックします。 |
| 30分毎 | 終日または設定したアクティブ時間の間、30分ごとにチェックします。 |
| 1時間毎 | 終日または設定したアクティブ時間の間、1時間ごとにチェックします。 |
| 毎日   | 週末を含め、1日1回、指定した時刻にチェックします。        |
| 毎週平日 | 週末を除き、1日1回、指定した時刻にチェックします。        |
| 毎週   | 週1回、選択した曜日の指定した時刻にチェックします。        |
| 毎月   | 月1回、選択した日付の指定した時刻にチェックします。        |

### 高度

高度モードでは、チェックの頻度、曜日、毎月のスケジュールを細かくコントロールできます。3つの設定をすべて設定することで、チェックの実行タイミングを正確に定義できます。

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-06.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=d3556c0c12a32bdbf8d97c4755a5add6" alt="［高度］タブで［1日1回］が選択されています" width="1920" height="911" data-path="images/kb/data-freshness-06.png" />
</Frame>

**How frequently?**—1日の中でチェックが実行される頻度

* **1日1回 —** チェックは1日1回、指定した時刻およびタイムゾーンに実行されます。
* **1日複数回 —** チェックは1日中、指定した間隔で繰り返し実行されます。\*\*［アクティブ時間］\*\*を有効にすることで、午前8時～午後6時など、定義された時間帯にのみチェックを実行するように制限できます。

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-07.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=8b1a77f3921667a904a22728f007cf93" alt="［高度］タブで［1日複数回］が選択され、［アクティブ時間］が有効になっています" width="1920" height="911" data-path="images/kb/data-freshness-07.png" />
</Frame>

**Day frequency**—チェックが実行される曜日

* **毎日 —** チェックはすべての曜日で実行されます。
* **特定の曜日 —** チェックは選択した曜日にのみ実行されます。
* **月の特定の日 —** チェックは選択した日付にのみ実行されます。

**Month frequency**—チェックが実行される月

* **毎月 —** チェックは毎月実行されます。
* **特定の月 —** チェックは選択した月にのみ実行されます。

## データキャッシングを設定する

1. \*\*［データの鮮度］**タブの**［データキャッシング］**セクションで、**［キャッシュを有効にする］\*\*トグルボタンをオンにします。

2. \*\*［キャッシュ期間（TTL）］\*\*を設定すると、キャッシュされたカードのクエリ結果をDomoが破棄せずに保持する期間をコントロールできます。最大キャッシュ期間は24時間です。

   <Frame>
     <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/ncwrG9zySS9dacCx/images/kb/data-freshness-08.png?fit=max&auto=format&n=ncwrG9zySS9dacCx&q=85&s=8d61f53780a92116ed6d0284e0d60b1c" alt="［キャッシング］セクションで［キャッシュを有効にする］トグルボタンがオンになっています" width="1920" height="911" data-path="images/kb/data-freshness-08.png" />
   </Frame>

## よくある質問

### データの鮮度

<AccordionGroup>
  <Accordion title="データが最新のように見えないのはなぜですか？">
    データの鮮度が有効になっており、使用事例に適した間隔に設定されていることを確認します。データの鮮度が無効になっている場合、カードのクエリ結果が最大24時間キャッシュされることがあります。
  </Accordion>

  <Accordion title="統合でOAuth認証を使用している場合、データの鮮度は機能しますか？">
    いいえ。データの鮮度チェックとキャッシングは、統合の接続に使用されているサービスアカウントに左右されます。OAuthの使用時はこれらの機能が無効になります。
  </Accordion>
</AccordionGroup>

### キャッシング

<AccordionGroup>
  <Accordion title="Domoがキャッシュを使用せずに常にウェアハウスにクエリを実行するのは、どのような場合ですか？">
    以下の状況で、Domoはキャッシュをバイパスし、常に新しいクエリを送信します。

    * DataSetの詳細ページでDataSetプレビューを表示している
    * DataSetビューを読み込んでいる
    * DataSetをMagic ETLに読み込んでいる
    * **動的なSQL関数**：NOW()、CURRENT\_DATE()、CURRENT\_TIMESTAMP()などの関数を含むクエリは、実行ごとに一意のSQL文字列を生成します。キャッシングは正確なSQLクエリにもとづいているため、これらのクエリではTTL設定に関係なくキャッシュされた結果を再利用しません。
  </Accordion>

  <Accordion title="カードを表示するたびにウェアハウスにクエリが実行されますか？">
    いいえ。カードを表示する際、Domoはまずキャッシュされた結果をチェックします。存在する場合は、Domoがキャッシュされたデータを返します。存在しない場合は、Domoがウェアハウスにクエリを実行します。
  </Accordion>

  <Accordion title="誰かがカードを編集した場合、ウェアハウスにクエリが実行されますか？">
    はい。Analyzerでカードを作成または編集するとき、\*\*［自動プレビュー］\*\*が有効になっていると、変更が発生するたびに新しいクエリがトリガーされます。
  </Accordion>

  <Accordion title="カードのクエリ結果はどれくらいの期間キャッシュされますか？">
    Domoはカードのクエリ結果を、最大24時間、または［キャッシュ期間（TTL）］の期限が切れるまで、いずれか短い方の期間キャッシュします。
  </Accordion>

  <Accordion title="Domoがキャッシュするクエリの数に制限はありますか？">
    いいえ。キャッシュされるクエリ結果の数には明示的な制限はありません。
  </Accordion>

  <Accordion title="Domoがキャッシュするデータサイズに制限はありますか？">
    いいえ。カードのキャッシュに保存されるデータには、行やデータサイズの制限はありません。
  </Accordion>

  <Accordion title="個々のDataSetに異なるキャッシュ期間を設定できますか？">
    いいえ。キャッシュ期間は統合レベルで設定され、その統合内のすべてのDataSetに適用されます。
  </Accordion>
</AccordionGroup>
