Opret og administrer et snapshot af et lager

Denne artikel indeholder trin til oprettelse og administration af lagersnapshots ved hjælp af Fabric-portalen, T-SQL-forespørgsler eller Fabric-API'en.

Forudsætninger

Et Fabric-arbejdsområde med en aktiv kapacitet eller en prøveversionskapacitet.
Et stoflager.
Kontrollér de nødvendige brugertilladelser.

Opret

Der kan oprettes flere snapshots for det samme overordnede lager. Når lagersnapshots er oprettet, vises de som underordnede elementer for det overordnede lager i arbejdsområdevisningen.

Opret et lagersnapshot på Fabric-portalen
Opret et lagersnapshot med REST API

Lagersnapshots kan oprettes via Fabric-portalen. På båndet under Administration skal du vælge Nyt lagersnapshot.

Eksempel på JSON-anmodning om oprettelse af et lagersnapshot via REST-API'en:

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

Erstat <workspace ID> og <parent warehouse ID> med de tilsvarende Fabric-arbejdsområde- og lager-id'er. Hvis du vil finde disse værdier, skal du besøge dit lager på Fabric-portalen.
- <workspace ID>: Find arbejdsområdets GUID i URL-adressen efter /groups/ sektionen eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
- <parent warehouse ID>: Find lager-GUID'et i URL-adressen efter afsnittet /warehouses/ eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
<bearer token>: Hent dette ved at følge disse trin:
1. Åbn dit Microsoft Fabric-arbejdsområde i en browser (Microsoft Edge eller Google Chrome).
2. Tryk på F12 for at åbne Udviklerværktøjer.
3. Vælg fanen Konsol . Hvis det er nødvendigt, skal du vælge Udvid Hurtig visning for at få vist konsolprompten >.
4. Skriv kommandoen powerBIAccessToken , og tryk på Enter. Højreklik på den store entydige streng, der returneres i konsollen, og vælg Kopiér strengindhold.
5. Indsæt den i stedet for <bearer token>.
Angiv selvforklarende værdier for <snapshot item display name> og <helpful description of snapshot item>.
Angiv et tidspunkt, hvor snapshottet skal baseres på. Tidsstemplet kan sættes til et hvilket som helst tidspunkt inden for den konfigurerede opbevaringsperiode. Hvis snapshotDateTime ikke er angivet, bruger snapshottet det aktuelle klokkeslæt.

Sådan returnerer du egenskaberne for det angivne snapshot:

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

Erstat <workspace ID> og <warehouse snapshot ID> med det tilsvarende Fabric-arbejdsområde-id og lager snapshotId. Hvis du vil finde disse værdier, skal du gå til dit lagers snapshot på Fabric-portalen.
- <workspace ID>: Find arbejdsområdets GUID i URL-adressen efter /groups/ sektionen eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
- <warehouse snapshot ID>: Find GUID for lagersnapshot i URL-adressen efter /warehousesnapshots/ sektionen .

Forespørg om et snapshot

Når lagersnapshots er oprettet, vises de som underordnede elementer i arbejdsområdet.

Opret forbindelse til snapshottet på samme måde som et lager. I indstillingerne for dit lagersnapshot skal du vælge siden SQL endpoint for at se og kopiere SQL forbindelsesstreng. Dette er servernavnet for dit warehouse-snapshot, og det ser ud som: <server-name>.datawarehouse.fabric.microsoft.com.

Brugere med de rette tilladelser (administrator, medlem, bidragyder eller fremviser) kan forespørge om et snapshot på samme måde som et lager. For mere information, se Warehouse-forbindelse i Microsoft Fabric.

Vis tidsstempel for øjebliksbillede

Når der køres en T-SQL-forespørgsel, medtages oplysninger om den aktuelle version af de data, der tilgås. Du kan f.eks. se tidsstemplet i Meddelelser i Fabric Portal-forespørgselseditoren:

Hvis du vil se et lagers snapshots og deres aktuelle tidsstempel, skal du bruge følgende T-SQL-forespørgsel på sys.databases og den udvidede egenskab for TIMESTAMP til at gengive attributter:

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;

Opdater tidsstempel for øjebliksbillede

Du kan når som helst opdatere tidsstemplet for et eksisterende lagersnapshot.

Det kan du gøre med T-SQL-kommandoer i forbindelse med det overordnede lager eller via Fabric-portalen. Du kan få flere oplysninger under Opdater tidsstempel for øjebliksbillede.

På Fabric-portalen skal du vælge Hent ny tilstand i genvejsmenuen og derefter vælge et tidsstempel for snapshottet. Du kan vælge Aktuel eller et hvilket som helst tidspunkt inden for den konfigurerede opbevaringsperiode.

SQL-sætningen ALTER DATABASE bruger systemklokkeslæt for lageret som det nye tidspunkt, hvor kilde warehouse-dataene afspejles i snapshottet.

