Items - Get Upstream Relations (beta)

บริการ:: Core

เวอร์ชัน API:: v1

เรียกดูความสัมพันธ์อัพสตรีมสําหรับสินค้า

หมายเหตุ

API นี้เป็นส่วนหนึ่งของการเผยแพร่รุ่นเบต้า และมีไว้สําหรับวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต เมื่อเรียกใช้ API นี้ ผู้เรียกต้องระบุ true เป็นค่าสําหรับพารามิเตอร์ betaคิวรี

แสดงหน่วยข้อมูลทั้งหมดที่เป็นอัพสตรีมของรายการที่ระบุ รวมถึงขอบความสัมพันธ์และพื้นที่ทํางานที่อ้างอิง

สิทธิ์การได้รับอนุญาต

ผู้เรียกต้องมีสิทธิ์ การอ่าน สําหรับรายการนี้

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

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

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

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

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

อินเตอร์เฟซ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/relations/upstream?beta={beta}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
itemId	path	True	string (uuid)	รหัสสินค้า
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน
beta	query	True	boolean	ต้องตั้งค่าพารามิเตอร์ที่จําเป็นนี้เพื่อ `true` เข้าถึง API นี้ ซึ่งอยู่ในรุ่นเบต้าในขณะนี้

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย

200 OK

ชื่อ	พิมพ์	คำอธิบาย
200 OK	RelationsResponse	คําขอเสร็จสมบูรณ์
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ `Retry-After` ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่พบรายการที่ร้องขอ ไม่เพียงพอ Privileges - ผู้เรียกมีสิทธิ์เพียงพอในการเข้าถึงรายการ

RelationsResponse

คําขอเสร็จสมบูรณ์

429 Too Many Requests

ErrorResponse

เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

ItemNotFound - ไม่พบรายการที่ร้องขอ
ไม่เพียงพอ Privileges - ผู้เรียกมีสิทธิ์เพียงพอในการเข้าถึงรายการ

ตัวอย่าง

Get upstream relations example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/3546052c-ae64-4526-b1a8-52af7761426f/relations/upstream?beta=True

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

รหัสสถานะ:: 200

