Erstellen und Verwalten eines Lager-Snapshots

Dieser Artikel enthält Schritte zum Erstellen und Verwalten von Lagermomentaufnahmen mithilfe des Fabric-Portals, T-SQL-Abfragen oder der Fabric-API.

Voraussetzungen

Fabric-Arbeitsbereich mit aktiver Kapazität oder Testkapazität
Ein Stofflager.
Überprüfen Sie die erforderlichen Benutzerberechtigungen.

Erstellen

Für dasselbe übergeordnete Lager können mehrere Momentaufnahmen erstellt werden. Sobald Schnappschüsse des Lagers erstellt wurden, erscheinen sie als untergeordnete Elemente des Hauptlagers in der Arbeitsbereich-Ansicht.

Erstellen eines Lager-Snapshots im Fabric Portal
Erstellen eines Lager-Snapshots mit der REST-API

Lagermomentaufnahmen können über das Fabric-Portal erstellt werden. Wählen Sie im Ribbon unter Verwaltung die Option Neuer Lager-Snapshot aus.

Beispiel-JSON-Anforderung zum Erstellen einer Warehouse-Momentaufnahme über die REST-API:

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
  } 
}

Ersetzen <workspace ID> und <parent warehouse ID> durch die entsprechenden Fabric-Arbeitsbereichs- und Warehouse-IDs. Um diese Werte zu finden, besuchen Sie Ihr Warehouse im Fabric-Portal.
- <workspace ID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
- <parent warehouse ID>: Suchen Sie die Warehouse-GUID in der URL nach dem Abschnitt /warehouses/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
<bearer token>: Befolgen Sie diese Schritte, um dies zu erhalten:
1. Öffnen Sie Ihren Microsoft Fabric-Arbeitsbereich in einem Browser (Microsoft Edge oder Google Chrome).
2. Drücken Sie F12, um die Entwicklungstools zu öffnen.
3. Klicken Sie auf die Registerkarte Konsole. Wählen Sie bei Bedarf Schnellansicht erweitern aus, um die Konsoleneingabeaufforderung > anzuzeigen.
4. Geben Sie den Befehl powerBIAccessToken ein, und drücken Sie die EINGABETASTE. Klicken Sie mit der rechten Maustaste auf die große eindeutige Zeichenfolge, die in der Konsole zurückgegeben wird, und wählen Sie "Zeichenfolgeninhalt kopieren" aus.
5. Fügen Sie es anstelle von <bearer token> ein.
Geben Sie selbsterklärende Werte für <snapshot item display name> und <helpful description of snapshot item> an.
Geben Sie eine Zeit für die Erstellung der Momentaufnahme an. Der Zeitstempel kann auf einen beliebigen Punkt innerhalb des Aufbewahrungszeitraums (innerhalb der letzten 30 Tage) festgelegt werden. Falls snapshotDateTime nicht angegeben, verwendet die Momentaufnahme die aktuelle Uhrzeit.

So geben Sie die Eigenschaften der angegebenen Momentaufnahme zurück:

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

Ersetzen Sie <workspace ID> und <warehouse snapshot ID> durch die entsprechende Fabric-Arbeitsbereichs-ID und Lager-Snapshot-Id. Um diese Werte zu finden, besuchen Sie Ihren Lager-Schnappschuss im Fabric-Portal.
- <workspace ID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
- <warehouse snapshot ID>: Suchen Sie die Lagerbestandsaufnahme-GUID in der URL nach dem /warehousesnapshots/ Abschnitt.

Abfrage einer Momentaufnahme

Nach ihrer Erstellung werden Momentaufnahmen des Lagers als untergeordnete Elemente im Arbeitsbereich angezeigt.

Verbinden Sie sich mit der Momentaufnahme genau wie mit einem Warenlager. Besuchen Sie in den Einstellungen Ihrer Lagermomentaufnahme den SQL-Endpunkt, um die SQL-Verbindungszeichenfolge anzuzeigen und zu kopieren. Die Verbindungszeichenfolge sieht wie folgt aus: <server-name>.datawarehouse.fabric.microsoft.com. Benutzer mit entsprechenden Berechtigungen (Administrator, Mitglied, Mitwirkender oder Betrachter) können eine Momentaufnahme genau wie ein Datenlager abfragen. Weitere Informationen finden Sie unter Warehouse-Konnektivität in Microsoft Fabric.

Anzeigen des Momentaufnahmezeitstempels

Wenn eine T-SQL-Abfrage ausgeführt wird, werden Informationen zur aktuellen Version der daten, auf die zugegriffen wird, enthalten. Sie können z. B. den Zeitstempel im Abfrage-Editor des Fabric-Portals sehen:

Um die Momentaufnahmen eines Lagers und deren aktuelle Zeitstempel anzuzeigen, verwenden Sie die folgende T-SQL-Abfrage in Verbindung mit sys.databases und der erweiterten Eigenschaft von TIMESTAMP, um Attribute zu rendern.

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;

Aktualisieren des Momentaufnahmezeitstempels

Sie können den Zeitstempel einer vorhandenen Lagermomentaufnahme jederzeit aktualisieren.

Sie können dies mit T-SQL-Befehlen im Kontext des übergeordneten Lagers oder über das Fabric-Portal erreichen. Weitere Informationen finden Sie unter Aktualisieren des Zeitstempels für Momentaufnahmen.

Wählen Sie im Fabric-Portal im Kontextmenü " Neuen Zustand erfassen " aus, und wählen Sie dann einen Zeitstempel für die Momentaufnahme aus. Sie können den aktuellen oder beliebigen Punkt innerhalb des Aufbewahrungszeitraums (innerhalb der letzten 30 Tage) auswählen.

