Items - Bind Semantic Model Connection

Servizio:

SemanticModel

Versione API:

v1

Associa un riferimento all'origine dati di un modello semantico a una connessione dati.
Questa API può essere usata anche per scollegare i riferimenti alle origini dati.

Permissions

Il chiamante deve essere il proprietario del modello semantico.

Limitazioni

Questa API non supporta le operazioni bulk. Per associare più riferimenti all'origine dati di un modello semantico, l'utente deve inviare più richieste bindConnection.

Ambiti delegati obbligatori

SemanticModel.ReadWrite.All o Item.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interfaccia

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
semanticModelId	path	True	string (uuid)	ID modello semantico.
workspaceId	path	True	string (uuid)	L’ID dell’area di lavoro.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
connectionBinding	True	ConnectionBinding	Dettagli dell'associazione di connessione.

Risposte

Nome	Tipo	Descrizione
200 OK		Richiesta completata correttamente.
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: ItemNotFound: il modello semantico richiesto non è stato trovato. InvalidRequest: richiesta di connessione del modello semantico di binding non valida.

Esempio

Bind a semantic model connection example

Unbind a semantic model connection example

Bind a semantic model connection example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

200

Unbind a semantic model connection example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

200

Definizioni

Nome	Descrizione
BindSemanticModelConnectionRequest	Payload di una richiesta bindConnection per associare un riferimento all'origine dati di un modello semantico a una connessione dati.
ConnectionBinding	Dettagli dell'associazione di connessione.
ConnectivityType	Tipo di connettività della connessione. È possibile aggiungere altri tipi di connettività nel tempo.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
ListConnectionDetails	Output dei dettagli della connessione per le operazioni di elenco.

BindSemanticModelConnectionRequest

Oggetto

Payload di una richiesta bindConnection per associare un riferimento all'origine dati di un modello semantico a una connessione dati.

Nome	Tipo	Descrizione
connectionBinding	ConnectionBinding	Dettagli dell'associazione di connessione.

ConnectionBinding

Oggetto

Dettagli dell'associazione di connessione.

Nome	Tipo	Descrizione
connectionDetails	ListConnectionDetails	Dettagli della connessione.
connectivityType	ConnectivityType	Tipo di connettività della connessione.
id	string (uuid)	ID oggetto della connessione.

ConnectivityType

Enumerazione

Tipo di connettività della connessione. È possibile aggiungere altri tipi di connettività nel tempo.

Valore	Descrizione
ShareableCloud	La connessione si connette tramite il cloud e può essere condivisa con altri utenti.
PersonalCloud	La connessione si connette tramite il cloud e non può essere condivisa con altri utenti.
OnPremisesGateway	La connessione si connette tramite un gateway dati locale.
OnPremisesGatewayPersonal	La connessione si connette tramite un gateway dati locale personale.
VirtualNetworkGateway	La connessione si connette tramite un gateway dati di rete virtuale.
Automatic	La connessione si connette tramite il cloud usando una connessione dati implicita. Questa opzione è disponibile solo per scenari specifici, ad esempio modelli semantici che usano Single Sign-On (SSO)."
None	La connessione non è associata

ErrorRelatedResource

Oggetto

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

ListConnectionDetails

Oggetto

Output dei dettagli della connessione per le operazioni di elenco.

Nome	Tipo	Descrizione
path	string	Percorso della connessione.
type	string	Tipo di connessione.