บทความนี้ประกอบด้วยขั้นตอนในการสร้างและจัดการสแนปช็อตคลังสินค้าโดยใช้พอร์ทัล Fabric คิวรี T-SQL หรือ Fabric API
ข้อกําหนดเบื้องต้น
- พื้นที่ทํางาน Fabric ที่มีความจุที่ใช้งานอยู่หรือความจุรุ่นทดลองใช้
- คลังสินค้าผ้า
- ตรวจสอบ สิทธิ์ของผู้ใช้ที่จําเป็น
สร้าง
สามารถสร้างสแนปช็อตหลายรายการสําหรับคลังสินค้าหลักเดียวกันได้ เมื่อสร้างสแนปช็อตของคลังสินค้าแล้ว สแนปช็อตจะปรากฏเป็นรายการย่อยของคลังสินค้าหลักในมุมมองพื้นที่ทํางาน
สามารถสร้างสแนปช็อตคลังสินค้าผ่านพอร์ทัล Fabric ได้ ในริบบอน ภายใต้การจัดการ เลือกสแนปช็อตคลังสินค้าใหม่
ตัวอย่างคําขอ JSON สําหรับการสร้างสแนปช็อตคลังสินค้าผ่าน 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
}
}
แทนที่ <workspace ID> และ <parent warehouse ID> ด้วย Id พื้นที่ทํางาน Fabric และ Warehouse ที่สอดคล้องกัน หากต้องการค้นหาค่าเหล่านี้ โปรดไปที่คลังสินค้าของคุณในพอร์ทัล Fabric
-
<workspace ID>: ค้นหาพื้นที่ทํางาน GUID ใน URL หลังจาก /groups/ ส่วน หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
-
<parent warehouse ID>: ค้นหา GUID ของคลังสินค้าใน URL หลังจากส่วน /warehouses/ หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
<bearer token>: ขอรับสิทธิ์นี้โดยทําตามขั้นตอนเหล่านี้:
- เปิดพื้นที่ทํางาน Microsoft Fabric ของคุณในเบราว์เซอร์ (Microsoft Edge หรือ Google Chrome)
- กด F12 เพื่อเปิด เครื่องมือสําหรับนักพัฒนา
- เลือก แท็บคอนโซล ถ้าจําเป็น เลือก ขยายมุมมอง ด่วนเพื่อแสดงพร้อมท์
>คอนโซล
- พิมพ์คําสั่ง
powerBIAccessTokenและกด Enter คลิกขวาบนสตริงที่ไม่ซ้ํากันขนาดใหญ่ที่ส่งกลับในคอนโซลและเลือกคัดลอกเนื้อหาสตริง
- วางแทนที่
<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> ด้วย ID พื้นที่ทํางาน Fabric และ snapshotId ของคลังสินค้าที่สอดคล้องกัน หากต้องการค้นหาค่าเหล่านี้ ให้ไปที่สแนปช็อตคลังสินค้าของคุณในพอร์ทัล Fabric
-
<workspace ID>: ค้นหาพื้นที่ทํางาน GUID ใน URL หลังจาก /groups/ ส่วน หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
-
<warehouse snapshot ID>: ค้นหา GUID สแนปช็อตคลังสินค้าใน URL หลังจาก /warehousesnapshots/ ส่วน
คิวรีสแนปช็อต
เมื่อสร้างแล้ว สแนปช็อตของคลังสินค้าจะปรากฏเป็นรายการย่อยในพื้นที่ทํางาน
เชื่อมต่อกับสแนปช็อตเช่นเดียวกับคลังสินค้า ในการตั้งค่าสแนปช็อตของคลังสินค้าของคุณ ไปที่จุดสิ้นสุด SQL เพื่อดูและคัดลอกสตริงการเชื่อมต่อ SQL สตริงการเชื่อมต่อมีลักษณะดังนี้: <server-name>.datawarehouse.fabric.microsoft.com ผู้ใช้ที่มีสิทธิ์ที่เหมาะสม (ผู้ดูแลระบบ สมาชิก ผู้สนับสนุน หรือผู้ชม) สามารถคิวรีสแนปช็อตได้เช่นเดียวกับคลังสินค้า สําหรับข้อมูลเพิ่มเติม ดูการเชื่อมต่อ Warehouse ใน 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;
อัปเดตประทับเวลาของสแนปช็อต
คุณสามารถอัปเดตการประทับเวลาของสแนปช็อตคลังสินค้าที่มีอยู่ได้ทุกเมื่อ
คุณสามารถทําสิ่งนี้ให้สําเร็จได้ด้วยคําสั่ง T-SQL ในบริบทของคลังสินค้าหลักหรือผ่านพอร์ทัล Fabric สําหรับข้อมูลเพิ่มเติม ให้ดู อัปเดตการประทับเวลาของสแนปช็อต
ในพอร์ทัล Fabric เลือก จับภาพสถานะใหม่ จากเมนูบริบท จากนั้นเลือกการประทับเวลาสําหรับสแนปช็อต คุณสามารถเลือก ปัจจุบัน หรือจุดใดก็ได้ภายในระยะเวลาการเก็บรักษา (ภายใน 30 วันที่ผ่านมา)
คําสั่ง ALTER DATABASE SQL ใช้เวลาของระบบของคลังสินค้าเป็นจุดใหม่ในเวลาที่ข้อมูลคลังสินค้าต้นทางจะสะท้อนให้เห็นในสแนปช็อต
เมื่อต้องการอัพเดตสแนปช็อตเป็นสถานะปัจจุบันของคลังสินค้า ให้ใช้CURRENT_TIMESTAMP
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
นอกจากนี้ ประทับเวลายังสามารถตั้งค่าเป็นจุดใดก็ได้ภายในระยะเวลาการเก็บรักษา (ภายใน 30 วันที่ผ่านมา) รูปแบบของTIMESTAMPอาร์กิวเมนต์คือYYYY-MM-DDTHH:MM:SS.SS ตัวอย่างเช่น ในการตั้งค่าประทับเวลาเป็น 27 เมษายน 2025 ที่ 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
สแนปช็อตคลังสินค้ายังสามารถอัปเดตผ่านพอร์ทัล Fabric ได้อีกด้วย ใน Ribbon ภายใต้ การจัดการ ให้เลือก จัดการสแนปช็อตคลังสินค้า
ตั้งชื่อใหม่
คุณสามารถเปลี่ยนชื่อรายการสแนปช็อตของคลังสินค้าผ่าน REST API และในพอร์ทัล Fabric ได้
สามารถเปลี่ยนชื่อสแนปช็อตคลังสินค้าผ่านพอร์ทัล Fabric ได้ เปิดสแนปช็อตคลังสินค้าของคุณ เลือกปุ่มการตั้งค่า ใส่ ชื่อใหม่
ตัวอย่างคําขอ JSON เพื่อเปลี่ยนชื่อสแนปช็อตคลังสินค้าผ่าน 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
}
}
แทนที่ <workspace ID> , <warehouse snapshot ID>และ <parent Warehouse ID>ด้วยรหัสพื้นที่ทํางาน Fabric และ Warehouse ที่สอดคล้องกัน หากต้องการค้นหาค่าเหล่านี้ ให้ไปที่สแนปช็อตคลังสินค้าของคุณในพอร์ทัล Fabric
-
<workspace ID>: ค้นหาพื้นที่ทํางาน GUID ใน URL หลังจาก /groups/ ส่วน หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
-
<warehouse snapshot ID>: ค้นหา GUID สแนปช็อตคลังสินค้าใน URL หลังจาก /warehousesnapshots/ ส่วน
-
<parent warehouse ID>: ค้นหา GUID ของคลังสินค้าใน URL หลังจากส่วน /warehouses/ หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
<bearer token>: ขอรับสิทธิ์นี้โดยทําตามขั้นตอนเหล่านี้:
- เปิดพื้นที่ทํางาน Microsoft Fabric ของคุณในเบราว์เซอร์ (Microsoft Edge หรือ Google Chrome)
- กด F12 เพื่อเปิด เครื่องมือสําหรับนักพัฒนา
- เลือก แท็บคอนโซล ถ้าจําเป็น เลือก ขยายมุมมอง ด่วนเพื่อแสดงพร้อมท์
>คอนโซล
- พิมพ์คําสั่ง
powerBIAccessTokenและกด Enter คลิกขวาบนสตริงที่ไม่ซ้ํากันขนาดใหญ่ที่ส่งกลับในคอนโซลและเลือกคัดลอกเนื้อหาสตริง
- วางแทนที่
<bearer token>
ให้ค่าการอธิบายตนเองสําหรับ <snapshot item new display name> และ<helpful description of snapshot item>
ให้เวลาสําหรับสแนปช็อตที่จะยึดตาม ประทับเวลาสามารถตั้งค่าเป็นจุดใดก็ได้ภายในระยะเวลาการเก็บรักษา (ภายใน 30 วันที่ผ่านมา) ถ้า snapshotDateTime ไม่มี สแนปช็อตจะใช้เวลาปัจจุบัน
ลบ
คุณสามารถลบสแนปช็อตคลังสินค้าในพอร์ทัล 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> ด้วย Id พื้นที่ทํางาน Fabric และ Warehouse ที่สอดคล้องกัน หากต้องการค้นหาค่าเหล่านี้ ให้ไปที่สแนปช็อตคลังสินค้าของคุณในพอร์ทัล Fabric
-
<workspace ID>: ค้นหาพื้นที่ทํางาน GUID ใน URL หลังจาก /groups/ ส่วน หรือโดยการเรียกใช้ SELECT @@SERVERNAME ในคลังสินค้าที่มีอยู่ ตัวอย่างเช่น: 11aaa111-a11a-1111-1aaa-aa111111aaa อย่าใส่ / อักขระ
-
<warehouse snapshot ID>: ค้นหา GUID สแนปช็อตคลังสินค้าใน URL หลังจาก /warehousesnapshots/ ส่วน
-
<bearer token>: ขอรับบริการโดยทําตามขั้นตอนเหล่านี้:
- เปิดพื้นที่ทํางาน Microsoft Fabric ของคุณในเบราว์เซอร์ (Microsoft Edge หรือ Google Chrome)
- กด F12 เพื่อเปิด เครื่องมือสําหรับนักพัฒนา
- เลือก แท็บคอนโซล ถ้าจําเป็น เลือก ขยายมุมมอง ด่วนเพื่อแสดงพร้อมท์
>คอนโซล
- พิมพ์คําสั่ง
powerBIAccessTokenและกด Enter คลิกขวาบนสตริงที่ไม่ซ้ํากันขนาดใหญ่ที่ส่งกลับในคอนโซลและเลือกคัดลอกเนื้อหาสตริง
- วางแทนที่
<bearer token>
เนื้อหาที่เกี่ยวข้อง