Items - Bind Semantic Model Connection

บริการ:

SemanticModel

เวอร์ชัน API:

v1

ผูกการอ้างอิงแหล่งข้อมูลแบบจําลองความหมายไปยังการเชื่อมต่อข้อมูล
API นี้ยังสามารถใช้ในการยกเลิกการผูกการอ้างอิงแหล่งข้อมูลได้อีกด้วย

สิทธิ์

ผู้เรียกต้องเป็นเจ้าของแบบจําลองความหมาย

Limitations

API นี้ไม่สนับสนุนการดําเนินการแบบกลุ่ม เพื่อผูกการอ้างอิงแหล่งข้อมูลหลายแหล่งของแบบจําลองความหมาย ผู้ใช้ต้องส่งคําขอ BindConnection หลายรายการ

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

SemanticModel.ReadWrite.All หรือ Item.ReadWrite.All

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

Identity	Support
ผู้ใช้	Yes
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ	Yes

Interface

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

พารามิเตอร์ URI

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
semanticModelId	path	True	string (uuid)	ID แบบจําลองความหมาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

เนื้อความของคำขอ

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
connectionBinding	True	ConnectionBinding	รายละเอียดของการผูกการเชื่อมต่อ

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK		คําขอเสร็จสมบูรณ์
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่พบแบบจําลองความหมายที่ร้องขอ InvalidRequest - คําขอการเชื่อมต่อแบบจําลองความหมายไม่ถูกต้อง

ตัวอย่าง

Bind a semantic model connection example

Unbind a semantic model connection example

Bind a semantic model connection example

คำขอตัวอย่าง

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

คำตอบตัวอย่าง

รหัสสถานะ:

200

Unbind a semantic model connection example

คำขอตัวอย่าง

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

คำตอบตัวอย่าง

รหัสสถานะ:

200

คำจำกัดความ

ชื่อ	คำอธิบาย
BindSemanticModelConnectionRequest	ส่วนข้อมูลของคําขอ bindConnection เพื่อผูกการอ้างอิงแหล่งข้อมูลของแบบจําลองความหมายกับการเชื่อมต่อข้อมูล
ConnectionBinding	รายละเอียดของการผูกการเชื่อมต่อ
ConnectivityType	ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ListConnectionDetails	รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ

BindSemanticModelConnectionRequest

ออบเจ็กต์

ส่วนข้อมูลของคําขอ bindConnection เพื่อผูกการอ้างอิงแหล่งข้อมูลของแบบจําลองความหมายกับการเชื่อมต่อข้อมูล

ชื่อ	พิมพ์	คำอธิบาย
connectionBinding	ConnectionBinding	รายละเอียดของการผูกการเชื่อมต่อ

ConnectionBinding

ออบเจ็กต์

รายละเอียดของการผูกการเชื่อมต่อ

ชื่อ	พิมพ์	คำอธิบาย
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectivityType	ConnectivityType	ชนิดการเชื่อมต่อของการเชื่อมต่อ
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ

ConnectivityType

การแจงนับ

ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
ShareableCloud	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และสามารถแชร์กับผู้อื่นได้
PersonalCloud	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และไม่สามารถแชร์กับผู้อื่นได้
OnPremisesGateway	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กร
OnPremisesGatewayPersonal	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กรส่วนบุคคล
VirtualNetworkGateway	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือน
Automatic	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์โดยใช้การเชื่อมต่อข้อมูลโดยนัย ตัวเลือกนี้พร้อมใช้งานสําหรับสถานการณ์เฉพาะเช่น แบบจําลองความหมายที่ใช้ Sign-On เดี่ยว (SSO)"
None	การเชื่อมต่อไม่ถูกผูกไว้

ErrorRelatedResource

ออบเจ็กต์

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

ออบเจ็กต์

การตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

ออบเจ็กต์

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ListConnectionDetails

ออบเจ็กต์

รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางของการเชื่อมต่อ
type	string	ชนิดของการเชื่อมต่อ