Bu makale Doku portalı, T-SQL sorguları veya Doku API'sini kullanarak ambar anlık görüntüleri oluşturma ve yönetme adımlarını içerir.
Önkoşullar
- Aktif kapasite veya deneme kapasitesine sahip bir Fabric çalışma alanı.
- Bir kumaş deposu.
- Gerekli kullanıcı izinlerini doğrulayın.
Oluştur
Aynı ana ambar için birden çok anlık görüntü oluşturulabilir. Ambarın anlık görüntüleri oluşturulduktan sonra, çalışma alanı görünümünde ana ambarın alt öğeleri olarak görünür.
Depo anlık görüntüleri Fabric portalı aracılığıyla oluşturulabilir. Şeritteki Yönetim'in altında Yeni ambar anlık görüntüsü'ne tıklayın.
REST API aracılığıyla bir ambar anlık görüntüsü oluşturmak için örnek JSON isteği:
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>
ve <parent warehouse ID>
ilgili Fabric çalışma alanı ve depo kimlikleriyle değiştirin. Bu değerleri bulmak için Doku portalında ambarınızı ziyaret edin.
-
<workspace ID>
: /groups/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak çalışma alanı GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
-
<parent warehouse ID>
: /warehouses/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak ambar GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
<bearer token>
: Aşağıdaki adımları izleyerek bunu elde edin:
- Microsoft Fabric çalışma alanınızı tarayıcıda (Microsoft Edge veya Google Chrome) açın.
- Geliştirici Araçları'nı açmak için F12 tuşuna basın.
-
Konsol sekmesini seçin. Gerekirse, konsol istemini göstermek için Hızlı Görünümü Genişlet'i seçin
>
.
- Komutunu
powerBIAccessToken
yazın ve Enter tuşuna basın. Konsolda döndürülen büyük benzersiz dizeye sağ tıklayın ve Dize içeriğini kopyala'yı seçin.
- yerine
<bearer token>
yapıştırın.
<snapshot item display name>
ve <helpful description of snapshot item>
için kendi kendine açıklayıcı değerler sağlayın.
Anlık görüntünün temel alınması için bir zaman dilimi sağlayın. Zaman damgası, saklama süresi içinde (son 30 gün içinde) herhangi bir noktaya ayarlanabilir. Eğer snapshotDateTime
sağlanmazsa, anlık görüntü geçerli saati kullanır.
Belirtilen anlık görüntünün özelliklerini döndürmek için:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
-
<workspace ID>
ve <warehouse snapshot ID>
'i ilgili Fabric çalışma alanı kimliği ve depo snapshotId değeriyle değiştirin. Bu değerleri bulmak için Fabric portalında depo anlık görüntünüzü ziyaret edin.
-
<workspace ID>
: /groups/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak çalışma alanı GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
-
<warehouse snapshot ID>
: /warehousesnapshots/
bölümünden sonraki URL'de ambar anlık görüntüsü GUID'sini bulun.
Anlık görüntüyü sorgulama
Oluşturulduktan sonra, depo anlık görüntüleri çalışma alanında alt öğeler olarak görünür.
Anlık görüntüye tıpkı bir ambar gibi bağlanın. Sql bağlantı dizesini görüntülemek ve kopyalamak için ambar anlık görüntünüzün ayarlarında SQL uç noktasını ziyaret edin. Bağlantı dizesi şöyle görünür: <server-name>.datawarehouse.fabric.microsoft.com
. Uygun izinlere sahip kullanıcılar (Yönetici, Üye, Katkıda Bulunan veya Görüntüleyici) bir anlık görüntüyü tıpkı bir ambar gibi sorgulayabilir. Daha fazla bilgi için bkz. Microsoft Fabric'te depo bağlantısı.
Anlık görüntü zaman damgasını görüntüleme
T-SQL sorgusu çalıştırıldığında, erişilmekte olan verilerin geçerli sürümüyle ilgili bilgiler eklenir. Örneğin, zaman damgasını Doku portalının iletileri sorgu düzenleyicisinde görebilirsiniz:
Bir ambarın anlık görüntülerini ve mevcut zaman damgalarını görmek için, sys.databases
üzerinde aşağıdaki T-SQL sorgusunu ve öznitelikleri görüntülemek için TIMESTAMP
'in genişletilmiş özelliğini kullanın.
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;
Anlık görüntü zaman damgasını güncelleştirme
Mevcut bir ambar anlık görüntüsünün zaman damgasını istediğiniz zaman güncelleştirebilirsiniz.
Bunu üst ambar bağlamında veya Doku portalı aracılığıyla T-SQL komutlarıyla gerçekleştirebilirsiniz. Daha fazla bilgi için bkz . Anlık görüntü zaman damgasını güncelleştirme.
Doku portalında bağlam menüsünden Yeni durumu yakala'yı seçin ve ardından anlık görüntü için bir zaman damgası seçin.
Geçerli'yi veya saklama süresi içinde herhangi bir noktayı (son 30 gün içinde) seçebilirsiniz.
SQL deyimi, ALTER DATABASE
kaynak ambar verilerinin anlık görüntüye yansıtılacağı yeni zaman noktası olarak ambarın sistem saatini kullanır.
Anlık görüntüyü ambarın geçerli durumuna güncelleştirmek için kullanın CURRENT_TIMESTAMP
.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Zaman damgası, saklama süresi içinde (son 30 gün içinde) herhangi bir noktaya da ayarlanabilir. Bu TIMESTAMP
argümanın formatı YYYY-MM-DDTHH:MM:SS.SS
. Örneğin, zaman damgasını 27 Nisan 2025 saat 18:10 UTC olarak ayarlamak için:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Yeniden Adlandır
REST API ve Fabric portalı aracılığıyla bir depo anlık görüntü öğesini yeniden adlandırabilirsiniz.
Ambar anlık görüntüleri Fabric portalı üzerinden yeniden adlandırılabilir. Depo anlık görüntünüzü açın. Ayarlar düğmesini seçin, yeni bir Ad girin.
REST API aracılığıyla bir ambar anlık görüntüsünü yeniden adlandırmak için örnek JSON isteği:
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>
ve <parent Warehouse ID>
değerlerini ilgili Doku çalışma alanı ve ambar kimlikleriyle değiştirin. Bu değerleri bulmak için Fabric portalında depo anlık görüntünüzü ziyaret edin.
-
<workspace ID>
: /groups/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak çalışma alanı GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
-
<warehouse snapshot ID>
: URL'deki /warehousesnapshots/
bölümünü geçtikten sonra ambar anlık görüntüsü GUID'sini bulun.
-
<parent warehouse ID>
: /warehouses/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak ambar GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
<bearer token>
: Aşağıdaki adımları izleyerek bunu elde edin:
- Microsoft Fabric çalışma alanınızı tarayıcıda (Microsoft Edge veya Google Chrome) açın.
- Geliştirici Araçları'nı açmak için F12 tuşuna basın.
-
Konsol sekmesini seçin. Gerekirse, konsol istemini göstermek için Hızlı Görünümü Genişlet'i seçin
>
.
- Komutunu
powerBIAccessToken
yazın ve Enter tuşuna basın. Konsolda döndürülen büyük benzersiz dizeye sağ tıklayın ve Dize içeriğini kopyala'yı seçin.
- yerine
<bearer token>
yapıştırın.
<snapshot item new display name>
ve <helpful description of snapshot item>
için kendi kendine açıklayıcı değerler sağlayın.
Anlık görüntünün temel alınması için bir zaman dilimi sağlayın. Zaman damgası, saklama süresi içinde (son 30 gün içinde) herhangi bir noktaya ayarlanabilir. Eğer snapshotDateTime
sağlanmazsa, anlık görüntü geçerli saati kullanır.
Sil
Fabric portalında veya REST API ile bir ambar anlık görüntüsünü silebilirsiniz.
Depo anlık görüntüleri Fabric portalı üzerinden silinebilir. Çalışma alanı öğesi listesinde ambar anlık görüntüsü öğesinin bağlam menüsünü ve ardından Sil'i seçin.
Anlık görüntüyü silmek için örnek REST API isteği:
DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
-
<workspace ID>
ve <warehouse snapshot ID>
ilgili Fabric çalışma alanı ve depo kimlikleriyle değiştirin. Bu değerleri bulmak için Fabric portalında depo anlık görüntünüzü ziyaret edin.
-
<workspace ID>
: /groups/
bölümünden sonraki URL'de veya mevcut bir ambarda SELECT @@SERVERNAME
çalıştırarak çalışma alanı GUID'sini bulun. Örneğin, 11aaa111-a11a-1111-1aaa-aa111111aaa
.
/
karakterlerini eklemeyin.
-
<warehouse snapshot ID>
: /warehousesnapshots/
bölümünden sonraki URL'de ambar anlık görüntüsü GUID'sini bulun.
-
<bearer token>
: Aşağıdaki adımları izleyerek bunu elde edin:
- Microsoft Fabric çalışma alanınızı tarayıcıda (Microsoft Edge veya Google Chrome) açın.
- Geliştirici Araçları'nı açmak için F12 tuşuna basın.
-
Konsol sekmesini seçin. Gerekirse, konsol istemini göstermek için Hızlı Görünümü Genişlet'i seçin
>
.
- Komutunu
powerBIAccessToken
yazın ve Enter tuşuna basın. Konsolda döndürülen büyük benzersiz dizeye sağ tıklayın ve Dize içeriğini kopyala'yı seçin.
- yerine
<bearer token>
yapıştırın.
İlgili içerik