Denne artikkelen inneholder fremgangsmåter for å opprette og administrere øyeblikksbilder av lager ved hjelp av Fabric-portalen, T-SQL-spørringer eller Fabric API-en.
Forutsetninger
- Et stoffarbeidsområde med en aktiv kapasitet eller prøvekapasitet.
- Et stofflager.
- Kontroller de nødvendige brukertillatelsene.
Opprett
Flere øyeblikksbilder kan opprettes for samme overordnede lager. Når øyeblikksbilder av lageret er opprettet, vises de som underordnede elementer i det overordnede lageret i arbeidsområdevisningen.
Øyeblikksbilder av lager kan opprettes via Fabric-portalen. Velg Øyeblikksbilde av nytt lager på båndet under Administrasjon.
Eksempel på JSON-forespørsel om å opprette et øyeblikksbilde av et lager 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
}
}
Erstatt <workspace ID> og <parent warehouse ID> med tilsvarende stoffarbeidsområde og lager-ID-er. Hvis du vil finne disse verdiene, kan du gå til lageret i Fabric-portalen.
-
<workspace ID>: Finn GUID-en for arbeidsområdet i nettadressen etter inndelingen /groups/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
-
<parent warehouse ID>: Finn lager-GUID-en i nettadressen etter inndelingen /warehouses/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
<bearer token>: Få dette ved å følge disse trinnene:
- Åpne Microsoft Fabric-arbeidsområdet ditt i en nettleser (Microsoft Edge eller Google Chrome).
- Trykk F12 for å åpne Utviklerverktøy.
- Velg Konsoll-fanen. Hvis det er nødvendig, velger du Utvid hurtigvisning for å vise konsollledeteksten
>.
- Skriv inn kommandoen
powerBIAccessToken , og trykk ENTER. Høyreklikk på den store unike strengen som returneres i konsollen, og velg Kopier strenginnhold.
- Lim den inn i stedet for
<bearer token>.
Angi selvforklarende verdier for <snapshot item display name> og <helpful description of snapshot item>.
Angi et tidspunkt for øyeblikksbildet som skal baseres på. Tidsstempelet kan settes til hvilket som helst punkt innenfor den konfigurerte oppbevaringsperioden. Hvis snapshotDateTime det ikke er angitt, bruker øyeblikksbildet gjeldende klokkeslett.
Slik returnerer du egenskapene for det angitte øyeblikksbildet:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Erstatt
<workspace ID> og <warehouse snapshot ID> med tilsvarende Fabric workspace ID og warehouse snapshotId. Hvis du vil finne disse verdiene, kan du gå til øyeblikksbildet av lageret i Fabric-portalen.
-
<workspace ID>: Finn GUID-en for arbeidsområdet i nettadressen etter inndelingen /groups/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
-
<warehouse snapshot ID>: Finn GUID-en for øyeblikksbilde av lageret i NETTADRESSEn etter inndelingen /warehousesnapshots/ .
Spør et øyeblikksbilde
Når de er opprettet, vises øyeblikksbilder av lager som underordnede elementer i arbeidsområdet.
Koble til øyeblikksbildet akkurat som et lager. I innstillingene til lagerbildet ditt, velg siden SQL endpoint for å vise og kopiere SQL tilkoblingsstreng. Dette er servernavnet for lagerbildet ditt, og det ser ut som: <server-name>.datawarehouse.fabric.microsoft.com.
Brukere med riktige tillatelser (administrator, medlem, bidragsyter eller seer) kan spørre et øyeblikksbilde akkurat som et lager. For mer informasjon, se Warehouse-tilkobling i Microsoft Fabric.
Vis tidsstempelet for øyeblikksbilde
Når en T-SQL-spørring kjøres, inkluderes informasjon om gjeldende versjon av dataene som åpnes. Du kan for eksempel se tidsstempelet i redigeringsprogrammet for meldinger i Stoffportal-portalen:
Hvis du vil se øyeblikksbilder av et lager og gjeldende tidsstempel, bruker du følgende T-SQL-spørring på sys.databases og den utvidede egenskapen TIMESTAMP til å gjengi 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;
Oppdater tidsstempel for øyeblikksbilde
Du kan når som helst oppdatere tidsstempelet for et eksisterende øyeblikksbilde av lageret.
Du kan utføre dette med T-SQL-kommandoer i konteksten til det overordnede lageret, eller via Fabric-portalen. Hvis du vil ha mer informasjon, kan du se Oppdatere tidsstempel for øyeblikksbilde.
Velg Hent ny tilstand fra hurtigmenyen i Stoffportalen, og velg deretter et tidsstempel for øyeblikksbildet. Du kan velge Nåværende eller hvilket som helst punkt innenfor den konfigurerte oppbevaringsperioden.
ALTER DATABASE SQL-setningen bruker systemtiden for lageret som det nye tidspunktet kildelagerdataene gjenspeiles i øyeblikksbildet.
Hvis du vil oppdatere øyeblikksbildet til gjeldende tilstand for lageret, bruker du CURRENT_TIMESTAMP.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Tidsstempelet kan også settes til et hvilket som helst punkt innenfor den konfigurerte oppbevaringsperioden. Argumentets format TIMESTAMP er YYYY-MM-DDTHH:MM:SS.SS. Hvis du for eksempel vil angi tidsstempelet til 27. april 2025 kl. 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Øyeblikksbilder av lager kan også oppdateres via Fabric-portalen. På båndet, under Administrasjon, velger du Administrer øyeblikksbilde av lager.
Bemerkning
Når du endrer den konfigurerbare oppbevaringsperioden, hvis en reduksjon i lagringsperioden vil ugyldiggjøre ett eller flere eksisterende lagerøyeblikksbilder (fordi deres snapshot-tidsstempel faller utenfor det nye lagringsvinduet), blir endringen blokkert. For å gå videre, flytt først de berørte øyeblikksbildene til et nyere tidsstempel eller slett dem, og oppdater deretter lagringsperioden.
Gi nytt navn
Du kan gi nytt navn til et øyeblikksbilde av et lager via REST-API og i Fabric-portalen.
Øyeblikksbilder av lager kan gis nytt navn via Fabric-portalen. Åpne øyeblikksbildet av lageret. Velg innstillinger-knappen, angi et nytt navn.
Eksempel på JSON-forespørsel om å gi nytt navn til et øyeblikksbilde av lageret 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
}
}
Erstatt <workspace ID> , <warehouse snapshot ID>og <parent Warehouse ID>med tilsvarende fabric arbeidsområde og lager-ID-er. Hvis du vil finne disse verdiene, kan du gå til øyeblikksbildet av lageret i Fabric-portalen.
-
<workspace ID>: Finn GUID-en for arbeidsområdet i nettadressen etter inndelingen /groups/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
-
<warehouse snapshot ID>: Finn GUID-en for øyeblikksbilde av lageret i NETTADRESSEn etter inndelingen /warehousesnapshots/ .
-
<parent warehouse ID>: Finn lager-GUID-en i nettadressen etter inndelingen /warehouses/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
<bearer token>: Få dette ved å følge disse trinnene:
- Åpne Microsoft Fabric-arbeidsområdet ditt i en nettleser (Microsoft Edge eller Google Chrome).
- Trykk F12 for å åpne Utviklerverktøy.
- Velg Konsoll-fanen. Hvis det er nødvendig, velger du Utvid hurtigvisning for å vise konsollledeteksten
>.
- Skriv inn kommandoen
powerBIAccessToken , og trykk ENTER. Høyreklikk på den store unike strengen som returneres i konsollen, og velg Kopier strenginnhold.
- Lim den inn i stedet for
<bearer token>.
Angi selvforklarende verdier for <snapshot item new display name> og <helpful description of snapshot item>.
Angi et tidspunkt for øyeblikksbildet som skal baseres på. Tidsstempelet kan settes til hvilket som helst punkt innenfor den konfigurerte oppbevaringsperioden. Hvis snapshotDateTime det ikke er angitt, bruker øyeblikksbildet gjeldende klokkeslett.
Slett
Du kan slette et øyeblikksbilde av et lager i Stoff-portalen eller med REST-API-en.
Øyeblikksbilder av lager kan slettes via Fabric-portalen. Velg hurtigmenyen for øyeblikksbildeelementet for lageret i elementlisten for arbeidsområdet, og velg Slett.
Eksempel på REST-API-forespørsel for sletting av et øyeblikksbilde:
DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Erstatt
<workspace ID> og <warehouse snapshot ID> med tilsvarende stoffarbeidsområde og lager-ID-er. Hvis du vil finne disse verdiene, kan du gå til øyeblikksbildet av lageret i Fabric-portalen.
-
<workspace ID>: Finn GUID-en for arbeidsområdet i nettadressen etter inndelingen /groups/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
-
<warehouse snapshot ID>: Finn GUID-en for øyeblikksbilde av lageret i NETTADRESSEn etter inndelingen /warehousesnapshots/ .
-
<bearer token>: Få dette ved å følge disse trinnene:
- Åpne Microsoft Fabric-arbeidsområdet ditt i en nettleser (Microsoft Edge eller Google Chrome).
- Trykk F12 for å åpne Utviklerverktøy.
- Velg Konsoll-fanen. Hvis det er nødvendig, velger du Utvid hurtigvisning for å vise konsollledeteksten
>.
- Skriv inn kommandoen
powerBIAccessToken , og trykk ENTER. Høyreklikk på den store unike strengen som returneres i konsollen, og velg Kopier strenginnhold.
- Lim den inn i stedet for
<bearer token>.
Relatert innhold