Items - Bind Semantic Model Connection
의미 체계 모델 데이터 원본 참조를 데이터 연결에 바인딩합니다.
이 API를 사용하여 데이터 원본 참조를 바인딩 해제할 수도 있습니다.
Permissions
호출자는 의미 체계 모델의 소유자여야 합니다.
제한점
이 API는 대량 작업을 지원하지 않습니다. 의미 체계 모델의 여러 데이터 원본 참조를 바인딩하려면 사용자가 여러 bindConnection 요청을 제출해야 합니다.
필요한 위임된 범위
SemanticModel.ReadWrite.All 또는 Item.ReadWrite.All
Microsoft Entra 지원 식별자
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
| 아이덴티티 | Support |
|---|---|
| 사용자 | Yes |
| 서비스 주체 및 관리 ID | Yes |
인터페이스
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/bindConnectionURI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
semantic
|
path | True |
string (uuid) |
의미 체계 모델 ID입니다. |
|
workspace
|
path | True |
string (uuid) |
작업 영역 ID입니다. |
요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| connectionBinding | True |
연결 바인딩의 세부 정보입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
일반적인 오류 코드:
|
예제
| Bind a semantic model connection example |
| Unbind a semantic model connection example |
Bind a semantic model connection example
샘플 요청
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"
}
}
}
샘플 응답
Unbind a semantic model connection example
샘플 요청
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"
}
}
}
샘플 응답
정의
| Name | Description |
|---|---|
|
Bind |
의미 체계 모델의 데이터 원본 참조를 데이터 연결에 바인딩하는 bindConnection 요청의 페이로드입니다. |
|
Connection |
연결 바인딩의 세부 정보입니다. |
|
Connectivity |
연결의 연결 유형입니다. 시간이 지남에 따라 추가 연결 유형을 추가할 수 있습니다. |
|
Error |
오류 관련 리소스 세부 정보 개체입니다. |
|
Error |
오류 응답입니다. |
|
Error |
오류 응답 세부 정보입니다. |
|
List |
목록 작업에 대한 연결 세부 정보 출력입니다. |
BindSemanticModelConnectionRequest
의미 체계 모델의 데이터 원본 참조를 데이터 연결에 바인딩하는 bindConnection 요청의 페이로드입니다.
| Name | 형식 | Description |
|---|---|---|
| connectionBinding |
연결 바인딩의 세부 정보입니다. |
ConnectionBinding
연결 바인딩의 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| connectionDetails |
연결의 연결 세부 정보입니다. |
|
| connectivityType |
연결의 연결 유형입니다. |
|
| id |
string (uuid) |
연결의 개체 ID입니다. |
ConnectivityType
연결의 연결 유형입니다. 시간이 지남에 따라 추가 연결 유형을 추가할 수 있습니다.
| 값 | Description |
|---|---|
| ShareableCloud |
연결은 클라우드를 통해 연결되며 다른 사용자와 공유할 수 있습니다. |
| PersonalCloud |
연결은 클라우드를 통해 연결되며 다른 사용자와 공유할 수 없습니다. |
| OnPremisesGateway |
연결은 온-프레미스 데이터 게이트웨이를 통해 연결됩니다. |
| OnPremisesGatewayPersonal |
연결은 개인 온-프레미스 데이터 게이트웨이를 통해 연결됩니다. |
| VirtualNetworkGateway |
연결은 가상 네트워크 데이터 게이트웨이를 통해 연결됩니다. |
| Automatic |
연결은 암시적 데이터 연결을 사용하여 클라우드를 통해 연결됩니다. 이 옵션은 SSO(Single Sign-On)를 사용하는 의미 체계 모델과 같은 특정 시나리오에서만 사용할 수 있습니다. |
| None |
연결이 바인딩되지 않음 |
ErrorRelatedResource
오류 관련 리소스 세부 정보 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| resourceId |
string |
오류와 관련된 리소스 ID입니다. |
| resourceType |
string |
오류와 관련된 리소스의 형식입니다. |
ErrorResponse
오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| moreDetails |
추가 오류 세부 정보 목록입니다. |
|
| relatedResource |
오류 관련 리소스 세부 정보입니다. |
|
| requestId |
string |
오류와 연결된 요청의 ID입니다. |
ErrorResponseDetails
오류 응답 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| relatedResource |
오류 관련 리소스 세부 정보입니다. |
ListConnectionDetails
목록 작업에 대한 연결 세부 정보 출력입니다.
| Name | 형식 | Description |
|---|---|---|
| path |
string |
연결 경로입니다. |
| type |
string |
연결의 형식입니다. |