Items - Bind Semantic Model Connection

Hizmet:

SemanticModel

API Sürümü:

v1

Semantik model veri kaynağı başvurularını bir veri bağlantısına bağlar.
Bu API, veri kaynağı başvurularının bağlamasını çözmek için de kullanılabilir.

Permissions

Çağıranın semantik modelin sahibi olması gerekir.

Sınırlamalar

Bu API toplu işlemleri desteklemez. Bir anlam modelinin birden çok veri kaynağı başvurularını bağlamak için kullanıcının birden çok bindConnection isteği göndermesi gerekir.

Gerekli Temsilci Kapsamları

SemanticModel.ReadWrite.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

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

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

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/bindConnection

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
semanticModelId	path	True	string (uuid)	Anlamsal model kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Veri Akışı Adı	Gerekli	Tür	Description
connectionBinding	True	ConnectionBinding	Bağlantı bağlamanın ayrıntıları.

Yanıtlar

Veri Akışı Adı	Tür	Description
200 OK		İ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	Yaygın hata kodları: ItemNotFound - İstenen anlam modeli bulunamadı. InvalidRequest - Geçersiz bağlama semantik modeli bağlantı isteği.

Örnekler

Bind a semantic model connection example

Unbind a semantic model connection example

Bind a semantic model connection example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels/cfafbeb1-8037-4d0c-896e-a46fb27ff229/bindConnection

{
  "connectionBinding": {
    "id": "0b9af1bd-e974-4893-8947-d89d5a560385",
    "connectivityType": "OnPremisesDataGateway",
    "connectionDetails": {
      "type": "SQL",
      "path": "contoso.database.windows.net;sales"
    }
  }
}

Örnek yanıt

Durum kodu:

200

Unbind a semantic model connection example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels/cfafbeb1-8037-4d0c-896e-a46fb27ff229/bindConnection

{
  "connectionBinding": {
    "connectivityType": "None",
    "connectionDetails": {
      "type": "SQL",
      "path": "contoso.database.windows.net;sales"
    }
  }
}

Örnek yanıt

Durum kodu:

200

Tanımlar

Veri Akışı Adı	Description
BindSemanticModelConnectionRequest	Anlamsal modelin veri kaynağı başvurularını bir veri bağlantısına bağlamak için bir bindConnection isteğinin yükü.
ConnectionBinding	Bağlantı bağlamanın ayrıntıları.
ConnectivityType	Bağlantının bağlantı türü. Zaman içinde ek bağlantı türleri eklenebilir.
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ListConnectionDetails	Liste işlemleri için bağlantı ayrıntıları çıktısı.

BindSemanticModelConnectionRequest

Nesne

Anlamsal modelin veri kaynağı başvurularını bir veri bağlantısına bağlamak için bir bindConnection isteğinin yükü.

Veri Akışı Adı	Tür	Description
connectionBinding	ConnectionBinding	Bağlantı bağlamanın ayrıntıları.

ConnectionBinding

Nesne

Bağlantı bağlamanın ayrıntıları.

Veri Akışı Adı	Tür	Description
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectivityType	ConnectivityType	Bağlantının bağlantı türü.
id	string (uuid)	Bağlantının nesne kimliği.

ConnectivityType

Numaralandırma

Bağlantının bağlantı türü. Zaman içinde ek bağlantı türleri eklenebilir.

Değer	Description
ShareableCloud	Bağlantı bulut üzerinden bağlanır ve başkalarıyla paylaşılabilir.
PersonalCloud	Bağlantı bulut üzerinden bağlanır ve başkalarıyla paylaşılamaz.
OnPremisesGateway	Bağlantı, şirket içi veri ağ geçidi üzerinden bağlanır.
OnPremisesGatewayPersonal	Bağlantı, kişisel bir şirket içi veri ağ geçidi üzerinden bağlanır.
VirtualNetworkGateway	Bağlantı bir sanal ağ veri ağ geçidi üzerinden bağlanır.
StreamingVirtualNetworkGateway	Bağlantı, akış sanal ağ veri ağ geçidi üzerinden bağlanır.
Automatic	Bağlantı, örtük bir veri bağlantısı kullanarak bulut üzerinden bağlanır. Bu seçenek yalnızca Tek Sign-On (SSO) kullanan anlamsal modeller gibi belirli senaryolarda kullanılabilir."
None	Bağlantı bağlı değil

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	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ı.

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
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ı.

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

ListConnectionDetails

Nesne

Liste işlemleri için bağlantı ayrıntıları çıktısı.

Veri Akışı Adı	Tür	Description
path	string	Bağlantının yolu.
type	string	Bağlantının türü.