Hvis du vil opdatere snapshottet til lagerets aktuelle tilstand, skal du bruge CURRENT_TIMESTAMP.
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP; 
```
Tidsstemplet kan også sættes til et hvilket som helst tidspunkt inden for den konfigurerede opbevaringsperiode. Formatet af TIMESTAMP argumentet er YYYY-MM-DDTHH:MM:SS.SS. Hvis du f.eks. vil angive tidsstempel til 27. april 2025 kl. 18:10 UTC:
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
```

Lagersnapshots kan også opdateres via Fabric-portalen. På båndet under Administration skal du vælge Administrer lagerstedssnapshot.

Bemærkning

Når du ændrer den konfigurerbare opbevaringsperiode, og en reduktion af opbevaringsperioden ville ugyldiggøre en eller flere eksisterende warehouse-snapshots (fordi deres snapshot-tidsstempel ligger uden for det nye opbevaringsvindue), blokeres ændringen. For at fortsætte, skal du først flytte de berørte snapshots til et nyere tidsstempel eller slette dem, og derefter opdatere opbevaringsperioden.

Omdøb

Du kan omdøbe et lagers snapshotelement via REST API og på Fabric-portalen.

Omdøb et lagersnapshot på Fabric-portalen
Omdøb et lagersnapshot med REST API

Lagersnapshots kan omdøbes via Fabric-portalen. Åbn dit lagers snapshot. Vælg knappen Indstillinger, angiv et nyt navn.

Eksempel på JSON-anmodning om at omdøbe et lagersnapshot via REST-API'en:

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

Erstat <workspace ID> , <warehouse snapshot ID>og <parent Warehouse ID>med de tilsvarende Fabric-arbejdsområde- og lager-id'er. Hvis du vil finde disse værdier, skal du gå til dit lagers snapshot på Fabric-portalen.
- <workspace ID>: Find arbejdsområdets GUID i URL-adressen efter /groups/ sektionen eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
- <warehouse snapshot ID>: Find GUID for lagersnapshot i URL-adressen efter /warehousesnapshots/ sektionen .
- <parent warehouse ID>: Find lager-GUID'et i URL-adressen efter afsnittet /warehouses/ eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
<bearer token>: Hent dette ved at følge disse trin:
1. Åbn dit Microsoft Fabric-arbejdsområde i en browser (Microsoft Edge eller Google Chrome).
2. Tryk på F12 for at åbne Udviklerværktøjer.
3. Vælg fanen Konsol . Hvis det er nødvendigt, skal du vælge Udvid Hurtig visning for at få vist konsolprompten >.
4. Skriv kommandoen powerBIAccessToken , og tryk på Enter. Højreklik på den store entydige streng, der returneres i konsollen, og vælg Kopiér strengindhold.
5. Indsæt den i stedet for <bearer token>.
Angiv selvforklarende værdier for <snapshot item new display name> og <helpful description of snapshot item>.
Angiv et tidspunkt, hvor snapshottet skal baseres på. Tidsstemplet kan sættes til et hvilket som helst tidspunkt inden for den konfigurerede opbevaringsperiode. Hvis snapshotDateTime ikke er angivet, bruger snapshottet det aktuelle klokkeslæt.

Slet

Du kan slette et lagersnapshot på Fabric-portalen eller med REST-API'en.

Slet et lagersnapshot på Fabric-portalen
Slet et lagersnapshot med REST API

Lagersnapshots kan slettes via Fabric-portalen. På listen over arbejdsområdeelementer skal du vælge genvejsmenuen for lagersnapshotelementet og vælge Slet.

Eksempel på EN REST API-anmodning om sletning af et snapshot:

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

Erstat <workspace ID> og <warehouse snapshot ID> med de tilsvarende Fabric-arbejdsområde- og lager-id'er. Hvis du vil finde disse værdier, skal du gå til dit lagers snapshot på Fabric-portalen.
- <workspace ID>: Find arbejdsområdets GUID i URL-adressen efter /groups/ sektionen eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
- <warehouse snapshot ID>: Find GUID for lagersnapshot i URL-adressen efter /warehousesnapshots/ sektionen .
<bearer token>: Hent dette ved at følge disse trin:
1. Åbn dit Microsoft Fabric-arbejdsområde i en browser (Microsoft Edge eller Google Chrome).
2. Tryk på F12 for at åbne Udviklerværktøjer.
3. Vælg fanen Konsol . Hvis det er nødvendigt, skal du vælge Udvid Hurtig visning for at få vist konsolprompten >.
4. Skriv kommandoen powerBIAccessToken , og tryk på Enter. Højreklik på den store entydige streng, der returneres i konsollen, og vælg Kopiér strengindhold.
5. Indsæt den i stedet for <bearer token>.

Feedback

Var denne side nyttig?

Last updated on 2026-05-08