Items - Bind Semantic Model Connection

Tjänst:

SemanticModel

API-version:

v1

Binder en referens för en semantisk modelldatakälla till en dataanslutning.
Det här API:et kan också användas för att avbinda datakällans referenser.

Permissions

Anroparen måste vara ägare till den semantiska modellen.

Begränsningar

Det här API:et stöder inte massåtgärder. Om du vill binda flera datakällreferenser för en semantisk modell måste användaren skicka flera bindConnection-begäranden.

Obligatoriska delegerade omfång

SemanticModel.ReadWrite.All eller Item.ReadWrite.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Support
User	Yes
Tjänsthuvudnamn och hanterade identiteter	Yes

Gränssnitt

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
semanticModelId	path	True	string (uuid)	Det semantiska modell-ID:t.
workspaceId	path	True	string (uuid)	Arbetsyte-ID.

Begärandetext

Name	Obligatorisk	Typ	Description
connectionBinding	True	ConnectionBinding	Information om anslutningsbindningen.

Svar

Name	Typ	Description
200 OK		Begäran har slutförts.
429 Too Many Requests	ErrorResponse	Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas. Sidhuvuden Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: ItemNotFound – Den begärda semantiska modellen hittades inte. InvalidRequest – Ogiltig anslutningsbegäran för bindningssemantisk modell.

Exempel

Bind a semantic model connection example

Unbind a semantic model connection example

Bind a semantic model connection example

Exempelbegäran

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

Exempelsvar

Statuskod:

200

Unbind a semantic model connection example

Exempelbegäran

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

Exempelsvar

Statuskod:

200

Definitioner

Name	Description
BindSemanticModelConnectionRequest	Nyttolasten för en bindConnection-begäran för att binda en datakällreferens för en semantisk modell till en dataanslutning.
ConnectionBinding	Information om anslutningsbindningen.
ConnectivityType	Anslutningens anslutningstyp. Ytterligare anslutningstyper kan läggas till över tid.
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
ListConnectionDetails	Utdata för anslutningsinformation för liståtgärder.

BindSemanticModelConnectionRequest

Objekt

Nyttolasten för en bindConnection-begäran för att binda en datakällreferens för en semantisk modell till en dataanslutning.

Name	Typ	Description
connectionBinding	ConnectionBinding	Information om anslutningsbindningen.

ConnectionBinding

Objekt

Information om anslutningsbindningen.

Name	Typ	Description
connectionDetails	ListConnectionDetails	Anslutningsinformationen för anslutningen.
connectivityType	ConnectivityType	Anslutningens anslutningstyp.
id	string (uuid)	Objekt-ID för anslutningen.

ConnectivityType

Uppräkning

Anslutningens anslutningstyp. Ytterligare anslutningstyper kan läggas till över tid.

Värde	Description
ShareableCloud	Anslutningen ansluter via molnet och kan delas med andra.
PersonalCloud	Anslutningen ansluter via molnet och kan inte delas med andra.
OnPremisesGateway	Anslutningen ansluter via en lokal datagateway.
OnPremisesGatewayPersonal	Anslutningen ansluter via en personlig lokal datagateway.
VirtualNetworkGateway	Anslutningen ansluter via en virtuell nätverksdatagateway.
StreamingVirtualNetworkGateway	Anslutningen ansluter via en strömmande virtuell nätverksdatagateway.
Automatic	Anslutningen ansluter via molnet med hjälp av en implicit dataanslutning. Det här alternativet är endast tillgängligt för specifika scenarier som semantiska modeller som använder enkel Sign-On (SSO)."
None	Anslutningen är inte bunden

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
isRetriable	boolean	När det är sant kan begäran göras på nytt. Använd svarshuvudet Retry-After för att fastställa fördröjningen, om den är tillgänglig.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string (uuid)	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.

ListConnectionDetails

Objekt

Utdata för anslutningsinformation för liståtgärder.

Name	Typ	Description
path	string	Sökvägen till anslutningen.
type	string	Typen av anslutning.