Compartir a través de

Items - Bind Semantic Model Connection

Servicio:
SemanticModel
Versión de la API:
v1

Enlaza una referencia de origen de datos de modelo semántico a una conexión de datos.
Esta API también se puede usar para desenlace de referencias de origen de datos.

Permissions

El autor de la llamada debe ser el propietario del modelo semántico.

Limitaciones

Esta API no admite operaciones masivas. Para enlazar varias referencias de origen de datos de un modelo semántico, el usuario debe enviar varias solicitudes bindConnection.

Ámbitos delegados necesarios

SemanticModel.ReadWrite.All o Item.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad Support
Usuario Sí
Entidad de servicio e Identidades administradas Sí

Interfaz

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
semanticModelId
 path True

string (uuid)

Identificador del modelo semántico.
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
connectionBinding True

ConnectionBinding

Detalles del enlace de conexión.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • ItemNotFound: no se encontró el modelo semántico solicitado.

  • InvalidRequest: solicitud de conexión del modelo semántico de enlace no válida.

Ejemplos

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

Bind a semantic model connection example

Solicitud de ejemplo

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

Respuesta de muestra

status code:
200

Unbind a semantic model connection example

Solicitud de ejemplo

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

Respuesta de muestra

status code:
200

Definiciones

Nombre Description
BindSemanticModelConnectionRequest

La carga de una solicitud bindConnection para enlazar una referencia de origen de datos de un modelo semántico a una conexión de datos.
ConnectionBinding

Detalles del enlace de conexión.
ConnectivityType

Tipo de conectividad de la conexión. Se pueden agregar tipos de conectividad adicionales a lo largo del tiempo.
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
ListConnectionDetails

Salida de detalles de conexión para las operaciones de lista.

BindSemanticModelConnectionRequest

Object

La carga de una solicitud bindConnection para enlazar una referencia de origen de datos de un modelo semántico a una conexión de datos.

Nombre Tipo Description
connectionBinding

ConnectionBinding

Detalles del enlace de conexión.

ConnectionBinding

Object

Detalles del enlace de conexión.

Nombre Tipo Description
connectionDetails

ListConnectionDetails

Detalles de conexión de la conexión.
connectivityType

ConnectivityType

Tipo de conectividad de la conexión.
id

string (uuid)

Identificador de objeto de la conexión.

ConnectivityType

Enumeración

Tipo de conectividad de la conexión. Se pueden agregar tipos de conectividad adicionales a lo largo del tiempo.

Valor Description
ShareableCloud

La conexión se conecta a través de la nube y se puede compartir con otros usuarios.
PersonalCloud

La conexión se conecta a través de la nube y no se puede compartir con otros usuarios.
OnPremisesGateway

La conexión se conecta a través de una puerta de enlace de datos local.
OnPremisesGatewayPersonal

La conexión se conecta a través de una puerta de enlace de datos local personal.
VirtualNetworkGateway

La conexión se conecta a través de una puerta de enlace de datos de red virtual.
Automatic

La conexión se conecta a través de la nube mediante una conexión de datos implícita. Esta opción solo está disponible para escenarios específicos, como modelos semánticos que usan single Sign-On (SSO)."
None

La conexión no está enlazada

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

ListConnectionDetails

Object

Salida de detalles de conexión para las operaciones de lista.

Nombre Tipo Description
path

string

Ruta de acceso de la conexión.
type

string

Tipo de la conexión.