Published - List Datasource Elements

Hizmet:: DataAgent

API Sürümü:: v1

Yayımlanan bir veri kaynağı için şema ağacı düzeyinde şema öğelerini döndürür.

Uyarı

Veri Aracısı yapılandırma yönetimi şu anda Önizleme aşamasındadır (daha fazla bilgi edinin).

Öğeler bir veri kaynağının şema ağacını (şemalar, tablolar, sütunlar) temsil eder. parametresini kullanarak düzey düzeyinde gezinin rootId .

Bu API, sayfalandırmadestekler.

İzinler

Çağıranın DataAgent için okuma izinlerine sahip olması gerekir.

Gerekli Devredilen Kapsamlar

Item.Read.All veya Item.ReadWrite.All veya DataAgent.Read.All veya DataAgent.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

Arayüz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataAgents/{dataAgentId}/datasources/{datasourceId}/elements

İsteğe bağlı parametrelerle:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataAgents/{dataAgentId}/datasources/{datasourceId}/elements?rootId={rootId}&continuationToken={continuationToken}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
dataAgentId	path	True	string (uuid)	DataAgent Kimliği.
datasourceId	path	True	string (uuid)	Veri kaynağı kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
continuationToken	query		string	Sonuçların sonraki sayfasını almak için bir belirteç.
rootId	query		string	Üst öğenin tanımlayıcısı. Kök düzeyini almak için atla.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	DataSourceElements	İstek başarıyla tamamlandı.
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	Sık karşılaşılan hata kodları: ItemNotFound - İstenen öğe bulunamadı.

DataSourceElements

İstek başarıyla tamamlandı.

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

Sık karşılaşılan hata kodları:

ItemNotFound - İstenen öğe bulunamadı.

Örnekler

List published DataAgent datasource elements example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataAgents/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/datasources/c1c6d12f-8d2a-4d5b-9ca1-8bb7b42d4a30/elements

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "id": "U2NoZW1hcw==",
      "isSelected": false,
      "displayName": "Schemas",
      "type": "Schemas",
      "hasSubElements": true,
      "state": "Available",
      "lastSyncDateTime": "2025-06-15T10:30:00Z"
    },
    {
      "id": "VGFibGVz",
      "isSelected": false,
      "displayName": "Tables",
      "type": "Tables",
      "hasSubElements": true,
      "state": "Available",
      "lastSyncDateTime": "2025-06-15T10:30:00Z"
    }
  ],
  "continuationToken": null,
  "continuationUri": null
}

Tanımlar

Name	Description
DataSourceElement	Veri kaynağı şema öğesi.
DataSourceElements	Veri kaynağı şema öğelerinin sayfalandırılmış listesi.
ElementState	Veri kaynağı şemasındaki öğesinin geçerli kullanılabilirliğini gösterir. Zaman içinde ek ElementState türleri eklenebilir.
ElementType	Veri kaynağı şema öğesinin genel türü. Zaman içinde ek ElementType türleri eklenebilir.
ErrorRelatedResource	Hata ile ilişkili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
IndexState	Lakehouse dosya dizinleri için dizin durumu. Zaman içinde ek IndexState türleri eklenebilir.

DataSourceElement

Nesne

Veri kaynağı şema öğesi.

Name	Tür	Description
dataType	string	Sütunlar için veri türü (örneğin, int, dize). Yalnızca sütun öğeleri için sunulur.
description	string	Öğesinin kullanıcı kümesi açıklaması.
displayName	string	Öğenin insan tarafından okunabilen adı.
hasSubElements	boolean	Bu öğenin detaya gidecek alt öğeleri olup olmadığı.
id	string	Öğe tanımlayıcısı. Şema ağacında daha ayrıntılı detaya gitmek için rootId olarak kullanın.
indexState	IndexState	Lakehouse dosya dizinleri için dizin durumu.
isSelected	boolean	Bu öğenin DataAgent tarafından kullanılmak üzere seçilip seçilmediği.
lastSyncDateTime	string	Bu öğenin en son veri kaynağı şemasından ISO 8601 zaman damgası (örneğin, 2025-06-15T10:30:00Z) olarak eşitlenmesi.
state	ElementState	Öğesinin canlı şemada mevcut olup olmadığını gösterir.
type	ElementType	Şema öğesinin türü.

