Items - Refresh Sql Endpoint Metadata

Hizmet:
SQLEndpoint
API Sürümü:
v1

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

İstek gövdesinde sağlandığında tables , yalnızca belirtilen tablolar yenilenir. Atlandığında veya boş olduğunda, tüm tablolar yenilenir.

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 tamamen 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. ile tablesbirleştirildiğinde, eşitleme durumu sıfırlamasının kapsamı yalnızca belirtilen tablolarla belirlenir. Varsayılan değer yanlıştır.
tables

TableDefinition[]

Sağlandığında, yenilemenin kapsamını yalnızca listelenen tabloların kapsamına alır. Atlandığında veya boş olduğunda, tüm tablolar yenilenir. Her girdi, bir şema ve bu şema altında yenilenmesi gereken bir veya daha fazla tablo adı belirtir. Tek bir istekte eşitlenebilen en fazla tablo sayısı 25'tir. Tablo çözümlemesi, SQL uç noktasının üst öğesinin şema etkin olup olmamasına bağlıdır. Şema etkinleştirilmiş öğeler için tablolar çağıran tarafından sağlanan şema kullanılarak çözümlenir. Şema etkin olmayan öğeler için, çağıran tarafından sağlanan şema değerinden bağımsız olarak tüm tablolar varsayılan şema altında çözümlenir; varsayılan olmayan şema altındaki tablolar çözümlenemez ve bir DeltaTableNotFound hatayla bildirilir.
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
429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

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
Refresh selective tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

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

Örnek isteği

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"
    }
  ]
}

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

Örnek isteği

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

{
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "dbo",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "DeltaTableNotFound",
        "message": "Delta table 'Tables\\OrderDetails\\_delta_log' not found."
      },
      "lastSuccessfulSyncDateTime": "2026-06-08T10:31:26.5329616Z"
    },
    {
      "tableName": "DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2026-06-08T08:32:53.3890146Z"
    }
  ]
}

Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace

Örnek isteği

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

{
  "recreateTables": true,
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    }
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    }
  ]
}

Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

Örnek isteği

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

{
  "tables": [
    {
      "schema": "sales",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "analytics",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "tableName": "sales.Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "sales.OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    },
    {
      "tableName": "analytics.DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:24.9183509Z"
    }
  ]
}

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 analiz uç noktasını yenilemeye yönelik istek yükü.
SyncStatus

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

Seçmeli yenileme kapsamını belirlemeye yönelik bir şema ve tablo adları çifti.
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ı.
isRetriable

boolean

True olduğunda istek yeniden denenebilir. Varsa gecikmeyi Retry-After belirlemek için yanıt üst bilgisini kullanın.
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 (uuid)

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 analiz uç noktasını yenilemeye yönelik istek yükü.

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 tamamen 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. ile tablesbirleştirildiğinde, eşitleme durumu sıfırlamasının kapsamı yalnızca belirtilen tablolarla belirlenir. Varsayılan değer yanlıştır.
tables

TableDefinition[]

Sağlandığında, yenilemenin kapsamını yalnızca listelenen tabloların kapsamına alır. Atlandığında veya boş olduğunda, tüm tablolar yenilenir. Her girdi, bir şema ve bu şema altında yenilenmesi gereken bir veya daha fazla tablo adı belirtir. Tek bir istekte eşitlenebilen en fazla tablo sayısı 25'tir. Tablo çözümlemesi, SQL uç noktasının üst öğesinin şema etkin olup olmamasına bağlıdır. Şema etkinleştirilmiş öğeler için tablolar çağıran tarafından sağlanan şema kullanılarak çözümlenir. Şema etkin olmayan öğeler için, çağıran tarafından sağlanan şema değerinden bağımsız olarak tüm tablolar varsayılan şema altında çözümlenir; varsayılan olmayan şema altındaki tablolar çözümlenemez ve bir DeltaTableNotFound hatayla bildirilir.
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.

TableDefinition

Nesne

Seçmeli yenileme kapsamını belirlemeye yönelik bir şema ve tablo adları çifti.

Name Tür Description
schema

string

minLength: 1
maxLength: 128

Tablo çözümlemesi için şema adı. Ayrılmış sistem şeması olmamalıdır.
tableNames

string[]

minLength: 1
maxLength: 128

Belirtilen şema altında yenilenmesi gereken bir veya daha fazla tablo adı.

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ı. Şema etkinleştirilmiş öğeler için, tablo adının önüne şema adı (örneğin, "schema.tableName") eklenir.

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.