チュートリアル: ウェアハウス内の T-SQL を使用したタイムトラベル

適用対象:✅ Warehouse in Microsoft Fabric

このチュートリアルでは、T-SQL ステートメントを使用して、ウェアハウステーブル内のタイムトラベルを行う方法について説明します。タイムトラベルとは、特定の時点に存在していたデータに対してクエリを実行することを意味します。

注

このチュートリアルでは、エンドツーエンドのシナリオの一部を構成します。このチュートリアルを完了するには、まず次のチュートリアルを完了する必要があります。

ワークスペースを作成する
倉庫を作成する
Warehouse にデータを取り込む

タイムトラベルクエリを操作する

このタスクでは、売上別に上位 10 人の顧客のビューを作成する方法について説明します。次のタスクのビューを使用して、タイムトラベルクエリを実行します。

最初のチュートリアルで作成したワークスペースが開かれていることを確認します。
[ホーム] リボンの [新しい SQL クエリ] を選択します。

クエリエディターで、以下のコードを貼り付けます。このコードでは、Top10Customersという名前のビューが作成されます。このビューでは、クエリを使用して、売上に基づいて上位 10 人の顧客を取得します。

--Create the Top10Customers view.
CREATE VIEW [dbo].[Top10Customers]
AS
SELECT TOP(10)
    FS.[CustomerKey],
    DC.[Customer],
    SUM(FS.[TotalIncludingTax]) AS [TotalSalesAmount]
FROM
    [dbo].[dimension_customer] AS DC
    INNER JOIN [dbo].[fact_sale] AS FS
        ON DC.[CustomerKey] = FS.[CustomerKey]
GROUP BY
    FS.[CustomerKey],
    DC.[Customer]
ORDER BY
    [TotalSalesAmount] DESC;

クエリを実行します。
実行が完了したら、クエリの名前を Create Top 10 Customer Viewに変更します。
エクスプローラーの ペインで、スキーマの dbo フォルダー内から、Top10Customers ビューが存在することを確認します。
タイムトラベルクエリを操作する新しいクエリを作成します。
クエリエディターで、以下のコードを貼り付けます。このコードは、1 つのファクト行の TotalIncludingTax 値を更新して、売上の合計を意図的に拡大します。また、現在のタイムスタンプも取得します。
```
 --Update the TotalIncludingTax for a single fact row to deliberately inflate its total sales.
 UPDATE [dbo].[fact_sale]
 SET [TotalIncludingTax] = 200000000
 WHERE [SaleKey] = 22632918; --For customer 'Tailspin Toys (Muir, MI)'
 GO

 --Retrieve the current (UTC) timestamp.
 SELECT CURRENT_TIMESTAMP;
```
注

現在、タイムトラベルには世界協定時刻 (UTC) タイムゾーンのみを使用できます。
クエリを実行します。
実行が完了したら、クエリの名前を Time Travelに変更します。
結果ペインで、タイムスタンプの値に注目します (値は現在の UTC 日時になります)。
現在上位 10 人の顧客を取得するには、新しいクエリエディターに次のステートメントを貼り付けます。このコードでは、FOR TIMESTAMP AS OF クエリヒントを使用して上位 10 人の顧客を取得します。
```
 --Retrieve the top 10 customers as of now.
 SELECT *
 FROM [dbo].[Top10Customers]
 OPTION (FOR TIMESTAMP AS OF 'YOUR_TIMESTAMP');
```
クエリの名前を Time Travel Nowに変更します。
Time Travel クエリに戻り、Copy コマンドを使用してクエリ結果をコピーします。
Time Travel Now クエリに戻り、YOUR_TIMESTAMP をクリップボードにコピーしたタイムスタンプに置き換えます。

Important

FOR TIMESTAMP AS OFリテラルは最大で3桁の分数秒(yyyy-MM-ddTHH:mm:ss[.fff]形式)を受け入れます。コピーした値に3桁以上の分数秒数(例: 2024-05-02T20:44:13.7700000)がある場合は、ミリ秒単位(2024-05-02T20:44:13.770)にトリミングしてください。高精度リテラルは変換誤差で失敗します。詳細は「タイムトラベルの制限」を参照してください。
クエリを実行し、2 番目の先頭 CustomerKey 値が Tailspin Toys (Muir, MI)の場合は 49 であることに注意してください。
タイムスタンプから 1 分間のを減算して、タイムスタンプ値を以前の時刻に変更します。
もう一度クエリを実行し、2 番目の一番上の CustomerKey 値が Wingtip Toys (Sarversville, PA)の場合は 381 であることに注意してください。