Membuat dan mengelola rekam jepret gudang

Artikel ini mencakup langkah-langkah untuk membuat dan mengelola rekam jepret gudang menggunakan portal Fabric, kueri T-SQL, atau Fabric API.

Prasyarat

• Ruang kerja Fabric dengan kapasitas aktif atau kapasitas uji coba.
• Sebuah gudang kain.
• Verifikasi izin pengguna yang diperlukan.

Buat

Beberapa rekam jepret dapat dibuat untuk gudang induk yang sama. Setelah rekam jepret gudang dibuat, rekam jepret tersebut muncul sebagai item turunan dari gudang induk dalam tampilan ruang kerja.

Membuat rekam jepret gudang di portal Fabric

Rekam jepret gudang dapat dibuat melalui portal Fabric. Di pita, di bawah Manajemen, pilih Rekam jepret gudang baru.

Membuat rekam jepret gudang dengan REST API

Contoh permintaan JSON untuk membuat rekam jepret gudang melalui 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
  } 
} 

• Ganti <workspace ID> dan <parent warehouse ID> dengan ID ruang kerja dan gudang Fabric yang sesuai. Untuk menemukan nilai-nilai ini, kunjungi gudang Anda di portal Fabric.

  • <workspace ID>: Temukan GUID ruang kerja di URL setelah bagian /groups/ , atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.
  • <parent warehouse ID>: Temukan GUID gudang di URL setelah bagian /warehouses/, atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.

• <bearer token>: Dapatkan ini dengan mengikuti langkah-langkah berikut:

  1. Buka ruang kerja Microsoft Fabric Anda di browser (Microsoft Edge atau Google Chrome).
  2. Tekan F12 untuk membuka Alat Pengembang.
  3. Pilih tab Konsol . Jika perlu, pilih Perluas Tampilan Cepat untuk menampilkan perintah >konsol .
  4. Ketik perintah powerBIAccessToken dan tekan Enter. Klik kanan pada string unik besar yang dikembalikan di konsol dan pilih Salin konten string.
  5. Tempelkan sebagai pengganti <bearer token>.

• Berikan nilai penjelasan mandiri untuk <snapshot item display name> dan <helpful description of snapshot item>.

• Berikan waktu sebagai acuan untuk snapshot. Tanda waktu dapat diatur ke titik mana pun dalam periode retensi yang dikonfigurasi. Jika snapshotDateTime tidak disediakan, rekam jepret menggunakan waktu saat ini.

Untuk mengembalikan properti rekam jepret yang ditentukan:

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

• Ganti <workspace ID> dan <warehouse snapshot ID> dengan ID ruang kerja Fabric dan snapshotId gudang yang sesuai. Untuk menemukan nilai-nilai ini, kunjungi rekam jepret gudang Anda di portal Fabric.
  • <workspace ID>: Temukan GUID ruang kerja di URL setelah bagian /groups/ , atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.
  • <warehouse snapshot ID>: Temukan GUID cuplikan gudang di URL setelah bagian /warehousesnapshots/.

Meminta cuplikan

Setelah dibuat, rekam jepret gudang muncul sebagai item turunan di ruang kerja.

Sambungkan ke rekam jepret seperti gudang. Di pengaturan cuplikan gudang Anda, pilih halaman SQL endpoint untuk melihat dan menyalin string koneksi SQL. Ini adalah nama server untuk rekam jepret gudang Anda, dan terlihat seperti: <server-name>.datawarehouse.fabric.microsoft.com.

Pengguna dengan izin yang sesuai (Admin, Anggota, Kontributor, atau Penampil) dapat mengkueri rekam jepret seperti gudang. Untuk informasi selengkapnya, lihat konektivitas Warehouse di Microsoft Fabric.

Menampilkan tanda waktu rekam jepret

Saat kueri T-SQL dijalankan, informasi tentang versi data saat ini yang diakses disertakan. Misalnya, Anda dapat melihat tanda waktu di Pesan-pesan dari editor kueri portal Fabric:

Untuk melihat cuplikan gudang dan cap waktu saat ini, gunakan kueri T-SQL berikut pada sys.databases dan properti yang diperluas dari TIMESTAMP untuk merender atribut:

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;

Memperbarui tanda waktu rekam jepret

Anda dapat memperbarui tanda waktu rekam jepret gudang yang ada kapan saja.

Anda dapat menyelesaikan ini dengan perintah T-SQL dalam konteks gudang induk, atau melalui portal Fabric. Untuk informasi selengkapnya, lihat Memperbarui tanda waktu rekam jepret.

Di portal Fabric, pilih Ambil status baru dari menu konteks, lalu pilih tanda waktu untuk rekam jepret. Anda dapat memilih Saat ini atau titik mana pun dalam periode retensi yang dikonfigurasi.

Pernyataan ALTER DATABASE SQL menggunakan waktu sistem gudang sebagai titik waktu baru di mana data gudang sumber akan tercermin dalam rekam jepret.

• Untuk memperbarui rekam jepret ke status gudang saat ini, gunakan CURRENT_TIMESTAMP.

  ALTER DATABASE [<snapshot name>]
  SET TIMESTAMP = CURRENT_TIMESTAMP; 
  

