Items - Refresh Sql Endpoint Metadata

Hizmet:

SQLEndpoint

API Sürümü:

v1

SQL analiz uç noktası içindeki tüm tabloları yeniler.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Permissions

Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

Item.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{sqlEndpointId}/refreshMetadata

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
sqlEndpointId	path	True	string (uuid)	SQL analytics uç noktası kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Tür	Description
recreateTables	boolean	True olarak ayarlandığında, bu özellik sisteme yenileme işlemi sırasında SQL analytics uç noktasındaki tüm tabloları bırakmasını ve yeniden oluşturmasını önerir. Tabloları kaynak tanımlarından tam olarak yeniden oluşturmanız gerekiyorsa , örneğin tutarsızlıkları çözmek veya temiz bir yenileme sağlamak için bu seçeneği kullanın. Varsayılan değer yanlıştır.
timeout	Duration	Zaman aşımına uğramadan önceki istek süresi. Varsayılan değer 15 dakikadır.

Yanıtlar

Name	Tür	Description
200 OK	TableSyncStatuses	İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi, SQL analytics tablosu yenileme işlemi devam ediyor. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı.

Örnekler

Refresh all tables for a specified SQL analytics endpoint in a workspace

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

Örnek yanıt

Durum kodu:

200

{
  "value": [
    {
      "tableName": "Table 1",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:54.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2025-08-08T10:36:54.9651741Z"
    },
    {
      "tableName": "Table 2",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:43:02.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "AdalRetryException",
        "message": "Couldn't run query. There is a problem with the Microsoft Entra ID token. Have the warehouse owner log in again. If they're unavailable, use the takeover feature."
      },
      "lastSuccessfulSyncDateTime": "2025-08-07T10:44:27.2632648Z"
    },
    {
      "tableName": "Table 3",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:59.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2025-08-06T08:32:53.3890146Z"
    }
  ]
}

Tanımlar

Name	Description
Duration	Bir süre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
SqlEndpointRefreshMetadataRequest	SQL analaytics uç noktası istek yükünü yenileyin.
SyncStatus	Eşitleme işleminin durumu. Zaman içinde ek SyncStatus türleri eklenebilir.
TableSyncStatus	Tablo eşitleme durumu nesnesi.
TableSyncStatuses	Tablo eşitleme durumlarının listesi.
TimeUnit	Süre için zaman birimi. Zaman içinde ek süre türleri eklenebilir.

Duration

Nesne

Bir süre.

Name	Tür	Description
timeUnit	TimeUnit	Süre için zaman birimi. Zaman içinde ek süre türleri eklenebilir.
value	number	Süre içindeki timeUnits sayısı.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

SqlEndpointRefreshMetadataRequest

Nesne

SQL analaytics uç noktası istek yükünü yenileyin.

Name	Tür	Description
recreateTables	boolean	True olarak ayarlandığında, bu özellik sisteme yenileme işlemi sırasında SQL analytics uç noktasındaki tüm tabloları bırakmasını ve yeniden oluşturmasını önerir. Tabloları kaynak tanımlarından tam olarak yeniden oluşturmanız gerekiyorsa , örneğin tutarsızlıkları çözmek veya temiz bir yenileme sağlamak için bu seçeneği kullanın. Varsayılan değer yanlıştır.
timeout	Duration	Zaman aşımına uğramadan önceki istek süresi. Varsayılan değer 15 dakikadır.

SyncStatus

Numaralandırma

Eşitleme işleminin durumu. Zaman içinde ek SyncStatus türleri eklenebilir.

Değer	Description
Success	Başarılı olduğunu gösterir.
Failure	Bir hatayı gösterir.
NotRun	İşlemin çalışmadığını gösterir.

TableSyncStatus

Nesne

Tablo eşitleme durumu nesnesi.

Name	Tür	Description
endDateTime	string (date-time)	YYYY-AA-GGTHH:mm:ssZ biçimini kullanarak tablo eşitlemesinin UTC'de tamamlandığı tarih ve saat.
error	ErrorResponseDetails	Hata yanıtı ayrıntıları
lastSuccessfulSyncDateTime	string (date-time)	YYYY-AA-GGTHH:mm:ssZ biçimini kullanarak tablo eşitlemesinin UTC'de başarılı olduğu tarih ve saat.
startDateTime	string (date-time)	YYYY-MM-DDTHH:mm:ssZ biçimini kullanarak tablo eşitlemesinin UTC'de başlatıldığı tarih ve saat.
status	SyncStatus	Tablonun hatasız eşitlenip eşitlenmediği.
tableName	string	Eşitlenen tablonun adı.

TableSyncStatuses

Nesne

Tablo eşitleme durumlarının listesi.

Name	Tür	Description
value	TableSyncStatus[]	Tablo eşitleme durumlarının listesi.

TimeUnit

Numaralandırma

Süre için zaman birimi. Zaman içinde ek süre türleri eklenebilir.

Değer	Description
Seconds	Saniye cinsinden süre.
Minutes	Dakika cinsinden süre.
Hours	Saat cinsinden süre.
Days	Gün cinsinden süre.