Ez a cikk a fabricportál, a T-SQL-lekérdezések vagy a Fabric API használatával történő raktári pillanatképek létrehozásának és kezelésének lépéseit tartalmazza.
Előfeltételek
- Fabric-munkaterület, amely aktív kapacitással vagy próbakapacitással rendelkezik.
- Egy szövetraktár.
- Ellenőrizze a szükséges felhasználói engedélyeket.
Hozz létre
Több pillanatkép is létrehozható ugyanahhoz a szülőraktárhoz. A raktári pillanatképek létrehozása után a szülőraktár gyermekelemeiként jelennek meg a munkaterület nézetben.
Raktári pillanatképek létrehozhatók a Fabric portálon. A menüszalag Kezelés területén válassza az Új raktári pillanatkép lehetőséget.
Minta JSON-kérés egy raktári pillanatkép REST API-val történő létrehozásához:
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
}
}
Cserélje le <workspace ID>
és <parent warehouse ID>
a(z) megfelelő Fabric munkaterület azonosítókra, és raktárazonosítókra. Ezeknek az értékeknek a megkereséséhez látogassa meg a raktárat a Fabric portálon.
-
<workspace ID>
: Keresse meg a munkaterület GUID azonosítót a /groups/
szakasz utáni URL-címben, vagy futtassa SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
-
<parent warehouse ID>
: Keresse meg a raktár GUID azonosítót az URL-címben a /warehouses/
szakasz után, vagy futtassa a SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
Ezt az alábbi lépések követésével szerezheti be:
- Nyissa meg a Microsoft Fabric-munkaterületet egy böngészőben (Microsoft Edge vagy Google Chrome).
- A Fejlesztői eszközök megnyitásához nyomja le F12.
- Válassza a Konzol lapot. Ha szükséges, válassza a Gyorsnézet kibontása lehetőséget a konzol parancssorának
>
megjelenítéséhez.
- Írja be a parancsot
powerBIAccessToken
, és nyomja le az Enterbillentyűt. Kattintson a jobb gombbal a konzolon visszaadott nagy egyedi sztringre, és válassza a Sztring tartalmának másolása lehetőséget.
- Másolja be a
<bearer token>
helyére.
Adjon meg magától értetődő értékeket a <snapshot item display name>
és a <helpful description of snapshot item>
számára.
Adjon meg egy időpontot a pillanatkép alapjául. Az időbélyeg a megőrzési időszakon belül (az elmúlt 30 napon belül) bármely pontra beállítható. Ha snapshotDateTime
nincs megadva, a pillanatkép az aktuális időt használja.
A megadott pillanatkép tulajdonságainak visszaadása:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Cserélje le a
<workspace ID>
és <warehouse snapshot ID>
elemeket a megfelelő Fabric munkaterület azonosítójára és a raktári pillanatkép azonosítójára. Ezeknek az értékeknek a megkereséséhez látogasson el a Fabric portálon található raktári instantképre.
-
<workspace ID>
: Keresse meg a munkaterület GUID azonosítót a /groups/
szakasz utáni URL-címben, vagy futtassa SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
-
<warehouse snapshot ID>
: Keresse meg a raktári pillanatkép GUID-azonosítóját a /warehousesnapshots/
szakasz utáni URL-címben.
Pillanatkép lekérdezése
A létrehozás után a raktári pillanatképek gyermekelemként jelennek meg a munkaterületen.
Csatlakozzon a pillanatképhez úgy, mint egy raktárhoz. A raktári pillanatkép beállításai között látogasson el az SQL-végpontra, hogy megtekintse és lemásolja az SQL-kapcsolati sztringet. A kapcsolati sztring a következőképpen néz ki: <server-name>.datawarehouse.fabric.microsoft.com
. A megfelelő engedélyekkel (rendszergazda, tag, közreműködő vagy megtekintő) rendelkező felhasználók ugyanúgy kérdezhetnek le egy pillanatképet, mint egy raktárban. További információ: Warehouse-kapcsolat a Microsoft Fabricben.
A pillanatkép időbélyegének megtekintése
T-SQL-lekérdezés futtatásakor a rendszer információkat tartalmaz a hozzáférés alatt álló adatok aktuális verziójáról. Az időbélyeg például a Háló portál lekérdezésszerkesztőjénekÜzenetei lapján látható:
Egy raktár pillanatképeinek és aktuális időbélyegeinek megtekintéséhez használja a következő T-SQL-lekérdezést a(z) sys.databases
elemen, és a(z) TIMESTAMP
kiterjesztett tulajdonságot az attribútumok megjelenítéséhez.
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;
Pillanatkép időbélyegének frissítése
A meglévő raktári pillanatképek időbélyegét bármikor frissítheti.
Ezt T-SQL-parancsokkal, a szülőraktár környezetében vagy a Háló portálon keresztül teheti meg. További információ: Pillanatkép-időbélyeg frissítése.
A Háló portálon válassza az Új állapot rögzítése lehetőséget a helyi menüből, majd válasszon egy időbélyeget a pillanatképhez. A megőrzési időszakon belül (az elmúlt 30 napon belül) kiválaszthatja az Aktuális vagy bármely pontot.
Az ALTER DATABASE
SQL-utasítás a raktár rendszeridejeként használja az új időpontot, amelyben a forrásraktár adatai megjelennek a pillanatképben.
Ha frissíteni szeretné a pillanatképet a raktár aktuális állapotára, használja a következőt CURRENT_TIMESTAMP
: .
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Az időbélyeg a megőrzési időszak bármely pontjára beállítható (az elmúlt 30 napon belül). Az argumentum formátuma TIMESTAMP
: YYYY-MM-DDTHH:MM:SS.SS
. Ha például az időbélyeget 2025. április 27-én 18:10-kor (UTC) szeretné beállítani:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Átnevezés
Átnevezhet egy raktári pillanatkép-elemet a REST API-val és a Háló portálon.
A raktári pillanatképek átnevezhetők a Fabric portálon keresztül. Nyissa meg a raktár pillanatképét. Válassza a Beállítások gombot, és adjon meg egy új nevet.
Minta JSON-kérés a raktár pillanatképének REST API-val való átnevezésére:
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
}
}
Cserélje le a <workspace ID>
, <warehouse snapshot ID>
, és <parent Warehouse ID>
elemeket a megfelelő Fabric munkaterület- és raktárazonosítókra. Az értékek megkereséséhez látogasson el a Fabric portálon található raktár pillanatképére.
-
<workspace ID>
: Keresse meg a munkaterület GUID azonosítót a /groups/
szakasz utáni URL-címben, vagy futtassa SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
-
<warehouse snapshot ID>
: Keresse meg a raktári pillanatkép GUID-azonosítóját a /warehousesnapshots/
szakasz utáni URL-címben.
-
<parent warehouse ID>
: Keresse meg a raktár GUID azonosítót az URL-címben a /warehouses/
szakasz után, vagy futtassa a SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
Ezt az alábbi lépések követésével szerezheti be:
- Nyissa meg a Microsoft Fabric-munkaterületet egy böngészőben (Microsoft Edge vagy Google Chrome).
- A Fejlesztői eszközök megnyitásához nyomja le F12.
- Válassza a Konzol lapot. Ha szükséges, válassza a Gyorsnézet kibontása lehetőséget a konzol parancssorának
>
megjelenítéséhez.
- Írja be a parancsot
powerBIAccessToken
, és nyomja le az Enterbillentyűt. Kattintson a jobb gombbal a konzolon visszaadott nagy egyedi sztringre, és válassza a Sztring tartalmának másolása lehetőséget.
- Másolja be a
<bearer token>
helyére.
Adjon meg magától értetődő értékeket a <snapshot item new display name>
és a <helpful description of snapshot item>
számára.
Adjon meg egy időpontot a pillanatkép alapjául. Az időbélyeg a megőrzési időszakon belül (az elmúlt 30 napon belül) bármely pontra beállítható. Ha snapshotDateTime
nincs megadva, a pillanatkép az aktuális időt használja.
Törlés
A Fabric portálon vagy a REST API-val törölheti a raktár pillanatképét.
A raktári pillanatképek a Fabric portálon törölhetők. A munkaterület elemlistájában válassza ki a raktári pillanatképelem helyi menüjét, majd válassza a Törlés lehetőséget.
Minta REST API-kérés pillanatkép törléséhez:
DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Cserélje le
<workspace ID>
és <warehouse snapshot ID>
a(z) megfelelő Fabric munkaterület azonosítókra, és raktárazonosítókra. Ezeknek az értékeknek a megkereséséhez látogasson el a Fabric portálon található raktári instantképre.
-
<workspace ID>
: Keresse meg a munkaterület GUID azonosítót a /groups/
szakasz utáni URL-címben, vagy futtassa SELECT @@SERVERNAME
egy meglévő raktárban. Például: 11aaa111-a11a-1111-1aaa-aa111111aaa
. Ne tartalmazza a /
karaktereket.
-
<warehouse snapshot ID>
: Keresse meg a raktári pillanatkép GUID-azonosítóját a /warehousesnapshots/
szakasz utáni URL-címben.
-
<bearer token>
: Ezt az alábbi lépések végrehajtásával szerezheti be:
- Nyissa meg a Microsoft Fabric-munkaterületet egy böngészőben (Microsoft Edge vagy Google Chrome).
- A Fejlesztői eszközök megnyitásához nyomja le F12.
- Válassza a Konzol lapot. Ha szükséges, válassza a Gyorsnézet kibontása lehetőséget a konzol parancssorának
>
megjelenítéséhez.
- Írja be a parancsot
powerBIAccessToken
, és nyomja le az Enterbillentyűt. Kattintson a jobb gombbal a konzolon visszaadott nagy egyedi sztringre, és válassza a Sztring tartalmának másolása lehetőséget.
- Másolja be a
<bearer token>
helyére.
Kapcsolódó tartalom