• Tanda waktu juga dapat diatur ke titik mana pun dalam periode retensi yang dikonfigurasi. Format TIMESTAMP argumen adalah YYYY-MM-DDTHH:MM:SS.SS. Misalnya, untuk mengatur tanda waktu ke 27 April 2025 pada pukul 18.10 UTC:

  ALTER DATABASE [<snapshot name>]
  SET TIMESTAMP = '2025-04-27T18:10:00.00';
  

Rekam jepret gudang juga dapat diperbarui melalui portal Fabric. Di pita, di bawah Manajemen, pilih Kelola rekam jepret gudang.

Note

Saat Anda mengubah periode retensi yang dapat dikonfigurasi, jika penurunan ke periode retensi akan membatalkan satu atau beberapa rekam jepret gudang yang ada (karena tanda waktu rekam jepretnya berada di luar jendela retensi baru), perubahan retensi diblokir. Untuk melanjutkan, pertama-tama lanjutkan rekam jepret yang terpengaruh ke tanda waktu yang lebih baru atau hapus, lalu perbarui periode retensi.

Ubah nama

Anda dapat mengganti nama item rekam jepret gudang melalui REST API dan di portal Fabric.

Mengganti nama snapshot gudang di portal Fabric

Cuplikan gudang dapat diganti namanya melalui portal Fabric. Buka rekam jepret gudang Anda. Pilih tombol pengaturan, berikan Nama baru.

Mengganti nama rekam jepret gudang dengan REST API

Contoh permintaan JSON untuk mengganti nama rekam jepret gudang melalui 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
  } 
}

• Ganti <workspace ID> , <warehouse snapshot ID>, dan <parent Warehouse ID>dengan RUANG kerja Fabric dan ID gudang yang sesuai. Untuk menemukan nilai-nilai ini, kunjungi rekam jepret gudang Anda di portal Fabric.

  • <workspace ID>: Temukan GUID ruang kerja di URL setelah bagian /groups/ , atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.
  • <warehouse snapshot ID>: Temukan GUID cuplikan gudang di URL setelah bagian /warehousesnapshots/.
  • <parent warehouse ID>: Temukan GUID gudang di URL setelah bagian /warehouses/, atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.

• <bearer token>: Dapatkan ini dengan mengikuti langkah-langkah berikut:

  1. Buka ruang kerja Microsoft Fabric Anda di browser (Microsoft Edge atau Google Chrome).
  2. Tekan F12 untuk membuka Alat Pengembang.
  3. Pilih tab Konsol . Jika perlu, pilih Perluas Tampilan Cepat untuk menampilkan perintah >konsol .
  4. Ketik perintah powerBIAccessToken dan tekan Enter. Klik kanan pada string unik besar yang dikembalikan di konsol dan pilih Salin konten string.
  5. Tempelkan sebagai pengganti <bearer token>.

• Berikan nilai penjelasan mandiri untuk <snapshot item new display name> dan <helpful description of snapshot item>.

• Berikan waktu sebagai acuan untuk snapshot. Tanda waktu dapat diatur ke titik mana pun dalam periode retensi yang dikonfigurasi. Jika snapshotDateTime tidak disediakan, rekam jepret menggunakan waktu saat ini.

Menghapus

Anda dapat menghapus rekam jepret gudang di portal Fabric atau dengan REST API.

Menghapus rekam jepret gudang di portal Fabric

Rekam jepret gudang dapat dihapus melalui portal Fabric. Di daftar item ruang kerja, pilih menu konteks untuk item rekam jepret gudang, dan pilih Hapus.

Menghapus rekam jepret gudang dengan REST API

Contoh permintaan REST API untuk menghapus rekam jepret:

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

• Ganti <workspace ID> dan <warehouse snapshot ID> dengan ID ruang kerja dan gudang Fabric yang sesuai. Untuk menemukan nilai-nilai ini, kunjungi rekam jepret gudang Anda di portal Fabric.
  • <workspace ID>: Temukan GUID ruang kerja di URL setelah bagian /groups/ , atau dengan menjalankan SELECT @@SERVERNAME di gudang yang ada. Contohnya, 11aaa111-a11a-1111-1aaa-aa111111aaa. Jangan sertakan karakter /.
  • <warehouse snapshot ID>: Temukan GUID cuplikan gudang di URL setelah bagian /warehousesnapshots/.
• <bearer token>: Dapatkan ini dengan mengikuti langkah-langkah berikut:
  1. Buka ruang kerja Microsoft Fabric Anda di browser (Microsoft Edge atau Google Chrome).
  2. Tekan F12 untuk membuka Alat Pengembang.
  3. Pilih tab Konsol . Jika perlu, pilih Perluas Tampilan Cepat untuk menampilkan perintah >konsol .
  4. Ketik perintah powerBIAccessToken dan tekan Enter. Klik kanan pada string unik besar yang dikembalikan di konsol dan pilih Salin konten string.
  5. Tempelkan sebagai pengganti <bearer token>.

Konten terkait

• Rekaman gudang
• UBAH DATABASE SET opsi