ウェアハウススナップショットの作成と管理 (プレビュー)

2025-05-20

この記事では、Fabric ポータル、T-SQL クエリ、または Fabric API を使用して、ウェアハウススナップショットを作成および管理する手順について説明します。

注

現在、ウェアハウススナップショットはプレビュー機能です。

[前提条件]

アクティブな容量または試用版の容量を持つ Fabric ワークスペース。
ファブリックウェアハウス。
必要なユーザーのアクセス許可を確認します。

創造する

同じ親ウェアハウスに対して複数のスナップショットを作成できます。倉庫スナップショットが作成されると、ワークスペースビューに親倉庫の子項目として表示されます。

Fabric ポータルでウェアハウススナップショットを作成する
REST API を使用してウェアハウススナップショットを作成する

ウェアハウススナップショットは、Fabric ポータルを使用して作成できます。リボンの [ 管理] で、[ 新しいウェアハウススナップショット] を選択します。

REST API を使用してウェアハウススナップショットを作成するためのサンプル JSON 要求:

POST https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items
Authorization: Bearer <bearer token>
Content-Type: application/json

{ 
 "type": "WarehouseSnapshot",
  "displayName": "<snapshot item display name>", 
  "description": "<helpful description of snapshot item>", 
  "creationPayload": { 
    "parentWarehouseId": "<parent warehouse ID>", 
    "snapshotDateTime": "<YYYY-MM-DDTHH:SS:SSZ>" //Enter UTC time
  } 
}

<workspace ID> と <parent warehouse ID> は、対応する Fabric ワークスペースとウェアハウス ID に置き換えます。これらの値を見つけるには、Fabric ポータルでウェアハウスにアクセスします。
- <workspace ID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
- <parent warehouse ID>: /warehouses/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してウェアハウス GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
<bearer token>: 次の手順に従ってこれを取得します。
1. ブラウザー (Microsoft Edge または Google Chrome) で Microsoft Fabric ワークスペースを開きます。
2. F12 キーを押して開発者ツールを開きます。
3. [コンソール] タブを選択します。必要に応じて、[簡易ビューの展開] を選択して、コンソールプロンプト > を表示します。
4. コマンド powerBIAccessToken を入力して、Enter キーを押します。コンソールで返された大きな一意の文字列を右クリックし、[ 文字列の内容をコピー] を選択します。
5. <bearer token> の代わりに貼り付けます。
<snapshot item display name>と<helpful description of snapshot item>のわかりやすい値を指定します。
スナップショットの基になる時間を指定します。タイムスタンプは、保持期間内 (過去 30 日以内) の任意の時点に設定できます。 snapshotDateTime指定されていない場合、スナップショットは現在の時刻を使用します。

指定したスナップショットのプロパティを返すには:

GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>

<workspace ID>と<warehouse snapshot ID>を、対応する Fabric ワークスペース ID とウェアハウス snapshotId に置き換えます。これらの値を確認するには、Fabric ポータルでウェアハウススナップショットにアクセスします。
- <workspace ID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
- <warehouse snapshot ID>: /warehousesnapshots/ セクションの後の URL で、ウェアハウススナップショット GUID を見つけます。

スナップショットのクエリを実行する

作成されると、ワークスペースに子項目としてウェアハウススナップショットが表示されます。

データ倉庫と同様にスナップショットに接続してください。ウェアハウススナップショットの設定で、 SQL エンドポイント にアクセスして、 SQL 接続文字列を表示してコピーします。接続文字列は次のようになります: <server-name>.datawarehouse.fabric.microsoft.com。適切なアクセス許可 (管理者、メンバー、共同作成者、またはビューアー) を持つユーザーは、ウェアハウスと同様にスナップショットに対してクエリを実行できます。詳細については、「 Microsoft Fabric のウェアハウス接続」を参照してください。

スナップショットのタイムスタンプを表示する

T-SQL クエリを実行すると、アクセスされているデータの現在のバージョンに関する情報が含まれます。たとえば、Fabric ポータルクエリエディターのメッセージでタイムスタンプを確認できます。

ウェアハウスのスナップショットとその現在のタイムスタンプを表示するには、 sys.databases に対して次の T-SQL クエリを使用し、 TIMESTAMP の拡張プロパティを使用して属性をレンダリングします。

SELECT snapshot_name = v.name
, source_warehouse_name = s.name
, snapshot_timestamp = DATABASEPROPERTYEX(v.name,'TIMESTAMP')
FROM sys.databases AS v 
INNER JOIN sys.databases AS s ON v.source_database_id=s.database_id;

スナップショットのタイムスタンプを更新する

既存のウェアハウススナップショットのタイムスタンプはいつでも更新できます。

これを実現するには、親ウェアハウスのコンテキストで、または Fabric ポータルを使用して T-SQL コマンドを使用します。詳細については、「スナップショットタイムスタンプの更新」を参照してください。