DataSourceElements

Nesne

Veri kaynağı şema öğelerinin sayfalandırılmış listesi.

Name	Tür	Description
continuationToken	string	Sonraki sonuç kümesi toplu işleminin belirteci. Başka kayıt yoksa yanıttan kaldırılır.
continuationUri	string	Sonraki sonuç kümesi toplu işleminin URI'sini. Başka kayıt yoksa yanıttan kaldırılır.
value	DataSourceElement[]	Şema öğelerinin listesi.

ElementState

Numaralandırma

Veri kaynağı şemasındaki öğesinin geçerli kullanılabilirliğini gösterir. Zaman içinde ek ElementState türleri eklenebilir.

Değer	Description
Available	öğesi veri kaynağı şemasında kullanılabilir.
NotAvailable	öğesi daha önce yapılandırılmıştı ancak artık veri kaynağı şemasında kullanılamıyor.
AccessDenied	Erişim reddedildiğinden veri kaynağı şeması okunamadı.
AccessDeniedOap	Erişim bir kuruluş erişim ilkesi tarafından engellendiğinden veri kaynağı şeması okunamadı.
DatasourceNotFound	Veri kaynağı bulunamadı.
SchemaUnavailable	Veri kaynağı şeması şu anda kullanılamıyor.

ElementType

Numaralandırma

Veri kaynağı şema öğesinin genel türü. Zaman içinde ek ElementType türleri eklenebilir.

Değer	Description
Root	Veri kaynağı şema ağacının kök öğesi.
Files	Dosyalar kapsayıcı öğesi.
Directory	Dizin öğesi.
Schemas	Şema öğeleri için bir gruplandırma kapsayıcısı.
Tables	Tablo öğeleri için gruplandırma kapsayıcısı.
Views	Görünüm öğeleri için bir gruplandırma kapsayıcısı.
Functions	İşlev öğeleri için gruplandırma kapsayıcısı.
ScalarFunctions	Skaler işlev öğeleri için bir gruplandırma kapsayıcısı.
TableValuedFunctions	Tablo değerli işlev öğeleri için gruplandırma kapsayıcısı.
Shortcuts	Kısayol öğeleri için bir gruplandırma kapsayıcısı.
MaterializedViews	Gerçekleştirilmiş görünüm öğeleri için bir gruplandırma kapsayıcısı.
Schema	Şema öğesi.
Table	Tablo öğesi.
ExternalTable	Dış tablo öğesi.
MaterializedView	Gerçekleştirilmiş görünüm öğesi.
View	Bir görünüm öğesi.
Column	Sütun öğesi.
Measure	Bir ölçü öğesi.
Function	İşlev öğesi.
FunctionParameter	İşlev parametresi öğesi.
FunctionReturnValue	İşlev dönüş değeri öğesi.
NodeType	Grafik düğümü türü öğesi.
EdgeType	Grafik kenar türü öğesi.
Entity	Bir ontoloji varlık öğesi.

ErrorRelatedResource

Nesne

Hata ile ilişkili 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 insan tarafından okunabilir bir temsilidir.
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 insan tarafından okunabilir bir temsilidir.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

IndexState

Numaralandırma

Lakehouse dosya dizinleri için dizin durumu. Zaman içinde ek IndexState türleri eklenebilir.

Değer	Description
Indexed	Dizin yapılandırılmamış arama için dizine alındı.
Indexing	Dizin şu anda dizinleniyor.
NotIndexed	Dizin dizine alınmadı.