{
  "items": [
    {
      "id": "9b218778-e7a5-4d73-8187-f10824047715",
      "type": "Lakehouse",
      "displayName": "Enterprise Sales Lakehouse",
      "workspaceId": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41"
    }
  ],
  "relations": [
    {
      "itemId": "3546052c-ae64-4526-b1a8-52af7761426f",
      "dependentOnItemId": "9b218778-e7a5-4d73-8187-f10824047715",
      "relationType": "PushData"
    }
  ],
  "workspaces": [
    {
      "id": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41",
      "displayName": "Data Engineering Workspace"
    }
  ]
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
RelationsEdge	ขอบความสัมพันธ์ระหว่างสองหน่วยข้อมูล
RelationsRelatedItem	สินค้าที่เกี่ยวข้องกับสินค้าที่ระบุ นี่คือชุดย่อยของวัตถุรายการทั้งหมด ที่มีเฉพาะคุณสมบัติที่ส่งกลับโดยความสัมพันธ์ API
RelationsResponse	การตอบสนองที่ประกอบด้วยรายการที่เกี่ยวข้อง ขอบความสัมพันธ์ และพื้นที่ทํางานอ้างอิง
RelationsWorkspace	พื้นที่ทํางานที่อ้างอิงในการตอบสนองความสัมพันธ์
RelationType	ชนิดของความสัมพันธ์ระหว่างสินค้าสองรายการ คุณสามารถเพิ่มชนิดความสัมพันธ์เพิ่มเติมได้เมื่อเวลาผ่านไป

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

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

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet
DataAgent	DataAgent
MirroredCatalog	มิเรอร์ดคาตาล็อก
AppBackend	AppBackend
OrgApp	แอปองค์กร
OrgAppAudience	ผู้ชมแอปองค์กร
DataBuildToolJob	DataBuildToolJob
AzureDatabricksStorage	รายการพื้นที่จัดเก็บข้อมูลที่สํารองข้อมูลโดย OneLake สําหรับ Azure Databricks

RelationsEdge

วัตถุ

ขอบความสัมพันธ์ระหว่างสองหน่วยข้อมูล

ชื่อ	พิมพ์	คำอธิบาย
dependentOnItemId	string (uuid)	ตัวระบุของรายการที่รายการต้นทางขึ้นอยู่กับ
itemId	string (uuid)	ตัวระบุหน่วยข้อมูลต้นทาง
relationType	RelationType	ชนิดของความสัมพันธ์ระหว่างสินค้าสองรายการ คุณสามารถเพิ่มชนิดความสัมพันธ์เพิ่มเติมได้เมื่อเวลาผ่านไป

RelationsRelatedItem

วัตถุ

สินค้าที่เกี่ยวข้องกับสินค้าที่ระบุ นี่คือชุดย่อยของวัตถุรายการทั้งหมด ที่มีเฉพาะคุณสมบัติที่ส่งกลับโดยความสัมพันธ์ API

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงของรายการ
id	string (uuid)	รหัสสินค้า
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID ของพื้นที่ทํางานที่ประกอบด้วยรายการ ใช้ ID นี้เพื่อค้นหาพื้นที่ทํางานในรายการ`workspaces`

RelationsResponse

วัตถุ

การตอบสนองที่ประกอบด้วยรายการที่เกี่ยวข้อง ขอบความสัมพันธ์ และพื้นที่ทํางานอ้างอิง

ชื่อ	พิมพ์	คำอธิบาย
items	RelationsRelatedItem[]	รายการข้อมูลที่เกี่ยวข้อง
relations	RelationsEdge[]	รายการของขอบความสัมพันธ์ระหว่างหน่วยข้อมูล
workspaces	RelationsWorkspace[]	รายการพื้นที่ทํางานที่อ้างอิงตามรายการที่เกี่ยวข้อง

RelationsWorkspace

วัตถุ

พื้นที่ทํางานที่อ้างอิงในการตอบสนองความสัมพันธ์

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงของพื้นที่ทํางาน
id	string (uuid)	ตัวระบุพื้นที่ทํางาน

RelationType

การแจงนับ

ชนิดของความสัมพันธ์ระหว่างสินค้าสองรายการ คุณสามารถเพิ่มชนิดความสัมพันธ์เพิ่มเติมได้เมื่อเวลาผ่านไป

ค่า	คำอธิบาย
CascadeDelete	ความสัมพันธ์ CascadeDelete ระบุว่ารายการนั้นเป็นพาเรนต์ของ DependentOnItemId และการลบรายการดังกล่าวจะทําให้รายการขึ้นต่อกันถูกลบออกด้วย
WeakAssociation	ความสัมพันธ์ WeakAssociation ระบุว่ามีการขึ้นต่อกันแบบนุ่มนวลบนรายการที่ระบุโดย dependentOnItemId ถ้ารายการแบบขึ้นต่อกันถูกลบ ความสัมพันธ์จะถูกลบ
Datasource	ความสัมพันธ์ของแหล่งข้อมูลระบุว่ามีการขึ้นต่อกันแบบนุ่มนวลในรายการที่ระบุโดยแหล่งข้อมูลทั่วไป ถ้ารายการแบบขึ้นต่อกันถูกลบ ความสัมพันธ์จะถูกลบ
PushData	ความสัมพันธ์ PushData ระบุว่าหน่วยข้อมูลขึ้นต่อกันเขียน/พุชข้อมูลไปยังรายการขึ้นต่อกัน (รายการที่ระบุโดย dependentOnItemId) ถ้ารายการแบบขึ้นต่อกันถูกลบ ความสัมพันธ์จะถูกลบ
Orchestration	ความสัมพันธ์ของการเรียงบ่งชี้ว่าสินค้าดําเนินการจัดการหรือกระบวนการเรียงของรายการขึ้นต่อกัน (รายการที่ระบุโดย DependentOnItemId) ถ้ารายการแบบขึ้นต่อกันถูกลบ ความสัมพันธ์จะถูกลบ
Shortcut	ความสัมพันธ์ทางลัดระบุว่ารายการมีทางลัดหรือลิงก์ไปยังข้อมูลหรือพื้นที่ข้อมูลจากรายการที่ระบุโดย dependentOnItemId ถ้ารายการแบบขึ้นต่อกันถูกลบ ความสัมพันธ์จะถูกลบ
HiddenInWorkspace	HiddenInWorkspace ระบุว่ารายการที่เป็นเจ้าของความสัมพันธ์นี้จะถูกซ่อนไว้ในพื้นที่ทํางาน