Fabric ポータルで、コンテキストメニューから [ 新しい状態のキャプチャ ] を選択し、スナップショットのタイムスタンプを選択します。保持期間内 (過去 30 日以内) に現在または任意のポイントを選択できます。

ALTER DATABASE SQL ステートメントでは、ソースウェアハウスデータがスナップショットに反映される新しい時点として、ウェアハウスのシステム時刻が使用されます。

スナップショットをウェアハウスの現在の状態に更新するには、 CURRENT_TIMESTAMPを使用します。
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP; 
```
タイムスタンプは、保持期間内 (過去 30 日以内) の任意のポイントに設定することもできます。 TIMESTAMP引数の形式はYYYY-MM-DDTHH:MM:SS.SS。たとえば、タイムスタンプを 2025 年 4 月 27 日 18:10 UTC に設定するには、次のようにします。
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
```

名前の変更

REST API と Fabric ポータルを使用して、ウェアハウススナップショット項目の名前を変更できます。

Fabric ポータルでウェアハウススナップショットの名前を変更する
REST API を使用してウェアハウススナップショットの名前を変更する

Fabric ポータルを使用して、ウェアハウススナップショットの名前を変更できます。ウェアハウススナップショットを開いてください。 [設定] ボタンを選択し、新しい 名前を指定します。

REST API を使用してウェアハウススナップショットの名前を変更する JSON 要求のサンプル:

PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token> 
Content-Type: application/json

{ 
  "type": "WarehouseSnapshot",
  "displayName": "<snapshot item new display name>", 
  "description": "<helpful description of snapshot item>", 
  "creationPayload": { 
    "parentWarehouseId": "<parent warehouse ID>", 
    "snapshotDateTime": "YYYY-MM-DDTHH:SS:SSZ" //Enter UTC time
  } 
}

<workspace ID>、<warehouse snapshot ID>、および<parent Warehouse ID>を対応する Fabric ワークスペースおよびウェアハウス ID に置き換えます。これらの値を確認するには、Fabric ポータルでウェアハウススナップショットにアクセスします。
- <workspace ID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
- <warehouse snapshot ID>: /warehousesnapshots/ セクションの後の URL で、ウェアハウススナップショット GUID を見つけます。
- <parent warehouse ID>: /warehouses/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してウェアハウス GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
<bearer token>: 次の手順に従ってこれを取得します。
1. ブラウザー (Microsoft Edge または Google Chrome) で Microsoft Fabric ワークスペースを開きます。
2. F12 キーを押して開発者ツールを開きます。
3. [コンソール] タブを選択します。必要に応じて、[簡易ビューの展開] を選択して、コンソールプロンプト > を表示します。
4. コマンド powerBIAccessToken を入力して、Enter キーを押します。コンソールで返された大きな一意の文字列を右クリックし、[ 文字列の内容をコピー] を選択します。
5. <bearer token> の代わりに貼り付けます。
<snapshot item new display name>と<helpful description of snapshot item>のわかりやすい値を指定します。
スナップショットの基になる時間を指定します。タイムスタンプは、保持期間内 (過去 30 日以内) の任意の時点に設定できます。 snapshotDateTime指定されていない場合、スナップショットは現在の時刻を使用します。

削除

Fabric ポータルまたは REST API を使用して、ウェアハウススナップショットを削除できます。

Fabric ポータルでウェアハウススナップショットを削除する
REST API を使用してウェアハウススナップショットを削除する

ウェアハウススナップショットは、Fabric ポータルを使用して削除できます。ワークスペース項目の一覧で、倉庫スナップショット項目のコンテキストメニューを選択し、[削除] を選択 します。

スナップショットを削除するための REST API 要求の例:

DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>

<workspace ID> と <warehouse snapshot ID> は、対応する Fabric ワークスペースとウェアハウス ID に置き換えます。これらの値を確認するには、Fabric ポータルでウェアハウススナップショットにアクセスします。
- <workspace ID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。たとえば、11aaa111-a11a-1111-1aaa-aa111111aaa のようにします。 / 文字は含めないでください。
- <warehouse snapshot ID>: /warehousesnapshots/ セクションの後の URL で、ウェアハウススナップショット GUID を見つけます。
<bearer token>: 次の手順に従ってこれを取得します。
1. ブラウザー (Microsoft Edge または Google Chrome) で Microsoft Fabric ワークスペースを開きます。
2. F12 キーを押して開発者ツールを開きます。
3. [コンソール] タブを選択します。必要に応じて、[簡易ビューの展開] を選択して、コンソールプロンプト > を表示します。
4. コマンド powerBIAccessToken を入力して、Enter キーを押します。コンソールで返された大きな一意の文字列を右クリックし、[ 文字列の内容をコピー] を選択します。
5. <bearer token> の代わりに貼り付けます。

次の方法で共有

ウェアハウス スナップショットの作成と管理 (プレビュー)