Freigeben über

Items - Bind Semantic Model Connection

Dienst:
SemanticModel
API-Version:
v1

Bindet einen Semantikmodelldatenquellenverweis an eine Datenverbindung.
Diese API kann auch verwendet werden, um verknüpfungsfähige Datenquellenverweise aufzuheben.

Erlaubnisse

Der Aufrufer muss der Besitzer des semantischen Modells sein.

Einschränkungen

Diese API unterstützt keine Massenvorgänge. Um mehrere Datenquellenverweise eines semantischen Modells zu binden, muss der Benutzer mehrere bindConnection-Anforderungen senden.

Erforderliche delegierte Bereiche

SemanticModel.ReadWrite.All oder Item.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Support
Benutzer Yes
Service Principal und Verwaltete Identitäten Yes

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
semanticModelId
 path True

string (uuid)

Die Semantikmodell-ID.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
connectionBinding True

ConnectionBinding

Die Details der Verbindungsbindung.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • ItemNotFound – Das angeforderte Semantikmodell wurde nicht gefunden.

  • InvalidRequest – Ungültige Bindungs-Semantikmodell-Verbindungsanforderung.

Beispiele

Bind a semantic model connection example
Unbind a semantic model connection example

Bind a semantic model connection example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200

Unbind a semantic model connection example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
BindSemanticModelConnectionRequest

Die Nutzlast einer bindConnection-Anforderung, um einen Datenquellenverweis eines semantischen Modells an eine Datenverbindung zu binden.
ConnectionBinding

Die Details der Verbindungsbindung.
ConnectivityType

Der Verbindungstyp der Verbindung. Zusätzliche Verbindungstypen können im Laufe der Zeit hinzugefügt werden.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
ListConnectionDetails

Die Ausgabe der Verbindungsdetails für Listenvorgänge.

BindSemanticModelConnectionRequest

Objekt

Die Nutzlast einer bindConnection-Anforderung, um einen Datenquellenverweis eines semantischen Modells an eine Datenverbindung zu binden.

Name Typ Beschreibung
connectionBinding

ConnectionBinding

Die Details der Verbindungsbindung.

ConnectionBinding

Objekt

Die Details der Verbindungsbindung.

Name Typ Beschreibung
connectionDetails

ListConnectionDetails

Die Verbindungsdetails der Verbindung.
connectivityType

ConnectivityType

Der Verbindungstyp der Verbindung.
id

string (uuid)

Die Objekt-ID der Verbindung.

ConnectivityType

Enumeration

Der Verbindungstyp der Verbindung. Zusätzliche Verbindungstypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
ShareableCloud

Die Verbindung verbindet sich über die Cloud und kann für andere freigegeben werden.
PersonalCloud

Die Verbindung verbindet sich über die Cloud und kann nicht für andere freigegeben werden.
OnPremisesGateway

Die Verbindung wird über ein lokales Datengateway hergestellt.
OnPremisesGatewayPersonal

Die Verbindung wird über ein persönliches lokales Datengateway hergestellt.
VirtualNetworkGateway

Die Verbindung wird über ein virtuelles Netzwerkdatengateway hergestellt.
Automatic

Die Verbindung wird über die Cloud mithilfe einer impliziten Datenverbindung hergestellt. Diese Option ist nur für bestimmte Szenarien wie semantische Modelle verfügbar, die single Sign-On (SSO) verwenden".
None

Die Verbindung ist nicht gebunden.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

ListConnectionDetails

Objekt

Die Ausgabe der Verbindungsdetails für Listenvorgänge.

Name Typ Beschreibung
path

string

Der Pfad der Verbindung.
type

string

Der Typ der Verbindung.