Die ALTER DATABASE SQL-Anweisung verwendet die Systemzeit des Lagers als neuen Zeitpunkt, in dem die Quelllagerdaten in der Momentaufnahme wiedergegeben werden.

Um die Momentaufnahme auf den aktuellen Zustand des Lagers zu aktualisieren, verwenden Sie CURRENT_TIMESTAMP.
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP; 
```
Der Zeitstempel kann auch auf einen beliebigen Punkt innerhalb des Aufbewahrungszeitraums (innerhalb der letzten 30 Tage) festgelegt werden. Das Format des TIMESTAMP Arguments ist YYYY-MM-DDTHH:MM:SS.SS. Um beispielsweise den Zeitstempel auf den 27. April 2025 um 18:10 UTC festzulegen:
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
```

Lagermomentaufnahmen können auch über das Fabric-Portal aktualisiert werden. Wählen Sie im Menüband unter "Verwaltung" die Option "Lagermomentaufnahme verwalten" aus.

Umbenennen

Sie können ein Lager-Snapshot-Element über die REST-API und im Fabric-Portal umbenennen.

Umbenennen eines Lagerbestandssnapshots im Fabric-Portal
Benennen Sie eine Lagermomentaufnahme mit der REST-API um

Bestands-Snapshots können über das Fabric-Portal umbenannt werden. Öffnen Sie Ihre Lagerbestandsaufnahme. Wählen Sie die Schaltfläche "Einstellungen" aus, geben Sie einen neuen Namen ein.

Beispiel-JSON-Anforderung zum Umbenennen einer Lagermomentaufnahme über die REST-API:

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
  } 
}

Ersetzen Sie <workspace ID>, <warehouse snapshot ID> und <parent Warehouse ID> durch die entsprechenden IDs für Fabric-Arbeitsbereich und Lager. Um diese Werte zu finden, besuchen Sie Ihren Lager-Schnappschuss im Fabric-Portal.
- <workspace ID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
- <warehouse snapshot ID>: Suchen Sie die Lagerbestandsaufnahme-GUID in der URL nach dem /warehousesnapshots/ Abschnitt.
- <parent warehouse ID>: Suchen Sie die Warehouse-GUID in der URL nach dem Abschnitt /warehouses/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
<bearer token>: Befolgen Sie diese Schritte, um dies zu erhalten:
1. Öffnen Sie Ihren Microsoft Fabric-Arbeitsbereich in einem Browser (Microsoft Edge oder Google Chrome).
2. Drücken Sie F12, um die Entwicklungstools zu öffnen.
3. Klicken Sie auf die Registerkarte Konsole. Wählen Sie bei Bedarf Schnellansicht erweitern aus, um die Konsoleneingabeaufforderung > anzuzeigen.
4. Geben Sie den Befehl powerBIAccessToken ein, und drücken Sie die EINGABETASTE. Klicken Sie mit der rechten Maustaste auf die große eindeutige Zeichenfolge, die in der Konsole zurückgegeben wird, und wählen Sie "Zeichenfolgeninhalt kopieren" aus.
5. Fügen Sie es anstelle von <bearer token> ein.
Geben Sie selbsterklärende Werte für <snapshot item new display name> und <helpful description of snapshot item> an.
Geben Sie eine Zeit für die Erstellung der Momentaufnahme an. Der Zeitstempel kann auf einen beliebigen Punkt innerhalb des Aufbewahrungszeitraums (innerhalb der letzten 30 Tage) festgelegt werden. Falls snapshotDateTime nicht angegeben, verwendet die Momentaufnahme die aktuelle Uhrzeit.

Löschen

Sie können eine Lagermomentaufnahme im Fabric-Portal oder mit der REST-API löschen.

Löschen einer Lagermomentaufnahme im Fabric-Portal
Löschen eines Lager-Snapshots mit REST-API

Momentaufnahmen des Lagerbestands können über das Fabric-Portal gelöscht werden. Wählen Sie in der Arbeitsbereichselementliste das Kontextmenü für das Lagermomentaufnahmeelement aus, und wählen Sie "Löschen" aus.

Beispiel-REST-API-Anforderung zum Löschen einer Momentaufnahme:

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

Ersetzen <workspace ID> und <warehouse snapshot ID> durch die entsprechenden Fabric-Arbeitsbereichs- und Warehouse-IDs. Um diese Werte zu finden, besuchen Sie Ihren Lager-Schnappschuss im Fabric-Portal.
- <workspace ID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
- <warehouse snapshot ID>: Suchen Sie die Lagerbestandsaufnahme-GUID in der URL nach dem /warehousesnapshots/ Abschnitt.
<bearer token>: Gewinnen Sie dies mit den folgenden Schritten:
1. Öffnen Sie Ihren Microsoft Fabric-Arbeitsbereich in einem Browser (Microsoft Edge oder Google Chrome).
2. Drücken Sie F12, um die Entwicklungstools zu öffnen.
3. Klicken Sie auf die Registerkarte Konsole. Wählen Sie bei Bedarf Schnellansicht erweitern aus, um die Konsoleneingabeaufforderung > anzuzeigen.
4. Geben Sie den Befehl powerBIAccessToken ein, und drücken Sie die EINGABETASTE. Klicken Sie mit der rechten Maustaste auf die große eindeutige Zeichenfolge, die in der Konsole zurückgegeben wird, und wählen Sie "Zeichenfolgeninhalt kopieren" aus.
5. Fügen Sie es anstelle von <bearer token> ein.

Feedback

War diese Seite hilfreich?

Last updated on 2025-11-10